Installing the Health and Value Dashboards silently


Where you are in the installation process

Step

Task

1.

2.

3.

4.

5.

6.

7.


8.

9.

Install the Health and Value Dashboards (You are here)

10.

Complete post-installation configuration tasks

To install the TrueSight Orchestration dashboard silently

  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.

      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<Password>
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=DB
      -J AO_START_SERVER_ON_SUCCESS=true
      -J AO_WEBSERVER_PORT=18080
      -J AO_WEBSERVER_SHUTDOWN_PORT=18050
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-DB
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration DB
      Click here to view the options file properties for the dashboards

      Prefix tags for silent installation properties:

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

      Property name

      Description and sample property

      AO_INSTALL_TYPE

      Specifies the installation type.

      • install_new

        Installs a new version of the product 

        -J AO_INSTALL_TYPE=install_new
      • upgrade_new
        Performs the following upgrade actions:
        • Upgrades from an earlier version of the component to the latest version
        • Repairs the latest installed version
        • Adds new features to the current version 
          -J AO_INSTALL_TYPE=upgrade_new

      This property is required in every options file.

      AO_ADMIN_USERNAME

      Specifies the name of the administrator. 

      -J AO_ADMIN_USERNAME=<adminUser>

      AO_ADMIN_PASSWORD

      Specifies the administrator password, in an encrypted format. 

      -J AO_ADMIN_PASSWORD=<adminPassword>

      AO_INSTALLING_FEATURES

      Specifies the components to install on the target computer.

      The following property specifies the dashboards:


      AO_INSTALLING_FEATURES=DB

      AO_WEBSERVER_PORT

      Specifies the port number for the dashboards

      AO_WEBSERVER_SHUTDOWN_PORT

      Specifies the shutdown port number for the dashboards

      AO_WEBSERVER_PROTOCOL

      Specifies the protocol on which the dashboards are to be installed. Valid values: http, https (default)

      AO_START_SERVER_ON_SUCCESS

      Specifies whether to start the server after a successful installation.

      • true: Starts the server
      • false: Does not start the server 
      -J AO_START_SERVER_ON_SUCCESS=true

      AO_WEBSERVER_HOST

      Specifies the fully qualified domain name of the host where you want to install the dashboards.

      AO_WINDOWS_SERVICE_NAME

      Specifies the service name on a Windows computer.

      Default value: BAO-DB

      AO_WINDOWS_SERVICE_DISPLAY_NAME

      Specifies the service display name on a Windows computer.

      Default value: TrueSight Orchestration DB

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

    Linux

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

Troubleshooting installation issues

If you face issues during or after installation, see Troubleshooting-the-dashboards.

Next step in the installation process

Now that all TrueSight Orchestration Platform components are installed successfully, you must complete the post-installation activities. For more information, see Configuring-your-environment-to-use-TrueSight-Orchestration-dashboards.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Platform 24.3