Installation Instructions of V7.5.1 Fix Pack 1 (V7.5.1.1) for the IBM Business Process Manager products

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

V7.5.1 Fix Pack 1 is intended 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 installations.

By installing V7.5.1 Fix Pack 1, 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 V7.5.1 Fix Pack 1.

Table of Contents

• About fix pack and prerequisites
• Problems addressed in this fix pack
• Fix pack prerequisites

• Installing the fix pack
• Upgrade instructions for installations with existing profiles
• Network deployment environments
• Installing V7.5.1 Fix Pack 1 (7.5.1.1)
• Fix pack install verification
• Rolling back V7.5.1 Fix Pack 1 (7.5.1.1)

• Additional information
• Reference
• Trademarks and service marks

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

About fix pack and prerequisites

Problems addressed in this fix pack

The fixes addressed in V7.5.1 Fix Pack 1 are explained in the Fix List for Business Process Manager products and WebSphere Enterprise Service Bus document.

Back to top

Fix pack prerequisites

To use this fix pack, you must have the following version of IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server installed:

• 7.5.0.0
• 7.5.0.1
• 7.5.1.0

You must also either have the following levels for WebSphere Application Server and its feature packs installed or must install the following levels of WebSphere Application Server and its feature packs during the upgrade:

• WebSphere Application Server V7.0.0 Fix Pack 25
• WebSphere Application Server V7 Feature Pack for XML V1.0.0 Fix Pack 13
• WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) V1.0.1 Fix Pack 15

These downloads are available through the Required interim fixes for IBM Business Process Management products document.

If you already have the WebSphere Application Server Version 7.0 Feature Packs installed, you still must have the repositories available and open when you are installing 7.5.1 Fix Pack 1. If you do not have them available, you will receive errors about not being about to synchronize the product installs.

Note: The feature pack repository that is available must be at the same fix level as you have already installed.

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.

Back to top

Installing the fix pack

Upgrade instructions for installations with existing profiles

If you have been using IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server V7.5.0.0, V7.5.0 Fix Pack 1 or V7.5.1.0 and you have created profiles, additional steps are required. Also, if you installed the product using the Typical installation, a profile was created and you need to follow these steps. These steps include backing up the profile, stopping all Java™ processes, and sequencing the upgrade. Before you continue with the fix pack installation, see the Upgrade Instructions for installations with existing profiles document for details on these steps. Return to this document, when instructed, to complete the Version 7.5.1 Fix Pack 1 installation.

Important: The database upgrade steps are different when you are upgrading from IBM Business Process Manager Version 7.5.0.x to 7.5.1 Fix Pack 1 compared to IBM Business Process Manager Version 7.5.1.0 to 7.5.1 Fix Pack 1 . If you are migrating from Business Process Manager V7.5.0.x follow the instructions in the information center on Upgrading from IBM Business Process Manager V7.5 to IBM Business Process Manager V7.5.1

Important: Depending on the topology, the instructions for updating the profile vary. The product might not continue to run successfully if you do not follow the instructions that are provided in the Upgrade Instructions for installations with existing profiles document.

Back to top

Network deployment environments


When you apply the fix pack in a network deployment environment, the connection to the deployment manager requires a user ID and password. Depending on your configuration, you might have to enter the credentials in a separate prompt near the end of the upgrade process.

Note: The credential panel displays twice during the upgrade process and has a default time out period of one minute. If you miss this prompt, your security configuration is set up such that a prompt is not displayed, or if you are running the silent installation script, follow the instructions in the Identifying profile update errors section.

If you do not want to monitor the upgrade progress, you can avoid this error by adding the WebSphere Application Server administrator user ID and password to the soap.client.props file.

For more information on how to configure security for WebSphere administration scripts, for which the WebSphere Process Server scripts depend, see configuring security with scripting in the WebSphere Application Server Information Center.

If the profile upgrade fails, follow the instructions in the Identifying profile update errors section on how to recover.

Back to top

Installing V7.5.1 Fix Pack 1 (7.5.1.1)

