Upgrading the ActiveMatrix Administrator Server and ActiveMatrix BPM Application

Prerequisites

If you are running ActiveMatrix BPM on a Windows platform, make sure that the TIBCO Host configuration folder, or any sub-folder or file in this folder’s hierarchy, is not currently locked by Windows. This folder is:

CONFIG_HOME\tibcohost\Admin-ActiveMatrixEnterpriseName-ActiveMatrixServerName

For example, a folder is locked if it is displayed in Windows Explorer or if a command shell is open with the folder as the current directory.

Note: If a folder or file in this hierarchy is locked, the upgrade will fail.

Procedure

  1. On the primary machine, run TIBCO Configuration Tool (if you did not run it automatically when you finished installing ActiveMatrix BPM software).
  2. In the TIBCO Configuration Folder dialog, select the existing CONFIG_HOME folder of the ActiveMatrix BPM system that you want to upgrade, then click OK.
  3. Run the Edit ActiveMatrix BPM > Upgrade or Downgrade TIBCO ActiveMatrix wizard. Make sure that you complete the following screens/fields as shown.
    Screen Requirement
    ActiveMatrix Upgrade Manager: Upgrade or Downgrade Select Upgrade.
    ActiveMatrix Upgrade Manager: Upgrade Options Select Upgrade All TIBCO Hosts.
    ActiveMatrix Upgrade Manager: Validate Make sure that the specified CONFIG_HOME is shown as ELIGIBLE, then click Next.
    ActiveMatrix Upgrade Manager: Upgrade Summary
    1. Select all four options:
      • Stop ALL TIBCO Hosts
      • Upgrade ALL TIBCO Hosts
      • Perform post-upgrade tasks
      • Start ALL TIBCO Hosts
    2. Click Upgrade.
    3. Click Finish.
  4. Run the Edit ActiveMatrix BPM > Upgrade TIBCO ActiveMatrix BPM Instance wizard. Make sure that you complete the following screens/fields as shown.
    Screen Requirement
    ActiveMatrix BPM Upgrade: Administrator Server Configuration Enter the details of the ActiveMatrix Administrator server that manages the BPM system that you want to upgrade.
    ActiveMatrix BPM Upgrade: Upgrade Configuration
    1. In the ActiveMatrix BPM Upgrade Details section, enter the Application Name and Environment Name of the BPM system that you want to upgrade.
    2. In the ActiveMatrix BPM Shaed Configuration Folder section, select the existing CONFIG_HOME folder of the ActiveMatrix BPM system that you want to upgrade as the Configuration Folder.
    ActiveMatrix BPM Upgrade: Summary Select the Upgrade ActiveMatrix BPM Instance Application option. Then:
    • If the string [Upgrading Database] is appended to the Upgrade ActiveMatrix BPM Instance Application action (indicating that you chose to automatically upgrade the ActiveMatrix BPM database), click Configure.
    • If the string [Not Upgrading Database Instance] is appended to the Upgrade ActiveMatrix BPM Instance Application action (indicating that you chose to manually upgrade the ActiveMatrix BPM database), see Manually Upgrading the BPM Database for information about how to complete the configuration process.