Installing Remedy SSO in the high-availability mode silently
Where are you in the Installation process
Step | Task |
---|---|
1 | Complete the planning activities |
2 | Preparing for TrueSight Capacity Optimization installation |
3 | Install Remedy Single Sign-On — Phase A (You are here) |
Install Remedy Single Sign-On — Phase B | |
4 | Install TrueSight Presentation Server |
5 | Install TrueSight Capacity Optimization Application Server and ETL Engine |
6 | Install TrueSight Capacity Optimization Gateway Server |
7 | Install TrueSight Capacity Optimization Capacity Agent |
8 | Complete the post-installation activities |
To install Remedy SSO in the high-availability mode silently
Remedy Single Sign-On high-availability environment is implemented as a redundant system with session failover. If the primary node fails, the load is transitioned to the secondary node with minimal interruption.
In a high-availability (HA) environment, multiple instances of the Remedy Single Sign-On (Remedy SSO) web application are deployed to form a cluster. Usually, a load balancer is used as a front end to the cluster, giving the external applications the appearance of a single server. The load balancer distributes requests among Remedy SSO nodes. However, there is no requirement for a sticky session, because requests can be handled by any instance.
You need to perform the following tasks to install Remedy SSO in a high-availability mode:
The silent (or unattended) installation obtains the required user inputs from the tsso_silent.options file, which is bundled along with the installer.
Step A: Install Remedy SSO on the primary computer
Log in to the host computer on which you want to install Remedy SSO, and delete all the files from the temporary directory:
- (Windows) %temp%
(Linux) /tmp
Extract the downloaded zip files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows)C:\Program Files
(Linux) /opt
You will need to type the database administrator and database user passwords in an encrypted form in the tsso_silent.options file in Step 5. You can encrypt these passwords using the TrueSightRSSOMaintenanceTool through the wizard or command line interface:
In the extracted folder, locate the tsso_silent.options file:
(Windows)<DownloadLocation>\RSSO\Windows\Disk1\
(Linux) <DownloadLocation>/RSSO/Linux/Disk1/
Open and edit the tsso_silent.options file. You can either retain the default values for the properties or change them, and save the file. The tsso_silent.options is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair.
From the command prompt, run the following command to start the installation. Type the complete path to the tsso_silent.options file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.
A local installation may take up to 15 minutes.
Syntax:- (Windows)
setup.exe -i silent -DOPTIONS_FILE="<
path_to_tsso_silent.options_file>"
- (Linux)
./setup.bin -i silent -DOPTIONS_FILE="<
>"path_to_tsso_silent.options_file
Examples:
- (Windows - Path without space)
setup.exe -i silent -DOPTIONS_FILE=C:\Disk1\tsso_silent.options
- (Windows - Path with space)
setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\tsso_silent.options"
- (Linux - Path without space)
./setup.bin -i silent -DOPTIONS_FILE=/opt/Disk1/tsso_silent.options
- (Linux - Path with space)
./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/tsso_silent.options"
- (Windows)
You can periodically check the installation status by checking the truesightrsso_install_log.txt file located at:
- (Windows)%temp%
(Linux) /tmp
- Search for the following log message in the truesightrsso_install_log.txt file to ensure that Remedy SSO is installed successfully:
Remedy Single Sign-On 18.02.00 for TrueSight 11.3.01 install succeeded.
Note:
BMC Recommends that you also open the remedysso_install_log.txt log file and verify if there are warnings and errors that need to be fixed. Contact BMC Support for Remedy SSO to fix any unresolved errors or warnings.
- (Windows)<installationDirectory>\rsso\RemedySSO\logs\
(Linux) <installationDirectory>/rsso/RemedySSO/logs
Verify that the following environment variable points to the Remedy SSO installation path:
(Windows) %TRUESIGHTRSSO_HOME%
(Linux) $TRUESIGHTRSSO_HOME
You can either construct the Remedy SSO URL or locate the URL in the log file:
- To define the URL, use the format: http(s)://<rsso_servername_FQDN>:<tomcat_port>/rsso
- To locate the URL:
- Open the truesightrsso_install_log.txt log file from:
- (Windows)<installationDirectory>\rsso\logs\
(Linux) <installationDirectory>/rsso/logs
Search for the LOG EVENT that has the product URL as shown in the following example:
(Windows)
LOG EVENT {Description=[PRODUCT URL],Detail=[product url: https://HostA.bmc.com:448/rsso]}
(Linux)
LOG EVENT {Description=[PRODUCT URL],Detail=[product url: https://HostA.bmc.com:8048/rsso]}
- Open the truesightrsso_install_log.txt log file from:
Launch the Remedy SSO URL in a browser and log in to the Remedy SSO console using the default Admin credentials:
User name: Admin
Password: RSSO#Admin#
- Change the password for the Admin user. Click Admin > Change Password.
Log out of the Remedy SSO console, and log in with the new Admin credentials.
Your installation is complete if you are a Windows user.
- (Linux) Configure the Remedy SSO service to restart automatically each time the Remedy SSO server is restarted:
- Log in to the host computer as a root user.
From the command line, go to <installationDirectory>/rsso/bin, and run the following command:
./rsso service register <nonRootUserName><nonRootUserName> refers to the name of the non-root user that you used for installing Remedy SSO.
Your installation is complete.
Step B: Install Remedy SSO on the secondary computer
Log in to the host computer on which you want to install Remedy SSO, and delete all the files from the temporary directory:
- (Windows) %temp%
(Linux) /tmp
Extract the downloaded zip files (the installer) to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows)C:\Program Files
(Linux) /opt
You will need to type the database administrator and database user passwords in an encrypted form in the tsso_silent.options file in Step 5. You can encrypt these passwords using the TrueSightRSSOMaintenanceTool through the wizard or command line interface:
In the extracted folder, locate the tsso_silent.options file:
(Windows)<DownloadLocation>\RSSO\Windows\Disk1\
(Linux) <DownloadLocation>/RSSO/Linux/Disk1/
Open and edit the tsso_silent.options file. You can either retain the default values for the properties or change them, and save the file. The tsso_silent.options is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair.
From the command prompt, run the following command to start the installation. Type the complete path to the tsso_silent.options file in the command. If the path includes a blank space, enclose the path within double quotes. However, installation occurs in the background.
A local installation may take up to 15 minutes.
Syntax:- (Windows)
setup.exe -i silent -DOPTIONS_FILE="<
path_to_tsso_silent.options_file>"
- (Linux)
./setup.bin -i silent -DOPTIONS_FILE="<
>"path_to_tsso_silent.options_file
Examples:
- (Windows - Path without space)
setup.exe -i silent -DOPTIONS_FILE=C:\Disk1\tsso_silent.options
- (Windows - Path with space)
setup.exe -i silent -DOPTIONS_FILE="C:\temp folder\Disk1\tsso_silent.options"
- (Linux - Path without space)
./setup.bin -i silent -DOPTIONS_FILE=/opt/Disk1/tsso_silent.options
- (Linux - Path with space)
./setup.bin -i silent -DOPTIONS_FILE="/opt/temp folder/Disk1/tsso_silent.options"
- (Windows)
You can periodically check the installation status by checking the truesightrsso_install_log.txt file located at:
- (Windows)%temp%
(Linux) /tmp
- Search for the following log message in the truesightrsso_install_log.txt file to ensure that Remedy SSO is installed successfully:
Remedy Single Sign-On 18.02.00 for TrueSight 11.3.01 install succeeded.
Note:
BMC Recommends that you also open the remedysso_install_log.txt log file and verify if there are warnings and errors that need to be fixed. Contact BMC Support for Remedy SSO to fix any unresolved errors or warnings.
- (Windows)<installationDirectory>\rsso\RemedySSO\logs\
(Linux) <installationDirectory>/rsso/RemedySSO/logs
Verify that the following environment variable points to the Remedy SSO installation path:
(Windows) %TRUESIGHTRSSO_HOME%
(Linux) $TRUESIGHTRSSO_HOME
You can either construct the Remedy SSO URL or locate the URL in the log file:
- To define the URL, use the format: http(s)://<rsso_servername_FQDN>:<tomcat_port>/rsso
- To locate the URL:
- Open the truesightrsso_install_log.txt log file from:
- (Windows)<installationDirectory>\rsso\logs\
(Linux) <installationDirectory>/rsso/logs
Search for the LOG EVENT that has the product URL as shown in the following example:
(Windows)
LOG EVENT {Description=[PRODUCT URL],Detail=[product url: https://HostA.bmc.com:448/rsso]}
(Linux)
LOG EVENT {Description=[PRODUCT URL],Detail=[product url: https://HostA.bmc.com:8048/rsso]}
- Open the truesightrsso_install_log.txt log file from:
Launch the Remedy SSO URL in a browser and log in to the Remedy SSO console using the default Admin credentials:
User name: Admin
Password: RSSO#Admin#
- Change the password for the Admin user. Click Admin > Change Password.
Log out of the Remedy SSO console, and log in with the new Admin credentials.
Your installation is complete if you are a Windows user.
- (Linux) Configure the Remedy SSO service to restart automatically each time the Remedy SSO server is restarted:
- Log in to the host computer as a root user.
From the command line, go to <installationDirectory>/rsso/bin, and run the following command:
./rsso service register <nonRootUserName><nonRootUserName> refers to the name of the non-root user that you used for installing Remedy SSO.
Your installation is complete.
Step C: Set up and configure the load balancer details
Set up the load balancer on a host computer other than the primary and secondary Remedy SSO host computers. Refer to the specific load balancer documentation or ask the vendor for details about the configuration.
Next step in the Installation process
Step 3 Phase B — Now that you have successfully installed Remedy SSO, you must set up the Remedy SSO server.
Comments