Preparing for the Presentation Server upgrade

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


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

You can change the required configurations either manually or by running the PreinstallConfig.sh script. The script uses ulimit commands to perform the configuration changes.

  • To configure the properties by running the PreinstallConfig.sh script located in the Utility folder

    Navigate to the folder where you have downloaded the TrueSight Presentation Server installation file and run the PreinstallConfig.sh script with the root user permissions. The script changes the system configurations automatically to the values as mentioned in the above table under the manual configuration steps.

    Important

    The Truesight Presentation server installation or upgrade on a Linux host must be run as a non-root user.

    The PreinstallConfig.sh script needs to be run with root user permissions.

    Linux/Disk1/utility/PreinstallConfig.sh

    Example input

     sh PreinstallConfig.sh <TSPS_OWNER_NAME>

    <TSPS_OWNER_NAME> is the non-root username with which you want to install Truesight Presentation Server.

    System configuration file settings override the user settings, so you must check them to avoid getting an error message instructing to run the PreInstall.sh script again even after running the script.

    After you run the script, re-login by opening a new Linux user session before launching the installer.This utility ensures that the minimum required system configurations are carried out for Truesight Presentation Server installation.

  • To configure the properties in the configuration files manually

    1. Add the properties as given in the following table to either the limits.conf file or the sysctl.conf as specified.

      Important

      You must configure the values given in the table with the root user permissions.

      <TSPS_OWNER_NAME> is the non-root username with which you want to install Truesight Presentation Server.

      PropertyValueNotes





      /etc/security/limits.conf
      <TSPS_OWNER_NAME> soft nofile 65536
      <TSPS_OWNER_NAME> hard nofile 65536
      The number of open files must be at least 65536.
      <TSPS_OWNER_NAME> soft nproc 2048
      <TSPS_OWNER_NAME> hard nproc 2048
      The number of open processes must be at least 2048.
      <TSPS_OWNER_NAME> soft memlock unlimited
      <TSPS_OWNER_NAME> hard memlock unlimited
      The memory lock should be set to unlimited.
      <TSPS_OWNER_NAME> soft as unlimited
      <TSPS_OWNER_NAME> hard as unlimited

      The maximum Virtual memory should be unlimited.

      To configure the value for non-root user, some operating systems require that root user should also have unlimited maximum virtual memory. In such instances, add the following lines:

      root soft as unlimited
      root hard as unlimited
      /etc/sysctl.confvm.max_map_count=262144Maximum Map Count  is the maximum number of memory map areas a process may have.The virtual memory property max_map_count must be configured to at least 262144.

    2. After configuring the virtual memory, run the following command to refresh with the new configuration:

      sysctl -p


Tip

After making the configuration changes either manually or by running the script, log in by opening a new Linux user session and launch the installer.

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:

File namePropertyRemarks
csr.confvm.args.system.2=-Xmx4096m - maximum heap size value settingThe higher value between the customized and default values is retained.
vm.args.system.14=-Datsso.log.roll=3 - atsso rolled over log files countThe value from the version that you upgraded from is retained.
vm.args.system.15=-Datsso.log.limit=1000000The value from the version that you upgraded from is retained.
vm.args.system.26=-Djava.net.preferIPv4Stack=trueThe value from the version that you upgraded from is retained.
idxsrv.confvm.args.system.2=-Xmx4096m - maximum heap size value settingThe higher value between the customized and default values is retained.
vm.args.system.2=-Xms256m - minimum heap size value settingThe value is changed to be the same as the maximum heap size value. The maximum and minimum heap size values must be identical for the Elastic Search container to start.
vm.args.system.4=-Xss256k - thread stack sizeThe higher value between the customized and default values is retained.

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:

Was this page helpful? Yes No Submitting... Thank you

Comments