If you have existing profiles under this installation, before you continue with the fix pack installation, see the Profile upgrade instructions for V7.5.1 Fix Pack 1 (V7.5.1.1) IBM Business Process Manager (BPM) product installations with existing profiles for details on the steps to follow for the various topologies. Return to this document, when instructed, to complete the Version 7.5.1 Fix Pack 1 installation.

If you have installed IBM Process Designer 7.5.0.0, 7.5.0 Fix Pack 1 or 7.5.1.0, you need to update your IBM Process Designer environment separately to V7.5.1 Fix Pack 1. For more information, see the Updating Instructions for IBM Process Designer V7.5.1 Fix Pack 1 (V7.5.1.1) document.

Download repositories to local system

The IBM Installation Manager must be at a minimum level of Version 1.5.2 before starting IBM Business Process Manager 7.5.1 Fix Pack 1 installation updates. The IBM Installation Manager will detect an available update if you are connected to the Internet on the workstation that you are planning to complete the IBM Business Process Manager 7.5.1 Fix Pack 1 update activities. WebSphere Application Server V7.0.0 Fix Packs 11 and later are available in an Installation Manager format. The WebSphere Application Server V7.0.0 Fix Pack 25 is a prerequisite to the IBM Business Process Manager Express, IBM Business Process Manager Standard, IBM Business Process Manager Advanced, or IBM Business Process Manager Advanced - Process Server V7.5.1 Fix Pack 1.

If the machine on which 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 has Internet access, skip the following steps.

1. If the Installation Manager is lower than Version 1.5.2, download the latest copy of the Installation Manger 1.5.x from IBM Installation Manager download site
   
   
2. Download the appropriate V7.5.1 Fix Pack 1 from the IBM Business Process Manager products download site. Download the package to a temporary disk location.
• bpmExp.7511.repository.zip (for IBM Business Process Manager Express)
• bpmStd.7511.repository.zip (for IBM Business Process Manager Standard)
• bpmPC.7511.repository.zip (for IBM Business Process Manager Advanced)
• bpmPS.7511.repository.zip (for IBM Business Process Manager Advanced - Process Server)
  
  
3. If not already installed, download the following WebSphere Application Server V7 Fix Pack, Feature Pack repositories, and local copies of the WebSphere Application Server import repositories from the following locations:
• WebSphere Application Server V7 Feature Pack for XML V1.0.0 Fix Pack 13
• WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) V1.0.1 Fix Pack 15
• WebSphere Application Server V7 Feature Pack for XML V1.0.0 import repositories
• WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) V1.0.1 import repositories
• WebSphere Application Server V7.0.0 Fix Pack 25
  
  WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) V1.0.1 Fix Pack 15 or WebSphere Application Server V7 Feature Pack for Service Component Architecture (SCA) V1.0.1 import repositories are only required for IBM Business Process Manager Advanced and IBM Business Process Manager Advanced - Process Server. If you have other editions of IBM Business Process Server and have installed this feature pack separately, you may optionally install these as well.
  
  WebSphere Application Server Fix Pack image for all operating systems and platforms:
  The following two files when unzipped to the same location comprise the full 7.0.0 Fix Pack 25 repository that includes all WebSphere Application Server offerings for all supported operation systems and architectures:
  was.7.0.0.25.fp.all_Part1of2.zip
  was.7.0.0.25.fp.all_Part2of2.zip
  
  
  WebSphere Application Server Fix Pack images for specific operating systems and platforms:
  The following files contain repository slices that can be used to install WebSphere Application Server Network Deployment Version 7.0.0 Fix Pack 25 for a specified operating systems and architectures:
  
  
  Note: You do not need to download the previously listed full repository to upgrade your WebSphere Application Server Network Deployment installation on a specific operation system and architecture. You only need to download the single file from the following list that matches your operating system.
  was.nd.7.0.0.25.fp.aix.zip
  was.nd.7.0.0.25.fp.win.zip
  was.nd.7.0.0.25.fp.linux.x86.zip
  was.nd.7.0.0.25.fp.linux.s390.zip
  was.nd.7.0.0.25.fp.linux.ppc.zip
  was.nd.7.0.0.25.fp.solaris.sparc.zip
  was.nd.7.0.0.25.fp.solaris.x86.zip
  was.nd.7.0.0.25.fp.hpux.PARISC.zip
  was.nd.7.0.0.25.fp.hpux.ia64.zip
  
  
  All these WebSphere Application Server Fix Pack and Feature Pack Fix Pack files are available for download through the Required interim fixes for IBM Business Process Management products document.
  
  
