Hot Fix and Service Pack Installation Guide

Crystal and BusinessObjects XI Products

Contents
INSTALLATION ............................................................................................. 2 Order of installation ....................................................................................2 What happens during the installation .........................................................2 Installing Hot Fixes and Service Packs for UNIX or Linux platforms........4 Determining which patches are installed on a computer .............................5 Uninstalling ................................................................................................5 Silent Installation of Hot Fixes and Service Packs ......................................6

8/11/2005 12:09:00 PM

Copyright 2005 Business Objects. All rights reserved.

Page 1

Hot Fix and Service Pack Installation Guide

Crystal Products and BusinessObjects XI

Installation
This section applies to HFs and SPs for Crystal 10 and BusinessObjects XI products installed on a Windows platform. Information specific to UNIX and Linux platforms can be found here.

Order of installation
Updates of the same type (for example, WHFs with MHFs) do not need to be installed in a particular order. However, if you are installing a combination of SPs, MHFs, or WHFs, then follow this recommended order of installation: SP MHF WHF By following this order, the most recently updated components (in the WHF) are installed last.

What happens during the installation

HFs and SPs for Windows use an InstallShield install package. Here is the series of steps that occur during the install process: 1. Starting up install process The patch install initializes and determines where relevant products and folders are installed by checking the registry. For example, the subkey below contains entries indicating where the product is installed, as well as the location of the Common Files folder: HKEY_LOCAL_MACHINE\SOFTWARE\Business Objects\Suite 11.0\Crystal Reports These locations are used by the patch for searching and updating files. If the patch fails to find an installed product, then error code -199 is returned. More information on this error code is available in knowledge base article c2010232. 2. Displaying legal disclaimer and warning The install then displays a legal disclaimer which must be agreed to when installing the patch. Following the disclaimer is a warning. The warning indicates that the patch shuts down related Windows services affected by the patch. Services are restarted at the end of install. The warning also indicates to restart your computer if there are any technical issues after installing the patch.
8/11/2005 12:09:00 PM
Copyright 2005 Business Objects. All rights reserved.

Page 2

hot_fix_installation.pdf

Hot Fix and Service Pack Installation Guide

Crystal Products and BusinessObjects XI

3.

Selecting components (Weekly and MHF only) The Select Components dialog box (Figure 1) indicates which components are installed by the HF. SPs do not have this box since they install all files by design. WHFs and MHFs have the option of only selecting certain files to update. This is useful when the amount of testing required by the customer for their environment is dependent on the number of files introduced by a HF.

Figure 1 - Select Components Dialog Box

Files listed in this box are those found by the HF to update. Note that this will only list files located at their usual installed locations (determined by the patch install checking registry entries during the initialization step). If a file is not listed, then it will not be updated. No new files are introduced by HFs or SPs. The unavailable (grayed) check boxes indicate files which must be installed when other certain files are selected (a dependency). This dependency only occurs within the HF - there are no dependencies between different HFs. 4. Backing up files The next window indicates where files are backed up by the patch. Files are backed up in a Product Updates folder located in the installation folder of the product being updated. Each time a patch is run, a series of subfolders under the Product Updates folder is created to back up the files to be updated. For example:

8/11/2005 12:09:00 PM

Copyright 2005 Business Objects. All rights reserved.

Page 3

hot_fix_installation.pdf

Hot Fix and Service Pack Installation Guide

Crystal Products and BusinessObjects XI

C:\Program Files\Business Objects\Crystal Reports 11\Product updates\BusinessObjects XI Crystal Reports Weekly HF\Backup of CRXIWIN_EN\11.0.102.1402_4-21-20051718 The name of the lowest subfolder contains the date and time when the patch was run (mm-dd-yyyyhhmm). In this example, the patch was run on April 21, 2005 at 17:18. 5. Updating the files The patch backs up files that are selected for updating and then copies the updated versions to the computer. If the computer contains a newer version of the file than is included in the patch, the patch will not overwrite the existing file. The install process also registers files that need to be registered. Any .NET files in the patch are also automatically entered into the Global Assembly Cache (GAC). 6. Restarting services The last step of the installation process gives the option of restarting Windows services. This is a time saving feature if another patch is to be installed immediately afterwards. Clicking No prevents services from being started and then stopped when installing the next patch.

Installing Hot Fixes and Service Packs for UNIX or Linux platforms
To install Hot Fixes or Service Packs on a UNIX or Linux platform: 1. Unzip and unpack the Hot Fix using the 'gunzip' and 'tar' commands. For example:
gunzip ce10sol_en.tar.gz tar -xvf ce10sol_en.tar

