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

Where you are in the Upgrade process

Use this topic to upgrade Remedy SSO to the current version using the wizard-based TrueSight installer. The TrueSight installer for Remedy SSO automatically creates a backup directory during the upgrade process. You can locate the backup files and folders at <TrueSightRSSO_Install_dir>\TrueSightRSSO11.0.00.

To upgrade Remedy SSO using the wizard-based TrueSight installer

Do the following:

1. Log in to the host computer on which you want to upgrade Remedy SSO, and delete all the files from the temporary directory:

   • (Windows) %temp%
   • (Linux) /tmp
     

2. Extract the zipped files (the installer) that you downloaded in Step 2:Prepare for TrueSight Operations Management upgrade to a temporary location outside the following directory location to avoid any file sharing conflicts:

   • (Windows)C:\Program Files
   • (Linux) /opt
     
3. (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
4. Ensure that the Remedy SSO service is up and running. For more information on starting Remedy SSO, see Starting-and-stopping-the-TrueSight-Operations-Management-components.

5. If you have changed the database password of the earlier version of Remedy SSO, do the following:

   1. Encrypt the updated password by using the TrueSightRSSOMainatenanceTool that is available in the <rsso_installer>/utility directory.
   2. If you have changed the database admin password, open the <RSSO_HOME_DIR>/TrueSightRSSOInstalledConfiguration.xml file, and update the password against the DB_ADMIN_PWD and DB_ADMIN_CNFRM properties.
   3. If you have changed the RSSO user password, do the following:
      • Open the <RSSO_HOME_DIR>/TrueSightRSSOInstalledConfiguration.xml file, and update the password against the DB_USER_PWD and DB_PWD_CONFRM properties.
      • Open the <RSSO_HOME_DIR>/ rsso/conf/rssoproperties.conf file, and update the encrypted password.

6. 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
     
7. Failed to execute the [excerpt-include] macro.
   
8. Failed to execute the [excerpt-include] macro.
   
9. Select Yes to accept the Upgrade Confirmation and click Next.
10. Failed to execute the [excerpt-include] macro.
    
11. Click Install to start the upgrade.The installation may take up to 15 minutes.
    After the upgrade is complete, the Installation Summary page is displayed.
12. Failed to execute the [excerpt-include] macro.
    
13. Failed to execute the [excerpt-include] macro.
    
14. Failed to execute the [excerpt-include] macro.
    
15. Failed to execute the [excerpt-include] macro.
    

16. (Optional) If you have changed the Remedy SSO to the HTTP mode before upgrade, edit the web.xml file.

    1. Navigate to the following directory:
       • (Windows): <installationDirectory>\rsso\tomcat\conf
       • (Linux): <installationDirectory>/rsso/tomcat/conf

    2. Edit the web.xml file, comment the following part, and save the file:

       The commented code lines:

       <!-- 
       <security-constraint>

            <web-resource-collection>

               <web-resource-name>Secure context</web-resource-name>

               <url-pattern>/*</url-pattern>

            </web-resource-collection>

            <user-data-constraint>

                <transport-guarantee>CONFIDENTIAL</transport-guarantee>

            </user-data-constraint>

       </security-constraint>

       -->
17. Failed to execute the [excerpt-include] macro.
    

18. (Optional) If you have configured SAML authentication with your Remedy SSO enviornment, do the following:

    Reconfirgure the SAML authentication steps

    Failed to execute the [excerpt-include] macro.

19. Navigate to the <Remedy SSO Installation Directory>\rsso\bin directory, and restart the Remedy SSO server by running the following command:

    • (Windows) rsso.bat server start
    • (Linux) ./rsso server start

Troubleshooting upgrade failure

Do the following steps if the upgrade fails:

1. Backup the ProductRegistry.xml file.
   • (Windows) C:\Windows\ProductRegistry.xml
   • (Linux) /opt/bmc/ProductRegistry.xml
2. Navigate to the <TrueSightRSSO_install_dir> and delete the TrueSightRSSO folder.
3. Rename the TruesightRSSO11.0.00 folder to TruesightRSSO.
4. Restore the ProductRegistry.xml file.
5. Start the BMC Remedy SSO service.
6. Perform the upgrade procedure again.

Next step in the Upgrade process

Now that you have successfully upgraded Remedy SSO, you must proceed to Upgrading the Presentation Server.