4. Unpack the repositories to any directories that you choose. Note where you have unpacked the repositories. You should unpack each repository to its own directory.
   
   
   You can install the fix packs by using one of the following options:
   Graphical user interface (GUI) of IBM Installation Manager to update an installation
   Command line interface of IBM Installation Manager for a silent installation

Graphical user interface (GUI) of IBM Installation Manager to update an installation

1. Start the Installation Manager.
   
   On Windows operating systems with Internet access, you can click Start > Programs > IBM > IBM_BUSINESS_MANAGER_PRODUCT > Update. Then, skip to step 3b.
   
   If you do not have Internet access or are on a Linux or UNIX-based system, you can start IBM Installation Manager using the <install_location>/IBMIM command and the <install_root>\IBMIM.exe command on Windows operating systems. See Installation directories for the product and profile for more information on where Installation Manager is installed.
   
   Note: On the Windows 7, Windows Vista, or Windows 2008 operating systems, right click <install_root>\IBMIM.exe and select Run as administrator.
   
2. Add repositories to the IBM Installation Manager preferences.
   
   Click File > Preferences. Under Repositories select one of the following:
   
   - If you have Internet access, ensure that the Search service repositories during installation and updates option is selected.
   
   - If you do not have an Internet connection, add the location of all the local repositories 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 have unpacked.
   
   
3. Click OK.
   
   
4. Repeat this process for the WebSphere Application Server fix pack and feature pack repositories.
   
   
5. Click OK to save the new repository settings.
3. To graphically install the fix packs:
   
   
1. Click Update.
   
   
2. 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 > to continue.
   
   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 7.5.1 Fix Pack 1 is shown (unless there is a later fix pack available from the live update repository).
   
   
3. Ensure that the fix pack and the WebSphere Application Server fix pack and feature pack are selected and then click Next >. The Licenses window opens.
   
   
4. Read and accept the terms of the license agreements by selecting the appropriate button and click Next > to continue. The Features window opens. All of the installed features will be selected.
   
   
5. Click Next > to continue. The Summary window opens. All of the features that need to be updated are shown. The disk space required to perform the update is shown at the bottom.
   
   
6. 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.
   
   


Note: To graphically install the fix packs during a full installation when you have Internet access, follow the normal install instructions for a full installation. Go to Install Packages > Check for Other Versions and Extensions. All of the fix packs are discovered. Follow the instructions to select the Show all versions check box, then proceed with the full installation as normal.


Back to top

Command line interface of IBM Installation Manager for a silent installation


Installation Manager offers a command-line interface to silently update your product installation.

1. Use the following command to update your IBM Business Process Manager product to V7.5.1 Fix Pack 1:
   
   <IM_INSTALL_LOCATION>/tools/imcl install <FIX_IDS> -acceptLicense -installationDirectory <INSTALL_DIR> -repositories <FIXPACK_REPOSITORY> -log <LOG_FILE>
   
   Update the following variables above for your installation:
• <IM_INSTALL_LOCATION>
  This variable is the location where Installation Manager is installed. See Installation directories for the product and profile for more information on Installation Manager default install directories.
  
  
