Skip to Content

Sample platform upgrade options file templates for upgrades from 7.9.x and 8.0.x with RSSO to 20.02 with RSSO

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), 

WarningSome content is unavailable due to permissions.

Operator Control Panel (OCP), and

WarningSome content is unavailable due to permissions.

Development Studio.

Warning

Notes

  • 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-9-x-8-0-x-with-RSSO-to-20-02-with-RSSO for the worksheets).
  • If you are using an external BMC Remedy Single Sign-On (RSSO) authentication service (instead of the embedded RSSO that is installed with

    WarningSome content is unavailable due to permissions.

    Platform components), it should already be installed before installing

    WarningSome content is unavailable due to permissions.

    Platform components.

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. 

Warning

The properties that you include in the options file depend on which version of the BMC Remedy Single Sign-On (RSSO) authentication service you want to use: an existing external instance or an embedded version installed with

WarningSome content is unavailable due to permissions.

Platform components. Use the appropriate option file for your authentication setup.

Sample options file for repository upgrade using external RSSO version 18.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=18.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration REPO

Sample options file for repository upgrade using external RSSO version 9.1.03.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration REPO

Sample options file for repository upgrade using external RSSO version 9.1.02


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.02
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration REPO

Sample options file for repository upgrade using embedded RSSO


#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_USE_EMBEDDED_RSSO=true
-J AO_USE_EXTERNAL_RSSO=false
-J AO_RSSO_COOKIE_DOMAIN=<domain>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
-J AO_WEBSERVER_PROTOCOL=https
-J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
-J AO_REPOSITORY_HA_PORT=28090
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration REPO

Sample platform options file to upgrade the CDP only

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

Warning

The properties that you include in the options file depend on which version of the BMC Remedy Single Sign-On (RSSO) authentication service you want to use: an existing external instance or an embedded version installed with

WarningSome content is unavailable due to permissions.

Platform components. Use the appropriate option file for your authentication setup.

Sample options file for CDP upgrade using external RSSO 18.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=18.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP upgrade using external RSSO 9.1.03.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP upgrade using external RSSO 9.1.02


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP upgrade using embedded RSSO


#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_USE_EMBEDDED_RSSO=true
-J AO_USE_EXTERNAL_RSSO=false
-J AO_RSSO_COOKIE_DOMAIN=<domain>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
-J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
-J AO_REPOSITORY_HA_PORT=28090
-J AO_CDP_HA_IPADDRESS=<ipAddress>
-J AO_CDP_HA_PORT=38090
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

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.

Warning

Notes

Review these notes before using the sample files for an upgrade: 

  • 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.
  • The properties that you include in the options file depend on which version of the BMC Remedy Single Sign-On (RSSO) authentication service you want to use: an existing external instance or an embedded version installed with

    WarningSome content is unavailable due to permissions.

    Platform components. Use the appropriate option file for your authentication setup.

Sample options file for CDP and OCP upgrade using external RSSO 18.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=18.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP and OCP upgrade using external RSSO 9.1.03.x

#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP and OCP upgrade using external RSSO 9.1.02

#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_VERSION=9.1.02
-J AO_RSSO_REALM=<realm>
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample options file for CDP and OCP upgrade using embedded RSSO

#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_USE_EMBEDDED_RSSO=true
-J AO_USE_EXTERNAL_RSSO=false
-J AO_RSSO_COOKIE_DOMAIN=<domain>
-J AO_START_SERVER_ON_SUCCESS=true
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_WEBSERVER_PROTOCOL=https
-J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
-J AO_REPOSITORY_HA_PORT=28090
-J AO_CDP_HA_IPADDRESS=<ipAddress>
-J AO_CDP_HA_PORT=38090
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP

Sample platform options file to upgrade the activity peer

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

Warning

Note

Some RSSO-related properties take values specific to embedded or external RSSO environments. Use the appropriate value for your environment as instructed in the comments.

Sample options file for AP upgrade using external Remedy SSO 18.x

#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
-J AO_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
#In the next property, for embedded RSSO environments use BAOLocal or use the external RSSO realm name
-J AO_RSSO_REALM=<realm>
#In the next property, for embedded RSSO environments use the CDP URL or use the external RSSO URL
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_RSSO_VERSION=18.x
-J AO_RSSO_ADMIN_PASSWORD=<password>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration AP

