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.

Complete the pre-upgrade tasks

Review the System requirements for the Presentation Server to ensure that your system meets the new requirements before starting the upgrade.
Stop any components that are connected to the Presentation Server (for example, Capacity Optimization, or Infrastructure Management).
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
    (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
Ensure that the TrueSight Presentation Server is running before starting the upgrade. For information about starting the service, see Starting and stopping the Remedy SSO and Presentation Server components.
Note

Before starting the upgrade, ensure that the status of the Presentation Server is Running.
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.

Stop the primary and secondary Presentation Server.
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.
Start the primary Presentation Server.
Ensure that the logon page is displayed.
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
Migrate data format
Configure settings on a Linux host
Merge customizations performed in the configuration files

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

Perform these steps:

Install Remedy SSO
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 Open link .

Configure settings on a Linux host

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

As a root user, you can change the configurations either manually or by running the PreinstallConfig.sh script. The script uses ulimit commands to perform the configuration changes.

Ensure that the minimum system configurations required are met by doing one of the following:

Configure the properties by running the script
1. On the host computer, navigate to the <Download location>/Linux/Disk1/utility/ folder, and run the PreinstallConfig.sh script:
  sh PreinstallConfig.sh <TSPS_OWNER_NAME>
  <TSPS_OWNER_NAME> is the non-root username with which you want to deploy TrueSight Presentation Server.
  Important
  - The TrueSight Presentation Server installation or upgrade on a Linux host must be run as a non-root user.
  - System configuration file settings override the user settings. In case of an error that instructs you to run the PreInstallConfig.sh script again, ensure that you modify these configuration settings as per the error message before you rerun the script.
  The script changes the system configurations automatically to the values as listed in the System configuration settings table.
2. After you run the script, open a new Linux user session and log in as a non-root user before launching the TrueSight Presentation Serverinstaller.
Configure the properties manually
1. As a root user, add the properties as listed in the System configuration settings table to the limits.conf file and the sysctl.conf file.
  Important
  
  <TSPS_OWNER_NAME> is the non-root username with which you want to deployTrueSight Presentation Server.
2. After configuring the virtual memory, run the following command to refresh the configuration changes:
  sysctl -p
3. Open a new Linux user session, and log in as a non-root user before launching the TrueSight Presentation Serverinstaller.

System configuration settings

File name	Property and Value	Notes
`/etc/security/limits.conf` Note: Ensure that the limits for open files and processes mentioned in the `/etc/security/limits.conf` and `/etc/security/limits.d` files are same or the limits in the `/etc/security/limits.d` file is blank or removed. If the limits are different in these two files, you may get an installation error.	`<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 4096` `<TSPS_OWNER_NAME> hard nproc 4096`	The number of open processes must be at least 4096.
	`<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.conf	`vm.max_map_count=262144`	Maximum 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.

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.

File name	Property	Remarks
csr.conf	`vm.args.system.2=-Xmx4096m - maximum heap size value setting`	The higher value between the customized and default values is retained.
	`vm.args.system.14=-Datsso.log.roll=3 - atsso rolled over log files count`	The value from the version that you upgraded from is retained.
	`vm.args.system.15=-Datsso.log.limit=1000000`	The value from the version that you upgraded from is retained.
	`vm.args.system.26=-Djava.net.preferIPv4Stack=true`	The value from the version that you upgraded from is retained.
idxsrv.conf	`vm.args.system.2=-Xmx4096m - maximum heap size value setting`	The higher value between the customized and default values is retained.
	`vm.args.system.2=-Xms256m - minimum heap size value setting`	The 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 size`	The higher value between the customized and default values is retained.

Where to go from here

Perform the other pre-upgrade tasks listed in Preparing to upgrade TrueSight Capacity Optimization.