Upgrading the Infrastructure Management server for application high-availability
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 |
4 | Upgrade TrueSight Infrastructure Management — Phase A (You are here) |
Upgrade TrueSight Infrastructure Management — Phase B | |
5 | Upgrade App Visibility Manager |
6 | Upgrade Real End User Experience Monitoring Software Edition |
7 | Upgrade TrueSight IT Data Analytics |
You need to perform the following tasks to upgrade the Infrastructure Management server for application high-availability:
Application high-availability is supported only with the Oracle database.
Best practice
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.
Stop the secondary server by using the
pw sys stop
command. For more information, see Starting and stopping the TrueSight Operations Management components.- After stopping the secondary server, ensure that all internal processes are stopped by using the
pw process list
command. BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)
You can use the systemd service
BMCTrueSight.service
located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components.
- After stopping the secondary server, ensure that all internal processes are stopped by using the
- On the primary server, change the publishing server startup mode from automated to manual. Ignore this step if the startup mode is already set to manual.
- Edit the pserver.conf file located in the installationDirectory/pw/server/etc folder and change the value of the parameter
AutomatedStartMode
toManual
. - Run the command
pscontrol
manual
- Edit the pserver.conf file located in the installationDirectory/pw/server/etc folder and change the value of the parameter
- Upgrade the primary server. See:
(Using the wizard) Upgrading the Infrastructure Management server in the standalone mode using the wizard
(Silently) Upgrading the Infrastructure Management Server in the standalone mode silentlyIf you upgraded as a non-root user, then after the installation is complete, you might see the following warning in the tsim_servicepack_log.txt file located at installedDirectory\pw\pronto\logs. You can ignore this warning.
LOG EVENT {Description=[Error while updating BMCTrueSight],Detail=[/etc/init.d/BMCTrueSight (Permission denied)]}
- Ensure that the primary server has successfully started by running the
pw license list
command. The output should display a valid license expiration date, as in the following example:Feature : Server, Expiration : Thu Dec 31 00:00:00 IST 2099, NodeLocked : false
Important
The system requirements are validated every 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.
On the primary Infrastructure Management server, if you have customized service management data in the di_models.baroc file present in the <Infrastructure Management Server Install Directory>\pw\server\etc directory, copy the publishing server kb from the backup directory to the <Infrastructure Management Server Install Directory>\pw\server\etc\<psname> directory.
On the primary Infrastructure Management server, if you changed the publishing server startup mode from automated to manual before upgrading, change it back to automated.
Edit the pserver.conf file located in the installationDirectory/pw/server/etc folder and change the value of the parameterAutomatedStartMode
to Automated.Stop the primary server by using the
pw sys stop
command. For more information, see Starting and stopping the TrueSight Operations Management components.- After stopping the primary server, ensure that all internal processes are stopped by using the
pw process list
command. BMCTrueSight.service (Applicable only to version 11.3.04 and later on Linux)
You can use the systemd service
BMCTrueSight.service
located in the /etc/systemd/system directory to start and stop the Infrastructure Management server on Linux. For more information, see Starting and stopping the TrueSight Operations Management components.
- After stopping the primary server, ensure that all internal processes are stopped by using the
- Synchronize the cell database (MCDB) on the primary and secondary servers:
- Back up the installedDirectory\TrueSight\pw\server\var\<secondary_cell_name> folder (for example, pncell_<host name>#2) of the secondary server.
- Delete all content in the installedDirectory\TrueSight\pw\server\var\<secondary_cell_name> folder (for example, pncell_<host name>#2) of the secondary server.
- Copy all content from the installedDirectory\TrueSight\pw\server\var\<primary_cell_name> folder (for example, pncell_<host name>#1) of the primary server to the above location on the secondary server.
- On the secondary server, change the publishing server startup mode from automated to manual. Ignore this step if the startup mode is already set to manual.
Edit the pserver.conf file located in the installationDirectory/pw/server/etc folder and change the value of the parameterAutomatedStartMode
to Manual. Upgrade the secondary server. See:
(Using the wizard) Upgrading the Infrastructure Management server in the standalone mode using the wizard
(Silently) Upgrading the Infrastructure Management Server in the standalone mode silentlyImportant
When upgrading on the secondary server, do not use the KB folder migrated from the primary server. Use the migrated KB folder from the secondary server.
If you upgraded as a non-root user, then after the installation is complete, you might see the following warning in the tsim_servicepack_log.txt file located at installedDirectory\pw\pronto\logs. You can ignore this warning.
LOG EVENT {Description=[Error while updating BMCTrueSight],Detail=[/etc/init.d/BMCTrueSight (Permission denied)]}
The secondary server is not yet in a usable state. Do not check for connectivity with the TrueSight Presentation Server until you perform the rest of the instructions in this section.
Stop the secondary server by using the
pw sys stop
command.After stopping the secondary server, ensure that all internal processes are stopped by using the
pw process list
command.- Synchronize the cell database (MCDB) on the primary and secondary servers:
- Back up the installedDirectory\TrueSight\pw\server\var\<primary_cell_name> folder (for example, pncell_<host name>#1) of the primary server.
- Delete all content in the installedDirectory\TrueSight\pw\server\var\<primary_cell_name> folder (for example, pncell_<host name>#1) of the primary server.
- Copy all content from the installedDirectory\TrueSight\pw\server\var\<secondary_cell_name> folder (for example, pncell_<host name>#2) of the secondary server to the above location on the primary server.
- If you changed the publishing server startup mode from automated to manual before applying the feature pack or fix pack, change it back to automated. Do this on both servers.
Edit the pserver.conf file located in the installationDirectory/pw/server/etc folder and change the value of the parameterAutomatedStartMode
to Automated. - (Linux) If you performed the upgrade as a non-root user, do the following on the primary and secondary servers:
- Log on as a root user.
Run the <InstallationDirectory>/pw/scripts/create_startup_script script.
This will enable the BMCTrueSight.service service creation.
- Start the primary server by using the
pw sys start
skipHAcheckNoValidate
command. - Ensure that the primary server has successfully started by running the
pw license list
command. The output should display a valid license expiration date, as in the following example:Feature : Server, Expiration : Thu Dec 31 00:00:00 IST 2099, NodeLocked : false
- Verify that the primary server is the active node by running the
pw ha status
command. - Start the secondary server by using the
pw sys start
command. - Ensure that the secondary server has successfully started by running the
pw license list
command. The output should display a valid license expiration date, as in the following example:Feature : Server, Expiration : Thu Dec 31 00:00:00 IST 2099, NodeLocked : false
- In the secondary Infrastructure Management server, if you have customized service management data in the di_models.baroc file present in the <Infrastructure Management Server Install Directory>\pw\server\etc directory, copy the publishing server kb from the backup directory to the <Infrastructure Management Server Install Directory>\pw\server\etc\<psname> directory.
Verify that the secondary server is the standby node by running the
pw ha status
command.Important
The system requirements are validated every 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.
- After the TrueSight Infrastructure Management server upgraded successfully, if you observe any self monitoring events are open when the primary server is running in active mode and secondary serve is running in standby mode, close it manually.
Post-upgrade task
- Ensure that you review the information in the Troubleshooting version 11.3.04 upgrade and post-upgrade issues topic after you upgrade.
- If you have customized the password for the bppmws_internal user account before the TrueSight Infrastructure Management Server upgrade, use one of the following options to sync the password after the upgrade. In a HA environment, ensure that you run these steps on both the HA nodes.
- Option 1:Update the properties file manually
- On the Infrastructure Management server, go to the following backup file location:
<InstallationDirectory><OLD_VERSION>/pw/pronto/conf/bppmws_internal.properties
<OLD_VERSION> is the version that you are upgrading from. - Copy the value for the property bppmws_internal_key from the preceding properties backup file and replace the value in the following file:
<InstallationDirectory>/pw/pronto/conf/bppmws_internal.properties - Restart theTrueSight Infrastructure Management server.
- Option 2:Update the properties file using CLI command
- Open a command prompt on the Infrastructure Management server and run the following command:
pw internaluser change_passwd
- Enter the new password.
The new password is validated with Remedy SSO and then updated. - Restart the Infrastructure Management server.
- Due to security reasons, the following property is set to false during the upgrade.
http.enabled:false
If you want to monitor the Elasticsearch, set the above property to true
in the elasticsearch.yml file at the following directory path after the upgrade as applicable:
- (On Linux)<TRUESIGHTPSERVER_HOME>/truesightpserver/modules/elasticsearch/config/
- (On Windows) <TRUESIGHTPSERVER_HOME>\truesightpserver\modules\elasticsearch\config\
Note
On a high-availability environment, perform the preceding steps on both the primary and secondary servers.
Troubleshooting upgrade issues
If you face issues during the upgrade, see
Troubleshooting an Infrastructure Management deployment.
Next step in the Upgrade process
Step 4 Phase B — Now that you have successfully upgraded the Infrastructure Management Server, you must upgrade the Integration Service and remote cells.
Comments
Log in or register to comment.