2.

Stop all Crystal daemons on the machine being updated:

ccm.sh -stop all

3.

Ensure all Crystal daemons are stopped:

ps -ef | grep <crystal>

where <crystal> is the user account ID running the daemons 4. Terminate any Crystal daemons that are still running using the 'kill' command:
kill -5 <process id>

5.
8/11/2005 12:09:00 PM

Clean up shared memory:

Page 4

Copyright 2005 Business Objects. All rights reserved.

hot_fix_installation.pdf

Hot Fix and Service Pack Installation Guide

Crystal Products and BusinessObjects XI

On Sun Solaris, HP-UX and Linux, type the command:

ipcs | grep 'whoami' | awk '{print $2}' | xargs -i[] ipcrm -m []

6.

On IBM AIX, run the 'slibclean' command: Set run permissions on the Hot Fix file. For example:
chmod -Rf 755 ce10sol_en

7. 8.

Run the Hot Fix installer script and follow the prompts. Once the install is complete, restart the Crystal Enterprise components:
ccm.sh -start all

Determining which patches are installed on a computer

A History.txt file is created in the Product Updates folder the first time a HF or SP is installed on a computer. This file is updated when a patch is installed. History.txt is a log file that details when a particular patch was installed. Here is a sample History.txt file that shows that the Crystal Reports XI and Common XI WHF are installed:

A history of Crystal Decisions Hot Fixes being applied on this machine HF File Name CRXIWIN_EN.exe Date Installed 4-21-2005 Version Installed 11.0.102.1402 11.0.103.1429 Type Weekly Weekly

COMMONXIWIN_EN.exe 4-22-2005

The version number is an internal versioning system used by the Sustaining teams when creating updates. Versions can be used to distinguish different releases of HFs and SPs. The version numbers listed do not represent specific versions of file components in the patch.

Uninstalling
HFs and SPs provide an uninstall program to restore a system to a prepatch configuration. For Windows, a Restore folder is located in the backup folder created by a patch install each time it is run. For example: C:\Program Files\Business Objects\Crystal Reports 11\Product updates\BusinessObjects XI Crystal Reports Weekly HF\Backup of CRXIWIN_EN\11.0.102.1402_4-21-20051718\restore
8/11/2005 12:09:00 PM
Copyright 2005 Business Objects. All rights reserved.

Page 5

hot_fix_installation.pdf

Hot Fix and Service Pack Installation Guide

Crystal Products and BusinessObjects XI

The uninstall executable (Restore.exe or Setup.exe) in the Restore folder restores a system to the pre-patch configuration. The executable restores the backup files stored in the Files folder (at the same level as the restore folder) to their original locations. The uninstall executable is only available in this restore folder. There are no entries made in Add/Remove Programs when a HF or SP is installed. The uninstall process only restores files. It does not restore previous registry settings or the Global Assembly Cache (GAC) for .NET managed components.

Silent Installation of Hot Fixes and Service Packs

Starting with Crystal 10 products, HFs and SPs may be installed silently to allow for automated or unattended installations by system administrators. For more information on how to run silent installations search for knowledge base article c2014706 at: http://support.businessobjects.com/search

www.businessobjects.com
No part of the computer software or this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, recording, or by any information storage and retrieval system, without permission in writing from Business Objects. The information in this document is subject to change without notice. Business Objects does not warrant that this document is error free. This software and documentation is commercial computer software under Federal Acquisition regulations, and is provided only under the Restricted Rights of the Federal Acquisition Regulations applicable to commercial computer software provided at private expense. The use, duplication, or disclosure by the U.S. Government is subject to restrictions set forth in subdivision (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at 252.227-7013. The Business Objects product and technology are protected by US patent numbers 5,555,403; 6,247,008; 6,578,027; 6,490,593; and 6,289,352. The Business Objects logo, the Business Objects tagline, BusinessObjects, BusinessObjects Broadcast Agent, BusinessQuery, Crystal Analysis, Crystal Analysis Holos, Crystal Applications, Crystal Enterprise, Crystal Info, Crystal Reports, Rapid Mart, and WebIntelligence are trademarks or registered trademarks of Business Objects SA in the United States and/or other countries. Various product and service names referenced herein may be trademarks of Business Objects SA. All other company, product, or brand names mentioned herein, may be the trademarks of their respective owners. Specifications subject to change without notice. Not responsible for errors or omissions. Copyright 2005 Business Objects SA. All rights reserved.

8/11/2005 12:09:00 PM

Copyright 2005 Business Objects. All rights reserved.

Page 6

hot_fix_installation.pdf