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.
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
Read the license agreement and agree to the terms.
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:
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:
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.
| Field | Description |
|---|---|
| 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 Password | Password that you want to assign for the database administrator. |
| Confirm Password | Re-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 Password | Password that you want to assign for the database user. |
| Confirm Password | Re-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.
| Field | Description |
|---|---|
| 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 Password | Password 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 Password | Password that you want to assign for the database user. |
| Confirm Password | Re-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 Password | Password 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):
| |
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:
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
- Example: Correct use of cookie domain
The following image displays the domain configuration screen:
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:
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
To exit the installation program, click Done.
Depending on your platform, the following environment variable pointing to the product installation path is automatically set:
| Windows | Linux |
|---|---|
| %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.
- 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.
Comments
Log in or register to comment.