Upgrading the Presentation Server in the high-availability mode silently
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 |
Before you begin
Go to the secondary computer and stop the TrueSight Presentation Server:
- (Windows) Navigate to the TrueSightPServer\truesightpserver\bin directory, and run
tssh server stop
command. - (Linux) Navigate to the TrueSightPServer/truesightpserver/bin directory, and run
./tssh server stop
command.
Note
The Load Balancer Health Check URL formats have changed between TrueSight Operations Management versions 10.x and 11.x. For more information, see Guidelines for load balancers.
To upgrade the TrueSight Presentation Server in the high-availability mode using the silent installer
You need to perform the following tasks to upgrade TrueSight Presentation Server in a high-availability environment.
No additional steps are required to configure the load balancer.
Step A: Upgrade the TrueSight Presentation Server on the primary computer
Tip
To know whether the computer on which you plan to upgrade is the primary computer or the secondary computer, run the tssh ha status
command.
- On the primary computer, extract the downloaded files (the upgrade installer) to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows) C:\Program Files
(Linux) /opt
(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
.
- (applicable if you are upgrading from a version earlier than 11.0) You need to provide details of the Remedy Single Sign-On server that you plan to use with the TrueSight Presentation Server:
You will need to type the database administrator password and the Remedy Single Sign-On password in an encrypted form in the silent options file. Encrypt the password using the TrueSightPServerMaintenanceTool through the wizard or command line interface.
- Go to the extracted folder, and locate the silent options file:
- (Windows) <DownloadLocation>\Windows\Disk1\server-silent-options-upgrade-windows.txt
- (Linux) <DownloadLocation>/Linux/Disk1/server-silent-options-upgrade-linux.txt
Edit the silent options file. This is a text file that defines the installation properties in the form of a prefix tag followed by a property name and value pair. You can either retain the default values or change them and save the file.
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.- Total RAM (in MB): 32,000
- Available RAM (in MB): 25,000
- Total swap space / page file (in MB): 8,000
- Available swap space / page file (in MB): 8,000
At the command prompt, run one of the following commands to start the upgrade. Type the complete path to the silent options file in the command. If the path includes a blank space, enclose the path within double quotes.
Environment type Command Production environment with the existing encryption setting - (Windows)
setup.exe -i silent -DOPTIONS_FILE="<
path_to_server-
silent-options-upgrade-windows
.txt_file>" - (Linux - as a non-root user)
./setup.bin -i silent -DOPTIONS_FILE="<
>"path_to_server-
.txt_filesilent-options-upgrade-linux
Example
- (Windows)
setup.exe -i silent -DOPTIONS_FILE=C:\tempfolder\Disk1\
server-silent-options-upgrade-windows.txt
- (Linux)
./setup.bin -i silent -DOPTIONS_FILE=/opt/tempfolder/Disk1/
server-silent-options-upgrade-linux.txt
Test environment with the existing encryption setting - (Windows)
setup.exe -J MINIMAL=TRUE
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-upgrade-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=TRUE -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-upgrade-linux.txt
Example
- (Windows)
setup.exe -J MINIMAL=TRUE
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-upgrade-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=TRUE -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-upgrade-linux.txt
Note: On Linux, ensure that you start a new session as a non-root user to run the upgrade. Do not use the su
command to start a non-root session.Note: You can ignore the following message displayed on the Linux console immediately after you started running the
install.sh
:Ensure to run Disk1/utility/PreinstallConfig.sh script to configure env before running installer with non-root user ulimit now set to 65536.
- (Windows)
The upgrade might take upto 15 minutes. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at:
- (Windows) %temp%
(Linux) /tmp
Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is upgraded successfully:
Log message:
TrueSight Presentation Server 11.3.0x install succeeded
.
Note: (Optional) After the installation is complete, you can revoke the write permission on the /opt directory.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
(Linux only) Register the
BMCTSPSSvc.service
service by performing the following steps:Note: The systemd service
BMCTSPSSvc.service
is supported only from version 11.3.04. For more information on this service, see Starting and stopping the TrueSight Operations Management components.- As a root user, run the
tssh service register <Non-RootUserName>
. This command registers theBMCTSPSSvc.service
service under the /etc/systemd/system folder. - (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc.service command.
If you restart the TrueSight Presentation Server host without registering the
BMCTSPSSvc
service, the processes do not come up and you will need to start the TrueSight Presentation Server manually.Verify whether the service is registered with the following steps:
- Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
- Running the
systemctl status BMCTSPSSvc.service
To start and stop the service, run the following commands:
systemctl start BMCTSPSSvc.service
systemctl stop BMCTSPSSvc.service
- As a root user, run the
- (Applicable if you customized Tomcat files before the upgrade) Manually re-add the modifications in the web.xml and server.xml files.
(Applies only if you had configured HTTP access before the upgrade) Reconfigure the TrueSight Presentation Server for HTTP access as described in the steps.
(Optional) Perform the steps mentioned in the Troubleshooting a failed deployment
only if both of the following statements are true:
- You have upgraded the TrueSight Presentation Server to version 11.3.04, but you are not planning to upgrade your Integration Service or TrueSight Infrastructure Management server (they are running on one of the lower versions, such as 11.3.03 or earlier.)
- You are using the BMC-provided security certificates.
Step B: Upgrade the TrueSight Presentation Server on the secondary computer
- On the secondary computer, extract the downloaded files (the upgrade installer) to a temporary location outside the following location to avoid any file sharing conflicts:
(Windows) C:\Program Files
(Linux) /opt
(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
.
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.- Total RAM (in MB): 32,000
- Available RAM (in MB): 25,000
- Total swap space / page file (in MB): 8,000
- Available swap space / page file (in MB): 8,000
At the command prompt, run one of the following commands to start the upgrade. Type the complete path to the silent options file in the command. If the path includes a blank space, enclose the path within double quotes.
Environment type Command Production environment with the existing encryption setting - (Windows)
setup.exe -i silent -DOPTIONS_FILE="<
path_to_server-
silent-options-upgrade-windows
.txt_file>" - (Linux - as a non-root user)
./setup.bin -i silent -DOPTIONS_FILE="<
>"path_to_server-
.txt_filesilent-options-upgrade-linux
Example
- (Windows)
setup.exe -i silent -DOPTIONS_FILE=C:\tempfolder\Disk1\
server-silent-options-upgrade-windows.txt
- (Linux)
./setup.bin -i silent -DOPTIONS_FILE=/opt/tempfolder/Disk1/
server-silent-options-upgrade-linux.txt
Test environment with the existing encryption setting - (Windows)
setup.exe -J MINIMAL=TRUE
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-upgrade-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=TRUE -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-upgrade-linux.txt
Example
- (Windows)
setup.exe -J MINIMAL=TRUE
-i silent -DOPTIONS_FILE=C:\Disk1\server-silent-options-upgrade-windows.txt
- (Linux - as a non-root user)
./setup.bin -J MINIMAL=TRUE -i silent -DOPTIONS_FILE=/opt/Disk1/server-silent-options-upgrade-linux.txt
Note: On Linux, ensure that you start a new session as a non-root user to run the upgrade. Do not use the su
command to start a non-root session.Note: You can ignore the following message displayed on the Linux console immediately after you started running the
install.sh
:Ensure to run Disk1/utility/PreinstallConfig.sh script to configure env before running installer with non-root user ulimit now set to 65536.
- (Windows)
The upgrade might take upto 15 minutes. You can periodically check the installation status by checking the truesightpserver_install_log.txt file located at:
- (Windows) %temp%
(Linux) /tmp
Locate the following log message in the truesightpserver_install_log.txt file to ensure that the Presentation Server is upgraded successfully:
Log message:
TrueSight Presentation Server 11.3.0x install succeeded
.
Note: (Optional) After the installation is complete, you can revoke the write permission on the /opt directory.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
(Linux only) Register the
BMCTSPSSvc.service
service by performing the following steps:Note: The systemd service
BMCTSPSSvc.service
is supported only from version 11.3.04. For more information on this service, see Starting and stopping the TrueSight Operations Management components.- As a root user, run the
tssh service register <Non-RootUserName>
. This command registers theBMCTSPSSvc.service
service under the /etc/systemd/system folder. - (SUSE Linux Enterprise Server only) Run the chkconfig --add BMCTSPSSvc.service command.
If you restart the TrueSight Presentation Server host without registering the
BMCTSPSSvc
service, the processes do not come up and you will need to start the TrueSight Presentation Server manually.Verify whether the service is registered with the following steps:
- Ensure that you have read and write permissions for the installedDirectory\truesightpserver\logs\tssh.log file.
- Running the
systemctl status BMCTSPSSvc.service
To start and stop the service, run the following commands:
systemctl start BMCTSPSSvc.service
systemctl stop BMCTSPSSvc.service
- As a root user, run the
- (Applicable if you customized Tomcat files before the upgrade) Manually re-add the modifications in the web.xml and server.xml files.
(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.
You do not need additional configurations for the load balancer.
(Optional) Perform the steps mentioned in the Troubleshooting a failed deployment
only if both of the following statements are true:
- You have upgraded the TrueSight Presentation Server to version 11.3.04, but you are not planning to upgrade your Integration Service or TrueSight Infrastructure Management server (they are running on one of the lower versions, such as 11.3.03 or earlier.)
- You are using the BMC-provided security certificates.
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
Log in or register to comment.