Performing the Presentation Server upgrade

Before you begin

• Ensure that you have performed all the tasks listed in Preparing for the Presentation Server upgrade.
• Download the installation files for the BMC TrueSight Presentation Server and extract the contents of the zipped distribution file to an appropriate directory on the computer on which the Presentation Server will be upgraded.

To provide required permissions to nonroot users on Linux

On Linux computers, you can upgrade the Presentation Server only as a nonroot user. Though the nonroot user may already have ownership permissions for the destination directory, you must provide ownership permissions for the executables to the nonroot user. 

1. Log on as a root user.

2. Provide ownership permissions to nonroot users for all installation files by running the following command: 

   chown -R nonrootuser installationDirectoryFolderName

   nonrootuser is the name of the nonroot user.
   installationDirectoryFolderName is the name of the folder that contains the installation files. 

   For example,  chown -R nonroot /Linux/Disk1


3. Provide Xauthority permissions by running the following command:

   chown -R nonrootuser /usr/bin/xauth 

4. Apply executable rights to the installation files by running the following command:

   chmod -R 755 installationDirectoryFolderName

   For example, chmod -R 755 Disk1 

To upgrade the Presentation Server

1. Launch the installation wizard:

   • (Windows) Navigate to Windows\Disk1 and double-click setup.exe.

   • (Linux) As a nonroot user, navigate to Linux/Disk1 and run ./setup.bin.

     Note

     Ensure that you have set the DISPLAY environment variable.

2. On the Welcome page, click Next.
   
3. 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.
   

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

   Important

   After you confirm, the Presentation Server is stopped temporarily and is started automatically post-upgrade.

5. Verify that the information on the Installation Preview page reflects your upgrade correctly. Click Previous to make changes, or click Install.
6. After the upgrade is complete, click View Log to view the log files and confirm that the upgrade process was successful.
7. Click Done to exit the installation wizard.

To upgrade the Presentation Server in a high availability deployment

1. Logon to the computer where the secondary Presentation Server is installed and open a CLI command prompt.
2. Navigate to (Windows) TrueSightPServer\truesightpserver\bin or (Linux) TrueSightPServer/truesightpserver/bin directory and run the following command to stop the secondary server:
   
   tssh server stop secondary 
3. Logon to the computer where the primary Presentation Server is installed, and perform step 1 through step 7 of to upgrade the Presentation Server.
4. Logon to the computer where the secondary Presentation Server is installed, perform step 1 through step 7 of to upgrade the Presentation Server.
5. After the upgrade completes on the secondary Presentation Server, run the following commands from the InstalledDirectory\bin folder:
   1. Stop the secondary Presentation Server:
      tssh server stop
      
   2. Copy the snapshot:
      tssh ha copysnapshot
      
   3. Restart the secondary Presentation Server:
      tssh server start

Where to go from here

Verifying the Presentation Server upgrade

Related topics

Upgrading the Presentation Server

BMC TrueSight Operations Management high availability deployment