Performing the Remedy SSO installation silently with the TrueSight installer


This topic provides instructions for performing a silent installation of Remedy Single Sign-On (or Remedy SSO) by using the TrueSight installer.  A silent (or unattended) installation obtains the required user input or installation settings from an options file.

This file defines installation settings such as the type of installation, the database settings, the cookie domain details, and so on. 

The following information can help you understand the silent installation properties and the process involved in performing the installation:

Before you begin

Review and complete the tasks listed at Preparing-to-install-Remedy-SSO-with-the-TrueSight-installer.

To install Remedy SSO silently


  1. Log on to the computer on which you want to perform the silent installation.
  2. Locate the tsso_silent.options file from the following location:
    • Windows: <DownloadLocation>\RSSO\Windows\Disk1\
    • Linux: <DownloadLocation>/RSSO/Linux/Disk1/
  3. Edit the options file, specify values for the properties, and then save the file.
    For more information, see Silent installation properties.
  4. Run the following command, as appropriate:

    • Windows: setup.exe -i silent -DOPTIONS_FILE="<pathToOptionsFile>"
    • Linux: ./setup.bin -i silent -DOPTIONS_FILE="<pathToOptionsFile>"

      In the preceding command syntax, <pathToOptionsFile> refers to the complete path to the options file. If the file name or path includes a space, enclose the file path in double quotes.

    Examples:

    • Windows: setup.exe -i silent -DOPTIONS_FILE="C:\Disk1\tsso_silent.options"
    • Linux: ./setup.bin -i silent -DOPTIONS_FILE="/opt/Disk1/tsso_silent.options"

Silent installation properties

This section provides information about property values listed in the silent installation options file. This file is a text file that defines the same inputs as those required while running the installation wizard. The installation properties are in the form of a prefix tag followed by a property name and value pair.
 

Prefix tags

The following table lists the prefix tags that precede the installation properties.

Prefix tags for silent installation properties

Installation properties

The following table lists the installation properties that succeed the prefix tags.

Installation properties

Encrypting the password for Remedy SSO installation

The Maintenance Tool enables you to create an encrypted password that Remedy SSO requires for providing the password input for accessing the PostgreSQL database. You must use an encrypted password so that the password is not exposed in the silent options file.

You can run the Maintenance Tool in a GUI or from the command line interface (CLI), as follows:

To encrypt the password by using the Maintenance Tool in a GUI

  1. Open the Maintenance Tool by navigating to the following directory:
    • Windows: <DownloadLocation>\RSSO\Windows\Disk1\Utility
    • Linux: <DownloadLocation>/RSSO/Linux/Disk1/Utility 
  2. Run the TrueSightRSSOMaintenanceTool utility and click the Encrypt tab.
  3. Enter the password in the Password and Confirm Password fields and click Encrypt.
  4. Copy the encrypted password (from the Encrypted Password field) as the value of the relevant password parameters in the silent options file.
    Example:-J DB_ADMIN_PWD=DES\:3d93ab9b35c5deea9d7d64484b0c78fc

To encrypt the password by using the Maintenance Tool with the CLI

  1. Navigate to the following directory to locate the Maintenance Tool.
    • Windows: <DownloadLocation>\RSSO\Windows\Disk1\Utility
    • Linux: <DownloadLocation>/RSSO/Linux/Disk1/Utility
  2. Run the following command:

    • Windows: TrueSightRSSOMaintenanceTool.cmd -silent -encrypt -encrypt -password=<password> -confirm_password=<password>
    • Linux: ./TrueSightRSSOMaintenanceTool.sh -silent -encrypt -encrypt -password=<password> -confirm_password=<password>

    In the preceding commands, <password> refers to the password that you want to encrypt.

    Note

    (For Linux) If you are using a password that contains special characters, make sure you add the password in single quotes.

    Example: ./TrueSightRSSOMaintenanceTool.sh -silent -encrypt -encrypt -password='<password>' -confirm_password='<password>'

  3. Copy the resulting encrypted password output as the value of the relevant password parameters in the silent options file.
    Example:-J DB_ADMIN_PWD=DES\:3d93ab9b35c5deea9d7d64484b0c78fc

Post-installation task for Linux

On a Linux server, configure the Remedy Single Sign-On service to automatically start each time the Remedy SSO server is restarted.

  1. Log on as a root user.
  2. Navigate to <installationDirectory>/rsso/bin and run the following command.
    ./rsso service register <nonRootUserName>
    In the preceding command, <nonRootUserName> refers to the name of the non-root user with which you installed Remedy Single Sign-On.

Accessing Remedy SSO after installation

The product URL and default user credentials are:

  • URL: http(s)://<HostName>:<Port>/rsso
  • User name: Admin; Password: RSSO#Admin#

You can also find the product URL in the truesightrsso_install_log.txt log file located at:

  • (Windows) <installationDirectory>\rsso\logs\
  • (Linux) <installationDirectory>/rsso/logs/

For example, see the product URL in the following log line:

LOG EVENT {Description=[PRODUCT URL],Detail=[product url: https://HostA.bmc.com:8048/rsso]}

Note

After you log on to Remedy Single Sign-On for the first time, change the password corresponding to the default user.

Where to go from here

Configure Remedy SSO general settings

If you use an HTTP connection, you must manually configure the setup as a post-installation activity.

 

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