Installing an Activity Peer using the wizard

Where you are in the installation process

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 an AP

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 Activity Peer and click Next.
7. Browse to select the directory to install the AP 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\AP
   • UNIX: /opt/bmc/BAO/AP
8. Enter the root port that you want to use for the AP 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.

1. Provide the following details for configuring the AP and click Next.

1. 1. Select the protocol as https.
   2. Type the hostname (in FQDN format) where the CDP in installed.
   3. Type the CDP port number. The default port number is 38080. 
   4. Type the name of the Grid specified while installing the CDP.

1. 1. Type the name of the peer. 

      Note

      Before installing the AP, you added a peer to the grid. You must specify the name of the peer here.

   2. Type the user name assigned to the AO Admin group. 

      The AO admin name used to authenticate against Remedy Single Sign-On (default is AoAdmin).

   3. Type the password that matches the aoadmin user. 

   4. Type the Remedy SSO URL used by the CDP. 
      
      

      Note

      The AP always uses an external Remedy SSO, which can be one of the following:

      • The Remedy SSO instance embedded on the repository.
      • The Remedy SSO instance embedded on the CDP or HA-CDP.
      • The external Remedy SSO that you specified during the repository installation or upgrade.

      Typically the AP uses the Remedy SSO that is used by the CDP or HA-CDP.

      Examples:

      • If using an embedded Remedy SSO on a repository server with the name bao-repository.mydomain, the URL is similar to the following:
        https://bao-repository.mydomain:28080
      • If using an embedded Remedy SSO on a CDP server with the name bao-cdp.mydomain, the URL is similar to the following:
        https://bao-cdp.mydomain:38080

      • If using an external Remedy SSO server with the name external-rsso.mydomain, the URL is similar to the following:
        https://external-rsso.mydomain:8080

   5. Provide the realm name for the Remedy SSO authentication instance used in your environment. 

      The realm name is the same as the one used by the CDP. 

      Note

      • If you are using the embedded Remedy SSO on the repository, CDP, or HA-CDP, the realm used by TrueSight Orchestration is BAOLocal.
      • If you are using the external Remedy SSO, provide the realm name for on the external Remedy SSO.

   6. Select your RSSO version from the list. 
2. Click Advanced Options and change the details: 
   1. Type the service name.
      The default value is BAO-AP. Typically, you would do this if you install more than one activity peer on the same host. 
   2. Select the AP protocol.
   3. Type the hostname in an FQDN format. 
   4. 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. To start the AP server after installation, select Yes.
4. Review the information and click Install.
5. 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.

Post-installation tasks

If you install the AP on a Linux server, you must complete the following instructions after the installation.

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 – Classic mode section to proceed further in the installation process.