Installing a Hot-Fix

This task explains what a Hot-Fix is and how to install it.

What Is a Hot-Fix ?
A Hot-Fix is a software maintenance package containing a small number of code fixes,
designed to fix a small number of critical problems. A Hot-Fix enables a customer to receive
fixes for urgent problems, without having to wait for the next service pack.

Unlike the General Availability (GA) and Service Pack (SP) levels, which are scheduled,
periodic releases, Hot-Fix releases are not periodically scheduled.

Simply requesting a Hot-Fix does not automatically guarantee that the customer will receive
it: all Hot-Fix requests first must be approved and accepted by Dassault Systèmes prior to
delivery.

Furthermore, a Hot-Fix may contain fixes related to problems reported earlier by different
customers. All the files included in the Hot-Fix will nevertheless be installed.

How Are Hot-Fixes Distributed ?

Hot-Fixes are provided as a single, compressed file.

Naming Convention

Hot-Fix code files are named according to the following naming convention:

HotFix<Prod><RxxxSyyyHzzz>.YYY.UUU.MM-DD-YYYY.hh.mm

Where :

Prod = V5x for CATIA/ENOVIA V5 family

Rxxx = Release Level in 3 digits (e.g. R016, R017)
Syyy = Service Pack Level in 3 digits (e.g. S006, S007)
Hzzz = Hot-Fix number (e.g. H001, H002, H003)
YYY = cab for Windows or tar.Z or tar for UNIX
UUU = intel_a or aix_a, aix_a64, hpux_b, solaris_a, irix_a
MM-DD-YYYY.hh.mm = Date and Time Stamp of HotFix

For example:
HotFixV5xR017S002H008.cab.intel_a.01-18-2007.10.52

Remark :
Each Hot-Fix is delivered with an information file which lists the solved problems and
installed files :
HotFix<Prod><RxxxSyyyHzzz>APARlist.MM-DD-YYYY.hh.mm

For example :
HotFixV5xR017S002H008APARlist.01-18-2007.10.52
On Which Level Can a Hot-Fix Be Installed ?
A Hot-Fix is built on only one GA+SP level, and can only be installed on the same GA+SP
level.

The nomenclature for the Hot-Fix is as follows:

 the GA level : B11

 the build level : 0 if the Hot-Fix is built on the GA level, 1 if built on the service pack 1
level, etc.
 the Hot-Fix number.

Consequently, the first Hot-Fix on the V5R11 GA level would be:

B11.0.1

For a given GA+SP level, Hot-Fixes are cumulative, as illustrated below:

For example, Hot-Fix B11.0.2 contains both new fixes and the fixes delivered with Hot-Fix
B11.0.1.

Uninstalling Previous Hot-Fix

A Hot-Fix cannot be installed if a Hot-Fix is already installed. Consequently, you must
uninstall the previous Hot-Fix before installing a new Hot-Fix.

Similarly, a service pack cannot be installed if a Hot-Fix is already installed. Consequently,

you must uninstall the Hot-Fix before installing a new service pack.

If you are installing a Hot-Fix on a service pack level, the service pack has to be committed
beforehand.

Unlike a service pack, a Hot-Fix cannot be committed.

You uninstall a Hot-Fix using the Hot-Fix Uninstall tab which is added to the Software
Management tool when a Hot-Fix is installed.
Miscellaneous Constraints and Restrictions
Keep in mind the following constraints and restrictions when installing Hot-Fixes:

 The installation process does not analyze which products have already been installed
and does not filter the files for installation depending on which product lines have
already been installed: all files included in a Hot-Fix are installed automatically. This
means, for example, that files belonging to ENOVIA 3d com may be installed on a
CATIA installation.

 If there is a Hot-Fix already installed, you cannot install additional configurations or

products without first uninstalling the Hot-Fix.

 Once a Hot-Fix has been installed, integrity checking (performed using the
Software Management tool) at level 3 is no longer available since the appropriate
option is grayed out in the Check Integrity tab

 Once a Hot-Fix has been installed, the CATDeltaInstall command cannot be run.

