Upgrade process overview


The upgrade process consists of the following stages:

  • Stage 1: Prepare for upgrade—During this stage, you identify the files that you must download from the BMC Electronic Product Distribution (EPD) site, where those files are located, and how to access the files and download them. In this stage, you perform various tasks to set up the installation environment, to ensure that required ports are available, and to determine the bundled components that you might also want to install.
  • Stage 2: Perform the upgrade—In this stage, you perform the actual upgrade of the product. BRPM enables you to upgrade to a new installation folder or to the same installation folder as your current version. You might also need to complete some preparatory tasks before you begin the upgrade, and perform additional tasks after the upgrade.

Supported upgrade paths

You can upgrade to:

Version

Upgrade path

BRPM 5.0.08

5.0.07.x, 5.0.06.x, 5.0.05.x, 5.0.04.x, 5.0.03.x, 5.0.02, 5.0.01.0x, and 5.0.00

BRPM 5.0.07

5.0.06.x, 5.0.05.x, 5.0.04.x, 5.0.03.x, 5.0.02, 5.0.01.0x, and 5.0.00

BRPM 5.0.06

5.0.05.x, 5.0.04.x, 5.0.03.x, 5.0.02, 5.0.01.0x, and 5.0.00

BRPM 5.0.05

5.0.04.x, 5.0.03.x, 5.0.02, 5.0.01.0x, and 5.0.00

BRPM 5.0.04

5.0.03.x, 5.0.02, 5.0.01.0x, and 5.0.00


Note

 Upgrade from BRPM 2.6.x, 4.3.x, 4.4.x, and 4.6.is not supported.

Changes due to support for WildFly Application Server

Support for WildFly Application Server was introduced in BRPM version 5.0.03.004 and continues in version 5.0.06. If you are upgrading from version 5.0.03.003 or earlier, note these changes.

Feature/ Change

Version 5.0.03.003 or earlier

Version 5.0.03.004 and later

For more information

Change in the BRPM Home Directory

<RLMInstallDir>\releases\<versionNo>\RPM

<RLMInstallDir>\releases\<versionNo>\RPM\portal.war\WEB-INF

-

Automation job concurrency and other product settings moved

Present in the torquebox.yml file

Present in the wildfly.xml file

Change in the standalone file names

standalone.xml

standalone-ha.xml (for clusters)

Configuration

Deployment

File

HTTP

Non-high-availability

standalone-full.xml

High-availability

standalone-full-ha.xml

HTTPS

Non-high-availability

standalone-full-https.xml

High-availability

standalone-full-ha-https.xml

-

Change in the location of deployment information

RLMInstallDir/server/jobss/standalone/deployments/RPM-knob.yml contains the deployment information.

This information is now contained in the CURRENT_RPM_PATH environment variable in the <RLMHome>/bin/start.sh file.

STOMP Host URL

Needed by Requester UI

Not needed any more

-

Running the rake tasks

Need to be run from the following directory: <RLMInstallDir>\releases\<versionNo>\RPM

Need to be run from the following directory: <RLMInstallationDirectory>\releases\<versionNo>\RPM\portal.war\WEB-INF

-

Configuration settings for JBoss and HornetQ

RLMInstallDir/server/jobss/standalone/configuration/standalone.xml RLMInstallDir/server/jobss/standalone/configuration/standalone-ha.xml (for clusters)

Not needed anymore. Settings added to the standalone-full.xml and standalone-full-ha.xml files.

Changes in <RLM_HOME>/bin/start.sh, <RLM_HOME>/bin/stop.sh

A standalone instance does not need binding to the node name and IP address.

  • Contains information about the binding of a standalone instance to the node name and IP address
  • Contains BRPM deployment information.

Caution: Do not copy these files from the existing installation. If you have customized these files in the existing installation, make those changes in the upgraded environment again.


Where to go next

Preparing-for-upgrade

Related topic

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*