Installing a Lightweight 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 TrueSight Orchestration workflows, select SOAP Endpoint.
6. Click OK.

To install an LAP silently

You launch the silent installation from the command line and are not prompted for input. 

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 LAP

      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<Password>
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=LAP,WEBSERVER
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_NAME=MyGrid
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_START_SERVER_ON_SUCCESS=false
      -J AO_OCP_DEPLOYMENT_CONTEXT=baoocp
      -J AO_PEER_NAME=CDP
      -J AO_PEER_NET_CONFIG_CDP_CONTEXT=baocdp
      -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      -J AO_PEER_NET_CONFIG_CDP_PORT=38080
      -J AO_REPOSITORY_PORT=28080
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=
      -J AO_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_PEER_NET_CONFIG_PEER_NAME=CDP
      -J AO_PEER_NET_CONFIG_NEW_PEER_NAME=LAP
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_SECURITY_ACTIVE=false
      -J AO_SECURITY_WEB_PROTOCOL=https
      -J AO_WEBSERVER_PORT=48080
      -J AO_WEBSERVER_SHUTDOWN_PORT=48050
      -J AO_PEER_COMM_PORT=61719
      -J AO_WEBSERVER_HOST=<fullyQualifiedCDPhostName>
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-LAP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration LAP

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

      Prefix tags for silent installation properties:

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

      Property	Description
      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

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_LAP_options.txt
   Linux	sh ./installCommand -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"	sh ./linux_bao_server_installer_<version>.sh -i silent -DOPTIONS_FILE=tso_LAP_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 LAP 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 tso'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.