Installing a CDP using the wizard

To install a CDP

While installing a CDP, the installation program searches for and uses the configuration settings for the repository.

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. 

   CDP+OCP options

   You can choose to install the optional component – Operator Control Panel (OCP) with the CDP. 

   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.

   You can also install the OCP independently after the CDP is installed successfully.

7. 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
8. Enter the root port that you want to use for the CDP and click Next. 

9. (Optional) Click Edit Ports to change the default port values and avoid conflicts with other applications or operating system services on the target server and click Next.

   Default CDP ports

   By default, CDP is installed using the following ports:

   CDP: 38080

   CDP Shutdown: 38050

   CDP Communication: 61719

10. On the Primary CDP selection panel provide the following information and click Next.

    Important

    While installing the CDP for the first time, Primary CDP is selected by default. Select the Secondary CDP option only if you want to install the High-availability CDP after the primary CDP is successfully installed.

    The default values for the Grid Name and the CDP Name are displayed. Update the values according to your requirements.

    1. Select the Repository Protocol that matches the protocol used while installing the repository.
       The default value is https. 
    2. In the Repository Host Name field, type the fully qualified domain name (FQDN) of the host where the repository is installed. 
    3. In the Repository Port Number field, type the port number on which the repository is installed.
       The default port number is 28080.

    4. Enter the password for the administrator account used for the repository.
       If you have not created a separate administrator account after installing the repository, you can enter the password for the aoadmin account.

       
       
       

11. To install 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

12. To install 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+.

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

      Important

      The backup of the Cassandra database exists in the directory <AO_HOME>/backups/.

14. To start the CDP server after installation, select Yes.
15. Review the information and click Install.

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

    Note

    Cassandra database is installed out-of-the-box when you install the CDP or HA-CDP components. Cassandra database stores data for the jobs running on the Grid. This data is displayed on the Job List and Job View tabs on the Health Dashboard.

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

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

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.