Performing the Presentation Server upgrade
This topic explains how to upgrade the TrueSight Presentation Server to the current version. You can upgrade the TrueSight Presentation Server using the upgrade wizard, or you can use the procedure.
Before you begin
- Ensure that you have performed all the tasks listed in Preparing for the Presentation Server upgrade.
Download the TrueSight Presentation Server installation files and extract the contents of the zipped distribution file to an appropriate directory on the computer on which the TrueSight Presentation Server is being upgraded.
To provide required permissions to non-root users on Linux
On Linux computers, you can upgrade the TrueSight Presentation Server only as a non-root user. Though the non-root user may already have ownership permissions for the destination directory, you must provide ownership permissions for the executables to the non-root user.
- Log on as a root user.
Provide ownership permissions to non-root users for all installation files by running the following command:
chown -R nonrootuser installationDirectoryFolderName
nonrootuser is the name of the non-root user.
installationDirectoryFolderName is the name of the folder that contains the installation files.
chown -R nonrootuser /Linux/Disk1
Apply executable rights to the installation files by running the following command:
chmod -R 755 installationDirectoryFolderName
chmod -R 755 /Linux/Disk1
To upgrade the TrueSight Presentation Server
- Launch the installation wizard:
(Windows) Navigate to Windows\Disk1 and double-click setup.exe.
(Linux) As a non-root user, navigate to Linux/Disk1 and run ./setup.bin.
Ensure that you have set the DISPLAY environment variable and non-root user configurations are done for Linux.
- On the Welcome page, click Next.
- On the License Agreement page, read the agreement and select the I agree to the terms of the license agreement option, and click Next.
If you do not agree to the terms of the license agreement, the installation process will not continue.
On the Upgrade Confirmation page, click Yes, and click Next.
The installer automatically verifies the upgrade requirements. If it finds any errors, it displays them in a separate window. You can quit the upgrade process at this point, correct the indicated discrepancies, and then rerun the upgrade.
After you confirm, the TrueSight Presentation Server is stopped temporarily and is started automatically post-upgrade.
- Enter the Remedy Single Sign-On Server settings to be configured with the TrueSight Presentation Server and click Next.
- Enter the Fully Qualified Domain Name (FQDN) of the Remedy Single Sign-On server installed on the system.
- Use the port number of the Remedy Single Sign-On server installed on the system. The default port number is 448 for HTTPS and 88 for HTTP.
- Enter the Remedy Single Sign-On server super user password. The Single Sign-On super username is Admin.
Select a protocol. The options are: HTTPS or HTTP. By default HTTPS is selected.
The Port and Protocol details mentioned here are related only to the Tomcat details configured on the Remedy SSO server.
When you select HTTPS, you get an option to import certificates, yes or no. If you select yes, browse and import the certificate file.
- Verify that the information on the Installation Preview page reflects your upgrade correctly. Click Previous to make changes, or click Install.
- After the upgrade is complete, click View Log to view the log files and confirm that the upgrade process was successful.
- Click Done to exit the installation wizard.
If the Tomcat Server web.xml or server.xml file was modified before the upgrade, manually add those changes to the Tomcat server web.xml or server.xml file after the upgrade. The truesightpserver_10.x.xx folder (where x.xx is the version that you are upgrading from) contains the backup files of the earlier installation.
To upgrade the TrueSight Presentation Server in a high-availability deployment
- Open a CLI command prompt on the TrueSight Presentation Server secondary node.
- Navigate to the directory:
- Run the following command to stop the secondary server:
tssh server stop
- On the existing TrueSight Presentation Server primary node, perform steps 1–7 of to upgrade the Presentation Server.
- (Optional) If you have installed the TrueSight Presentation Server in the high-availability mode, you can configure aliases and hosts to access the TrueSight Presentation Server. For more information, see Configuring the Presentation Server for high availability.
(Applies only if you configured high-availability post installation in an earlier release) On the computer where the existing version of the secondary Presentation Server is installed, perform the following steps:
Edit the TrueSightPServer\TrueSightPServerInstalledConfiguration.xml file.
Locate and change the following property values. If these properties are not present, add them.
In the preceding properties, ensure that the value is set as follows:
TrueSight_high_availability_enabled: Indicates whether high availability is enabled. Value must be set to 1.
TrueSight_high_availability_type: Indicates the type of server - primary or secondary. Value must be set to 2.
TrueSight_high_availability_configuration_file: Specify the complete location path of the ha-shared.conf file copied from the primary server.
On the secondary node, perform steps 1–4 of to upgrade the Presentation Server.
If the upgrade is not successful and if you want to restore to the earlier version, see Restoring the earlier version of the Presentation Server if the upgrade fails.
Where to go from here
If you have a High Availability environment for your TrueSight Presentation Server, see Configuring the Presentation Server for high availability.
See Verify the Presentation Server upgrade to understand how to verify that the TrueSight Presentation Server is successfully upgraded.