• <FIX_IDS>
  This variable lists the fixes to install. Fix IDs are separated by spaces. Use the following information to get the correct fix ids for your product
  
  
  IBM Business Process Manager Express
  com.ibm.websphere.ND.v70_7.0.25.20120831_0427
  com.ibm.websphere.XML.v10_1.0.13.20120814_1806
  com.ibm.ws.WBPMEXP_7.5.1001.20120915_1224
  
  
  IBM Business Process Manager Standard
  com.ibm.websphere.ND.v70_7.0.25.20120831_0427
  com.ibm.websphere.XML.v10_1.0.13.20120814_1806
  com.ibm.ws.WBPMSTD_7.5.1001.20120915_1227
  
  
  IBM Business Process Manager Advanced
  com.ibm.websphere.ND.v70_7.0.25.20120831_0427
  com.ibm.websphere.XML.v10_1.0.13.20120814_1806
  com.ibm.websphere.SCA.v10_1.0.1015.20120815_0003
  com.ibm.ws.WPS75_7.5.1001.20120915_1234
  
  
  IBM Business Process Manager Advanced - Process Server
  com.ibm.websphere.ND.v70_7.0.25.20120831_0427
  com.ibm.websphere.XML.v10_1.0.13.20120814_1806
  com.ibm.websphere.SCA.v10_1.0.1015.20120815_0003
  com.ibm.ws.WBPMPS_7.5.1001.20120915_1230
  
  
  IBM Business Monitor
  com.ibm.websphere.ND.v70_7.0.25.20120831_0427
  com.ibm.websphere.XML.v10_1.0.13.20120814_1806
  com.ibm.ws.WBM75_7.5.1001.20120915_1258
  
  
• <INSTALL_DIR>
  This variable is the installation directory of the product.
  
  
• <FIXPACK_REPOSITORY>
  This variable is the location of the fix pack repository.
  Note: Use commas to separate multiple locations.
  
  
• <LOG_FILE>
  This variable is 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 install location. The following command is an example:
   
   
   C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl install com.ibm.websphere.ND.v70_7.0.25.20120831_0427 com.ibm.websphere.XML.v10_1.0.13.20120814_1806 com.ibm.websphere.SCA.v10_1.0.1015.20120815_0003 com.ibm.ws.WPS75_7.5.1001.20120915_1234 -acceptLicense -installationDirectory C:\IBM\BPM\v7.5 -repositories C:\BPM7511_repository,C:\WAS70025_repository,C:\SCA10115_repository,C:\XML10013_repository -log silent_update.txt
   
   
3. When the silent fix pack installation completes, check the log files to ensure that the installation completes successfully. A success message that is similar to the following text displays on the command line:
   
   
   Updated to com.ibm.ws.WPS75_7.5.1001.20120915_1234 in the C:\IBM\BPM\v7.5 directory.

For additional information about silent installations, visit the Information Center.

Installing IBM Business Process Manager Express silently using a response file
Installing IBM Business Process Manager Standard silently using a response file
Installing IBM Business Process Manager Advanced silently using a response file
Installing IBM Business Process Manager Advanced: Process Server silently using a response file

Installing IBM Business Process Manager Express silently using the command line
Installing IBM Business Process Manager Standard silently using the command line
Installing IBM Business Process Manager Advanced silently using the command line
Installing IBM Business Process Manager Advanced: Process Server silently using the command line

Fix pack install verification


For upgrades of installations with existing profiles, refer to the Identifying profile update errors section under the Profile upgrade tab for details on verifying the fix pack installation.

Note: Installation Manager on the Microsoft Windows operating system does not recognize profile update errors. When you upgrade an installation on a Windows operating system, you must look at the Identifying profile update errors section, even if Installation Manager ends with the following message: "The packages are updated".

Back to top

Rolling back the V7.5.1 Fix Pack 1 (V7.5.1.1)

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

Graphical user interface (GUI) of IBM Installation Manager to roll back an installation
Command line interface of IBM Installation Manager for a silent roll back of a fix pack

Note: The following procedure only rolls back the product binary. Any existing profiles that were upgraded during a fix pack installation are not rolled back; you must restore the profiles from the backup you took before you upgraded the product. Any new profiles created after the upgrade cannot be reused; you must delete and recreate the profiles after you have completed the rollback.

