Installing repository silently

Where you are in the installation process

Step

Task

1.

2.

3.

Install the repository ( You are here )

4.

Install the Configuration Distribution Peer

5.

Install TrueSight Orchestration Development Studio

6.

Install TrueSight Orchestration Content

7.

Install additional peers – Activity Peer

Install additional peers – Lightweight Activity Peer

Install additional peers – High Availability CDP

8.

Install the Operator Control Panel

9.

Install the Health and Value Dashboards

10.

Complete post-installation configuration tasks

To install the repository 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 repository, and delete all the files from the temporary directory:
    • (Window s) %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 repository options file provided here. 

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

      Sample options file for repository installation using external Remedy SSO
      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_ADMIN_USERNAME=aoadmin
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=REPO,WEBSERVER
      -J AO_REPOSITORY_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo/
      -J AO_ENVIRONMENT_NAME=TSO Environment
      -J AO_GRID_NAME=MyGrid
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_START_SERVER_ON_SUCCESS=true
      -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_PORT=38080
      -J AO_REPOSITORY_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_REPOSITORY_PORT=28080
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_PEER_NET_CONFIG_PEER_NAME=CDP
      -J AO_PEER_NET_CONFIG_NEW_PEER_NAME=HACDP
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_SECURITY_ACTIVE=true
      -J AO_SECURITY_WEB_PROTOCOL=https
      -J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
      -J AO_CDP_HA_IPADDRESS=<ipAddress>
      -J AO_HACDP_HA_IPADDRESS=<ipAddress>
      -J AO_REPOSITORY_HA_PORT=28090
      -J AO_CDP_HA_PORT=38090
      -J AO_HACDP_HA_PORT=38091
      -J AO_WEBSERVER_PORT=48080
      -J AO_WEBSERVER_SHUTDOWN_PORT=48050
      -J AO_PEER_COMM_PORT=61719
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_RSSO_COOKIE_DOMAIN=<domain>
      -J AO_USE_EMBEDDED_RSSO=false
      -J AO_USE_EXTERNAL_RSSO=true
      -J AO_RSSO_VERSION=20.02
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_SERVER_STOP_SUCCCESSFUL=true
      -J AO_ADMIN_PASSWORD=<password>
      -J AO_RSSO_ADMIN_PASSWORD=<password>
      -J AO_RSSO_REALM=BAOLocal
      -J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>

      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-REPO
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration Repository
      Sample options file for repository installation using embedded Remedy SSO
      #Replace the variables and sample values in this example.
      -P installLocation=<fullPathToTheInstallationDirectory>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_WEBSERVER_PROTOCOL=https
      -J AO_INSTALL_TYPE=install_new
      -J AO_INSTALLING_FEATURES=REPO,WEBSERVER
      -J AO_ENVIRONMENT_NAME=TSO Environment
      -J AO_GRID_NAME=MyGrid
      -J AO_GRID_TYPE=dev
      -J AO_GRID_LOGGING_LEVEL=debug
      -J AO_START_SERVER_ON_SUCCESS=true
      -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_PORT=8080
      -J AO_REPOSITORY_PORT=28080
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_PEER_NET_CONFIG_PEER_NAME=CDP
      -J AO_PEER_NET_CONFIG_PROTOCOL=https
      -J AO_SECURITY_ACTIVE=true
      -J AO_SECURITY_WEB_PROTOCOL=https
      -J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>
      -J AO_CDP_HA_IPADDRESS=<ipAddress>
      -J AO_HACDP_HA_IPADDRESS=<ipAddress>
      -J AO_REPOSITORY_HA_PORT=28090
      -J AO_CDP_HA_PORT=38090
      -J AO_HACDP_HA_PORT=38091
      -J AO_WEBSERVER_PORT=28080
      -J AO_WEBSERVER_SHUTDOWN_PORT=28050
      -J AO_PEER_COMM_PORT=61719
      -J AO_WEBSERVER_HOST=<fullyQualifiedAOwebServerHostName>
      -J AO_RSSO_COOKIE_DOMAIN=<domain>
      -J AO_USE_EMBEDDED_RSSO=true
      -J AO_USE_EXTERNAL_RSSO=false
      -J AO_RSSO_VERSION=20.02
      -J AO_EMBEDDED_RSSO_URL= https://<fullyQualifiedAOwebServerHostName>:<webServerPort>
      -J AO_WEBSERVER_URL=https://<fullyQualifiedAOwebServerHostName>:<webServerPort>/baorepo

      #Optional properties only required for Windows OS
      #-J AO_WINDOWS_SERVICE_NAME=BAO-REPO
      #-J AO_WINDOWS_SERVICE_DISPLAY_NAME=TrueSight Orchestration Repository
      Click here to view the repository options file properties

      Prefix tags for silent installation properties:

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

      Property name

      Description

      installLocation

      Specifies the full path to the installation directory.

      -P installLocation=<fullPathToTheInstallationDirectory>

      This property is required in every options file.

      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_INSTALLING_FEATURES

      Specifies the components to install on the target computer.

      The following property specifies the repository 
      -J AO_INSTALLING_FEATURES=REPO

      With the exception of Development Studio, this property is required in every options file.

      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_PORT

      Specifies the port number for the repository.

      Default value: 28080 

      -J AO_WEBSERVER_PORT=28080

      AO_WEBSERVER_SHUTDOWN_PORT

      Specifies the web server shutdown port.

      Default value: 28050 

      -J AO_WEBSERVER_SHUTDOWN_PORT=28050

      AO_WEBSERVER_PROTOCOL

      Specifies the protocol on which the repository is installed.

      Valid values: http, https (default)

      AO_WEBSERVER_HOST

      Specifies the fully qualified domain name of the host where you want to install the repository or any other platform components.

      AO_WEBSERVER_URL

      Specifies the URL used to launch the platform component.

      AO_ADMIN_USERNAME

      Specifies the name of the administrator user.

      AO_ADMIN_PASSWORD

      Specifies the password, in an encrypted format, for the administrator user.

      AO_WINDOWS_SERVICE_NAME

      Specifies the service name on a Windows computer.

      Default value: BAO-REPO

      You can use other alphanumeric value that do not contain spaces.

      AO_WINDOWS_SERVICE_DISPLAY_NAME

      Specifies the service display name on a Windows computer.

      Default values: TrueSight Orchestration REPO

      External Remedy SSO properties

      AO_USE_EXTERNAL_RSSO

      Specifies to use the external Remedy SSO instance.

      -J AO_USE_EXTERNAL_RSSO=true

      AO_USE_EMBEDDED_RSSO

      Set this to false when using the external Remedy SSO instance.

      -J AO_USE_EMBEDDED_RSSO=false

      AO_RSSO_ADMIN_PASSWORD

      Specifies administrator password, in an encrypted format, to log into the external Remedy SSO instance. 

      -J AO_RSSO_ADMIN_PASSWORD=<password>

      AO_RSSO_REALM

      Specifies the name of the realm used for the external Remedy SSO instance. 

      -J AO_RSSO_REALM=<realm>

      AO_RSSO_VERSION

      Specifies the external Remedy SSO version

      -J AO_RSSO_VERSION=20.02

      or

      -J AO_RSSO_VERSION=20.02

      AO_EXTERNAL_RSSO_URL

      Specifies the external Remedy Single Sign-On URL.

      -J AO_EXTERNAL_RSSO_URL=https://<fullyQualifiedRSSOhostName>:<port>

      Embedded Remedy SSO properties

      AO_USE_EMBEDDED_RSSO

      Specifies to install the embedded Remedy SSO instance.

      -J AO_USE_EMBEDDED_RSSO=true

      AO_USE_EXTERNAL_RSSO

      Set this to false when using the embedded Remedy SSO instance.

      -J AO_USE_EXTERNAL_RSSO=true

      AO_RSSO_COOKIE_DOMAIN

      Specifies the cookie domain for the embedded Remedy SSO instance.

      -J AO_RSSO_COOKIE_DOMAIN=<domain>

      Repository high-availability properties

      AO_REPOSITORY_HA_IPADDRESS

      Specifies the repository IP address for communication with the enterprise service bus.

      This must be an IP address that allows access from the CDP and/or the HA-CDP.

      -J AO_REPOSITORY_HA_IPADDRESS=<ipAddress>

      Note

      If using external Remedy SSO, the -J AO_REPOSITORY_HA_IPADDRESS property is mandatory for successfully installing and running the repository.

      AO_REPOSITORY_HA_PORT

      Specifies the repository port for communication with the enterprise service bus.

      Default value: 28090 

      -J AO_REPOSITORY_HA_PORT=28090

      Note

      If using external Remedy SSO, the -J AO_REPOSITORY_HA_PORT property is mandatory for successfully installing and running the repository.

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

    Linux

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

  • When you install the repository, a default user, aoadmin is created. 
  • If you installed repository with the embedded RSSO, a default local user aoadmin, default role AoAdmin, and a realm BAOLocal are created in RSSO. The user aoadmin is automatically added to the AoAdmin role. 
  • If using external RSSO, the aoadmin user must be assigned to the AoAdmin role (in RSSO) for TrueSight Orchestration authentication. 
  • After you log on to the repository using the default credentials, change passwords for the default user.
  • If you are using Internet Explorer 8.0 or later, ensure that you add the URL for the TrueSight Orchestration repository in the trusted sites of the browser.

Next step in the installation process

Now that you have successfully installed the repository, ensure that the repository is up and running and then install the Configuration Distribution Peer. For more information about the installation process, see Installing – Classic mode.

Related topic

Preparing-for-TrueSight-Orchestration-installation

 

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