IBM Support

Update instructions for the IBM Business Process Manager (BPM) V8.0.1 products

Product Readmes


Abstract

This document provides instructions for installing V8.0.1 for the IBM Business Process Manager products

Content



This refresh 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.

The Version 8.0.1 Refresh pack is available for the following products:

  • IBM Business Process Manager Express
  • IBM Business Process Manager Standard
  • IBM Business Process Manager Advanced
  • IBM Business Process Manager Advanced - Process Server installations.

By installing Version 8.0.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 Version 8.0.1.

Important Note: You must install mandatory interim fix JR44669 when installing IBM Business Process Manager Version 8.0 Refresh Pack 1. See Required interim fix for APAR JR44669 prior to Version 8.0.1 database upgrade or bootstrap for important information about this mandatory fix.




Table of Contents
Problems addressed in this refresh pack
Refresh pack prerequisites
Upgrade instructions for installations with existing profiles
Network Deployment environments
Installing V8.0.1
Refresh pack install verification
Rolling back V8.0.1
Additional information
Reference


© 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 the refresh pack and its prerequisites


Problems addressed in this refresh pack

The fixes that are addressed in Version 8.0.1 are explained in the Fix list for IBM Business Process Manager Version 8.0 products document.



Refresh pack prerequisites

To use this refresh pack, you must have one of the following products installed:

  • IBM Business Process Manager Express Version 8.0
  • IBM Business Process Manager Standard Version 8.0
  • IBM Business Process Manager Advanced Version 8.0
  • IBM Business Process Manager Advanced - Process Server Version 8.0


Also, you must either have the WebSphere Application Server Version 8.0.0. Fix Pack 5 installed or must install it during the upgrade.

These downloads are available through the Required interim fixes for IBM Business Process Manager and IBM Business Monitor document.

Use the following links to access the hardware and software prerequisites for the products:



Installing the refresh 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 V8.0.0.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 refresh 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 8.0.1 installation.

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.




Network Deployment environments


When you apply the refresh 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 IBM Business Process Manager 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.

Installing V8.0.1

If you have existing profiles under this installation, before you continue with the refresh pack installation, see the Profile upgrade instructions for V8.0.1 IBM Business Process Manager (BPM) product installations with existing profiles. This document lists the steps to follow for the various topologies. Return to this document, when instructed, to complete the Version 8.0.1 installation.

If you have installed IBM Process Designer 8.0, you need to update your IBM Process Designer environment separately to V8.0.1. For more information, see the Updating Instructions for IBM Process Designer V8.0.1 document.


Download repositories to local system

The IBM Installation Manager must be at a minimum level of Version 1.6.0 before starting IBM Business Process Manager 8.0.1 installation updates. The IBM Installation Manager detects an available update if you are connected to the Internet on the workstation that you are planning to complete the IBM Business Process Manager 8.0.1 update activities. WebSphere Application Server V8.0.0 Fix Pack 5 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 V8.0.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.

Important note: Even if you have Internet access, you might be unable to connect to the live repositories, which contain the required fixes. For more information on how to work around this issue, see the You cannot connect to the IBM Business Process Manager or IBM Business Monitor V8.0.1 service repository during a custom installation document. You can also use the following steps and download the repository locally.

  1. If the Installation Manager is lower than Version 1.6.0, download the latest copy of the Installation Manger 1.6.x from IBM Installation Manager download site.

  2. Download the appropriate V8.0.1 refresh pack from the IBM Business Process Manager product download site. Download the package to a temporary disk location.
    • bpmExp.8010.repository.zip for IBM Business Process Manager Express
    • bpmStd.8010.repository.zip for IBM Business Process Manager Standard
    • bpmAdv.8010.repository.zip for IBM Business Process Manager Advanced
    • bpmAdvPS.8010.repository.zip for IBM Business Process Manager Advanced - Process Server

  3. Download and install WebSphere Application Server Version 8.0.0 Fix Pack 5, if it is not yet installed. IBM Business Process Manager no longer bundles the WebSphere Application Server fix pack. This fix pack, which is required for IBM Business Process Manager, is available through Fix Central.

  4. Download the required interim fixes repositories from the Required interim fixes for IBM Business Process Managr and IBM Business Monitor download document.

  5. Unpack the repositories to any directories that you choose; unpack each repository to its own directory. Note where you have unpacked the repositories.