For illustration purposes, this scenario is based on the V5R11 release. All paths
reference V5R11 installations, and the screen shots were also based on the V5R11
release. The basic operating principles and step-by-step instructions are of course
applicable to later releases.

Installing and Uninstalling a Hot-Fix on Windows

We assume that you have already downloaded the Hot-Fix to your computer before
continuing.

Using the Graphic User Interface

1. Log on as an administrator.

You must belong to the Administrators group, or have the privileges assigned to the
Administrators group. Otherwise, you will not be able to install the different levels on the
source computer.

2. Use a packing utility (for example, WinZip), to extract the contained files and
subdirectories (for example, INTEL) into an empty folder.

3. Select Start -> Programs -> Accessories -> Command Prompt to open a
Command Prompt window.

4. Go to the folder into which you extracted the files, then to the INTEL folder.

5. Enter the command:

StartHFX
The Welcome dialog box is then displayed:

If several GA levels are installed, the "Choose Destination" dialog box will prompt you to
choose the GA level on which you want to install the Hot-Fix.

6. Click the Next button to move to the next step.

If any Version 5 processes are still running, the following dialog box appears:

7. Click the Yes button to move to the next step.

The Dassault Systèmes Hot-Fix Setup dialog box appears:

8. Click the Next button to move to the next step.

The Recap dialog box appears:

9. Click the Install button to install the Hot-Fix.

The Setup Complete dialog box appears:

10. Click the Finish button to exit the installation.

11. You can now check the level of your installation. For example, if you installed CATIA,
select the Start->Programs->CATIA->Tools->Software Management command.
In the General tab, the number of the Hot-Fix you just installed is displayed beneath the
service pack level information like this:

Currently installed Hot-Fix : B11.0.1

You can also check the level by selecting the Help->About command in an interactive
Version 5 session.

12. We explained earlier that before installing another Hot-Fix or a service pack, you first
have to uninstall the current Hot-Fix. If you attempt to install another Hot-Fix, for example, an
error message like this will be displayed:

You need to remove Hot-Fix B11.0.1 before installing B11.0.2

To uninstall the current Hot-Fix, click the Hot-Fix Uninstall tab to the far right of the Dassault
Systèmes Software Management dialog box:

This tab is added to the Software Management tool only a Hot-Fix is installed.

13. Click the Uninstall button.

The Hot-Fix is uninstalled, and all trace of the Hot-Fix in the General tab will be removed. if
you exit then rerun the Software Management tool, the Hot-Fix Uninstall tab will have
disappeared.
Installing a Hot-Fix in Batch Mode
1. Log on as an administrator.

You must belong to the Administrators group, or have the privileges assigned to the
Administrators group. Otherwise, you will not be able to install the different levels on the
source computer.

2. Use a packing utility (for example, WinZip), to extract the contained files and
subdirectories (for example, INTEL) into an empty folder.

3. Select Start -> Programs -> Accessories -> Command Prompt to open a
Command Prompt window.

4. Go to the folder into which you extracted the Hot-Fix files, then to the Intel folder.

5. Enter the command:

StartHFXB

with the appropriate arguments.

StartHFXB Command Syntax

StartHFXB [-u unloaddir] [-killprocess] [-v] [-h]

-u "unload_dir": specifies the unload directory (not necessary if only one GA level is
installed, since the path is read from the registry); make sure the directory path is enclosed
like this: "unload dir" if the directory name contains spaces.
-killprocess: kills any running Version 5 processes before installing the Hot-Fix
-v: verbose mode
-h: displays help.

Uninstalling a Hot-Fix in Batch Mode

1. Log on as an administrator.

You must belong to the Administrators group, or have the privileges assigned to the
Administrators group. Otherwise, you will not be able to install the different levels on the
source computer.

2. Select Start->Programs->Command Prompt to open a Command Prompt window.

3. Go to the following installation folder, for example:

install_folder\code\bin

4. Enter the command:

CATSoftwareMgtB –hfxR
Installing and Uninstalling a Hot-Fix on UNIX
We assume that you have already downloaded the Hot-Fix to your workstation before
continuing.

Using the Graphic User Interface

1. Logon as root.

2. If the Hot-Fix file name contains ".Z", rename the Hot-Fix file to a name with extension ".Z"
(for example: mv <Hot-Fix file> <Hot-Fix file>.Z), and then decompress the file
(for example: uncompress <Hot-Fix file>).

3. Extract the contained files and subdirectories into an empty directory (for example: tar -
xvf <Hot-Fix file>).

4. Go to the directory into which you extracted the Hot-Fix files.

5. Enter the command:

./start

to start the installation procedure, or:

./start -s

if you want to start the installation procedure without the accompanying music.

The Version 5 setup program will be run. The setup program checks you have the correct
prerequisites. Then, the Welcome dialog box greets you. The setup program invokes a full
self-explanatory graphical interface which walks you through the installation.
6. Click the Next button to move to the next step.

The Choose Destination Location dialog box appears. A default destination folder is already
proposed:

/usr/Dassault Systemes/B11

7. If the default destination directory is suitable, click the Next button to move to the next step,
or click the Browse... button and navigate to select another folder and click OK.

The directory must exist, otherwise an error message will be displayed.

8. Click the Next button to move to the next step.

The Dassault Systèmes Hot-Fix Setup dialog box appears:

9. Click the Next button to move to the next step.

The Recap dialog box appears:

10. Click the Install button to install the Hot-Fix.

The Setup Complete dialog box appears.

11. Click the Finish button to exit the installation.

12. You can now check the level of your installation. To do so, enter the command:
/usr/DassaultSystemes/B11/OS/code/command/catstart -run CATSoftwareMgt

where "OS" is:

 aix_a
 hpux_b
 irix_a
 solaris_a
 aix_a64

In the General tab, the number of the Hot-Fix you just installed is displayed beneath the
service pack level information like this:

Currently installed HFX : B11.0.1

13. We explained earlier that before installing another Hot-Fix or a service pack, you first
have to uninstall the current Hot-Fix. If you attempt to install another Hot-Fix, for example, an
error message like this will be displayed:
You need to remove Hot-Fix B11.0.1 before installing B11.0.2

To uninstall the current Hot-Fix, click the Hot-Fix Uninstall tab to the far right of the Dassault
Systèmes Software Management dialog box:

This tab is added to the Software Management tool only when a Hot-Fix is installed.

14. Click the Uninstall button.

The Hot-Fix is uninstalled, and all trace of the Hot-Fix in the General tab will be removed. If
you exit then rerun the Software Management tool, the Hot-Fix Uninstall tab will have
disappeared.
Installing a Hot-Fix in Batch Mode

1. Log on as root.

2. If the Hot-Fix file name contains ".Z", rename the Hot-Fix file to a name with extension ".Z"
(for example: mv <Hot-Fix file> <Hot-Fix file>.Z), and then decompress the file
(for example: uncompress <Hot-Fix file>).

3. Extract the contained files and subdirectories into an empty directory (for example: tar -
xvf <Hot-Fix file>).

4. Go to the directory into which you extracted the Hot-Fix files.

5. Enter the command:

./start -b -s

Running the command with at least one argument other than "-s" starts the installation in
batch mode, without having to specify the "-b" argument.

start Command Syntax

start [-b] [-u unloaddir] [-killprocess] [-v] [-s] [-h]

-b: specifies that you want to install in batch mode

-u "unload_dir": specifies the unload directory; the default unload directory is:
/usr/Dassault Systemes/B11
-killprocess: kills any running Version 5 processes before installing the Hot-Fix
-v: verbose mode
-s: without music
-h: displays help.

Uninstalling a Hot-Fix in Batch Mode

1. Log on as root.

2. Enter the command:

/usr/Dassault Systemes/B11/OS/catstart -run "CATSoftwareMgtB -hfxR"

where "OS" is:

 aix_a
 hpux_b
 irix_a
 solaris_a
 aix_a64