Installing IBM Business Process Manager Version 8.5.6.0 Cumulative Fix 2

This cumulative fix is a cumulative maintenance package that applies to all distributed operating systems. It is a single package that bundles a number of individual fixes.

The cumulative fix is to be used on IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, and IBM Business Process Manager Advanced - Process Server V8.5.6.x.

Table of Contents

• Problems addressed in this cumulative fix
• Installation instructions
• Cumulative fix prerequisites
• Installing the cumulative fix
• Downloading repositories to the local system
• Upgrading an installation interactively
• Upgrading an installation silently using the command line (imcl)
• Rolling back the cumulative fix
• Rolling back the cumulative fix installation interactively
• Rolling back the cumulative fix installation silently using the command line (imc)
• Rolling back IBM Process Designer
• Reference
• Trademarks and service marks

© Copyright International Business Machines Corporation 2015. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Problems addressed in this cumulative fix

By installing the cumulative fix, you will raise the fix level of your product, either IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server, to Version 8.5.6.0 CF02.

The fixes addressed in this cumulative fix are explained in the Fix list for IBM Business Process Manager Version 8.5.6.0 cumulative fix.

Installation instructions

Cumulative fix prerequisites

To use this cumulative fix, you must have Version 8.5.6.0 CF01, Version 8.5.6.0, Version 8.5.5, or Version 8.5.0.x of IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server product installed.

Important:

• Before you install, if you have any of these interim fixes installed:
• Interim fix JR52393 on IBM BPM V8.5.0.0, V8.5.0.1, V8.5.5.0, or V8.5.6.0
• Interim fix JR50538 on IBM BPM V8.5.5.0
• Interim fix JR49893 on IBM BPM V8.5.0.1
see WebSphere Application Server or IBM Business Process Manager upgrade might fail with 'The system cannot find the path specified' errors.
• if you are on a UNIX or Linux system, make sure that you check the ulimit setting. See Preparing Linux systems for installation or Preparing AIX systems for installation.
• If you want to create deployment environments using the Deployment Environment wizard, you must have installed WebSphere Application Server APAR PI40958, which is included in WebSphere Application Server V8.5.5.6 and later.
• If you have V8.5.5 or V8.5.0.x of IBM Business Process Manager, you can upgrade directly to the cumulative fix if you make both the V8.5.6.0 Refresh Pack 6 upgrade repository and the cumulative fix repository available to IBM Installation Manager during the upgrade.
• Installing the cumulative fix requires WebSphere Application Server V8.5.5, Fix Pack 5 or a later version.
• If you have Installation Manager installed, ensure that it is at V1.8.0 or later. If you have Internet access, Installation Manager checks for updates when it starts. If you do not have V1.8.0 or later, obtain links to the latest versions from Installation Manager and Packaging Utility download links.

Hardware and software prerequisites for IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, and IBM Business Process Manager Advanced - Process Server are available on the web on their respective Hardware and Software Support pages.


Installing the cumulative fix
To install the cumulative fix, follow these instructions to download the fix pack repositories, choose your installation path, and review the post-installation tasks.

1. Download the fix pack repositories to a local directory. For more information, see Downloading repositories to the local system. If you are installing the fix pack interactively by using IBM Installation Manager to connect to the live repository, this step is not required.
   
   
2. Choose one of the installation paths based on your environment.
1. If you have profiles, follow the instructions based on your current version:
• If you are upgrading from IBM Business Process Manager V8.5.6.0 CF01 or V8.5.6.0, complete the steps in Upgrading profiles from V8.5.6.x.
• If you are upgrading from IBM Business Process Manager V8.5.0.x or V8.5.5, complete the steps in Upgrading profiles from V8.5.0.x or V8.5.5.
• If you are migrating from a version earlier than IBM Business Process Manager V8.5.0.x, use Installation Manager to install the cumulative fix, but do not create profiles or a deployment environment. After installing the cumulative fix, follow the migration instructions to migrate your earlier version.
  
  
  Note: To continually run production applications during the upgrade and regression test period, you can roll out maintenance incrementally in an IBM Business Process Manager installation that consists of a Process Center and multiple Process Servers. See Performing a rolling upgrade in the product documentation.
  
  