You can install 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 Microsoft 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 Microsoft Windows 7, Windows Vista, or Windows 2008 operating systems, right-click <install_root>\IBMIM.exe and select Run as administrator.

  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 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 interim fix repositories and the WebSphere Application Server repository.

      5. Click OK to save the new repository settings.

  3. Use the following steps to graphically install:
    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.

    3. 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 8.0.1 is shown (unless there is a later fix pack available from the live update repository). 

    4. Ensure that the refresh pack and the WebSphere Application Server fix pack are selected and then 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. 

    5. Ensure that the interim fixes are all selected and then click Next > to continue. The Licenses window opens. 

    6. 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. 

    7. 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. 

    8. 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: 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 latest versions are discovered. Follow the instructions to select the Show all versions check box, then proceed with the full installation as normal.


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 Version 8.0.1:

    <IM_INSTALL_LOCATION>/tools/imcl install <OFFERING_IDS> <FIX_IDS> -acceptLicense -installationDirectory <INSTALL_DIR> -repositories <REPOSITORIES> -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.
    • <OFFERING_IDS>
      This variable is the list of offerings to be updated. Offering 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.v80
      com.ibm.bpm.EXP.V80


      IBM Business Process Manager Standard
      com.ibm.websphere.ND.v80
      com.ibm.bpm.STD.V80


      IBM Business Process Manager Advanced
      com.ibm.websphere.ND.v80
      com.ibm.bpm.ADV.V80


      IBM Business Process Manager Advanced - Process Server
      com.ibm.websphere.ND.v80
      com.ibm.bpm.PS.V80
    • <FIX_IDS>
      This variable identifies the fixes to be installed.
      8.0.0.0-WS-WAS-IFPM75937
      8.0.0.3-WS-WAS-IFPM75338
      8.0.0.3-WS-WASND-IFPM75877
      8.0.1.0-WS-BPM-IFJR44669
      8.0.1.0-WS-BPM-IFJR44699
    • <INSTALL_DIR>
      This variable is the installation directory of the product.
    • <REPOSITOERIES>
      This variable is the location of the fix repositories. 
      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 you update 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.v80 com.ibm.bpm.ADV.V80 8.0.0.0-WS-WAS-IFPM75937 8.0.0.3-WS-WAS-IFPM75338 8.0.0.3-WS-WASND-IFPM75877 8.0.1.0-WS-BPM-IFJR44669 8.0.1.0-WS-BPM-IFJR44699 -acceptLicense -installationDirectory C:\IBM\BPM\v8.0 -repositories C:\BPM801_repository,C:\WAS8005_repository,C:\WAS8005_iFix_repository,C:\8.0.1.0-WS-BPM-IFJR44669,C:\8.0.1.0-WS-BPM-IFJR44699 -log silent_update.txt

  3. When the silent refresh 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.bpm.ADV.V80_8.0.1000.20121102_2136 in the C:\IBM\BPM\v8.0 directory.

    For additional information about silent installations, visit these Information Center links:
  4. ProductContent Links
    IBM Business Process Manager Express
    IBM Business Process Manager Standard
    IBM Business Process Manager Advanced
    IBM Business Process Manager Advanced - Process Server

Alternatively, you can use the Interactive Installation and Configuration Guide and follow the instructions.

Refresh 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 refresh 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".



Rolling back V8.0.1
You can 'roll back' the refresh 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 refresh pack

Note: The following procedure only rolls back the product binary. Any existing profiles that were upgraded during a refresh 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

Complete the following steps to roll back an installation using the Graphical User Interface (GUI) of IBM Installation Manager:
  1. Close all of the 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 that 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 confirmation message 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.


Command-line interface of IBM Installation Manager for a silent roll back of a refresh 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 refresh pack-specific data backup tasks, which are described in Profile Upgrade instructions, before you migrated to Version 8.0.1. This data is restored after you complete the roll back task.
  1. Use the following command to roll back your IBM Business Process Manager product to V8.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>
      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.
    • <OFFERING_ID>
      This variable is the offering ID of the product that is installed.
    • <VERSION>
      This variable is the original version of the product. Rolling back returns your installation to this version.
    • <INSTALL_DIR>
      This variable is the installation directory of the product.
    • <LOG_FILE>
      This variable is the location and name of the silent log to write.


      Details for rolling back to version 8.0
      • IBM Business Process Manager Express​
        Offering ID: com.ibm.bpm.EXP.V80​
        Version: 8.0.0.20120504_0134​​
      • IBM Business Process Manager Standard​
        Offering ID​: com.ibm.bpm.STD.V80
        Version: 8.0.0.20120504_0135
      • IBM Business Process Manager Advanced ​
        Offering ID​: com.ibm.bpm.ADV.V80
        Version​: 8.0.0.20120504_0137​​
      • IBM Business Process Manager Advanced - Process Server​
        Offering ID: com.ibm.bpm.PS.V80​
        Version: 8.0.0.20120504_0137​
      • IBM Business Monitor
        Offering ID: com.ibm.websphere.MON.V80
        Version: 8.0.0.20120504_0231

  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.bpm.ADV.V80_8.0.0.20120504_0137​​ -installationDirectory C:\IBM\BPM\v8.0 -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.V80_8.0.0.20120504_0137​​ in the C:\IBM\BPM\v8.0 directory.

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




Additional information


Reference
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.





Trademarks and service marks
For trademark attribution, visit the IBM Terms of Use Web site.

Original Publication Date

16 November 2012

[{"Product":{"code":"SSFTN5","label":"IBM Business Process Manager Advanced"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTDH","label":"IBM Business Process Manager Standard"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"","label":"Linux zSeries"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Product":{"code":"SSFTBX","label":"IBM Business Process Manager Express"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Installation \/ Configuration","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Product Synonym

BPM

Document Information

Modified date:
17 June 2018

UID

swg27036335