Fix Pack installation instructions for the IBM Business Process Manager V8.5.0 Fix Pack 2 (V8.5.0.2) products

This fix pack is a cumulative maintenance package that bundles individual fixes for IBM Business Process Manager (BPM) V8.5.0 and V8.5.0.1 and applies to all distributed operating systems.


Table of Contents

• Problems addressed in this fix pack
• Installation instructions
• Installing V8.5.0 Fix Pack 2 (V8.5.0.2)
• Download repositories to the local system
• Upgrading an installation interactively by using IBM Installation Manager
• Upgrading an installation silently by using the IBM Installation Manager command line (imcl)
• Rolling back V8.5.0 Fix Pack 2 (V8.5.0.2)
• Rolling back an installation interactively by using IBM Installation Manager
• Rolling back an installation by using the IBM Installation Manager command line (imcl)
• Rolling back IBM Process Designer

© 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 fix pack

By installing V8.5.0.2, you raise the fix level of 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 V8.5.0.2.

The fixes addressed in V8.5.0.2 are explained in the Fix List for the IBM Business Process Manager Version 8.5 products document.

Installation instructions

Fix pack prerequisites
Before installing IBM BPM, ensure that you have the required hardware and software prerequisites:

• 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 their respective Hardware and Software Support web pages.
• IBM BPM V8.5.0.2 is installed onto IBM BPM V8.5.0 or V8.5.0.1.
• IBM BPM V8.5.0.2 requires WebSphere Application Server V8.5.5 Fix Pack 4 or a later version.
• If you have Installation Manager installed, ensure that it is at V1.6.0 or later. If you have Internet access, Installation manager checks for updates when it starts. If you do not have V1.6.0 or later, obtain links to the latest versions from Installation Manager and Packaging Utility download links.
• IBM BPM V8.5.0.2 Process Center environments require Process Designer clients at the V8.5.0.2 level and IBM Integration Designer clients at the V8.5.0 level.

Important:

• The following interim fixes update files in Portal.ear and ProcessPortalNotification.ear; they must be uninstalled before you install IBM BPM V8.5.0.2.

- Interim fix JR53081 (depends on interim fix JR50221)
- Interim fix JR51538 (depends on interim fix JR51706)

To uninstall the fixes:
1. Stop the entire environment, including cluster members, node agents, and the deployment manager for a network deployment environment.
2. Uninstall the fixes using IBM Installation Manager.
• If you receive a warning message that the ulimit setting is lower than recommended setting, change the ulimit value to 8192. For more information, see Warnings about GTK or ulimit on Linux or UNIX when installing or migrating.
  
  

Installing V8.5.0 Fix Pack 2 (V8.5.0.2)

To install IBM BPM V8.5.0.2, follow these instructions to download the fix pack repositories, choose your installation path, and review the post-installation tasks.

Procedure

1. Download the fix pack repositories to a local directory. For more information, see Download 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 BPM V8.5.0.x, complete the steps in Profile upgrade instructions for IBM Business Process Manager Version 8.5.0 Fix Pack 2 (V8.5.0.2).
• If you are migrating from a version earlier than IBM BPM V8.5.0, then you must install V8.5.0.1 first and migrate your deployment environments. Then, upgrade the migrated environment to V8.5.0.2.
  
  Note: To continually run production applications during the upgrade and regression test period, you can roll out maintenance incrementally in an IBM BPM installation that has IBM Process Center and multiple IBM Process Servers. For more information, see Performing a rolling upgrade.
  
  
2. If you install IBM BPM V8.5.0.2 in a new environment, include the V8.5.0.2 repository while installing the product. For more information, see the Interactive Installation and Configuration Guide.
   
   Note: When you have Internet access, follow the installation instructions. Go to Install Packages >  Check for Other Versions and Extensions. Follow the instructions to select Show all versions, and then proceed with the full installation.
   
   
3. If you installed V8.5.0 or V8.5.0.1, but you have not yet created a profile, choose one of the following options to update the product to V8.5.0.2. Complete the steps for each installation that needs to be upgraded.
• Upgrading an installation interactively by using IBM Installation Manager
• Upgrading an installation silently by using the IBM Installation Manager command line (imcl)
3. Review the optional post-installation task information for additional actions you might need to take.