2. If you install IBM BPM V8.5.6.0 CF02 in a new environment, include the cumulative fix with the V8.5.6.0 repository while installing the product. For more information, see the Interactive Installation and Configuration Guide.
   Note: If you are using the launchpad to install and you have Internet access, you can include CF02 from the live repository during installation. Otherwise, you must install the upgrades from a local directory. For example, if you are doing a typical installation on windows, you could add fixpack.BPM_CF=local_repository_path to bpm_updates.properties to include the cumulative fix, as described in step 1 of Installing and configuring Process Center in the product documentation.
   
   
3. If you installed V8.5.6.x, V8.5.5, or V8.5.0.x but you have not yet created a profile, choose one of the following options to update the product:
   Upgrading an installation interactively
   Upgrading an installation silently using the command line (imcl)
   
   
3. Review the optional post-installation task information for additional actions you might need to take.

If you selected to install with Java 6 only, you might see a warning "Returning with return code: INSTCONFPARTIALSUCCESS" and there might be an iscdeploy command error in the log.
You can fix the error by running the following command:
On Windows: install_root\bin\iscdeploy
On Linux or UNIX: install_root/bin/iscdeploy.sh

Your IBM Business Process Manager installations are now updated to V8.5.6.2.

You will still see "8.5.6.0" in the versionInfo command output, the SystemOut.log header, and the administrative console Welcome screen. For information about determining the installed version, see Product version and history information.



Downloading the repositories to the local system
Download the cumulative fix repositories to a local directory so that they can be used with Installation Manager during the upgrade process.
Notes:

• If you are installing interactively by using Installation Manager to make the updates and you have Internet access, these steps are not needed. You can download the required WebSphere Application Server fix pack and IBM BPM cumulative fix from the live repository.
• New installations require the IBM BPM V8.5.6 installation media, as noted in the IBM Knowledge Center for IBM BPM.
  
  

1. Download the appropriate fix repository by following the Downloading the cumulative fix 2 document. Download bpm.8560.cf2.delta.repository.1.zip and bpm.8560.cf2.delta.repository.2.zip to a temporary disk location.
   
   
2. If you are upgrading from a version earlier than V8.5.6, download the appropriate refresh pack using the Version 8.5 Refresh Pack 6 for the IBM Business Process Manager products document. Download bpm.8560.delta.repository.1.zip and bpm.8560.delta.repository.2.zip to a temporary disk location.
   
   
3. Unpack the repository files to any directory that you choose. The files must be unpacked to the same location. Note the location where you have unpacked the files.
   
   
4. You must have WebSphere Application Server V8.5.5, Fix Pack 5 or later installed or you must install it during the upgrade process. If you want to upgrade the WebSphere Application Server fix pack, download the applicable version for your environment.
   For example, download 8.5.5-WS-WAS-FP0000005-part1.zip and 8.5.5-WS-WAS-FP0000005-part2.zip for WebSphere Application Server V8.5.5.5.
   For information about the fixes and download links, see Fix list for IBM WebSphere Application Server V8.5.
   
   
5. Download any required interim fixes from IBM Fix Central that are specific to IBM BPM V8.5.6.2. Select your installation type and V8.5.6.2 to search for recommended fixes on this site.
   Note: Applying this cumulative fix will remove any previously installed interim fixes. If a fix is included in the cumulative fix, then you do not have to reinstall the interim fix.
   
   
6. Extract each set of fixpack or IFix repository zip files to its own local directory, although a common staging directory can be used. For example, staging_directory\BPMfixpack, staging_directory\refreshpack, or staging_directory\IFix1.
   Note: If a fix pack or refresh pack repository consists of multiple .zip files, ensure that they are all extracted to the same root directory. Choose to overwrite duplicate directories so that the files from both the .zip files are merged.
   For example, extract the two bpm.8560.cf2.delta.repository files to staging_directory\BPM856CF2, the two 8.5.5-WS-WAS-FP0000005 files to staging_directory\WAS8555, and each additional fix to its own directory in a similar fashion.
   
   
7. Return to the installation instructions and continue with the appropriate steps based on your existing setup.

Back to top

Upgrading an installation interactively
These steps upgrade one installation of IBM Business Process Manager. If you have existing profiles, follow the profile upgrade steps first. Ensure that these steps are followed only after you are directed here by the profile upgrade steps.

1. Start the Installation Manager. For more information about where Installation Manager is installed and the type of installation, see Installation directories for the product and profile.
   Note: The IBM Installation Manager must be at a minimum level of Version 1.8.0 before you start the IBM Business Process Manager cumulative fix installation updates. The Installation Manager detects an available update if you are connected to the Internet on the workstation where you plan to upgrade.
   
   