Graphical user interface (GUI) of IBM Installation Manager to rollback an installation

1. Close all programs that were installed using Installation Manager before rolling back.
   
   
2. Start Installation Manager. See Installation directories for the product and profile for more information on where Installation Manager is installed.
   
   
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 to which you want to roll back and click Next.
   
   
6. Read the summary information and click Roll Back to roll back the package.
   When the rollback process completes, a message confirmation displays 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. Restore the backed up data from the original version.

Back to top

Command line interface of IBM Installation Manager for a silent roll back of a fix pack

Installation Manager offers a command-line interface to silently rollback your product installation to the previous version. In the instructions, it is assumes that you completed all of the necessary profile, database, and fix pack-specific data backup tasks, which are described in Profile Upgrade instructions, before you migrated to Version 7.5.1 Fix Pack 1. This data is restored after you complete the roll back task.

1. The following command rolls back your IBM Business Process Manager product to V7.5.0.0, V7.5.0.1 or V7.5.1.0.

<IM_INSTALL_LOCATION>/tools/imcl rollback <OFFERING_ID>_<VERSION> -installationDirectory <INSTALL_DIR> -log <LOG_FILE>

Update the following variables for your installation:

<IM_INSTALL_LOCATION>
The location where Installation Manager is installed. See Installation directories for the product and profile for more information on Installation Manager default install directories.

<OFFERING_ID>
The offering ID of the product installed.

<VERSION>
The original version of the product. Rolling back returns your installation to this version.

<INSTALL_DIR>
The installation directory of the product.

<LOG_FILE>
The location and name of the silent log to write.



Details for rolling back to version 7.5.0.0

Product Name	Offering ID	Version
IBM Business Process Manager Express	com.ibm.ws.WBPMEXP	7.5.0.20110518_2017​
IBM Business Process Manager Standard	com.ibm.ws.WBPMSTD	7.5.0.20110518_2021​
IBM Business Process Manager Advanced	com.ibm.ws.WPS75	7.5.0.20110518_2042​
IBM Business Process Manager Advanced - Process Server	com.ibm.ws.WBPMPS	7.5.0.20110518_2037

Details for rolling back to version 7.5.0.1

Product Name	Offering ID	Version
IBM Business Process Manager Express	com.ibm.ws.WBPMEXP	7.5.1.20110729_1911​
IBM Business Process Manager Standard	com.ibm.ws.WBPMSTD	7.5.1.20110729_1913​
IBM Business Process Manager Advanced	com.ibm.ws.WPS75	7.5.1.20110729_1917
IBM Business Process Manager Advanced - Process Server	com.ibm.ws.WBPMPS	7.5.1.20110729_1915​

Details for rolling back to version 7.5.1.0

Product Name	Offering ID	Version
IBM Business Process Manager Express	com.ibm.ws.WBPMEXP	7.5.1000.20111111_2238
IBM Business Process Manager Standard	com.ibm.ws.WBPMSTD	7.5.1000.20111111_2241
IBM Business Process Manager Advanced	com.ibm.ws.WPS75	7.5.1000.20111111_2248
IBM Business Process Manager Advanced - Process Server	com.ibm.ws.WBPMPS	7.5.1000.20111111_2245

2. After updating the command for your environment, run the command from the tools directory under the Installation Manager install location.

The following command is an example:

C:\Program Files (x86)\IBM\Installation Manager\eclipse\tools\imcl rollback com.ibm.ws.WPS75_7.5.1000.20111111_2248 -installationDirectory C:\IBM\BPM\v7.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.ws.WPS75_7.5.1000.20111111_2248 in the C:\IBM\BPM\v7.5 directory.

4. Restore the backed up data from the original version.

Back to top

Additional information

Reference

Update Installer (UPDI) is no longer necessary for installing WebSphere Application Server interim fixes. Refer to the following document for more information.

You can find additional information on any of these topics in the IBM Business Process Manager Information Center.

For further information on 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

Back to top

Trademarks and service marks

For trademark attribution, visit the IBM Terms of Use Web site.

Back to top