Upgrading the Presentation Server in the standalone mode using the wizard
Where you are in the Upgrade process
Step | Task |
---|---|
1 | Preparing to upgrade TrueSight Operations Management solution |
2 | Upgrade Remedy Single Sign-On |
3 | Upgrade TrueSight Presentation Server (You are here) |
4 | Upgrade TrueSight Infrastructure Management |
5 | Upgrade App Visibility Manager |
6 | Upgrade Real End User Experience Monitoring Software Edition |
7 | Upgrade TrueSight IT Data Analytics |
To upgrade the TrueSight Presentation Server in the wizard-based mode
Extract the downloaded files to an appropriate directory on the computer on which you want to perform the upgrade:
(Windows) C:\<tempFolder>
(Linux) /opt
Note
(Applicable for upgrade on a Linux computer) If you do not extract the upgrade installation files on the Presentation Server host computer (on which you want to perform the upgrade), it is possible that the install.sh and setup.bin files do not have the required executable permissions. You might need to provide executable permissions to these files by running the
chmod -R 755 installationDirectoryFolderName
command.
For example,chmod -R 755 /Linux/Disk1
.
(Linux) Set the DISPLAY environment variable to ensure that the wizard-based installer launches the screens appropriately:
export DISPLAY=<IP address of the host computer>:0.0
Note
Ensure that the following system requirements are met. If your target computer does not meet these requirements, you cannot proceed with the upgrade. However, in a test environment, you can skip the system requirements validation and run the installer by using the
-J MINIMAL=TRUE
argument.(Linux) Perform the following steps to provide ownership permissions to the non-root user for all the upgrade-related installation files:
- Log on as a root user.
Run the following command:
chown -R <nonrootuser> <installationDirectoryFolderName>
In the preceding command, the following definitions apply:
<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
.
Navigate to the Disk1 directory of the extracted folder, use one of the following options to run the installer.
Environment type Command Production environment with the existing encryption setting (Windows)
setup.exe
(Linux - as a non-root user)
./setup.bin
Test environment with the existing encryption setting (Windows)
setup.exe
-J MINIMAL=TRUE
(Linux - as a non-root user)
./setup.bin
-J MINIMAL=TRUE
Review the welcome page, and click Next.
Read the license agreement, agree to the terms, and click Next.
On the Upgrade Confirmation page, click Yes, and click Next.
(Applicable if you are upgrading from a version earlier than 11.0) Provide the following details for Remedy SSO and click Next.
- Type the FQDN of the host computer on which you have installed Remedy SSO.
- Type the tomcat port number that you have configured while installing Remedy SSO. The default port number for Remedy SSO is:
- (Windows) HTTPS: 448 and HTTP: 88
- (Linux) HTTPS: 8048 and HTTP: 8088
- Type the Remedy SSO server superuser password. The Remedy SSO superuser name is Admin.
Select HTTP or HTTPS depending on the Remedy SSO configuration. By default, Remedy SSO is configured in the HTTPS mode.
- Select Yes or No to import the Remedy SSO private certificate. If you select:
- Yes: Specify the directory where the Remedy SSO private certificate is stored.
- No: You can import the Remedy SSO certificate after the upgrade is completed. For more information, see Applying Remedy Single Sign-On Server private certificate to the TrueSight Presentation Server .
Preview the details, and verify the configurations.
Click Install to start the upgrade. A local upgrade may take upto 15 minutes.
After the upgrade is complete, the Installation Summary page is displayed.Click View Log to view the upgrade log details on the screen. From the log view, you can expand and view the log messages. You can also navigate to the following default location of logs:
- (Windows) \Temp\truesightpserver_install_log.txt
- (Linux)/tmp/truesightpserver_install_log.txt
Click Done to exit the installer.
Verify the TrueSight Presentation Server status:
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run the
tssh server status
command. - (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run the
./tssh server status
command.
A list of include Presentation Server processes are displayed as shown in the following example.
Process status
================================
Core Server Running (13176)
Index Server Running (11028)
Database Server Running (6052)If errors occur when you run the
tssh server status
command, restart the TrueSight Presentation Server by running the following command:(Windows)
tssh server start
- (Linux)
tssh server start&
The&
character at the end of thetssh server start
command ensures that the process runs in the background, and you can continue to use the shell.
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run the
(Applicable if you customized Tomcat files before the upgrade) Manually re-add the modifications in the web.xml and server.xml files.
Launch the TrueSight Presentation Server application with the following URL:
(Windows) http(s)://<TSPS_FQDN>
- (Linux) http(s)://<TSPS_FQDN>:<tomcat_port>
Type the default Admin credentials (User name: admin, Password: admin12345), and click Log In.
The TrueSight console opens.
(Applies only if you had configured HTTP access before the upgrade) Reconfigure the TrueSight Presentation Server for HTTP access as described in the steps.
Your upgrade is now complete.
Notes
- The system requirements are validated each time you restart the host computer or product services. If the system requirements are not met, the product services are not started. To force-start the product services, see Starting and stopping the TrueSight Operations Management components.
- In the previous installation, if an IP address was used to access the TrueSight console, post upgrade, map the IP address to the FQDN in the following file:
- (Windows)System32\drivers\etc\hosts
- (Linux) \etc\hosts
After mapping, update bookmarked IP addresses (in browsers) to refer to this FQDN.
Post upgrade, check to ensure custom tuning parameters, if any, are correct. If required, restore them by using the backup files located at installationDirectory\TrueSightPServer\truesightpserver_<version>\conf\services and copy them to the installationDirectory\conf\custom folder.
(Applicable if you are upgrading from a version earlier than 11.0) If you were using an IP address to access or cross-launch the TrueSight Infrastructure Management servers, you need to change the IP address to the FQDN.
Troubleshooting upgrade issues
If you face issues related to upgrade, see Troubleshooting the Presentation Server deployment .
After an unsuccessful upgrade, if you want to restore to the earlier version, see Restoring the earlier version of the Presentation Server if the upgrade fails. .
Next step in the Upgrade process
Now that you have successfully upgraded the TrueSight Presentation Server, upgrade the other TrueSight components as per your requirements. For instructions, see Upgrading.
Comments
Hi guys,
Steps for configuring HTTP access"
we have info only for http access. If we configured https and implement security certificates, do we need to upgrade any keystores or certs?
Many thanks,
Hi George,
Thanks for your comment. We have taken this question to R&D. We will update you soon.
Priyanka
Hi George, as per R&D, the certificates should be retained post-upgrade. You don't need to reconfigure them post-upgrade. Hope this helps!
Backup your certificates anyhow!!!
Log in or register to comment.