Installing Remedy SSO in the standalone mode using the wizard
Where you are 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 using the wizard
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
Run the installer:
(Windows) As an administrator or as a non-administrator user, run setup.exe from Windows\Disk1
(Linux) As a non-root user, run ./setup.bin from Linux/Disk1
(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
Review the welcome page, and click Next.
Read the license agreement, agree to the terms, and click Next.
Review disk space requirements. If required, you can change the default installation directory, and click Next:
(Windows) C:\Program Files\BMC Software\TrueSightRSSO
(Linux) /opt/bmc/TrueSightRSSO
Select a database type.
- PostgreSQL - Packaged: Select this option to install the PostgreSQL database packaged with the TrueSight installer.
- PostgreSQL - External: Select this option to use an existing PostgreSQL database instance.
- PostgreSQL - Packaged: Select this option to install the PostgreSQL database packaged with the TrueSight installer.
Type the database details such as host name, database name, and port number based on the database type selected, and click Next.
If you have selected PostgreSQL - Packaged: You can choose to retain the following default values or type new values.
Database Name: rsso
Database port: 5438
If you have selected PostgreSQL - External: Type the details of the existing PostgreSQL database that you are planning to use.
If you have selected PostgreSQL - Packaged, you can retain the following default values for database admin and database user names, or type new values:
Database Admin user name: postgres
Database user name: rsso_user
Type the passwords, and confirm them, and click Next. Go to Step 14.
If you have selected PostgreSQL - External, select one of the following user options:
Create New User: Create a new user for managing Remedy SSO operations.
Use Existing User: Use the existing database administrator user (superuser) for managing Remedy SSO operations.
Based on your selection, do one of the following:
- If you have selected PostgreSQL - External - Create New User, type the database admin and user name details, type the respective passwords, and confirm them, and click Next.
- If you have selected PostgreSQL - External - Use Existing User, type the database admin name and password details, and click Next.
- If you have selected PostgreSQL - External - Create New User, type the database admin and user name details, type the respective passwords, and confirm them, and click Next.
Type the Tomcat port details that you want to use to communicate with Remedy SSO. You can retain the following default port values or type new values. Click Next:
- (Windows) HTTP: 88 and HTTPS: 448
- (Linux) HTTP: 8088 and HTTPS: 8048
By default, the installer configures Remedy Single Sign-On in HTTPS. If you want to use HTTP, you must manually configure it anytime as a post-installation activity
.
Configure the cookie domain and Server FQDN details, and click Next.
This is the cookie domain that you want to use to access Remedy SSO. It must be same as the network domain of host computer on which you are installing Remedy SSO or one of its parent domains. For example: If the host computer on which you want to install Remedy SSO belongs to apps.bmc.com, then your cookie domain must be bmc.com.
Preview the details, and verify the configurations.
Click Install to start the installation. A local installation may take up to 15 minutes.
After the installation is complete, the Installation Summary page is displayed.Click View log to view the installation log details on the screen. From the log view, you can expand and view the log messages.
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
Click Done to exit the installation program.
Verify that the following environment variable points to the Remedy SSO installation path:
(Windows) %TRUESIGHTRSSO_HOME%
(Linux) $TRUESIGHTRSSO_HOME
On Windows, do the following to verify the path :
- Open a New Admin Command Prompt
- Type
echo %TRUESIGHTRSSO_HOME%
(Alternatively) On Windows, you can navigate to System > Advanced System Settings > Environment Variables > System Variables lower panel to verify the path
You can either construct the Remedy SSO URL or locate the URL in the log file:
- To construct 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. The user name and password are case sensitive. Use the following 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.
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
Step 22 - The user name and password are case sensitive. Should be bolded. Case sensitive name messes with me every time.