IBM BPM, V8.0.1, All platforms > Migrating and upgrading your IBM BPM environment > Upgrading from IBM BPM V8.0 to IBM BPM V8.0.1 > Upgrading an ND environment

Upgrading the dmgr

Complete these steps to upgrade the dmgr in an ND environment.


Procedure

To upgrade the dmgr:

  1. Back up existing profiles in IBM BPM. This refresh pack updates the core product files and all the existing profiles that require an update.

    Before upgrading an existing installation, run the backupConfig command to back up the configuration files of each profile that the refresh pack can update. See Backing up and restoring administrative configuration files in the WebSphere Application Server Information Center for more information about running this command.

  2. Create backup copies of your existing databases. Database schema and content are changed during the upgrade process. Create a backup copy of the Process Center databases and copies of the databases in each runtime environment. Most databases provide a backup wizard or other user assistance for creating database backups. Contact your database administrator for more information.
  3. Back up default XSL transformation files. If you have applied any changes to the following default XSL transformation files located in the INSTALL_ROOT/ProcessChoreographer/Staff directory, back them up before performing the upgrade:

    • EverybodyTransformation.xsl
    • LDAPTransformation.xsl
    • SystemTransformation.xsl

    • UserRegistryTransformation.xsl
    • VMMTransformation.xsl

    These files are overwritten during the upgrade and the changes applied to these files are lost.

    After you upgrade your installation and before you start the server or a cluster, replace the XSL transformation files with the backup version.

  4. Stop all the Java™ processes. Before performing the upgrade, stop all Java processes that are associated with the Java SDK that is shipped with the IBM BPM products, including the node agent process, the dmgr process, and all server processes that belong to serviceable products, such as the IBM HTTP Server.

    The product might not continue to run successfully if you perform the upgrade when a WebSphere Application Server-related Java process is running.

  5. Stop the WebSphere Windows services.

    WebSphere Application Server refresh pack installation might update the WASServiceMsg.dll file.

    If any of the WebSphere servers (including node agents and dmgr) are configured to start automatically using Windows services, the WASServiceMsg.dll file gets locked by the Microsoft Windows operating system.

    If you see a WASServiceMsg.dll file cannot be replaced error during the refresh pack installation of WebSphere Application Server, change the starting option for all the WebSphere services so that they start manually. Then restart the machine where the updates are being made before installing the WebSphere Application Server refresh pack.

    Refer to the Technote WASServiceMsg.dll is locked when installing fix packs for more information.

  6. Install the refresh pack on the dmgr installation by using either IBM Installation Manager or the silent installation method.

    Refer to the technote Update Instructions for V8.0.1 for the IBM BPM (BPM) products, which contains specific instructions for using both the IBM Installation Manager graphical user interface (GUI) and the silent installation methods to install Refresh Pack V8.0.1. The dmgr profile is automatically updated during refresh pack installation.

    Install the new version of IBM BPM as described in Obtaining and installing the product code.

  7. Manually update the profile as follows:

    1. Make sure the dmgr is stopped.

    2. From the INSTALL_ROOT directory, run the following command:

      bin/ws_ant.sh -f util/BPMProfileUpgrade.ant -profileName profile_name -Dupgrade=true

      where profile_name is the name of the dmgr profile (which on z/OS is default).

  8. Check for any errors as explained in the "Identifying profile update errors" section of Recovering from profile update errors before continuing.

    Attention: The Installation Manager on the Microsoft Windows XP operating system does not recognize profile update errors. When you upgrade an installation on the Windows XP operating system, you must look at the "Identifying Profile Update Errors" section of Recovering from profile update errors, even if Installation Manager ended with the following message: The packages are updated.

  9. Before you update the databases, ensure that you have applied Mandatory Interim Fix JR44669. See Required interim fix for APAR JR44669. To download the fix, see Required interim fixes for IBM BPM.

  10. Run the following command on the dmgr to generate the SQL scripts that are needed for updating the database schemas:

    • INSTALL_ROOT\bin\BPMGenerateUpgradeSchemaScripts.bat -upgrade source_version profile_name
    • INSTALL_ROOT/bin/BPMGenerateUpgradeSchemaScripts.sh -upgrade source_version profile_name

    where:

    • source_version is the version from which you are upgrading; for example, 8.0.0.0. This value must be specified as four digits separated by periods, with the third digit representing the fix pack level.
    • profile_name is the name of the dmgr profile.

    If you are prompted for information about your database setup, specify the relevant values for your environment. When prompted, enter Y to confirm that you want to generate the scripts.

    If you enter incorrect information, you can run the BPMGenerateUpgradeSchemaScripts command again before proceeding.

    When you run the BPMGenerateUpgradeSchemaScripts command from the dmgr profile, the command generates the SQL scripts that are needed to update all of the databases in the ND environment. You can use these scripts later when you upgrade your managed nodes or clusters. The SQL scripts are stored in a profile_root/dbscripts/ component_name subdirectory for each product component, and logs are written to profile_root/upgrade/logs.

Upgrading an ND environment


Related tasks:
Upgrading managed nodes
Upgrading clusters


Related reference:
Recovering from profile update errors
BPMGenerateUpgradeSchemaScripts command-line utility