Installing TrueSight Orchestration Content silently


Where you are in the installation process

Step

Task

1.

2.

3.

4.

5.

6.

Install TrueSight Orchestration Content (You are here)

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

What you need to know before installing content

  • Content includes Application adaptersBase adaptersOperations Actions Management Modules, and Runbooks
  • Content versions differ from the platform versions. You must download a content version compatible with your current platform version. 
  • Based on your license terms, two installation paths are available for installing content: 
    • BSM Solutions: Enables you to install runbooks (solutions) that consist of preselected adapters and modules required for the solution. Using the BSM Solutions path you can configure third-party products required for the installation. All artifacts required for the solution are also installed. For example, you can install the Continuous Compliance for Servers runbook and specify the TrueSight Server Automation and BMC Remedy AR System configurations while installing the runbook. For more information about using this installation path to install solutions, see Runbooks.

    • Custom feature set: Enables you to select all available content in the release. No content is preselected and you cannot configure integrations with any other products. 

      Tip

      Unless you are installing a solution, always use this option to install content.

  • You can install content anytime after installing the repository and the Configuration Distribution Peer (CDP). Content is uploaded to the repository and is available from the Grid Manager and the Repository Manager. 

To install content silently

  1. Log in to the host computer (as a root user if you are using Linux) on which you want to install the content, 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 options file provided in the next step. 
    3. Replace the variables in the options file that match your environment requirements and save the file.
      Use the options file that matches your requirement. For example, you can choose to install either all adapters, or individual adapters or modules based on your requirement. The options file properties will be different based on the installation type. 

      Sample options file to install all content
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=ALL
      -J AO_CONTENT_INSTALL_TYPE=INSTALL_TYPE_CUSTOM
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install all base adapters
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=BASE
      -J AO_CONTENT_INSTALL_TYPE=INSTALL_TYPE_CUSTOM
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install selected base adapters
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=adapter-email,adapter-http,adapter-jms,
      adapter-powershell,adapter-scripting,adapter-snmp,adapter-sql,
      adapter-terminal,adapter-windows-command,adapter-ws
      -J AO_CONTENT_INSTALL_TYPE=INSTALL_TYPE_CUSTOM
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install all application adapters
      -P installLocation=<installationPathAndDirectory>
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=APP
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install a combination of selected application and base adapters
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=adapter-email,adapter-http,adapter-jms,adapter-snmp,
      adapter-windows-command,adapter-ws,adapter-active-directory,
      adapter-ars,adapter-bmc-atrium-cmdb
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install all core modules
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=platform-modules
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install all OA Management Modules
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=task-management-modules
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install selected modules
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=AutoPilot-AD-Utilities,AutoPilot-OA-Applications_Utilities,
      AutoPilot-OA-Common_Utilities,
      AutoPilot-OA-Directory_Services_Utilities,AutoPilot-OA-File_Utilities,AutoPilot-OA-Network_Utilities,
      AutoPilot-OA-Operating_System_Utilities
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Sample options file to install all runbooks
      -P installLocation=C:\Program Files\BMC Software\AO\content
      -J AO_ADMIN_USERNAME=<adminUser>
      -J AO_ADMIN_PASSWORD=<encryptedPassword>
      -J AO_INSTALLING_FEATURES=run-book-modules
      -J AO_REPOSITORY_PROTOCOL=https
      -J AO_REPOSITORY_HOST=<hostNameOrIpAddress>
      -J AO_REPOSITORY_PORT=<portNumberOnRepositoryServer>
      -J AO_REPOSITORY_USER_NAME=admin
      -J AO_REPOSITORY_PASSWORD=<password>
      Click here to see options file properties for installing content

      Prefix tags for silent installation properties:

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

      Property name

      Description and sample property

      installLocation

      Specifies the full path to the installation directory

      Default value:

      • Windows: c:\Program Files\BMC Software\AO\content
      • UNIX: /opt/bmc/ao/content
      -P installLocation=C:\Program Files\BMC Software\AO\content

      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

      Used with the content installer, specifies to install all content for TrueSight Orchestration; does not include BSM Solution workflows.

      -J AO_INSTALLING_FEATURES=ALL

      To specify the group of adapters to install, use one of the following values:

      • ALL: installs all base and application adapters
      • BASE or base-adapters: installs all base adapters but no application adapters
      • APP or application-adapters: installs all application adapters but no base adapter
      -J AO_INSTALLING_FEATURES=APP,adapter-http,adapter-jms

      To specify selected content, type the feature names, separated by a comma:

      -J AO_INSTALLING_FEATURES=adapter-email,adapter-http,
      adapter-jms,adapter-powershell,adapter-scripting,
      adapter-snmp,adapter-sql,adapter-terminal,
      adapter-windows-command,adapter-ws

      To specify the group of modules to install, use one of the following values:

      • ALL: installs all platform and task management modules
      • platform-modules: installs all platform modules
      • task-management-modules: installs all task management modules but no platform modules
      • run-book-modules: installs all run books
      -J AO_INSTALLING_FEATURES=platform-modules
      -J AO_INSTALLING_FEATURES=run-book-modules
      -J AO_INSTALLING_FEATURES=task-management-modules

      AO_CONTENT_INSTALL_TYPE

      Specifies the types of content installed. For more information about installation types, see Installing-TrueSight-Orchestration-Content-using-the-wizard.

      • INSTALL_TYPE_CUSTOM: installs any combination of content
        Always specify this option unless you have purchased a BMC solution that requires one of the BMC solutions that requires a predefined workflow.
      • INSTALL_TYPE_SOLUTIONS: installs content based on predefined BSM solutions; the adapters integrate with other BMC products
        When you specify this option, you must also include the following properties:
        • INSTALL_REMEDY_ITSM_INTEGRATIONS: true or false
        • REMEDY_PORT_NUMBER: "0" for automatic port mapping, or you can use specific port number
        • REMEDY_HOSTNAME: DNS name or IP of the target Remedy ITSM system
        • REMEDY_USER_NAME: Remedy administrator user name
        • REMEDY_PASSWORD: Remedy user password
        • ITSM_AUTHORING_COMPANY: Support company name for imported templates
        • ITSM_AUTHORING_ORGANIZATION: Support organization name for imported templates
        • ITSM_AUTHORING_GROUP: Support group name for imported templates
      -J AO_CONTENT_INSTALL_TYPE=INSTALL_TYPE_CUSTOM

      AO_REPOSITORY_PROTOCOL

      Specifies the protocol used to access the repository.

      -J AO_REPOSITORY_PROTOCOL=http

      AO_REPOSITORY_HOST

      Specifies the hostname of IP address for the repository. The value cannot be a loopback address

      -J AO_REPOSITORY_HOST=111.11.111.111

      AO_REPOSITORY_PORT

      Specifies the port to access the repository

      -J AO_REPOSITORY_PORT=28080

      AO_REPOSITORY_USER_NAME

      Specifies the user name required to log on.

      -J AO_REPOSITORY_USER_NAME=admin

      AO_REPOSITORY_PASSWORD

      Specifies the password that corresponds to the user name.

      -J AO_REPOSITORY_PASSWORD=myPassword
  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_Content_options.txt

    Linux

    sh ./installCommand -i silent -DOPTIONS_FILE="fullPathToOptionsFile/optionsFile"
    sh ./setup.sh -i silent -DOPTIONS_FILE=tso_Content_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.


Next step in the installation process

Content can be installed anytime in the installation process. For more information about the components to install after content, see the Installing – Classic mode section. 

 

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