Sample options file for AP upgrade using external Remedy SSO 9.1.03.x

#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
-J AO_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
#In the next property, for embedded RSSO environments use BAOLocal or use the external RSSO realm name
-J AO_RSSO_REALM=<realm>
#In the next property, for embedded RSSO environments use the CDP URL or use the external RSSO URL
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_ADMIN_PASSWORD=<password>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration AP

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
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration LAP

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.

Warning

The properties that you include in the options file depend on which version of the BMC Remedy Single Sign-On (RSSO) authentication service you want to use: an existing external instance or an embedded version installed with

WarningSome content is unavailable due to permissions.

Platform components. Use the appropriate option file for your authentication setup.

Sample options file for HA-CDP upgrade using external RSSO 18.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_REALM=<realm>
-J AO_RSSO_VERSION=18.x
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_REPOSITORY_PORT=<port number>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_PROTOCOL=https
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_PEER_NET_CONFIG_CDP_PORT=<port>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP

Sample options file for HA-CDP upgrade using external RSSO 9.1.03.x

#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_REALM=<realm>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_REPOSITORY_PORT=<port number>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_PROTOCOL=https
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_PEER_NET_CONFIG_CDP_PORT=<port>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP

Sample options file for HA-CDP upgrade using external RSSO 9.1.02

#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_RSSO_REALM=<realm>
-J AO_RSSO_VERSION=9.1.02
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_REPOSITORY_PORT=<port number>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_PROTOCOL=https
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_PEER_NET_CONFIG_CDP_PORT=<port>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP

Sample options file for HA-CDP upgrade using embedded RSSO

#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_USE_EMBEDDED_RSSO=true
-J AO_USE_EXTERNAL_RSSO=false
-J AO_RSSO_COOKIE_DOMAIN=<domain>
-J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
-J AO_REPOSITORY_PORT=<port number>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_PROTOCOL=https
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_PEER_NET_CONFIG_CDP_PORT=<port>
-J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
-J AO_REPOSITORY_HA_PORT=28090
-J AO_CDP_HA_IPADDRESS=<ipAddress>
-J AO_CDP_HA_PORT=38090
-J AO_HACDP_HA_IPADDRESS=<ipAddress>
-J AO_HACDP_HA_PORT=38091
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP

Sample platform options file to upgrade the OCP

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

Warning

Notes

Review these notes before using the sample files for an installation.

  • 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.
  • Some RSSO-related properties take values specific to embedded or external RSSO environments. Use the appropriate value for your environment as instructed in the comments.

Sample options file for OCP upgrade using external RSSO 18.x


#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
#In the next property, for embedded RSSO environments use BAOLocal or use the external RSSO realm name
-J AO_RSSO_REALM=<realm>
#In the next property, for embedded RSSO environments use the CDP URL or use the external RSSO URL
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_RSSO_VERSION=18.x
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baoocp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration OCP

Sample options file for OCP upgrade using external RSSO 9.1.03.x

#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_USE_EXTERNAL_RSSO=true
-J AO_USE_EMBEDDED_RSSO=false
#In the next property, for embedded RSSO environments use BAOLocal or use the external RSSO realm name
-J AO_RSSO_REALM=<realm>
#In the next property, for embedded RSSO environments use the CDP URL or use the external RSSO URL
-J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
-J AO_RSSO_VERSION=9.1.03.x
-J AO_RSSO_ADMIN_PASSWORD=<password>
-J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
-J AO_WEBSERVER_PORT=<port>
-J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baoocp
-J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
-J AO_WEBSERVER_PROTOCOL=https
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration OCP

Sample platform options file to upgrade the Dashboards

You can use the following sample options file to upgrade the

WarningSome content is unavailable due to permissions.

Dashboard component.

Warning

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-9-x-and-8-0-x-with-RSSO-to-20-02-with-RSSO.

#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>
#Optional properties only required for Windows OS
#-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration DB

Sample platform options file to upgrade Development Studio

You can use the following sample options file to upgrade the

WarningSome content is unavailable due to permissions.

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>

 

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

TrueSight Orchestration Platform 20.02