IBM Tivoli Composite Application Manager for WebSphere V6.1
Readme for the update installer V6.1.0
January 11, 2007
Contents
3.2 Unpacking the Update Installer 3
3.4 Updating the Response File 4
3.6 Cleaning Prepared Installation 5
3.8 Rolling Back Failed Installation 6
4.1 Unpacking the Update Installer 7
4.3 Updating the Response File 8
4.4 Preparing Uninstallation 8
4.5 Cleaning Prepared Uninstallation 9
4.7 Rolling Back Failed Uninstallation 11
5 Displaying Installed Updates 11
5.1 Unpacking the Update Installer 11
The Update Installer for IBM Tivoli Composite Application Manager for WebSphere V6.1 provides the following functionality:
A silent command-line update installer.
Installation and removal of individual or multiple updates (Fix Packs and interim fixes).
Logging, tracking and prerequisites handling.
This readme describes how to use the update installer.
6.1.0 January 11, 2007
First release.
This section describes how to install Fix Packs and interim fixes.
The Fix Packs and interim fixes are distributed as tar files. Create a temporary directory, put the update package there and un-tar.
After un-taring the update package you should get the updates directory that contains the file with the *.update extension. For example:
>tar
xvf 6.1.0.1-TIV-ITCAMfWAS_MP-IF0002.tar
6.1.0.1-TIV-ITCAMfWAS_MP-IF0002.README
updates/
updates/6.1.0.1-TIV-ITCAMfWAS_MP-IF0002.update
Copy the update installer tar to the same directory were you un-tared the update package. This directory will typically contain the updates subdirectory. Un-tar the update installer package using the tar command, for example:
>tar xvf ITCAM_V61_UpdateInstaller.tar
silentUpdate.bat
silentUpdate.properties
silentUpdate.sh
update.jar
The resulting directory structure will contain both, the update installer and the update file. For example:
silentUpdate.bat
silentUpdate.properties
silentUpdate.sh
update.jar
6.1.0.1-TIV-ITCAMfWAS_MP-IF0002.README
updates/6.1.0.1-TIV-ITCAMfWAS_MP-IF0002.update
Before running the update installer you should login as root (Administrator) or owner of the product directory. Then update the environment as below.
The update installer requires the Java Runtime Environment version 1.3.1 or higher. Either include the java command into PATH or define the JAVA_HOME environment variable to point to the Java Runtime Environment home directory.
For example, on UNIX or Linux, run:
JAVA_HOME=/opt/WebSphere/AppServer/java
export JAVA_HOME
The update installer is a non-interactive silent installer that works based on the response file. The default name of the response file is silentUpdate.properties and it is supplied with the update installer. Update the response file as follows:
Set
the product.location property with the correct product
location directory
Optionally,
if the *.update files are not in default ./updates directory, then
set the updates.loction property with the directory that
contains the *.update files.
If the Visual Engine was not installed to the Managing Server runtime to be updated then set the updateVe property to false. Otherwise uncomment and set the updateVe.wasHome property with WAS_HOME of the Visual Engine application server.
Note: the response file is Java Properties file. Any backward-slashes should be doubled, for example:
product.location= C:\\Program Files\\IBM\\itcam\\WebSphere\\DC
To reduce the application server or Managing Server down-time the update installer allows to prepare installation while the product is running. This steps is optional but is recommended.
In order to prepare installation change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –prepareInstall
UNIX or Linux:
./silentUpdate.sh -prepareInstall
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -prepareInstall my.properties
UNIX or Linux:
./silentUpdate.sh -prepareInstall my.properties
A typical output of the -prepareInstall command is:
>./silentUpdate.sh -prepareInstall
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: prepare install
Finished successfully
If you decide to not install the update after you already run -prepareInstall then you can clean results of the ‘-prepareInstall’ command. In order to do that change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –cleanPrepared
UNIX or Linux:
./silentUpdate.sh –cleanPrepared
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -cleanPrepared my.properties
UNIX or Linux:
./silentUpdate.sh -cleanPrepared my.properties
A typical output of the -cleanPrepared command is:
>./silentUpdate.sh -cleanPrepared
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: clean prepared
Finished successfully
It is recommended that you run the -prepareInstall command before installing the update, see the previous section for details.
Before installing the update you should stop the product that you will update, i.e. the application server being monitored or the Managing Server components.
After you stopped the product change to the directory where the update installer scripts are stored and run the following command.
Windows:
silentUpdate.bat –install
UNIX or Linux:
./silentUpdate.sh -install
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -install my.properties
UNIX or Linux:
./silentUpdate.sh -install my.properties
A typical output of the -install command is:
>./silentUpdate.sh -install
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: install
Finished successfully
If the -install command fails and the automatic rollback fails also then the runtime will be locked for the updates until the rollback is completed successfully. In order to complete the rollback successfully do the following:
Review the update installer log and resolve the cause of the rollback failure.
Change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –rollback
UNIX or Linux:
./silentUpdate.sh –rollback
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -rollback my.properties
UNIX or Linux:
./silentUpdate.sh -rollback my.properties
A typical output of the -rollback command is:
>./silentUpdate.sh -rollback
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: rollback
Finished successfully
This section describes how to uninstall Fix Packs and interim fixes.
The all necessary uninstall information is stored to the product directory under the update sub-directory. You don’t need the original update package in order to uninstall it. So download the latest update installer and un-tar it:
>tar xvf ITCAM_V61_UpdateInstaller.tar
silentUpdate.bat
silentUpdate.properties
silentUpdate.sh
update.jar
Before running the update installer you should login as root (Administrator) or owner of the product directory. Then update the environment as below.
The update installer requires the Java Runtime Environment version 1.3.1 or higher. Either include the java command into PATH or define the JAVA_HOME environment variable to point to the Java Runtime Environment home directory.
For example, on UNIX or Linux, run:
JAVA_HOME=/opt/WebSphere/AppServer/java
export JAVA_HOME
The update installer is non-interactive silent installer that works based on the response file. The default name of the response file is silentUpdate.properties and it is supplied with the update installer. Update the response file as follows:
Set the product.location property with the correct product location directory.
Optionally,
if the *.update files are not in default ./updates directory, then
set the updates.loction property with the directory that
contains the *.update files.
If the Visual Engine was not installed to the Managing Server runtime to be updated then set the updateVe property to false. Otherwise uncomment and set the updateVe.wasHome property with WAS_HOME of the Visual Engine application server.
Set the uninstall.updates property with the one of possible values:
all – uninstall all updates
last – uninstall the updates installed by the last -install command
<comma separated list of updates> -- uninstall the specified updates. The updates are specified by their identifiers as displayed by the –listInstalledUpdates command. (f.e. 6.1.0.1, 6.1.0.1.1)
Note: the response file is Java Properties file. Any backward-slashes should be doubled, for example:
product.location=C:\\Program Files\\IBM\\itcam\\WebSphere\\DC
To reduce the application server or Managing Server down-time the update installer allows to prepare uninstallation while the product is running. This steps is optional but is recommended.
In order to prepare uninstallation change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –prepareUninstall
UNIX or Linux:
./silentUpdate.sh -prepareUninstall
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -prepareUninstall my.properties
UNIX or Linux:
./silentUpdate.sh -prepareUninstall my.properties
A typical output of the -prepareUninstall command is:
>./silentUpdate.sh -prepareUninstall
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: prepare uninstall
Finished successfully
If you decide to not uninstall after you already run -prepareUninstall then you can clean results of the ‘-prepareUninstall’ command. In order to do that change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –cleanPrepared
UNIX or Linux:
./silentUpdate.sh –cleanPrepared
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -cleanPrepared my.properties
UNIX or Linux:
./silentUpdate.sh -cleanPrepared my.properties
A typical output of the -cleanPrepared command is:
>./silentUpdate.sh -cleanPrepared
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: clean prepared
Finished successfully
It is recommended that you run the -prepareUninstall command before uninstalling the update, see the previous section for details.
Before uninstalling the update you should stop the product that you will update, i.e. the application server being monitored or the Managing Server components.
After you stopped the product change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –uninstall
UNIX or Linux:
./silentUpdate.sh -uninstall
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -uninstall my.properties
UNIX or Linux:
./silentUpdate.sh -uninstall my.properties
A typical output of the -uninstall command is:
>./silentUpdate.sh -uninstall
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: uninstall
Finished successfully
If the -uninstall command fails and the automatic rollback fails also then the runtime will be locked for the updates until the rollback is completed successfully. In order to complete the rollback successfully do the following:
Review the update installer log and resolve the cause of the rollback failure.
Change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –rollback
UNIX or Linux:
./silentUpdate.sh –rollback
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -rollback my.properties
UNIX or Linux:
./silentUpdate.sh -rollback my.properties
A typical output of the -rollback command is:
>./silentUpdate.sh -rollback
Update installer version 6.1.0
Logging details into C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20050916213723.log
Action: rollback
Finished successfully
This section describes how to display a list of the installed Fix Packs and interim fixes.
Download the latest update installer and un-tar it:
>tar xvf ITCAM_V61_UpdateInstaller.tar
silentUpdate.bat
silentUpdate.properties
silentUpdate.sh
update.jar
Before running the update installer you should login as root (Administrator) or owner of the product directory. Then update the environment as below.
The update installer requires the Java Runtime Environment version 1.3.1 or higher. Either include the java command into PATH or define the JAVA_HOME environment variable to point to the Java Runtime Environment home directory.
For example, on UNIX or Linux, run:
JAVA_HOME=/opt/WebSphere/AppServer/java
export JAVA_HOME
The update installer is non-interactive silent installer that works based on the response file. The default name of the response file is silentUpdate.properties and it is supplied with the update installer. Update the response file as follows:
Set
the product.location property with the correct product
location directory
Note: the response file is Java Properties file. Any backward-slashes should be doubled, for example:
product.location=C:\\Program Files\\IBM\\itcam\\WebSphere\\DC
To display a list of the installed Fix Packs and interim fixes change to the directory where the update installer scripts are stored and run the following command:
Windows:
silentUpdate.bat –displayInstalledUpdates
UNIX or Linux:
./silentUpdate.sh -displayInstalledUpdates
If your response file is named differently then the default silentUpdate.properties then specify it as a parameter:
Windows:
silentUpdate.bat -displayInstalledUpdates my.properties
UNIX or Linux:
./silentUpdate.sh -displayInstalledUpdates my.properties
A typical output of the - displayInstalledUpdates command is:
>./silentUpdate.sh - displayInstalledUpdates
Update installer version 6.1.0
Logging details into
C:\Program Files\IBM\itcam\WebSphere\DC\logs\update\update_20060121163339.log
Action: display installed updates
Updates installed 21.02.06 16:43
6.1.0
Finished successfully