Installing a CDP as a High-availability CDP silently

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 silently

  1. Log in to the host computer (as a root user if you are using Linux) on which you want to install the CDP, and delete all the files from the temporary directory:
    • (Windows) %temp%
    • (Linux) /tmp

  2. Create an options file for the repository by performing the following steps:

    1. Open a text editor to create a new file.
    2. Copy the contents of the sample CDP options file provided here. 

    3. Replace the variables in the options file that match your environment requirements and save the file.

      Sample options file to install the HA-CDP with external Remedy SSO
      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_INSTALL_TYPE=install_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_WEBSERVER_PORT=38080
      -J AO_WEBSERVER_SHUTDOWN_PORT=38050
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_CDP_IS_PRIMARY=false
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      -J AO_PEER_NET_CONFIG_CDP_PORT=38080
      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_PEER_NET_CONFIG_NEW_PEER_NAME=HACDP1
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:38080/baocdp
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepoServerHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      -J AO_REPOSITORY_USER_NAME=<adminUser>
      -J AO_REPOSITORY_PASSWORD=<password>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-HACDP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP
      Sample options file to install the HA-CDP with embedded Remedy SSO
      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_INSTALL_TYPE=install_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_WEBSERVER_PORT=38080
      -J AO_WEBSERVER_SHUTDOWN_PORT=38050
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_CDP_IS_PRIMARY=false
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      -J AO_PEER_NET_CONFIG_CDP_PORT=38080
      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_PEER_NET_CONFIG_NEW_PEER_NAME=HACDP1
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:38080/baocdp
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepoServerHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      -J AO_REPOSITORY_USER_NAME=<adminUser>
      -J AO_REPOSITORY_PASSWORD=<password>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      -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_NAME=BAO-HACDP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration HACDP
      Click here to see the options file properties for installing the HA-CDP

      Property name

      Description and sample property

      AO_PEER_NET_CONFIG_CDP_HOST

      Specifies the host name or IP address of the CDP. 

      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedHostName>

      AO_PEER_NET_CONFIG_CDP_PORT

      Specifies the web communication port for the CDP

      -J AO_PEER_NET_CONFIG_CDP_PORT=38080

      AO_PEER_NET_CONFIG_CDP_USER

      Specifies the user name required to log on. 

      -J AO_PEER_NET_CONFIG_CDP_USER=<password>

      AO_PEER_NET_CONFIG_CDP_PASSWORD

      Specifies the password, in an encrypted format, that corresponds to the user name.

      Note: The password value is encrypted and is not stored in the installation log.

      -J AO_PEER_NET_CONFIG_CDP_PASSWORD=<password>

      AO_PEER_NET_CONFIG_GRID_NAME

      Specifies the name of the grid to join. 

      Default value: MyGrid 

      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid

      AO_PEER_NET_CONFIG_NEW_PEER_NAME

      Specifies the name of the new peer to install .

      -J AO_PEER_NET_CONFIG_NEW_PEER_NAME=AP1

      AO_PEER_NET_CONFIG_PROTOCOL

      Specifies the protocol: http or https. 

      Default value: http 

      -J AO_PEER_NET_CONFIG_PROTOCOL=http

      Note: Do not set the value to https unless you have configured the web server container for SSL. 

      AO_PEER_NET_CONFIG_VALIDATE

      Specifies whether to validate peer communications configuration.

      • true: enables the silent installation program to test the peer-to-CDP or OCP-to-CDP communication configuration
      • false: continues the installation without validating the peer communication configurations 

      Default value: true 

      -J AO_PEER_NET_CONFIG_VALIDATE=true

      AO_REPOSITORY_HA_IPADDRESS

      Specifies the repository IP address for communication with the enterprise service bus.

      This should be the repository HA address provided for the repository installation.

      -J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>

      AO_REPOSITORY_HA_PORT

      Specifies the repository port for communication with the enterprise service bus.

      Default value: 28090 

      -J AO_REPOSITORY_HA_PORT=28090

      AO_CDP_HA_IPADDRESS

      Specifies the CDP IP address for communication with the enterprise service bus.

      This should be the CDP HA address provided for the primary CDP installation.

      -J AO_CDP_HA_IPADDRESS=<ipAddress>

      AO_CDP_HA_PORT

      Specifies the CDP port for communication with the enterprise service bus.

      Default value: 38090 

      -J AO_REPOSITORY_HA_PORT=38090

      AO_HACDP_HA_IPADDRESS

      Specifies the HA-CDP IP address for communication with the enterprise service bus.

      This must be an IP address that allows access from the repository and/or the CDP.

      -J AO_HACDP_HA_IPADDRESS=<ipAddress>

      AO_HACDP_HA_PORT

      Specifies the HA-CDP port for communication with the enterprise service bus.

      Default value: 38091

      -J AO_REPOSITORY_HA_PORT=38091

      External Remedy SSO properties (Conditional; not required if using embedded RSSO)

      AO_USE_EXTERNAL_RSSO

      Specifies to use the external Remedy SSO instance.

      -J AO_USE_EXTERNAL_RSSO=true

      AO_USE_EMBEDDED_RSSO

      Set this to false when using the external Remedy SSO instance.

      -J AO_USE_EMBEDDED_RSSO=false

      AO_RSSO_ADMIN_PASSWORD

      Specifies administrator password, in an encrypted format, to log into the external Remedy SSO instance. 

      -J AO_RSSO_ADMIN_PASSWORD=<password>

      AO_RSSO_VERSION

      Specifies the external Remedy SSO version

      -J AO_RSSO_VERSION=9.1.03.x

      or

      -J AO_RSSO_VERSION=9.1.02

      AO_RSSO_REALM

      Specifies the name of the realm used for the external Remedy SSO instance. 

      -J AO_RSSO_REALM=<realm>

      AO_EXTERNAL_RSSO_URL=https://<RSSO>:<port>

      Specifies the external Remedy Single Sign-On URL.

      -J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>

      Embedded Remedy SSO properties (Conditional; not required if using external RSSO)

      AO_USE_EMBEDDED_RSSO

      Specifies to install the embedded Remedy SSO instance.

      -J AO_USE_EMBEDDED_RSSO=true

      AO_USE_EXTERNAL_RSSO

      Set this to false when using the embedded Remedy SSO instance.

      -J AO_USE_EXTERNAL_RSSO=true

      AO_RSSO_VERSION

      Specifies the external Remedy SSO version

      -J AO_RSSO_VERSION=9.1.03.x

      or

      -J AO_RSSO_VERSION=9.1.02

      AO_RSSO_COOKIE_DOMAIN

      Specifies the cookie domain for the embedded Remedy SSO instance.

      -J AO_RSSO_COOKIE_DOMAIN=<domain>


  3. From the command line, execute one of the following commands to start the installation program in silent mode.
    When you specify the options file name, specify the full path to the options file; do not specify a path that is relative to the installation program.

    OS

    Command

    Example

    Windows

    pathToInstaller\installCommand  -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"
    setup.cmd -i silent -DOPTIONS_FILE=tso_CDP_options.txt

    Linux

    sh ./installCommand -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"
    sh ./linux_bao_server_installer_<version>.sh -i silent -DOPTIONS_FILE=tso_CDP_options.txt

    On Windows, the silent installation does not direct output to the console. a short startup message and a console representation of a progress meter is displayed. The installation finishes without comments on the screen. On Redhat Linux, you can output debug logging to the console window by exporting LAX_DEBUG=true.

  4. Verify whether the component is installed successfully by viewing the installation log (BAO_install_log.txt) located at the following location:

    • Red Hat Linux: /tmp
    • Microsoft Windows: C:\DOCUME~1_userName_\LOCALS~1\Temp

    Scroll to the end of the log file to locate the TrueSight Orchestration install succeeded success message.

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

    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*