Installing a CDP silently

Where you are in the installation process

Step

Task

1.

2.

3.

4.

Install the Configuration Distribution Peer (You are here)

5.

Install TrueSight Orchestration Development Studio

6.

Install TrueSight Orchestration Content

7.

Install additional peers – Activity Peer

Install additional peers – Lightweight Activity Peer

Install additional peers – High Availability CDP

8.

Install the Operator Control Panel

9.

Install the Health and Value Dashboards

10.

Complete post-installation configuration tasks

To install the Configuration Distribution Peer silently

While installing a Configuration Distribution Peer (CDP), the installation program searches for and uses the configuration settings for the repository.

  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.

      Note

      If you are installing a non-English version of the Operator Control Panel,  you must install the non-English OCP and CDP on separate Tomcat servers.

      Sample options file for CDP installation using 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=true
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_NAME=MyGrid
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_PEER_NAME=CDP
      -J AO_CERT_PRINCIPAL=<My Company Name>
      -J AO_CERT_PASSWORD=<password>
      -J AO_PEER_COMM_PORT=61719
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      -J AO_CDP_HA_IPADDRESS=<IP ADDRESS OF CDP HOST>
      -J AO_CDP_HA_PORT=<PEER_PEER_CONFIG_PORT+ 2>
      #The following two values can be either blank or valid TSO user
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-CDP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP
      Sample options file for CDP installation using 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=true
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_NAME=MyGrid
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_PEER_NAME=CDP
      -J AO_CERT_PRINCIPAL=<My Company Name>
      -J AO_CERT_PASSWORD=<password>
      -J AO_PEER_COMM_PORT=61719
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      #The following two values can be either blank or valid BAO user
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
      -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_NAME=BAO-CDP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP
      Sample options file for CDP and OCP installation using 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,WEBSERVER,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_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_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_CDP_IS_PRIMARY=true
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_PEER_NAME=CDP
      -J AO_CERT_PRINCIPAL=<My Company Name>
      -J AO_CERT_PASSWORD=<password>
      -J AO_PEER_COMM_PORT=61719
      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_OCP_DEPLOYMENT_CONTEXT=baoocp
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_PEER_NET_CONFIG_CDP_CONTEXT=baocdp
      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      -J AO_PEER_NET_CONFIG_CDP_PASSWORD=<password>
      -J AO_PEER_NET_CONFIG_CDP_PORT=38080
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-CDP-Test
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP
      Sample options file for CDP and OCP installation using 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,WEBSERVER,OCP
      -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_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_CDP_IS_PRIMARY=true
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_PEER_NAME=CDP
      -J AO_CERT_PRINCIPAL=<My Company Name>
      -J AO_CERT_PASSWORD=<password>
      -J AO_PEER_COMM_PORT=61719
      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_OCP_DEPLOYMENT_CONTEXT=baoocp
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_PEER_NET_CONFIG_CDP_CONTEXT=baocdp
      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      -J AO_PEER_NET_CONFIG_CDP_PASSWORD=<password>
      -J AO_PEER_NET_CONFIG_CDP_PORT=38080
      -J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_PORT=28080
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baocdp
      -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_NAME=BAO-CDP-Test
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration CDP
      Click here to view the CDP options file properties

      Prefix tags for silent installation properties:

      • -P: Precedes directory properties
      • -J: Precedes Java properties

      Property name

      Description and sample property

      AO_ENVIRONMENT_NAME

      Specifies the name of the environment. 

      -J AO_ENVIRONMENT_NAME=BAO Environment

      AO_GRID_NAME

      Specifies the grid name. A valid grid name contains 1-30 alphanumeric characters and does not contain any special characters or spaces. 

      Default value: MyGrid

      -J AO_GRID_NAME=MyGrid

      AO_GRID_TYPE

      Specifies one of the following grid types:

      • dev
      • test
      • preprod
      • prod 

      For more information about this grid property, see the Types table in CDP installation worksheet. 

      Default value: dev 

      -J AO_GRID_TYPE=prod

      AO_GRID_LOGGING_LEVEL

      Specifies one of the following logging levels:

      • debug
      • info
      • warn
      • error
      • off 

      Default value: debug 

      -J AO_GRID_LOGGING_LEVEL=warn

      AO_CDP_IS_PRIMARY

      Specifies whether the installation is for the initial CDP.

      • true: The peer is the primary CDP.
      • false: This peer is HA-CDP.
      -J AO_CDP_IS_PRIMARY=true

      AO_PEER_NAME

      Specifies the name of the CDP 

      Default value: CDP

      -J AO_PEER_NAME=CDP

      AO_REPOSITORY_HOST

      Specifies the host name or IP address for the repository. The value cannot be a loopback address. 

      -J AO_REPOSITORY_HOST=<fullyQualifiedRepositoryHostName>

      AO_REPOSITORY_PORT

      Specifies the port used for the repository

      Default value: 28080 

      -J AO_REPOSITORY_PORT=28080

      AO_REPOSITORY_PROTOCOL

      Specifies the protocol used for the repository login page: http or https. 

      Default value: https 

      -J AO_REPOSITORY_PROTOCOL=https

      AO_REPOSITORY_USER_NAME

      Specifies the user name required to log on. 

      -J AO_REPOSITORY_USER_NAME=<repositoryUser>

      AO_REPOSITORY_PASSWORD

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

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

      -J AO_REPOSITORY_PASSWORD=<password>

      AO_CERT_PRINCIPAL

      Specifies whether the certificate principal is the owner of the license; the expected value is a company name. 

      -J AO_CERT_PRINCIPAL=<My Company Name>

      AO_CERT_PASSWORD

      Specifies a password that is at least six characters in length. 

      -J AO_CERT_PASSWORD=<password>

      AO_PEER_COMM_PORT

      Specifies the grid peer communications port number. 

      Default value: 61719

      -J AO_PEER_COMM_PORT=61719

      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>

      Note

      If using external Remedy SSO, the -J AO_REPOSITORY_HA_IPADDRESS property is mandatory for successfully installing and running the CDP.

      AO_REPOSITORY_HA_PORT

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

      Default value: 28090 

      -J AO_REPOSITORY_HA_PORT=28090

      Note

      If using external Remedy SSO, the -J AO_REPOSITORY_HA_PORT property is mandatory for successfully installing and running the CDP.

      AO_CDP_HA_IPADDRESS

      Specifies the 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 HA-CDP.

      -J AO_CDP_HA_IPADDRESS=<ipAddress>

      Note

      If using external Remedy SSO, the -J AO_CDP_HA_IPADDRESS property is mandatory for successfully installing and running the CDP.

      AO_CDP_HA_PORT

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

      Default value: 38090 

      -J AO_CDP_HA_PORT=38090

      Note

      If using external Remedy SSO, the -J AO_CDP_HA_PORT property is mandatory for successfully installing and running the CDP.

      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_REALM

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

      -J AO_RSSO_REALM=<realm>

      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_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_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 CDP is installed, log on to the Grid Manager (web application hosted on the CDP), by using the following details:

    Default URL for the CDP

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

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

    The Status tab shows the grid that you set up when you installed the 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.
  • After installing the primary CDP, the Default role has full access to the repository and to the grid, just as the AoAdmin role. In Remedy SSO, if a user is not assigned to any role, it is assigned to the Default group/role. BMC recommends that you update the permissions for the Default group to avoid providing permissions to unintended users. For more information, see Configuring-after-grid-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).

Troubleshooting the installation

If you face issues during installation, see Troubleshooting-the-installation. 

Next step in the installation process

For a basic deployment scenario, you can choose to install the TrueSight Orchestration Development Studio and 

TrueSight Orchestration Content after installing the CDP. 

See the Installing – Classic mode section for installing platform components based on your deployment scenario. 

Related topic

Installing – Classic mode

 

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