• On Windows, right-click IM_INSTALL_LOCATION\IBMIM.exe and select Run as administrator.
  
  
• On Linux or UNIX, start IBM Installation Manager using the IM_INSTALL_LOCATION/IBMIM command.
  
  
2. Add the repositories to the IBM Installation Manager preferences. Click File > Preferences. Under Repositories, select one of the following options:
• If you have Internet access, ensure that the Search service repositories during installation and updates option is selected.
  
  
• If you do not have Internet access, add the location of the local repositories that you downloaded in the Downloading the repositories to the local system section.
1. Click Add Repository.
   
   
2. Type or browse to the repository.config file for the IBM Business Process Manager repository that you extracted and click OK.
   
   
3. Repeat this process for all new repositories.
   
   
4. Click OK to save the new repository settings.
   
   
3. Click Update.
   
   
4. Select the package group where you have installed IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server and click Next.
   
   
5. After Installation Manager checks the service repositories, the Update Packages window opens and the IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server 8.5.6.0 cumulative fix is shown, unless there is a later fix available from the live update repository. If you are also installing WebSphere Application Server V8.5.5 Fix Pack 5 or later, it is also shown.
   
   
6. Ensure that these fix packs are all selected. Clear the Show recommended only check box to make sure that you can see all the added fixes. Click Next. If you have Internet connectivity or have added local interim fix repositories, another Update Packages window opens. A list of interim fixes is displayed.
   
   
7. Ensure that the interim fixes are all selected and then click Next.
   Note: Applying this cumulative fix will remove any previously installed interim fixes. If a fix is included in the cumulative fix, then you do not have to reinstall the interim fix.
   
   
8. Read and accept the terms of the license agreements by selecting the appropriate button and click Next. The Features window opens. All the installed features will be selected.
   
   
9. Click Next. All the features that need to be updated are shown in the Summary window. The disk space that is required to perform the update is shown at the bottom.
   
   
10. Click Update to start the update. The updates are downloaded either from the live update repository or from your local repository. The updates are installed. After the installation of the updates is complete, you receive a confirmation.
    
    
11. If you have existing profiles, follow the links below to return to the profile upgrade instructions to continue upgrading your profiles. If you want to upgrade additional installations, repeat the steps, or return to step 4 for installations using the same Installation Manager.
• If you are upgrading from V8.5.6, continue following the profile upgrade instructions from step 6 under Upgrading IBM Business Process Manager Advanced or IBM Business Process Manager Standard V8.5.6.x or Upgrading IBM Business Process Manager Express V8.5.6.x.
• If you are upgrading from V8.5.0.x or V8.5.5, continue following the procedure from step 9 under Upgrading IBM Business Process Manager Advanced or IBM Business Process Manager Standard V8.5.0.x or V8.5.5 or step 8 under Upgrading IBM Business Process Manager Express V8.5.0.x or V8.5.5.

Upgrading an installation silently using the command line (imcl)
Installation Manager offers a command-line interface to update your product installation silently. These steps upgrade one installation of IBM Business Process Manager. If you have existing profiles, ensure that these steps are followed only after you are directed here by the profile upgrade steps.

1. Run the following command from the tools directory under the Installation Manager installation location:
   
   
   IM_INSTALL_LOCATION/tools/imcl install PACKAGE_IDS -acceptLicense -installationDirectory INSTALL_DIR -repositories REPOSITORY -log LOG_FILE
   
   
   Update the variables in the previous command specifically for your installation using the following information:
   
   
• IM_INSTALL_LOCATION
  This variable represents the location where Installation Manager is installed. See Installation directories for the product and profile for more information about Installation Manager default installation directories.
  
  
• PACKAGE_IDS
  This variable represents the list of packages to be updated. Package IDs are separated by spaces. Use the following list to get the correct package ID for your product.
  
  
• IBM Business Process Manager Express
  com.ibm.bpm.EXP.v85
• IBM Business Process Manager Standard
  com.ibm.bpm.STD.v85
• IBM Business Process Manager Advanced
  com.ibm.bpm.ADV.v85
• IBM Business Process Manager Advanced - Process Server
  com.ibm.bpm.PS.v85
  
  
• INSTALL_DIR
  This variable represents the installation directory of the product.
  
  
