Sample platform upgrade options file templates for upgrades from 7.7.x and 7.8.x to 7.9.00 with ASSO

This section contains sample options files that you can use as templates to create options file to upgrade the repository, Configuration Distribution Peer (CDP), Activity Peer (AP), Lightweight Activity Peer (LAP) BMC Atrium Orchestrator Operator Control Panel (OCP), and BMC Atrium Orchestrator Development Studio.

If you are doing a fresh installation instead of an upgrade, use the options file templates in Options file templates for silent installations.

Note

To replace the variables or sample values (such as port numbers) in these examples, use the values that you provided in your upgrade worksheets (see Preparing for upgrades from 7.7.x and 7.8.x to 7.9.00 with ASSO for the worksheets).

For more information on the properties in these files, see Installation properties for platform options files.

This topic includes the following sections:

Sample platform options file to upgrade the repository

The following options file contains variable names for the properties required to upgrade the repository.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=REPO
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_SECURITY_COMM_HOST=<fullyQualifiedSSOhostName>
-J AO_SECURITY_WEB_PORT=8443
-J AO_SECURITY_WEB_PROTOCOL=https
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
-J AO_AMADMIN_PASSWORD=<password>
-J AO_WEBSERVER_PROTOCOL=https

The value for the -J AO_SECURITY_COMM_HOST variable is the host name where BMC Atrium Single Sign-On is installed. The value for -J AO_SECURITY_WEB_PORT is the port number specified for BMC Atrium Single Sign-On.

Sample platform options file to upgrade the CDP only

The following options file contains variable names for the properties required to upgrade the CDP.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=CDP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_AMADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the CDP and the OCP

The following options file contains variable names for the properties required to upgrade the CDP and the OCP in the same panel.

Note

If you are installing a non-English version of the Operator Control Panel, you must install it separately from the CDP. You must install the non-English OCP and CDP on separate Tomcat servers.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=CDP,OCP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_AMADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the activity peer

The following options file contains variable names for the properties required to upgrade the AP.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=AP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the lightweight activity peer

The following options file contains variable names for the properties required to upgrade the LAP.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=LAP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the HA-CDP

The following options file contains variable names for the properties required to upgrade the HA-CDP.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=CDP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_REPOSITORY_PORT=<port number>
-J AO_AMADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the OCP

The following options file contains variable names for the properties required to upgrade the OCP.

Note

If you are installing a non-English version of the Operator Control Panel, you must install it separately from the CDP. You must install the non-English OCP and CDP on separate Tomcat servers.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=OCP
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_AMADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baoocp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_WEBSERVER_PROTOCOL=https

Sample platform options file to upgrade the Dashboards

You can use the following sample options file to upgrade the BMC Atrium Orchestrator Dashboard component.

Note

There are prerequisite steps required for Dashboard upgrades, such as backing up property files for later use. Ensure that you perform the steps described in Upgrading the Dashboards from 7.7.x and 7.8.x to 7.9.00 with ASSO.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J AO_INSTALL_TYPE=upgrade_new
-J AO_INSTALLING_FEATURES=DB
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_WEBSERVER_PORT=18080
-J AO_WEBSERVER_SHUTDOWN_PORT=18050
-J AO_WEBSERVER_PROTOCOL=https
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>

Sample platform options file to upgrade Development Studio

You can use the following sample options file to upgrade the BMC Atrium Orchestrator Development Studio.

#Replace the variables and sample values in this example.
-P installLocation=<fullPathToTheInstallationDirectory>
-J DEVSTUDIO_INSTALL_TYPE=upgrade_new
-J DEVSTUDIO_WORKSPACE_DIR=<fullPathToWorkspaceDirectory>