Installing the Operator Control Panel silently

Where you are in the installation process

Review these notes before using the sample files for an installation.

• 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.
• Some Remedy SSO-related properties take values specific to embedded or external Remedy SSO environments. Use the appropriate value for your environment as instructed in the comments.

To install Operator Control Panel silently

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

1. Log in to the host computer (as a root user if you are using Linux) on which you want to install the repository, and delete all the files from the temporary directory:
   • (Windows) %temp%
   • (Linux) /tmp
2. Create an options file for the OCP 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.

      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=OCP,WEBSERVER
      -J AO_ENVIRONMENT_NAME=BAO Environment
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_START_SERVER_ON_SUCCESS=true
      -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>
      -J AO_RSSO_VERSION=9.1.03.x
      #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=<RSSO_PASSWORD>
      -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_PEER_NET_CONFIG_GRID_NAME=MyGrid
      -J AO_PEER_NET_CONFIG_PEER_NAME=CDP
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_PEER_NET_CONFIG_VALIDATE=true
      -J AO_WEBSERVER_PORT=38080
      -J AO_WEBSERVER_SHUTDOWN_PORT=38050
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:38080/baoocp
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<password>
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-OCP
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration OCP

      Click here to view the OCP options file properties

      Prefix tags for silent installation properties:

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

      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 a stand-alone OCP installation, because the Remedy SSO instance is external to the OCP (whether it is embedded on a BAO component or an external Remedy SSO environment). -J AO_USE_EXTERNAL_RSSO=true
      AO_USE_EMBEDDED_RSSO	Set this to false for a stand-alone OCP 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_CONTEXT	Specifies the Web context for the CDP. -J AO_PEER_NET_CONFIG_CDP_CONTEXT=baocdp
      AO_PEER_NET_CONFIG_PEER_NAME	Specifies the name of the peer to which the OCP will connect. -J AO_PEER_NET_CONFIG_PEER_NAME=CDP
      AO_PEER_NET_CONFIG_CDP_HOST	Specifies the host name or IP address of the CDP.  -J AO_PEER_NET_CONFIG_CDP_HOST=<fullyQualifiedCDPhostName>
      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_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_PROTOCOL	Specifies the protocol: http or https.  Default value: https  -J AO_PEER_NET_CONFIG_PROTOCOL=https
      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 prompt, 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_OCP_options.txt
   Linux	sh ./installCommand -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"	sh ./linux_bao_server_installer_<version>.sh -i silent -DOPTIONS_FILE=tso_OCP_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.