Installing Remedy SSO in the standalone mode using the TrueSight installer wizard

Where you are in the Installation process


To install Remedy SSO using the wizard-based TrueSight installer

  1. 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

  2. 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

  3. 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
  4. (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
  5. Review the welcome page, and click Next.
  6. Read the license agreement, agree to the terms, and click Next.

  7. 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

  8. Select a database type.

    • PostgreSQL - Packaged: Select this option to install the PostgreSQL database packaged with the TrueSight installer.
      tssowiz_dbpkgd_v11301.png
    • PostgreSQL - External: Select this option to use an existing PostgreSQL database instance.
      tssowiz_dbext_v11301.png

  9. 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.

  10. 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

    tssowiz_dbpkgUsers_v11301.png

  11. Type the passwords, and confirm them, and click Next. Go to Step 14.

  12. 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.

  13. 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.

      tssowiz_dbextNewusr_v11301.png
    • If you have selected PostgreSQL - External - Use Existing User, type the database admin name and password details, and click Next.

      tssowiz_dbextExistusr_v11301.png


  14. 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.
    tssowiz_tomcatport_v11301.png

  15. 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.

    tssowiz_fqdn_v11301.png

  16. Preview the details, and verify the configurations.
  17. 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.

  18. 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
  19. Click Done to exit the installation program.

  20. 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 :
      1. Open a New Admin Command Prompt
      2. 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
      verify_env_variable_rsso.png

  21. 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:
      1. Open the truesightrsso_install_log.txt log file from:
        • (Windows)<installationDirectory>\rsso\logs\
        • (Linux) <installationDirectory>/rsso/logs
      2. 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]}

  22. 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#
  23. Change the password for the Admin user. Click Admin > Change Password.

  24. 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.

  25. (Linux) Configure the Remedy SSO service to restart automatically each time the Remedy SSO server is restarted:

    1. Log in to the host computer as a root user.

    2. 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.

Post-installation - Applying the hotfix or patch

Remedy SSO latest patches and hot fixes

  • If you have Remedy Single Sign-On installed, you must check and apply the relevant patches for a seamless integration with the TrueSight Presentation Server.
  • Before proceeding with the patch installation, if the TrueSight Presentation Server is running, stop the TrueSight Presentation Server and back up Remedy Single Sign-On.
  1. Extract the downloaded hotfix file into a temporary location. For example, RSSO_9103001_2018MAY18_CU_ALL.zip or RSSO_1808_2018NOV23_CU_ALL to a /temp folder.
  2. Stop the Remedy SSO server Tomcat service.
  3. Copy all the folders and files in <RSSO_TOMCAT>/webapps/rsso folder into a backup folder.
    <RSSO_TOMCAT> is the directory of tomcat where RSSO webapp is deployed.
  4. Copy the following files from the server folder in the extracted hotfix zip file into their corresponding paths in <RSSO_TOMCAT>/webapps/rsso folder:
    • (Linux)
      WEB-INF/classes/com/bmc/rsso/admin/service/BaseConfigService.java
      WEB-INF/classes/com/bmc/rsso/admin/local/servlet/SearchLocalUserServlet.java
      WEB-INF/classes/com/bmc/rsso/data/idps/IdPLDAP.class
      WEB-INF/lib/core-<rsso_ver>.jar
      WEB-INF/lib/common-<rsso_ver>.jar
    • (Windows)
      WEB-INF\classes\com\bmc\rsso\admin\service\BaseConfigService.java
      WEB-INF\classes\com\bmc\rsso\admin\local\servlet\SearchLocalUserServlet.java
      WEB-INF\classes\com\bmc\rsso\data\idps\IdPLDAP.class
      WEB-INF\lib\core-<rsso_ver>.jar
      WEB-INF\lib\common-<rsso_ver>.jar
  5. Restart the Remedy SSO server Tomcat service.


Rollback the hotfix update

If you have to rollback the hotfix, do the following:


    1. Stop the Remedy SSO server Tomcat service.
    2. Delete all the folders and files in <RSSO_TOMCAT>/webapps/rsso folder.
    3. Restore the folders and files from the backup folder created in Step 3.

Troubleshooting installation issues

If you face issues during installation, see Troubleshooting the Remedy Single Sign-On server deployment.

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. 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*