Applying feature packs or fix packs on the Presentation Server in the high-availability mode using the wizard

Where you are in the Applying feature packs or fix packs process

StepTask
1Prepare to apply the feature pack or fix pack
2Apply the feature pack or fix pack on the TrueSight Presentation Server (You are here)
3Apply the feature pack or fix pack on Infrastructure Management
4Apply the feature pack or fix pack on App Visibility Manager



To apply feature packs or fix packs on the Presentation server using the wizard

  1. On the secondary TrueSight Presentation Server, run the following command from the InstalledDirectory\bin folder.  
    (Windows) tssh server stop
    (Linux) ./tssh server stop  

    Note

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


  2. On the primary TrueSight Presentation Server, perform the following steps:
    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 ./install.sh.

        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 the next screen. You can quit the upgrade process at this point, correct the indicated discrepancies, and then rerun the upgrade.

      Important

      After you confirm, the TrueSight 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.
      The installer configures the TrueSight Presentation Server and starts the installation process. This might take some time. After the installation, the Installation Summary dialog box displays a summary of the installation. 
      To view the installation logs, click View Log.
    6. Click Done to exit the installation wizard.
    7. (Optional) If you have configured a proxy or DNS alias to access the TrueSight 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:
        (Windows) tssh server stop
        (Windows) tssh server start  
        (Linux) ./tssh server stop
        (Linux) ./tssh server start

        Note

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

  3. On the secondary TrueSight Presentation Server, perform the following steps:
    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 ./install.sh.

        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 the next screen. You can quit the upgrade process at this point, correct the indicated discrepancies, and then rerun the upgrade.

      Important

      After you confirm, the TrueSight 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.
      The installer configures the TrueSight Presentation Server and starts the installation process. This might take some time. After the installation, the Installation Summary dialog box displays a summary of the installation. 
      To view the installation logs, click View Log.
    6. Click Done to exit the installation wizard.
    7. (Optional) If you have configured a proxy or DNS alias to access the TrueSight 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:
        (Windows) tssh server stop
        (Windows) tssh server start  
        (Linux) ./tssh server stop
        (Linux) ./tssh server start

        Note

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

    8. If you have not configured a load balancer for high availability, proceed to step i
       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 -->
    9. Stop the secondary TrueSight Presentation Server:
      (Windows) tssh server stop
      (Linux) ./tssh server stop
    10. Restart the secondary TrueSight Presentation Server: 
      (Windows) tssh server start  
      (Linux) ./tssh server start 

      Note

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

To verify the Presentation Server upgrade was successful

  1. Access the truesightpserver_fixpack_log.txt which is located in the (Windows%temp% directory or (Linux/tmp directory. Check for warnings or errors. If there are no errors or warnings, the Presentation Server was successfully upgraded.
  2. Navigate to the (WindowsTrueSightPServer\truesightpserver\bin or (LinuxTrueSightPServer/truesightpserver/bin directory and run the following command:

    (Windows) tssh server status

    (Linux) ./tssh server status

    1. The current installed version is displayed in the header that is similar to the following example:
      BMC TrueSight Presentation Server - Command Line Interface 2018 version 11.0.00.003
    2. A list of Presentation Server processes is displayed that is similar to the following sample:
      Process status
      ================================
      Core Server     Running (13176)
      Index Server    Running (11028)
      Database Server Running (6052)

If errors occur, restart the Presentation Server by running the following command:

(Windows) tssh server start

(Linux) ./tssh server start

If error conditions persist, contact BMC Customer Support for assistance.

Where to go from here

Now that you have successfully installed the feature pack or fix pack on the Presentation Server, install it on the other TrueSight Operations Management components. For instructions, see Applying feature packs or fix packs.

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

Comments