Installing an Activity Peer silently

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   workflows, select SOAP Endpoint.
6. Click OK.

To install an AP silently

1. Log in to the host computer (as a root user if you are using Linux) on which you want to install the AP, 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 AP options file provided here. 

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

      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=AP,WEBSERVER
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_PORT=38080
      -J AO_WEBSERVER_SHUTDOWN_PORT=38050
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_USE_EXTERNAL_RSSO=true
      -J AO_USE_EMBEDDED_RSSO=false
      #In the next property, for embedded RSSO environments use BAOLocal or use the external RSSO realm name
      -J AO_RSSO_REALM=<realm>
      #In the next property, for embedded RSSO environments use the CDP URL or use the external RSSO URL
      -J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>
      -J AO_RSSO_ADMIN_PASSWORD=<password>
      -J AO_RSSO_VERSION=9.1.03.x
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_PEER_NET_CONFIG_CDP_USER=<adminUser>
      -J AO_PEER_NET_CONFIG_CDP_PASSWORD=<password>
      -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=AP1
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=warn
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-AP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration AP

       Click here to view the options file properties for installing the AP

      Property name	Description and sample property
      AO_USE_EXTERNAL_RSSO	Specifies to use the external Remedy SSO instance. This should always be set to true for an AP installation, because the Remedy SSO instance is external to the AP (whether it is embedded on a TrueSight Orchestration component or an external Remedy SSO environment). -J AO_USE_EXTERNAL_RSSO=true
      AO_USE_EMBEDDED_RSSO	Set this to false for an AP installation. -J AO_USE_EMBEDDED_RSSO=false
      AO_RSSO_REALM	For embedded Remedy SSO environments, use BAOLocal or use the external Remedy SSO realm name.
      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	For embedded Remedy SSO environments use the CDP URL or use the external Remedy SSO URL.
      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 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

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_AP_options.txt
   Linux	sh ./installCommand -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"	sh ./linux_bao_server_installer_<version>.sh -i silent -DOPTIONS_FILE=tso_AP_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.

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