Preparing for the Presentation Server upgrade

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

To use the product, you must be an advanced user with good technical understanding and expertise. To perform the upgrade, BMC recommends that you are an experienced administrator with the following skills:

  • Knowledge of various components
  • Knowledge of network connectivity and communication protocols
  • Experience as a PostgreSQL administrator


To prepare the Presentation Server for upgrading

  1. Review the system requirements for the Presentation Server and if required, upgrade them.
  2. Install Remedy Single Sign-On for enabling single sign-on access to Presentation Server and its associated components.
  3. After installing Remedy SSO, migrate internal user data from Atrium Single Sign-On to Remedy Single Sign-on. 

    Note

    You can migrate the internal user data either before or after upgrading the Presentation Server. For details, see Migrating internal user data from Atrium Single Sign-On to Remedy Single Sign-On.

  4. Note down the passwords for the bppmws_internal and csm_user users. These users are used for internal communication between the Presentation Server and Infrastructure Management Server and the Presentation Server and ITSM respectively.

    Important

    After upgrading the Presentation Server, you must reset the passwords for these users as noted down to reestablish the communication as mentioned above. You can do this by logging into the Remedy SSO Admin console.

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

  6. 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.
  7. Ensure that the Presentation Server is running before starting the upgrade. If the 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 Presentation Server to be Running before starting the upgrade process.

      On Linux computers, add & at the end of the tssh server start command so that the process runs in the background and you can continue to use the shell.

Single Sign-On in high availability mode

While upgrading the Presentation Server from version 10.5 or later, if your Single Sign-On (SSO) is in the high availability (HA) mode, you must enter the SSO certificate details in the TrueSightPServerInstalledConfiguration.xml file. You must add the IS_SSO_Server_IN_HA_MODE and SSO_CERTIFICATE_HOME properties in the TrueSightPServerInstalledConfiguration.xml file. Perform the following action to add the properties:

  1. Navigate to the Presentation Server installation directory.

  2. Open the TrueSightPServerInstalledConfiguration.xml file, and add the following properties:

    <property>
    <name>IS_SSO_SERVER_IN_HA_MODE</name>
    <value>true</value>
    </property>
    <property>
    <name>SSO_CERTIFICATE_HOME</name>
    <value>Path for SSO certificate</value>
    </property>

    An example of the path to an SSO certificate could be C:\tmp\<SSO certificate name>.cer

  3. Save the TrueSightPServerInstalledConfiguration.xml file.

Upgrade on a Linux host

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

tsomd110:Preparing for the Presentation Server installation

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

Upgrade the Presentation Server by using one of the following procedures:

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

Comments