Page tree
Skip to end of metadata
Go to start of metadata

This topic explains how to apply feature packs or fix packs on the Presentation Server using the upgrade wizard. You can also apply feature packs or fix packs on the Presentation Server silently.  

Related topic

Upgrading from an earlier version of the Presentation Server? See Upgrading the Presentation Server

Before you begin

To provide required permissions to non-root users on Linux

On Linux computers, you can upgrade the 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. 

  1. Log on as a root user.
  2. 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. 

    For example,  chown -R nonrootuser /Linux/Disk1

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

    chmod -R 755 installationDirectoryFolderName

    For example, chmod -R 755 Disk1 

To apply feature packs or fix packs on the Presentation Server

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

      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, select 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 after applying the feature pack or fix pack.

  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 feature pack or fix pack is applied, use the Browse to Log option in the Maintenance Tool to view the installation logs. Feature pack or fix pack installation logs are not displayed through the View Log option.

  7. Click Done to exit the installation wizard.
  8. (Optional) If you had configured the Presentation Server for HTTP access prior to the upgrade, reconfigure it again:
    1. In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\web.xml file.

      Comment out the security-constraint section so that it reads as follows:

      <!--

      <security-constraint>

              <web-resource-collection>

                  <web-resource-name>Secure context</web-resource-name>

                  <url-pattern>/*</url-pattern>

                  </web-resource-collection>

                  <user-data-constraint>

                  <transport-guarantee>CONFIDENTIAL</transport-guarantee>

                  </user-data-constraint>

          </security-constraint>

      -->

    2. Run the following commands from the InstalledDirectory\bin folder to restart the Presentation Server:
      tssh server stop
      tssh server start 
        

      Note

      On Linux, run the commands as the non-root user that initially installed the Presentation Server.

  9. (Optional) If you have configured a proxy or DNS alias to access the Presentation Server, perform the following steps: 
     

    1. In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\web.xml file.
      Comment out the CSRF (Cross site request forgery) Header Referer Check Filter section so that it reads as follows:
       

      <!-- Start : CSRF (Cross site request forgery) Header Referer Check Filter -->
      <!--
      	<filter>
      		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
      		<filter-class>com.bmc.truesight.secure.csrf.CSRFHeaderRefererCheckFilter</filter-class>         
      	</filter>
      	<filter-mapping>
      		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
      		<url-pattern>/*</url-pattern>
      	</filter-mapping>
      -->
      <!-- End : CSRF(Cross site request forgery) Header Referer Check Filter -->


    2. Run the following commands from the InstalledDirectory\bin folder to restart the Presentation Server:
      tssh server stop
      tssh server start 
        

      Note

      On Linux, run the commands as the non-root user that initially installed the Presentation Server.

To apply feature packs or fix packs on the Presentation Server in a high availability deployment

  1. On the secondary Presentation Server, run the following command from the InstalledDirectory\bin folder.  
    tssh server stop
     

    Note

    On Linux, run the command as the non-root user that initially installed the Presentation Server.


  2. On the primary Presentation Server, perform the following steps:
    1. Perform steps 1–9 of To apply feature packs or fix packs on the Presentation Server.
    2.  If you have configured a load balancer for high availability, perform the following steps:  
      1. In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\web.xml file.
         Comment out the CSRF (Cross site request forgery) Header Referer Check Filter section so that it reads as follows: 

        <!-- Start : CSRF (Cross site request forgery) Header Referer Check Filter -->
        <!--
        	<filter>
        		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
        		<filter-class>com.bmc.truesight.secure.csrf.CSRFHeaderRefererCheckFilter</filter-class>         
        	</filter>
        	<filter-mapping>
        		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
        		<url-pattern>/*</url-pattern>
        	</filter-mapping>
        -->
        <!-- End : CSRF(Cross site request forgery) Header Referer Check Filter -->
      2. Run the following commands from the InstalledDirectory\bin folder to restart the Presentation Server:
        tssh server stop
        tssh server start
         

        Note

        On Linux, run the commands as the non-root user that initially installed the Presentation Server.


  3. On the secondary Presentation Server, perform the following steps:

    1.  Perform steps 1–9 of To apply feature packs or fix packs on the Presentation Server 

    2.  If you have not configured a load balancer for high availability, proceed to step c.
       If you have configured a load balancer for high availability, perform the following step:
       Comment out the CSRF (Cross site request forgery) Header Referer Check Filter section so that it reads as follows.
       

      <!-- Start : CSRF (Cross site request forgery) Header Referer Check Filter -->
      <!--
      	<filter>
      		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
      		<filter-class>com.bmc.truesight.secure.csrf.CSRFHeaderRefererCheckFilter</filter-class>         
      	</filter>
      	<filter-mapping>
      		<filter-name>CSRFHeaderRefererCheckFilter</filter-name>
      		<url-pattern>/*</url-pattern>
      	</filter-mapping>
      -->
      <!-- End : CSRF(Cross site request forgery) Header Referer Check Filter -->

       

    3. Stop the secondary Presentation Server:
      tssh server stop
    4. Copy the snapshot:
      tssh ha copysnapshot 
    5.  Restart the secondary Presentation Server: 
      tssh server start
       

      Note

      On Linux, run the commands as the non-root user that initially installed the Presentation Server.


Where to go from here

To verify the Presentation Server operation, see Verifying the Presentation Server operation after applying feature packs or fix packs

For an overview of applying feature packs or fix packs on the Presentation Server, see Applying feature packs or fix packs on the Presentation Server.