Results

Your IBM BPM installations are now updated to V8.5.0.2.

If you need to create a new IBM BPM environment you might want to review Planning for IBM Business Process Manager and the "Configuring profiles and creating a network deployment environment" topic in the custom installation section for your environment. Using the BPMConfig command is the recommended method to create an environment. See the IBM Business Process Manager documentation for details.


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

• 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 or IBM BPM fix packs from the live repository.
• New installations require the IBM BPM V8.5.0 installation media, as noted in the IBM Knowledge Center for IBM BPM.

Procedure

1. Download the appropriate fix pack by following the Version 8.5.0 Fix Pack 2 for the IBM Business Process Manager products document. Download bpm.8502.delta.repository.zip to a temporary disk location.
   
   
2. You must have WebSphere Application Server V8.5.5 Fix Pack 4 or a later version 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 IBM BPM V8.5.0.2. For information about the fixes and download links, see Fix list for IBM WebSphere Application Server V8.5.
   
   When you decompress the following two files to the same location, it creates the full WebSphere Application Server V8.5.5 Fix Pack 4 repository that includes all WebSphere Application Server offerings for all supported operation systems and architectures:
   8.5.5-WS-WAS-FP0000004-part1.zip
   8.5.5-WS-WAS-FP0000004-part2.zip
   
   
3. Download any required interim fixes from IBM Fix Central that are specific to IBM BPM V8.5.0.2. Select your installation type and V8.5.0.2 to search for recommended fixes on this site.
   Note: Applying this fix pack will remove any previously installed interim fixes. If a fix is included in the fix pack, then you do not have to reinstall the interim fix.
   
   
4. Extract each fix's repository to its own local directory. If the fix pack repository consists of multiple zip files, ensure that they are all extracted to the same root directory, for example staging_directory\fixpack. Choose to overwrite duplicate directories so that the files from both the zip files are merged.
   
   
5. Return to the installation instructions and continue with the appropriate steps based on your existing setup.

Upgrading an installation interactively by using IBM Installation Manager
These steps upgrade one installation of IBM BPM. If you have existing profiles, ensure that these steps are followed only after being directed here by the profile upgrade steps.

Procedure

1. Start Installation Manager while logged in as the appropriate user based on the type of installation. For more information about where Installation Manager is installed and the type of installation, see Default installation directories for IBM Installation Manager.
• On Windows, right-click install_root\IBMIM.exe and select Run as administrator.
• On Linux or UNIX, start Installation Manager by using the install_location/IBMIM command.
2. Add repositories to the Installation Manager preferences. Click File > Preferences. Under Repositories, select one of the following options:
• If you have Internet access, ensure that Search service repositories during installation and updates is selected.
• If you do not have Internet access, add the location of all the local repositories that you downloaded from the Download repositories to 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 the interim fix repositories and the IBM WebSphere Application Server fix pack repository, if necessary.
4. Click OK to save the new repository settings.
3. Click Update.
   
   
4. Select the package group where you 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 Version 8.5.0 Fix Pack 2 is shown unless there is a later fix pack available from the live update repository.
   If you are also installing WebSphere Application Server V8.5.5 Fix Pack 4 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 the IBM Business Process Manager 8.5.0.2 fix pack. 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. Select all the recommended interim fixes for IBM Business Process Manager V8.5.0.2 and all the recommended interim fixes for WebSphere Application Server. For more information, see Recommended interim fixes for IBM Business Process Manager V8.5.0.2.
   
   
8. Ensure that the interim fixes are all selected and then click Next.
   Note: Applying this fix pack will remove any previously installed interim fixes. If a fix is included in the fix pack, then you do not have to reinstall the interim fix.
   
   
9. 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 are selected.
   
   
10. 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.
    
    
11. Click Update. The updates are downloaded either from the live update repository or from your local repository. After the installation of the updates is complete, you receive a confirmation message.
    Note
