Preparing for the Presentation Server upgrade

Before upgrading the TrueSight Presentation Server, ensure that you review and complete the following prerequisite activities and requirements.

Related topic

Installing-Remedy-SSO

Upgrading-the-Presentation-Server

Preparing-for-the-Presentation-Server-installation

Data migration before upgrading the Presentation Server

Migrating-internal-user-data-from-Atrium-Single-Sign-On-to-Remedy-Single-Sign-On

Customizing-configuration-files-in-the-Presentation-Server

To prepare the TrueSight Presentation Server for upgrading

  1. Review the system requirements for the TrueSight Presentation Server 11.0 and if required, upgrade them.
  2. Manually back up the database by using the tssh database startbackup command.
  3. Install Remedy Single Sign-On for enabling single sign-on access to TrueSight Presentation Server and its associated components.
  4. After installing Remedy SSO, migrate internal user data from Atrium Single Sign-On to Remedy Single Sign-on. For details, see Migrating-internal-user-data-from-Atrium-Single-Sign-On-to-Remedy-Single-Sign-On.
  5. If you have custom security certificates for the internal communication between the TrueSight Presentation Server and TrueSight App Visibility Manager, ensure that your files are not overwritten by the upgrade process. See instructions  in Applying-private-certificates-between-the-App-Visibility-portal-and-the-Presentation-Server.
  6. Ensure to close all the files and folders opened in the current session as well as close other user sessions on the server before starting an upgrade.
  7. Ensure that the environment variable TRUESIGHTPSERVER_HOME is set to the Presentation Server installation folder.
  8. Manually stop any components that are directly connected to the Presentation Server (for example, Infrastructure Management or App Visibility Manager).
  9. Ensure that you back up the following files before the upgrade:
    • /opt/bmc/ProductRegistry.xml file. This file must contain the details of the currently installed product such as the installation directory and product version. If the ProductRegistry.xml file is not available, contact BMC Support.
    • <Installation_Directory>/TrueSightPServer/TrueSightPServerInstalledConfiguration.xml file.
  10. Ensure that the /opt/bmc/ProductRegistry.xml file is present with the installed product details such as the installation directory path and the product version. If the ProductRegistry.xml is not available, contact BMC Support.
  11. If the Presentation Server is in the high-availability mode, do the following:
    1. Stop the primary and secondary Presentation Server.
    2. On both the primary and the secondary servers, do the following:
      1. Tar or zip the TRUESIGHTPSERVER_HOME directory.
      2. Back up the /opt/bmc/ProductRegistry.xml and /opt/bmc/ProductRegistry.xsd files.
    3. Start the primary Presentation Server.
    4. Ensure that the logon page is displayed before starting the upgrade.
  2. Ensure that the TrueSight Presentation Server is running before starting the upgrade. If the TrueSight Presentation Server is not running, start it by running the following command:
    • (Windows) tssh server start

    • (Linux)./tssh server start

      Note

      You must wait for the status of the TrueSight Presentation Server to be Running before starting the upgrade process.

  3. Run the dataUpgrade utility to migrate the data format. For more information, see Migrating-the-data-format-before-upgrading-the-Presentation-Server.

    Note

    Do not run the dataUpgrade utility and migrate internal user data from Atrium SSO to Remedy SSO utility at the same time.

    RAM requirement

    Before your run this utility, at least 2 GB RAM must be available.

Upgrade on a Linux host

If you are upgrading or installing the TrueSight Presentation Server on a Linux host, the following system configurations are required:

Failed to execute the [excerpt-include] macro. Cause: [Error number 2 in 0: No wiki with id [confluencePage:page] could be found]. Click on this message for details.

Customized configuration files

While upgrading the TrueSight Presentation Server from versions 10.5 or later, the following configuration files are copied from the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\services to the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory:
  -csr.conf
  -idxsrv.conf
  -dbsrv.conf
If you have customized any of the above files for system arguments, your changes for the following properties are retained according to the following table:

Notes

- If you have customized any other properties, you must manually merge the changes in the respective files in the  %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory.

- After the upgrade, the configuration files in the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory are given preference over the files in the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\services directory.

Where to go from here

If you have migrated the data format as given in Migrating-the-data-format-before-upgrading-the-Presentation-Server, upgrade the TrueSight Presentation Server using one of the following procedures:

 

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