Preparing for upgrade

This section describes how to prepare for an upgrade of the BMC Atrium Orchestrator Platform product:

Supported upgrade paths

The following table describes the supported upgrade paths from your current version to BMC Atrium Orchestrator Platform 7.8. 

Your current versionSupported upgrade pathsNotes

7.7.02, 7.8.00, 7.8.01, or 7.8.02

If your current environment is earlier than BMC Atrium Orchestrator Platform version 7.6.03, you must upgrade your platform server components to BMC Atrium Orchestrator Platform version 7.7 Service Pack 2 and then upgrade to 7.8., 7.7.02, 7.8.00, 7.8.01, or 7.8.02, 7.8.00, 7.8.01, or 7.8.02, 7.8.01, or 7.8.02 or 7.8.02 requires a hotfix that you can get from BMC Customer Support.

Before upgrading

Before upgrading, review the following information.

  • Before upgrading to 7.6.03 to 7.8.x, ensure that you install BMC Atrium Single Sign-On first. For information about installing BMC Atrium Single Sign-On, see Installing.
  • When you upgrade from 7.6.03 to 7.8.x, the Access Manager component is replaced by BMC Atrium Single Sign-On. A migration utility/tool is provided, which exports all authentication data from Access Manager and then allows you to import the data in Grid Manager. 
    You must run the migration tool before you start with the upgrade. For more information, see Migrating authentication and authorization data from Access Manager 
  • Make copies of server.xml and broker-config.xml files before upgrading. For more information, see Backing up server.xml and broker-config.xml files.
  • Before upgrading to BMC Atrium Orchestrator Platform version 7.8.02 or later, if your BMC Atrium Orchestrator environment will use HTTPS, ensure that your environment supports TLS secure transport protocol.


In platform versions earlier than 7.7, BMC Atrium Orchestrator supported the installation or combination of certain edge components, such as BMC Atrium Orchestrator Operator Control Panel with a graphing server. However, this combination cannot be upgraded in 7.7 or later.

During an upgrade, when you point to the home directory of such an installation, the following message is displayed, indicating that a component or combination is no longer supported:

Cannot upgrade the installed feature/combination of features. Please refer to the user documentation section Preparing for upgrade for supported features.

BMC recommends that you review the following list of available components and combinations, and within your existing license counts, decide whether the current server should be retired or be replaced by an alternate component or combination.

  • Repository
  • Configuration distribution peer
    • BMC Atrium Orchestrator Operator Control Panel
  • Activity peer
  • Lightweight activity peer
  • BMC Atrium Orchestrator Operator Control Panel

When upgrading components, you must upgrade them in the following order:

  1. Repository
  2. CDP
  3. Additional peers
  4. BMC Atrium Orchestrator Development Studio

You can upgrade BMC Atrium Orchestrator content anytime after you upgrade the repository. When you finish upgrading the platform components, you use Grid Manager to update the content on the grid. For more information about updating content on the grid, see Upgrading adapters.


Before upgrading on Linux and Solaris environments, stop the BMC Atrium Orchestrator platform component services. For example, if you are upgrading CDP, stop the CDP service and then continue with the upgrade.

The following BMC Communities video (8:34) is part one of a series on upgrading a basic setup of BMC Atrium Orchestrator Platform 7.6.03 to 7.8.01 and upgrading Content on Windows. This video provides an overview of the new features in 7.8.01, highlights some important differences between 7.6.03 and 7.8.01, provides an overview of the upgrade steps and prerequisites, and demonstrates how to install Atrium Single Sign-On.

Upgrade worksheets

During an upgrade, the installation program displays settings from the previous installation that you can modify during the upgrade.

The following worksheets provide space for you to list the property settings that correspond to the text boxes and options that are displayed during the upgrade process:

Where applicable, properties affected by upgrade scenarios are noted. If you choose to change these settings, use the worksheets in this section to record the new settings before you start the upgrade.
You can also use the completed worksheets to edit the values in the options file templates used for silent upgrades.

Where to go from here

Performing the upgrade
Upgrading silently

Was this page helpful? Yes No Submitting... Thank you