Upgrading the CDP

The topic describes how to use the GUI installation program to upgrade a configuration distribution peer (CDP). During a CDP upgrade, you can also upgrade the TrueSight Orchestration Operator Control Panel.

Important

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.

Before you begin

You must upgrade the repository and it must be running.
If you use an external BMC Remedy Single Sign-On instance, it must be installed and running.

You must shut down the CDP service and we recommend that you shut down the services for all peers in your environment. For more information, see Starting-and-stopping-product-components-and-services.
You must download the installation files from the BMC EPD website.
You must be logged in as an administrator and have administrator rights for the computer that contains the CDP.
You must complete the upgrade worksheets (CDP-worksheet and Operator-Control-Panel-worksheet) to record any changes to your system settings.
If you are installing on a Windows computer, make sure that Data Execution Prevention (DEP) is configured to recognize the installation program. For more information, see Configuring-DEP-on-Windows-computers-before-upgrading.
Copy the server.xml and broker-config.xml files and store them in a safe location. For more information, see Backing-up-server-xml-and-broker-config-xml-files.
If you are upgrading on a Linux computer, you must run the rngd service to make sure that the system has adequate entropy. For more information, see Run-the-rngd-service-on-Linux-computers-before-upgrades.
You must exit all other programs.

To upgrade the CDP

Navigate to the directory where the installation program files are downloaded and start the installation program.
- Windows: setup.cmd
- Linux: linux_bao_server_installer_<version>.sh
On the splash screen, select the language in which to view the installation program, and click OK.
On the Welcome panel, review the information and click Next.
On the license agreement panel, select I agree to the terms of the license agreement, and click Next.
On the Installation Type panel, select Upgrade an existing install, and click Next.
Browse to select the directory to install the CDP and click Next.
By default, the component is installed in the following directory (also referred to as AO_HOME in the documentation):
- Windows: C:\Program Files\BMC Software\BAO\CDP
- UNIX: /opt/bmc/BAO/CDP

To upgrade the CDP by using embedded Remedy SSO, select Install Embedded Remedy SSO, click Advanced Options, provide the following information, and click Next:

Parameter	Default value	Notes
Service Name	BAO-CDP	If you install more than one CDP on the same computer, make sure that you change the Service Name to avoid conflict.
CDP Protocol	https
CDP Host Name	-	Fully qualified domain name of the computer where you are installing the CDP
Repository HA Address	-	The repository IP address and port for communication with the enterprise service bus (ESB) are generated in the following format: <IPaddress>:<port> On a computer that has multiple network interface cards (NICs) this must be the IP address that allows access from the CDP and/or the HA-CDP. The default port is the repository web port plus 10. For example, if the repository port is 28080, the Repository HA address is 28090. Important: Repository HA Address is required for installations/upgrades with embedded RSSO installations. This is not applicable if you are using external RSSO on the CDP. Often, multiple IP addresses are detected by the installer (on a machine that has multiple NICs). Verify the default address and port number and replace them if required.
CDP HA Address	-	CDP IP address and port for communication with the enterprise service bus are generated in the following format: <IPaddress>:<port> On a machine that has multiple network interface cards (NICs) this must be an IP address that allows access from the repository and/or the HA-CDP. The default port is the CDP web port plus 10. For example, if the CDP port is 38080, the CDP HA address is 38090. Important: CDP HA Address is required for installations/upgrades with embedded RSSO installations. This is not applicable if you are using external RSSO on the CDP. Often multiple IP addresses are detected by the installer (on a machine that has multiple NICs). Verify the default address and port number and replace them if required.
TSO Domain	-	Specifies the cookie domain name for TrueSight Orchestration and BMC Remedy Single Sign-On, which controls the cookie visibility between servers within the domain. You must specify the network domain of the computer on which you are installing the component. Example: yourcompany.com

To upgrade the CDP by using external Remedy SSO, select Use External Remedy SSO, provide the following information, and click Next:

Parameter	Default value and notes
Remedy SSO URL	Type the external Remedy SSO URL in the following format: https://<hostname>/<port> For example, if Remedy SSO server has the name external-rsso.mydomain, the URL is: https://external-rsso.mydomain:8080
Remedy SSO Realm	Type the name of the realm to be used for TSO.
Admin password	Enter the admin password to log into RSSO.
Remedy SSO Version	Depending upon the RSSO version you are using, select the appropriate version from the following list: 9.1.02, 9.1.03.x, 9.1.04.x, 18.x, 18.x+. For example, if you are using RSSO version 20.02, select 18.x+.

On the Cassandra database details panel, select Yes to configure the Cassandra database or No to continue the installation without configuring the Cassandra database.

If you select Yes, provide the following information and click Next:

Parameter	Notes
Host IP Address	Enter the Host IP Address where Cassandra is installed
Port	Enter the Port number where Cassandra is running
Username	Enter the username to log into the Cassandra DB
Password	Enter the password to log into the Cassandra DB

Important

You must make sure that the Cassandra DB Server is running.
You must provide the Host IP Address where Cassandra is installed.

To skip configuring the Cassandra database, select No, and click Next.
To configure the Cassandra database after installation, enter the Cassandra details in the context.xml file located in the <AO_HOME>/tomcat/config directory.
Warning
Important
The backup of the Cassandra database exists in the directory <AO_HOME>/backups/.

Review the Connection Details panel, enter the AO Admin Password, and then click Next.

Click Yes when prompted to restart the server and then click Next.
When you have finished reviewing the installation preview in the Installation Choices Summary panel, click Install.
When the installation finishes successfully, click Done.

To import data from the existing Cassandra database

To import data from the existing Cassandra database, perform the following steps:

Stop the Cassandra database and the CDP. For more information, see Starting-and-stopping-product-components-and-services.
The backup of the Cassandra database exists in the directory <AO_HOME>/backups/.
Copy the data directory from <AO_HOME>\backups\cassandra\ and paste it into the Cassandra database directory. (For example, C:\cassandra\)
Restart the Cassandra database. After the database runs, you will find the data imported.

To start Cassandra database in Windows

Open Command Prompt with administrative privileges.
Navigate to the Cassandra installation directory (For example, ../cassandra/bin).
Run the command =>cassandra to start the Cassandra database.
Wait for Cassandra database to start. You should see log messages indicating that the server has started successfully.

To start the Cassandra database in Linux

Navigate to Cassandra installation directory (For example, ../cassandra/bin).
Run the command =>cassandra to start the Cassandra database.
Wait for Cassandra database to start. You should see log messages indicating that the server has started successfully.

Where to go from here

Clear your browser's cache before you log on to TrueSight Orchestration Grid Manager.

If you have not already done so, you can upgrade any of the following:

If you install an embedded version of BMC Remedy Single Sign-On during the upgrade process, after upgrading your TrueSight Orchestration components you must complete the steps in Configuring-a-fail-safe-enterprise-service-bus-after-upgrade.