Performing the Remedy SSO installation with the TrueSight installer

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-to-install-Remedy-SSO-with-the-TrueSight-installer.

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:

4 postgreSQL packaged.png

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:

4 B postgre ext.png

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.

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.

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:

6 port.png

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:

7 cookie domain.png

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:

8 install summary.png

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:

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.

Log on as a root user.
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.