If you configured your IBM® Business Automation
Workflow
environment for swinging profiles, you can apply an Business Automation Workflow interim fix or cumulative fix and swing the
profiles.
About this task
Only Business Automation Workflow interim fixes and cumulative
fixes are supported, not WebSphere® Application
Server or Java SDK
interim fixes.
Procedure
To apply the interim fix or cumulative fix, complete the following steps:
-
On the computer that holds the master product installation:
-
Use IBM Installation
Manager to apply the Business Automation Workflow interim fix or cumulative fix as usual.
-
Copy the contents of the master installation directory to another directory and compress to a
TAR file, for example:
mkdir CLONE_18002_iFixes
cp -R /opt/BPMInstall/MASTER/AppServer/* /opt/CLONE_18002_iFixes/
tar -cvf CLONE_18002_iFixes.tar CLONE_18002_iFixes/
-
On each computer where you created profiles:
-
Stop all the Java processes associated with the Business Automation Workflow products that are being upgraded.
Note: If you are applying a cumulative fix, this step is done as part of the normal upgrading
instructions.
- Stop the single cluster or the three clusters in the following order: Support, Application, and
then Messaging.
- Stop any other servers, the node agents, and then the deployment manager.
- Stop any other associated JVMs, such as the Profile Management Tool or the Quick Start
console.
- If you have a Microsoft Windows service or another function that automatically restarts the
servers when they are down, ensure that the service or function is disabled until the upgrade
process is complete.
Important: The product might not continue to run successfully if you
install the fix when a Java process related to WebSphere Application
Server is running.
-
Get the TAR file from the master computer and decompress the archive, for example:
tar -xvf CLONE_18002_iFixes.tar
-
Modify the following properties in the properties/wasprofile.properties
file to point to the common profile directories that you previously created on this computer in step
2c in Installing and configuring a swinging profiles environment.
For example, change the following
lines:
WS_CMT_LOG_HOME=${was_install_root}/logs/manageprofiles
WS_PROFILE_REGISTRY=${was_install_root}/properties/profileRegistry.xml
WS_WSPROFILE_DEFAULT_PROFILE_HOME=${was_install_root}/profiles
to:
WS_CMT_LOG_HOME=/opt/BPMUserData/logs/manageprofiles
WS_PROFILE_REGISTRY=/opt/BPMUserData/properties/profileRegistry.xml
WS_WSPROFILE_DEFAULT_PROFILE_HOME=/opt/BPMUserData/profiles
-
Change the symbolic link that you created in step 2d in Installing and configuring a swinging profiles environment to point
to the installation directory that you just decompressed on this computer, for example:
rm /opt/BPMCommonArea/BPMLink
ln -s /opt/CLONE_18002_iFixes /opt/BPMCommonArea/BPMLink
-
Use the BPMConfig -update command to change the network shared directory to
the folder you set. If you didn't set this directory in the previous version, set the
bpm.de.caseManager.networkSharedDirectory to an existing folder that is outside
the IBM Business Automation
Workflow installation folder.
-
Run the BPMEnablePostInstaller command to enable the necessary
post-installation scripts for the cumulative fix or interim fixes that were installed.
If you are installing a few interim fixes, you can specify the fix name as the input parameter
and separate the names with commas, for
example:
BPMEnablePostInstaller.sh -ifix 8.6.0.0-WS-BPM-IFJR00000,8.6.0.0-WS-BPM-IFJR11111
If
you are installing many interim fixes, you do not need to specify the file names, for
example:
BPMEnablePostInstaller.sh -ifix
If you are installing a cumulative
fix, you do not need to specify the file name, for
example:
BPMEnablePostInstaller.sh
Note: For case management:
- Every time you update IBM Business Automation
Workflow, run the
BPMEnablePostInstaller command to update the INI files.
- If you are using an external Content Platform Engine, every
time you replace the IBM Business Automation
Workflow installation files
to update IBM Business Automation
Workflow or update the version of the
external Content Platform Engine, you must run the
updateBPMExternalECM command to download those Content Platform Engine libraries again as mentioned in the upgrading
instructions.
-
Follow the upgrading steps to upgrade the database and profile. When you are finished
upgrading, start the environment and verify that the interim fix or cumulative fix installation was
successful.
Important: When you are applying a cumulative fix, make sure you wait to start the
environment only when directed to do so by the upgrading instructions.