1. If you have a large number of IBM BPM interim fixes installed, you might encounter an OutOfMemory error. To solve this problem, follow these steps to increase the maximum Java heap size:
1. Edit the file Installation_Manager_installation_directory/eclipse/IBMIM.ini.
2. Increase the the maximum heap size and save the file. For example, setting it to Xmx1536M will reserve 1536MB for the heap. The default heap size might differ by operating systems.
3. Restart Installation Manager and reinstall the fix pack.
2. The Installation Manager log file might show some SDK-related errors. These are related to WebSphere Application Server (WAS) V8.x fix pack installation and can be safely ignored. For more information, see http://www-01.ibm.com/support/docview.wss?uid=swg21584322.
   
   
12. 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 this process.
    Upgrading network deployment profiles for IBM Business Process Manager Advanced or IBM Business Process Manager Standard
    Upgrading stand-alone profiles for IBM Business Process Manager Express or IBM Integration Designer's Unit Test Environment (UTE)
    
    
    

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

Procedure

1. Run the following command from the tools directory under the Installation Manager installation location:
   
   IM_INSTALL_LOCATION/tools/imcl install OFFERING_IDS FIX_IDS -acceptLicense -installationDirectory INSTALL_DIR -repositories REPOSITORIES -log LOG_FILE
   
   The following example command is used when only the IBM BPM fix pack must be applied:
   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:\BPM8502_repository -log silent_update.txt
   
   Update the variables in the command specifically for your installation by using the following information:
• IM_INSTALL_LOCATION
  Represents the location where Installation Manager is installed. For more information on Installation Manager default installation directories, see Default installation directories for IBM Installation Manager.
• OFFERING_IDS
  Represents the list of offerings to be updated. Offering IDs are separated by spaces. Use the following list to get the correct offering IDs for your product.
• IBM Business Process Manager Express
  com.ibm.bpm.EXP.v85
  com.ibm.websphere.ND.v85
• IBM Business Process Manager Standard
  com.ibm.bpm.STD.v85
  com.ibm.websphere.ND.v85
• IBM Business Process Manager Advanced
  com.ibm.bpm.ADV.v85
  com.ibm.websphere.ND.v85
• IBM Business Process Manager Advanced - Process Server
  com.ibm.bpm.PS.v85
  com.ibm.websphere.ND.v85
• FIX_IDS
  This variable represents the interim fix IDs for any interim fixes that you must install.
  
• INSTALL_DIR
  Represents the installation directory of the product.
  
• REPOSITORIES
  Represents the location of the fix pack and interim fix repositories.
  Note: Use commas to separate multiple locations.
  
• LOG_FILE
  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. When the silent fix pack installation completes, check the log files to ensure that the installation completed successfully. A success message that is similar to the following message displays on the command line:
   Updated to com.ibm.bpm.PS.v85_8.5.1001.20130910_0349 in the C:\IBM\BPM\v8.5 directory.
   
   If you receive an OutOfMemory error with the default settings, increase the maximum Java heap size as illustrated in the following example:
   C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl install com.ibm.bpm.ADV.v85 -acceptLicense -installationDirectory C:\IBM\BPM\v8.5 -repositories C:\BPM8502_repository -vmargs -Xmx1536m
   
   where -vmargs -Xmx1536m represent the VM arguments to reserve 1536MB for the heap.

For additional information about silent installations, see the applicable product documentation:

Product	Content Links
IBM Business Process Manager Express	Linux Windows
IBM Business Process Manager Standard	AIX Linux Solaris Windows
IBM Business Process Manager Advanced	AIX Linux Solaris Windows
IBM Business Process Manager Advanced - Process Server	AIX Linux Solaris Windows

Alternatively, see Interactive Installation and Configuration Guide for additional information.



Rolling back V8.5.0 Fix Pack 2 (V8.5.0.2)

You can roll back the fix pack to a previous version, by using one of the following methods:

• Rolling back an installation interactively by using IBM Installation Manager
• Rolling back an installation silently by using the IBM Installation Manager command line (imcl)

Note: The following procedure rolls back only the IBM BPM installation. If you have existing profiles, 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 an installation interactively by using IBM Installation Manager

