Applying feature packs or fix packs using the Presentation Server installer
This topic explains how to apply feature packs or fix packs on the TrueSight Presentation Server using the upgrade wizard. You can also apply feature packs or fix packs on the TrueSight Presentation Server silently.
Upgrading from an earlier version of the TrueSight Presentation Server, see Upgrading the Presentation Server
Before you begin
- Ensure that you have performed all the tasks listed in Preparing to apply feature packs or fix packs on the Presentation Server.
- Download the installation files for the TrueSight Presentation Server and extract the contents of the zipped distribution file to an appropriate directory on the TrueSight Presentation Server host computer. See the Release notes and notices page for information about specific feature pack or fix pack installation files.
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.For example,
chown -R nonrootuser /Linux/Disk1
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 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 ./install.sh.
Note
Ensure that you have set the DISPLAY environment variable.
- 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, 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.
- 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. - Click Done to exit the installation wizard.
(Optional) If you have configured a proxy or DNS alias to access the TrueSight Presentation Server, perform the following steps:
In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\web.xml file.
Comment out theCSRF (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 -->
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.
To apply feature packs or fix packs on the TrueSight Presentation Server in a high availability deployment
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.
- On the primary TrueSight Presentation Server, perform the following steps:
- Perform steps 1–7 of Applying feature packs or fix packs using the Presentation Server installer .
- If you have configured a load balancer for high availability, perform the following steps:
In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\web.xml file.
Comment out theCSRF (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 -->
Run the following commands from the InstalledDirectory\bin folder to restart the TrueSight 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 TrueSight Presentation Server.
On the secondary TrueSight Presentation Server, perform the following steps:
Perform steps 1–7 of Applying feature packs or fix packs using the Presentation Server installer.
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 theCSRF (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 -->
- Stop the secondary TrueSight Presentation Server:
(Windows)tssh server stop
(Linux)./tssh server stop
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.
Where to go from here
To verify the TrueSight 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 TrueSight Presentation Server, see Applying feature packs or fix packs on the Presentation Server.
Comments
Log in or register to comment.