• REPOSITORIES
  This variable represents the location of the cumulative fix repository
  
  
  Note: Use commas to separate multiple locations.
  
  
• LOG_FILE
  This variable represents the location and name of the silent log file to write.
  
  
  By including the -acceptLicense parameter, you agree to the terms and licenses of this product.
  
  
2. After updating the command for your environment, run the command from the tools directory under the Installation Manager installation location.
   
   The following command is an example:
   C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl install com.ibm.bpm.PS.v85 -acceptLicense -installationDirectory C:\IBM\BPM\v8.5 -repositories C:\BPM856_repository -log silent_update.txt
3. When the silent cumulative fix installation completes, check the log files to ensure that the installation completed successfully. A success message that is similar to the following text displays on the command line:
   
   Updated to com.ibm.bpm.ADV.v85_8.5.6000.20150304_1832 in the C:\IBM\BPM\v8.5 directory
   

If you are upgrading from V8.5.6, continue following the profile upgrade instructions from step 6 under Upgrading IBM Business Process Manager Advanced or IBM Business Process Manager Standard V8.5.6.x or Upgrading IBM Business Process Manager Express V8.5.6.x.
If you are upgrading from V8.5.0.x or V8.5.5, continue following the procedure from step 9 under Upgrading IBM Business Process Manager Advanced or IBM Business Process Manager Standard V8.5.0.x or V8.5.5 or step 8 under Upgrading IBM Business Process Manager Express V8.5.0.x or V8.5.5.

Back to top

Rolling back the cumulative fix

Rolling back the cumulative fix

You can roll back the cumulative fix to V8.5.6.x by using one of the following options:
Rolling back the cumulative fix installation interactively
Rolling back the cumulative fix installation silently using the command line (imcl)

Note: The following procedure rolls back only the IBM BPM installation. If you have existing profiles and were upgrading from V8.5.6.x, see Rolling back the IBM BPM environment for instructions. If you have existing profiles and were upgrading from V8.5.5 or V8.5.0.x, see Rolling back the IBM BPM environment for instructions. New profiles created after the upgrade cannot be reused; you must delete and recreate the profiles after you complete the rollback process. See Removing profiles using the manageprofiles command-line utility for more information.


Rolling back the cumulative fix installation interactively

1. Close all programs that were installed by using Installation Manager.
   
   
2. Start Installation Manager. For information about where Installation Manager is installed, see Installation directories for the product and profile,
   
   
3. From the Start page of the Installation Manager, click Roll back to start the Roll back packages wizard.
   
   
4. On the Roll Back Packages page, from the Package Group Name list, select the package group that contains the packages that you want to roll back and click Next.
   
   
5. Select the version of the package that you want to roll back to and click Next.
   
   
6. Read the summary information and click Roll Back to roll back the package.
   
   
   When the rollback process completes, a message that confirms the success of the process is displayed near the top of the page.
   
   
7. Optional: Click View log file to open the log file for the current session in a new window.
   
   
8. Click Finish to close the wizard.
   
   
9. If you are rolling back the IBM BPM environment (profiles and database), reinstall all the previous interim fixes for IBM Business Process Manager and IBM WebSphere Application Server. You must reinstall all the interim fixes that you previously had installed before you upgraded and then rolled back.
   
   
10. Close Installation Manager.
    
    
11. If you have existing profiles, continue with the profile rollback steps for existing environments. For upgrading from V8.5.6.x, continue from step 4 in Rolling back the IBM BPM environment. For upgrading from V8.5.5 or V8.5.0.x, continue from step 4 in Rolling back the IBM BPM environment.

Warnings displayed during the rollback process
You might see warnings similar to the following warning in the Installation Manager rollback log (install_root/logs/wbi/uninstall/uninstallconfig_server.log):
<message>/opt/IBM/WebSphere/AppServer/properties/version/nif/config.wbi/uninstall.ngi/99SRunISCDeploy.ant:33: exec returned: 127
    at org.apache.tools.ant.taskdefs.ExecTask.runExecute(ExecTask.java:591)
    at org.apache.tools.ant.taskdefs.ExecTask.runExec(ExecTask.java:617)
    at org.apache.tools.ant.taskdefs.ExecTask.execute(ExecTask.java:452)

You can fix them by running the following command:

• On Windows: install_root\bin\iscdeploy -restore
• On Linux or UNIX: install_root/bin/iscdeploy -restore
  

  Back to top