1. Close all programs that were installed by using Installation Manager.
2. Start Installation Manager. For more information about where Installation Manager is installed, see Default installation directories for IBM Installation Manager.
3. From the Start page of Installation Manager, click Roll back.
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. Close Installation Manager.
10. If you have existing profiles, see Rolling back the IBM BPM environment to continue the profile rollback steps.
    

Warnings displayed during the rollback process

1. You might see warnings similar to the following warning in the Installation Manager rollback log file (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.sh -restore
  
2. When WebSphere Application Server 8.5.5.x is rolled back to 8.5.0.x, a warning related to the execution of the updateOdrServerXml.ant task might be displayed. This warning can be safely ignored. For more information, see http://www-01.ibm.com/support/docview.wss?uid=swg21669076.

Rolling back an installation silently by using the IBM Installation Manager command line (imcl)

Installation Manager offers a command-line interface to silently roll back your product installation to the previous version. Before you start the following rollback procedure, ensure that you backed up all the necessary profile, database, and fix pack-specific data by following the steps in Profile upgrade instructions before you upgraded to V8.5.0.2. This data is restored after you complete the rollback task.

Procedure

1. Run the following imcl command from the tools directory under the Installation Manager installation location.
   
   IM_INSTALL_LOCATION/tools/imcl rollback OFFERING_ID_VERSION -installationDirectory INSTALL_DIR -log LOG_FILE
   
   The following command is an example:
   C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl rollback com.ibm.bpm.EXP.v85_8.5.0.20130504_0134 -installationDirectory C:\IBM\BPM\v8.5 -log silent_rollback.txt
   
   Update the following variables for your installation:
• IM_INSTALL_LOCATION
  Represents the location where Installation Manager is installed. For more information about Installation Manager default installation directories, see Default installation directories for IBM Installation Manager.
  
• OFFERING_ID
  Represents the offering ID of the product installed.
  
• VERSION
  Represents the original version of the product. Rolling back returns your installation to this version.
  If you upgraded directly from V8.5.0 the version in the Details for rolling back to V8.5.0.0 information apply.
  
• Details for rolling back to V8.5.0.0
• IBM Business Process Manager Express
  Offering ID: com.ibm.bpm.EXP.v85
  Version: 8.5.0.20130525_1340
• IBM Business Process Manager Standard
  Offering ID: com.ibm.bpm.STD.v85
  Version: 8.5.0.20130525_1340
• IBM Business Process Manager Advanced
  Offering ID: com.ibm.bpm.ADV.v85
  Version: 8.5.0.20130525_1340
• IBM Business Process Manager Advanced - Process Server
  Offering ID: com.ibm.bpm.PS.v85
  Version: 8.5.0.20130525_1340
  
• If you have upgraded from Version 8.5.0.1, the version in the Details for rolling back to Version 8.5.0.1 information apply.
  
• Details for rolling back to V8.5.0.1
• IBM Business Process Manager Express
  Offering ID: com.ibm.bpm.EXP.v85
  Version: 8.5.1.20131107_1830
• IBM Business Process Manager Standard
  Offering ID: com.ibm.bpm.STD.v85
  Version: 8.5.1.20131107_1830
• IBM Business Process Manager Advanced
  Offering ID: com.ibm.bpm.ADV.v85
  Version: 8.5.1.20131107_1830
• IBM Business Process Manager Advanced - Process Server
  Offering ID: com.ibm.bpm.PS.v85
  Version: 8.5.1.20131107_1830
  
• INSTALL_DIR
  Represents the installation directory of the product.
  
• LOG_FILE
  Represents the location and name of the message log file.
  
  
2. 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.EXP.v85_8.5.0.20130504_0134 in the C:\IBM\BPM\v8.5 directory.
   
   
3. Restore the profile and the database backup you took before you installed V8.5.0.2.
   
   

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

Procedure

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. Then, 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 documentation.
• For a list of the most recent problems and solutions for this release, see the following documents:
• Release Notes for IBM Business Process Manager Standard Version 8.5 and its fix packs
• Release Notes for IBM Business Process Manager Express Version 8.5 and its fix packs
• Release Notes for IBM Business Process Manager Advanced Version 8.5 and its fix packs
• 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.