Upgrading a high-availability CDP

This topic describes how to use the GUI installation program to upgrade a configuration distribution peer designated as a high-availability CDP (HA-CDP). During the upgrade, the secondary CDP searches for and uses the primary CDP and the repository configuration settings.

Before you begin

You must upgrade the primary CDP.
If you are using an external authentication service, it must be installed and running.
The repository and the primary CDP must be running.
You must shut down the HA-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 fill in the HA-CDP-worksheet.
You must be logged in as an administrator and have administrator rights on the computer where you will upgrade the HA-CDP.
If you are installing on a Windows computer, make sure that 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 an HA-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, read 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 HA-CDP by using embedded Remedy SSO, select Install Embedded Remedy SSO, click Advanced Options, provide the following information, and click Next:

Parmeter	Default value and notes
Service Name	BAO-CDP
CDP Protocol	https
CDP Host Name	Fully qualified domain name of the computer where you are installing the CDP
Repository HA Address	Provide the repository IP address and port for communication with the enterprise service bus. Use the following format: <IPaddress>:<port> On a machine 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: This entry 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. If using external Remedy SSO, Repository HA Address and port is mandatory for successfully installing and running the CDP.
CDP HA Address	Provide the CDP IP address and port for communication with the enterprise service bus. Use 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: This entry 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. If using external Remedy SSO, CDP HA IP Address and port is mandatory for successfully installing and running the CDP.
HACDPHA Address	Provide the HA-CDP IP address and port for communication with the enterprise service bus. Use 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 primary CDP. The default port is the HA-CDP web port plus 10. For example, if the HA-CDP port is 38080, the HACDP HA address is 38090. Important: This entry 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. If using external Remedy SSO, CDP HA IP address and port are mandatory for successfully installing and running the CDP.
TSO Domain	Specify 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 HA-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	Provide 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 can be: https://external-rsso.mydomain:8080
Remedy SSO Realm	Provide the name of the realm.
Admin password	Enter the admin password to log into RSSO.
Remedy SSO Version	Select your Remedy SSO version from the following list: 9.1.02 9.1.03.x 9.1.04.x 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 and click Next.
Click Yes when prompted to restart the HA-CDP server and then click Next.
On the Installation Preview panel, review your settings and click Install.
When the installation finishes successfully, click Done.

Important

To import existing Cassandra details after you configure the Cassandra database when upgrading the HA-CDP, perform the following steps:

Stop the Cassandra database and the HA-CDP. For more information, see Starting-and-stopping-product-components-and-services.
Copy the Cassandra details in the context.xml file located in the <AO_HOME>/backups/ directory and paste it into the Cassandra database directory.
Restart the Cassandra database and the HA-CDP.

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 HA-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

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, you must complete the steps in Configuring-a-fail-safe-enterprise-service-bus-after-upgrade after upgrading your TrueSight Orchestration components.