Performing the Remedy SSO installation silently

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:

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

Property flagDescription
-PPrecedes directory properties
-JPrecedes Java properties
-A

Precedes application features

Installation properties

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

Installation properties

Property nameDescription
Installation
-P installLocation

Full path to the installation directory.

Default value:

  • Windows: C:\Program Files\BMC Software\TrueSightRSSO
  • Linux: /opt/bmc/TrueSightRSSO

Examples: 

  •  Windows: -P installLocation=C:\Program Files\BMC Software\TrueSight\TrueSightRSSO
  • Linux: -P installLocation=/opt/bmc/TrueSightRSSO
Feature selection
-A <Feature-Name>

Features that you want to install.

Leave the default value unchanged.

Default value: featureTrueSightRSSO

Example: -A featureTrueSightRSSO

Database settings

(Based on whether you plan to install PostgreSQL packaged with the installer or use an existing PostgreSQL instance, the values can differ for some of the properties.)

-J DB_TYPE

Type of database.

Leave the default value unchanged.

Default value: Postgres

Example: -J DB_TYPE=Postgres

-J DB_HOST
  • (PostgreSQL Packaged) Name of the computer on which you are running the installer.

    Note

    For a packaged PostgreSQL instance, the value must be localhost.

  • (PostgreSQL External) Name of the computer on which the existing database is running.

Default value: localhost

Example: -J DB_HOST=localhost

-J DB_PORT
  • (PostgreSQL Packaged) Port that you want to configure for connecting with the database.
  • (PostgreSQL External) Port used while installing the existing database.

Default value: 5438

Example: -J DB_PORT=5438

-J DB_POSTGRES_DBNAME
  • (PostgreSQL Packaged) Name with which you want to create the database.
  • (PostgreSQL External) Database name used while setting up the existing database instance.

    Note

    You cannot provide details of a PostgreSQL instance used with the Presentation Server.

Default value: rsso

Example: -J DB_POSTGRES_DBNAME=rsso

-J PG_TYPE
  • 0 indicates that you want to install PostgreSQL database packaged with the installer.
  • 1 indicates that you want to use an existing (or external) PostgreSQL instance.

Default value: 0

Example: -J PG_TYPE=0

-J DB_IS_USER_EXIST
  • true indicates that you want to use an existing user for managing PostgreSQL database operations (relevant for PostgreSQL External).
  • false indicates that you want to create a new database user for managing PostgreSQL database operations (relevant for PostgreSQL Packaged or PostgreSQL External with new user).

This input determines how the value of the DB_USER property is interpreted. If the value of this property is false, it means that the DB_USER value must be used for creating a new database user. However, if the value is true, it means the DB_USER value indicates an existing user name.

Default: false

Example: -J DB_IS_USER_EXIST=true

-J DB_ADMIN
  • (PostgreSQL Packaged) User name to be used for creating the database administrator user (superuser).
  • (PostgreSQL External) User name of an existing database administrator (superuser) for managing Remedy SSO operations.

This user is used for creating the database name and initializing the database.

Default value: postgres

Example: -J DB_ADMIN=postgres

Note: This input is automatically stored in lowercase.

-J DB_USER
  • (PostgreSQL Packaged) User name to be used for creating a database user for managing PostgreSQL database operations.
  • (PostgreSQL External) Based on whether you want to create a new user for managing PostgreSQL database operations, the value can be one of the following:
    • If you want to create a new user: User name to be used for creating a new database user
    • If you want to use an existing user: Existing database user name

Default value: rsso_user

Example: -J DB_USER=rsso_user

Note: This input is automatically stored in lowercase.

-J DB_ADMIN_PWD
  • (PostgreSQL Packaged) Password that you want to assign for the database administrator.
  • (PostgreSQL External) Password corresponding to the existing database administrator.

Example: -J DB_ADMIN_PWD=DES\:3d93ab9b35c5deea9d7d64484b0c78fc

Notes: You must encrypt the password and then specify the encrypted password as the value. For more information, see Encrypting the password for Remedy SSO installation.

-J DB_ADMIN_PWD_CNFRM

Re-enter the password specified for the DB_ADMIN_PWD property.

This input need not be provided if you want to install an existing PostgreSQL database instance and if you plan to use an existing user (superuser) for managing Remedy SSO operations.

Example: -J DB_ADMIN_PWD_CNFRM=DES\:3d93ab9b35c5deea9d7d64484b0c78fc

Note: You must encrypt the password and then specify the encrypted password as the value. For more information, see Encrypting the password for Remedy SSO installation.

-J DB_USER_PWD
  • (PostgreSQL Packaged) Password that you want to assign for the database user.
  • (PostgreSQL External) Based on whether you want to create a new user for managing Remedy SSO operations, the value can be one of the following:
    • If you want to create a new user: Password that you want to assign for the database user.
    • If you want to use an existing user: Password corresponding to the database user.

Example: -J DB_USER_PWD=DES\:4e14ab9b35c5dffa9d7d64484b0c78fd

Note: You must encrypt the password and then specify the encrypted password as the value. For more information, see Encrypting the password for Remedy SSO installation.

DB_USER_PWD_CNFRM

Re-enter the password specified for the DB_USER_PWD property.

This input need not be provided if you want want to install an existing PostgreSQL database instance and if you plan to use an existing user (superuser) for managing Remedy SSO operations.

Example: -J DB_USER_PWD_CNFRM=DES\:4e14ab9b35c5dffa9d7d64484b0c78fd

Note: You must encrypt the password and then specify the encrypted password as the value. For more information, see Encrypting the password for Remedy SSO installation.

Tomcat configuration details
TOMCAT_HTTP

HTTP port to be used for installing Remedy SSO.

Default values:

  • Windows: 88
  • Linux: 8088

Example: -J TOMCAT_HTTP_PORT=88

TOMCAT_HTTPS

HTTPS port to be used for installing Remedy SSO.

By default, the installer configures Remedy SSO with an HTTPS connection. If you use an HTTP connection, you must manually configure the setup as a post-installation activity. For more information see Setting up an HTTP connection for Remedy Single Sign-On.

Default value:

  • Windows: 448
  • Linux: 8048

Example: -J TOMCAT_HTTPS_PORT=448

Cookie domain details
-J COOKIE_DOMAIN

Cookie domain to be used for accessing Remedy SSO. The domain value of the cookie must be the network domain of Remedy SSO or one of its parent domains.

Default value: bmc.com

Example: -J COOKIE_DOMAIN=bmc.com

Note:

For a successful authorization, the Presentation Server domain name and the the Remedy SSO cookie domain must belong to the same network domain or one of the parent domains.

  • Example: Correct use of cookie domain
    • xyz.com is the cookie domain of Remedy SSO
    • <tspshostname>.abc.xyz.com is the Presentation Server FQDN
  • Example: Wrong use of cookie domain
    • xyz.com is the cookie domain of Remedy SSO 
    • <tspshostname>.abc.lmn.com is the Presentation Server FQDN
-J SERVER_FQDN

Fully qualified domain name of the server on which you are installing Remedy SSO.

Default value: example.bmc.com

Example: -J SERVER_FQDN=example.bmc.com

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

Where to go from here

Configuring the general settings in the Remedy Single Sign-On server

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

Was this page helpful? Yes No Submitting... Thank you

Comments