Preparing to upgrade the Presentation Server

Before upgrading the TrueSight Presentation Server, ensure that your environment meets the upgrade requirements, and complete the tasks described in this section.

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.

Complete the pre-upgrade tasks

  1. Review the System requirements for Presentation Server to ensure that your system meets the new requirements before starting the upgrade.

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

  3. As a best practice and to avoid a file lock happening during the upgrade process, exclude the installation directory from the on-access virus scanner. For more information, see Disable on-access virus scanners.

  4. Stop any components that are connected to the TrueSight Presentation Server (for example, Infrastructure Management or App Visibility Manager).
  5. Verify and ensure that the following properties in the <Installation_Directory>/TrueSightPServer/TrueSightPServerInstalledConfiguration.xml file is up-to-date. Update them, if required:
    • TrueSight_sso_hostname 
    • TrueSight_sso_port
    • TrueSight_sso_protocol
    • TrueSight_sso_password
    • IS_SSO_SERVER_CERTIFICATE
    • SSO_CERTIFICATE_HOME
  6. Back up the following:
    • Database: Run the tssh database startbackup command to back up the database.
    • Files: Manually back up the following files:
      • /opt/bmc/ProductRegistry.xml (Linux)
      • C:\Windows\ProductRegistry.xml (Windows)
        (This file contains details about the currently installed product such as the installation directory, product version, and so on. If the ProductRegistry.xml file is not present, contact BMC Support.)
      • <Installation_Directory>/TrueSightPServer/TrueSightPServerInstalledConfiguration.xml

  7. Ensure that the TrueSight Presentation Server is running before starting the upgrade.  For information about starting the service, see Starting and stopping the TrueSight Operations Management components.

    Note

    Before starting the upgrade, ensure that the status of the TrueSight Presentation Server is Running.

  8. Close all the files and folders opened in the current session. Also, close other user sessions on the server before starting the upgrade.

Complete the additional tasks for high-availability mode

The following steps are applicable only if the Presentation Server is in the high-availability mode.

  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.
  5. Verify the load balancer configuration. For more information, see Guidelines-for-load-balancers.

Complete the additional tasks if you are upgrading from version 10.7

If you are upgrading from version 10.7, you need to perform the following additional tasks:

Migrate data from Atrium Single Sign-On to Remedy Single Sign-On

Perform these steps:

  1. Install Remedy SSO

  2. Migrate internal user data from Atrium Single Sign-On to Remedy Single Sign-on. 
    For more information, see Migrating internal user data from Atrium Single Sign-On to Remedy Single Sign-On..

Migrate data format

Before you start the upgrade, you must run the dataUpgrade utility. This utility migrates the format of the data in TrueSight Presentation Server to the format required after running the upgrade. For more information, see Migrating the data format before upgrading the Presentation Server.

Configure settings on a Linux host

On a Linux host, you need to configure particular system configuration settings.

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.

Merge customizations performed in the configuration files

While upgrading the TrueSight Presentation Server, the following files are copied from the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\services directory to the %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory.

  • csr.conf 
  • idxsrv.conf

If you have customized these configuration files, your changes are retained as specified in the following table (for the given properties). 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.

Note

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.

While upgrading from version 11.0 or later the complete %TRUESIGHTPSERVER_HOME%\truesightpserver\conf\custom directory is copied over to the new version and therefore these changes are not required.

Where to go from here

If you are upgrading the product, perform the other pre-upgrade tasks listed in the Preparing-to-upgrade-TrueSight-Operations-Management-solution page. 

 

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