Rolling back the cumulative fix installation silently using the command line (imcl)
Installation Manager offers a command-line interface to silently roll back your product installation to the previous version. In the instructions, it is assumed that you completed all the necessary backup tasks, which are described in Upgrading profiles from V8.5.6.x and Upgrading profiles from V8.5.0.x or V8.5.5, before you upgraded to the cumulative fix. The previous profile is restored after you complete the rollback task.

1. Use the following command to roll back your IBM Business Process Manager product to V8.5.6.x
   
   
   IM_INSTALL_LOCATION/tools/imcl rollback PACKAGE_ID_VERSION -installationDirectory INSTALL_DIR -log LOG_FILE
   
   
   Update the following variables for your installation:
• IM_INSTALL_LOCATION
  This variable represents the location where Installation Manager is installed. See Installation directories for the product and profile for more information about Installation Manager default installation directories.
  
  
• PACKAGE_ID_VERSION
  This variable represents the original version of the product. Rolling back returns your installation to this version.
  
  
  Details for rolling back to Version 8.5.6.0 or Version 8.5.6.0 CF01
  
  
  IBM Business Process Manager Express
  Package ID: com.ibm.bpm.EXP.v85
  Version for rolling back to 8.5.6.0: 8.5.6000.20150304_1832
  Version for rolling back to 8.5.6.0 CF01: 8.5.6001.20150918_1719.
  
  
  IBM Business Process Manager Standard
  Package ID: com.ibm.bpm.STD.v85
  Version for rolling back to 8.5.6.0: 8.5.6000.20150304_1832
  Version for rolling back to 8.5.6.0 CF01: 8.5.6001.20150918_1719.
  
  
  IBM Business Process Manager Advanced
  Package ID: com.ibm.bpm.ADV.v85
  Version for rolling back to 8.5.6.0: 8.5.6000.20150304_1832
  Version for rolling back to 8.5.6.0 CF01: 8.5.6001.20150918_1719.
  
  
  IBM Business Process Manager Advanced - Process Server
  Package ID: com.ibm.bpm.PS.v85
  Version for rolling back to 8.5.6.0: 8.5.6000.20150304_1832
  Version for rolling back to 8.5.6.0 CF01: 8.5.6001.20150918_1719.
  
  
• INSTALL_DIR
  This variable represents the installation directory of the product.
• LOG_FILE
  Ths variable represents the location and name of the silent log to write.
  
  
  
2. After updating the command for your environment, run the command from the tools directory under the Installation Manager installation location.
   
   The following command is an example:
   
   C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl rollback com.ibm.bpm.ADV.v85_8.5.6000.20150304_1832 -installationDirectory C:\IBM\BPM\v8.5 -log silent_rollback.txt
   
   
3. When the rollback completes, check the log files to ensure that the rollback completed successfully. A success message displays on the command line:
   
   Rolled back to com.ibm.bpm.ADV.v85_8.5.6000.20150304_1832 in the C:\IBM\BPM\v8.5 directory.
   
   
4. If you are rolling back the IBM BPM environment (profiles and database), reinstall all the previous interim fixes for IBM Business Process Manager and IBM WebSphere Application Server. You must reinstall all the interim fixes that you previously had installed before you upgraded and then rolled back.
   
   
5. If you have existing profiles, continue with the profile rollback steps for existing environments. For upgrading from V8.5.6.x, continue from step 4 in Rolling back the IBM BPM environment. For upgrading from V8.5.5 or V8.5.0.x, continue from step 4 in Rolling back the IBM BPM environment.
   

Rolling back IBM Process Designer

IBM BPM does not support rolling back IBM Process Designer using Installation Manager. Instead, complete the following steps to roll back Process Designer.

1. After rolling back your Process Center to a previous version, use Installation Manager to uninstall Process Designer.
   
   
2. Delete the directory in which Process Designer was installed.
   
   
3. Reinstall Process Designer with a new zip file that is downloaded from Process Center. For instructions, see Installing IBM Process Designer.

Reference

You can find additional information about any of these topics in the IBM Business Process Manager product documentation.

For further information about the update strategy or obtaining updates, see the support page for your product.

IBM Business Process Manager Express Support page
IBM Business Process Manager Standard Support page
IBM Business Process Manager Advanced Support page
IBM Business Process Manager Advanced Process Server Support page
Trademarks and service marks:
For trademark attribution, visit the IBM Terms of Use Web site.