Performing the Remedy Single Sign-On installation

This section provides instructions for installing Remedy Single Sign-On 9.1.03.001 by using the TrueSight installer (wizard).

The steps involved in the installation are the same for both Windows and Linux platforms.

You can install Remedy Single Sign-On (or Remedy SSO) as an administrator or as a non-administrator user on Windows. If you are using a non-administrator user for installation, make sure that the non-administrator user is a part of the Administrators group. On Linux, you can perform the installation as a non-root user only.

The following information can guide you step-by-step for performing a wizard-based installation:

Before you begin

Review and complete the tasks listed at Preparing for the Remedy Single Sign-On installation.

To install Remedy SSO

Perform the following steps to install Remedy SSO. Navigate through the installation wizard by clicking Next.

Step 1: Start the installation program

Run the setup.exe (for Windows) or ./setup.bin (for Linux) file.

Note: (Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately:

export DISPLAY=<IP address of the host computer>:0.0

Step 2: Agree to the terms of use

Read the license agreement and agree to the terms.

Step 3: Review disk space requirements and choose the installation location

Review the disk space requirements and change the install location, if needed.

You can change the directory location by clicking Browse

The directory location defaults to the following:

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

The following image displays the directory selection screen:


Step 4: Configure the database settings

You can choose to perform a fresh installation or use an existing PostgreSQL database instance:

  • PostgreSQL - Packaged: Select this option to install the PostgreSQL database packaged with the installer.
  • PostgreSQL - External: Select this option to use an existing PostgreSQL database instance. For a high-availability installation, you must select this option.

Note

When you select the PostgreSQL - External option, you cannot provide details of a PostgreSQL instance used with the Presentation Server.

Based on the selected database type, you need to provide the following inputs. You can choose to accept the default values or assign new values.

If you selected PostgreSQL - Packaged:

  • Host Name: Host name of the computer on which you are running the installer. (Default: localhost).
  • Database Name: Name with which you want to create the database (Default: rsso).
  • Database Port: Port that you want to configure for connecting with the database (Default: 5438).

The following image displays the screen with PostgreSQL - Packaged database type selected:

If you selected PostgreSQL - External:

  • Host Name: Computer on which the existing database is running.
  • Database Name: Database name used while setting up the existing database instance (Default: rsso).
  • Database Port: Port used while installing the existing database (Default: 5438).

The following image displays the screen with PostgreSQL - External database type selected:

Step 5: Configure the required user accounts

Based on the database type selected, provide the following information for setting up the required user accounts.

If you selected PostgreSQL - Packaged database type in step 4, provide the information specified in the following table.

See the inputs required, if you selected PostgreSQL - External database type in step 4.

FieldDescription
Inputs specific to PostgreSQL - Packaged database
Database Admin User Name

User name to be used for creating the database administrator user (superuser).

This user is used creating the database name (specified in step 4) and initializing the database.

Note: This input is automatically stored in lowercase.

(Default: postgres)

Database Admin PasswordPassword that you want to assign for the database administrator.
Confirm PasswordRe-enter the password specified in the Database Admin Password box.
Database User Name

User name to be used for creating a database user for managing PostgreSQL database operations.

Note: This input is automatically stored in lowercase.

(Default: rsso_user)

Database User PasswordPassword that you want to assign for the database user.
Confirm PasswordRe-enter the password specified in the Database Password (RSSO) box.
Note: The user name specified for the database administrator user (superuser) and the Remedy Single Sign-On user cannot be the same.

The following image displays the screen that allows you to set up user accounts for the PostgreSQL - Packaged database.

If you selected PostgreSQL - External database type in step 4, select one of the following options and specify additional inputs relevant to the option selected.

  • Create New User: Indicates that you want to create a new user for managing Remedy Single Sign-On operations.
  • Use Existing User: Indicates that you want to use the existing database administrator user (superuser) for managing Remedy Single Sign-On operations.

Based on the option selected, provide the information specified in the following table.

FieldDescription
Inputs specific to PostgreSQL - External > Create New User
Database Admin User Name

User name of the existing database administrator (superuser).

This user is used creating the database name (specified in step 4) and initializing the database.

Note: This input is automatically stored in lowercase.

(Default: postgres)

Database Admin PasswordPassword corresponding to the database administrator.
Database User Name

User name to be used for creating a database user for managing PostgreSQL database operations.

Note: This input is automatically stored in lowercase.

(Default: rsso_user)

Database User PasswordPassword that you want to assign for the database user.
Confirm PasswordRe-enter the password specified in the Database Password (RSSO) box.
Note: The user name specified for the database administrator user (superuser) and the Remedy Single Sign-On user cannot be the same.

The following image displays the screen that allows you to set up user accounts for the PostgreSQL - External database (with the Create New User option selected):

Inputs specific to PostgreSQL - External > Use Existing User
Database User Name

Existing database user name to be used for managing PostgreSQL database operations.

Note: This input is automatically stored in lowercase.

Database User PasswordPassword corresponding to the database user.

The following image displays the screen that allows you to set up user accounts for the PostgreSQL - External database (with the Use Existing User option selected):

Step 6: Configure the Tomcat ports

Accept the following default port values or specify new values. These ports are used by Tomcat for communicating with Remedy Single Sign-On.

By default, the installer configures Remedy Single Sign-On with an HTTPS connection. If you use an HTTP connection, you must manually configure the setup as a post-installation activity.

  • HTTP Port: Port number for configuring an HTTP connection.
    Default values:
    • (Windows): 88
    • (Linux): 8088
  • HTTPS Port: Port number for configuring an HTTPS connection.
    Default values:
    • (Windows): 448
    • (Linux): 8048

The following image displays the screen that allows you to configure the Tomcat ports:

Step 7: Configure the cookie domain

Provide the following inputs:

  • Cookie Domain: Cookie domain to be used for accessing Remedy Single Sign-On. The domain value of the cookie must be the network domain of Remedy Single Sign-On or one of its parent domains.
  • Server FQDN: Fully qualified domain name of the server on which you are installing Remedy Single Sign-On.

    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


The following image displays the domain configuration screen:


Step 8: View the installation preview and start the installation

The installation preview provides information about the features to be installed, the disk space required, the destination directory, the database settings, and so on.

Click Install to start the installation. It might take a few minutes for the installation to complete.

The following image displays the installation summary screen:


Step 9 (Optional): View the log details

Click View log to see the log details. This is an optional step.

You can also view the installation log by navigating to the following directory:

  • (Windows) <installation_directory>\rsso\logs/truesightrsso_install_log.txt  
  • (Linux) <installation_directory>/rsso/logs/truesightrsso_install_log.txt
Step 10: Complete the installation

To exit the installation program, click Done

Depending on your platform, the following environment variable pointing to the product installation path is automatically set:

WindowsLinux
%TRUESIGHTRSSO_HOME%$TRUESIGHTRSSO_HOME

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

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

Comments