Installing a CDP as a High-availability CDP using the wizard

Where you are in the installation process

Step

Task

1.

2.

3.

4.

5.

6.

7.


Install additional peers – High Availability CDP (You are here)

8.

Install the Operator Control Panel

9.

Install the Health and Value Dashboards

10.

Complete post-installation configuration tasks

The high-availability configuration distribution peer (HA-CDP) is a secondary CDP that provides redundancy in a high-availability environment and is an optional server component of TrueSight Orchestration. Until a failover occurs, a secondary CDP functions as an Activity Peer. 

As this peer is used to provide redundancy, you would deploy this server on a different computer than the primary CDP. 

Even though APs and LAPs can be added after installation, BMC recommends that you add a peer first and then install it. You can use the Grid Manager Peers tab to add peers.

To add a peer to a grid

  1. Go to the Manage > Peers tab and click the Add a Peer icon.
  2. Enter a name for the peer and an optional description.

  3. Select a Type from the list.

    Note

    After a peer is configured as a configuration distribution peer (CDP), its type cannot be changed.

  4. (Optional, not applicable to LAPs) If the peer will be used as a synchronization point for uploading metrics, select Sync Point.
  5. (Optional; not applicable to LAPs) If this peer will service SOAP requests to run TrueSight Orchestration workflows, select SOAP Endpoint.
  6. Click OK.

To install the HA-CDP

  1. Navigate to the directory where the installation program files are downloaded and start the installation program. 
    • Windows: setup.cmd
    • Linux: linux_bao_server_installer_vv_rr_nn.sh
  2. On the splash screen, select the language in which to view the installation program, and click OK.
  3. Review the welcome page, and click Next.
  4. Read the license agreement, agree to the terms, and click Next. 
  5. Select Install new Orchestrator components and click Next.
  6. Select Configuration Distribution Peer and click Next. 
  7. Browse to select the directory to install the HA-CDP and click Next. 
    Since you select CDP, the root directory displays default CDP installation path that you must change. 
  8. Click Edit Ports to type the ports other than the CDP. 
    Specify different ports to avoid conflicts with other applications or operating system services on the target server and click Next.

  1. Click Secondary CDP and provide the following details and click Next:

    Field

    Default value and notes

    Grid Name

    MyGrid

    CDP Name

    HACDP The name must match the name of the secondary CDP added in Grid Manager.

    CDP Protocol

    https

    CDP Host Name

    Fully qualified domain name where the CDP is installed

    CDP Port Number

    38080

    Admin Password

    Password for the aoadmin user.

  2. (Embedded RSSO) If using embedded Remedy SSO, select Install Embedded Remedy SSO, click Advanced Options, and provide the following information:

    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.

    Note

    • 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.

    • 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.

    • 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.



  3. (External RSSO) If using external RSSO, select Use External Remedy SSO and provide the following information:

    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

  4. To start the HACDP server after installation, select Yes.
  5. Review the information and click Install.
  6. On the Installation Summary panel, perform one of the following actions:
    • To exit the installation program, click Done.
    • To review the BAO_install_log.txt file, click View Log, and then click Done to exit the installation program.

  7. To verify whether the HA-CDP is installed, log on to the Grid Manager (web application hosted on the CDP), by using the following details:

    Default URL and user account details for the CDP

    URL: http(s)://fullyQualifiedDomainName:webServerPort/baocdp

    Example: https://host.bmc.com:38080/baocdp

    Username: aoadmin

    Password: admin123

    The Status tab shows the grid that you set up when you installed the HA-CDP.

Post-installation activities

  • If you are using the embedded Remedy SSO, after installing your TrueSight Orchestration components you must complete the steps as described in Configuring-a-fail-safe-enterprise-service-bus-after-installation.

  • If you are installing in a Linux environment, you must complete the following instructions after the installation.

    Click here to see the steps to support dmidecode on Linux
    1. This supports running the dmidecode to gather operating system information by the Health dashboard. 
      To do this, edit the .bashrc file located in the $HOME directory and add the path. 
      For example, if the TrueSight Orchestration service is running under a user account called "tso", edit bao's .bashrc file and add the following lines:
      set PATH=${PATH}:/usr/sbin
      export PATH
    2. As root user, run the following command to update permissions so that non-root users can run the dmidecode command: 
      chmod g+s /usr/sbin/dmidecode
    3. Restart the TrueSight Orchestration service (see Starting-and-stopping-product-components-and-services).

Next step in the installation process

See the Installing section to proceed further in the installation process. 

Related topic

Installing – Classic mode

 

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