Upgrading the Presentation Server in the high-availability mode using the wizard

Where you are in the Upgrade process

StepTask
1Preparing to upgrade TrueSight Operations Management solution
2Upgrade Remedy Single Sign-On
3Upgrade TrueSight Presentation Server (You are here)
4Upgrade TrueSight Infrastructure Management 
5Upgrade App Visibility Manager 
6Upgrade Real End User Experience Monitoring Software Edition 
7Upgrade 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.

To upgrade the TrueSight Presentation Server in the high-availability mode using the wizard-based installer

You need to perform the following tasks to upgrade TrueSight Presentation Server in a high-availability environment.


Step A: Upgrade 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.

  1. On the primary computer, extract the downloaded files to an appropriate directory:
    • (WindowsC:\Program Files

    • (Linux) /opt

  2. (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

  3. (Linux) Perform the following steps to provide ownership permissions to the non-root user for all the upgrade-related installation files:

    1. Log on as a root user.
    2. 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.

  4. Navigate to the Disk1 directory of the extracted folder, use one of the following options to run the installer.

    Environment typeCommand
    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

  5. Review the welcome page, and click Next.
  6. Read the license agreement, agree to the terms, and click Next
  7. On the Upgrade Confirmation page, click Yes, and click Next.
  8. (Applicable if you are upgrading from a version earlier than 11.0) Provide the following details for Remedy SSO and click Next

    1. Type the FQDN of the host computer on which you have installed Remedy SSO. 
    2. 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
    3. Type the Remedy SSO server superuser password. The Remedy SSO superuser name is Admin.
    4. Select HTTP or HTTPS depending on the Remedy SSO configuration. By default, Remedy SSO is configured in the HTTPS mode.

    5. 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 .
  9. Preview the details, and verify the configurations.
  10. 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.
  11. 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
  12. Click Done to exit the installer.
  13. 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:

    • (Windowstssh server start

    • (Linuxtssh server start&
      The & character at the end of the tssh server start command ensures that the process runs in the background, and you can continue to use the shell.
  14. (Applicable if you customized Tomcat files before the upgrade) Manually re-add the modifications in the web.xml and server.xml files.
  15. (Applies only if you had configured HTTP access before the upgrade) Reconfigure the TrueSight Presentation Server for HTTP access as described in the steps.

     Steps for configuring HTTP access
    1. Log in to the Presentation Server host computer, and navigate to the following directory:

      • (Windows): <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf
      • (Linux): <Presentation Server installation directory>/truesightpserver/modules/tomcat/conf
    2. In a text editor, edit the \web.xml file and comment out the security-constraint section so that it reads as follows:

      <!--

      <security-constraint>

              <web-resource-collection>

                  <web-resource-name>Secure context</web-resource-name>

                  <url-pattern>/*</url-pattern>

                  </web-resource-collection>

                  

                  <user-data-constraint>

                  <transport-guarantee>CONFIDENTIAL</transport-guarantee>

                  </user-data-constraint>

          </security-constraint>

      -->

    3. In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\server.xml file:
      1. Modify the following line:

        <Connector connectionTimeout="20000" enableLookups="false" port="80" protocol="HTTP/1.1" redirectPort="443"/>

        Then, remove the redirectPort information and copy the compressableMimeType, compression, and compressionMinSize property information from the HTTPS connector so that it reads as follows:

        <Connector connectionTimeout="20000" enableLookups="false" port="80" protocol="HTTP/1.1" compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json" compression="on" compressionMinSize="1024" />

        Note

        The default port for Windows is 80 and Linux is 8080. If you specified a custom port during installation, enter that port number instead.

      2. Comment out the following line so that it reads as follows:

        <!-- <Connector SSLEnabled="true" ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
        TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
        TLS_DHE_DSS_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_128_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_SHA256,
        TLS_ECDHE_RSA_WITH_AES_128_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_SHA,TLS_ECDHE_RSA_WITH_AES_256_SHA384,
        TLS_ECDHE_ECDSA_WITH_AES_256_SHA384,TLS_ECDHE_RSA_WITH_AES_256_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_SHA,
        TLS_DHE_RSA_WITH_AES_128_SHA256,TLS_DHE_RSA_WITH_AES_128_SHA,TLS_DHE_DSS_WITH_AES_128_SHA256,
        TLS_DHE_RSA_WITH_AES_256_SHA256,TLS_DHE_DSS_WITH_AES_256_SHA,TLS_DHE_RSA_WITH_AES_256_SHA"
        clientAuth="false" compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json" compression="on" compressionMinSize="1024" keystoreFile="C:/Program Files/BMC Software/TrueSightPServer/truesightpserver/conf/secure/loginvault.ks" keystorePass="changeit" maxThreads="150" port="4435" protocol="org.apache.coyote.http11.Http11NioProtocol" scheme="https" secure="true" sslProtocol="TLSv1.2" useServerCipherSuitesOrder="true"/>
        -->

    4. From the <Presentation Server installation directory>\truesightpserver\truesightpserver\bin folder, use a command prompt to run the following commands:

      tssh properties set tspsPreferredWebServiceProtocol http

      tssh properties set tsps.xsrf.cookie.secure false

    5. If you want to use the TrueSight console to deploy and install packages on a PATROL Agent, from the <Presentation Server installation directory>\truesightpserver\truesightpserver\bin folder, use a command prompt to run the following command:

      tssh properties set server.port.websrv.protocol http

    6. Restart the TrueSight Presentation Server. 
    7. On each Infrastructure Management server connected to the TrueSight Presentation Server, set the following properties In the <Infrastructure Management installation directory>\pw\custom\conf\pronet.conf file:

      • tsps.tsim.http.enabled=true

      • pronet.xsrf.token.secure=false

    8. On each Infrastructure Management server, reload the newly updated properties of the Infrastructure Management server running the pw jproperties reload command.

  16. (Applicable if in a previous version you connected to the TrueSight Presentation Server with an alias name) The TrueSight Presentation Server validates all incoming requests to prevent Cross-Site Forgery (CSRF) attacks. After running the upgrade, you must configure all hosts, aliases, or proxies for CSRF validation. Unless you do this, you cannot access TrueSight Presentation Server even if the upgrade completed successfully.

    Run the following commands to enable the CSRF filter for the alias names set:

    1. Navigate to the following location:
      • (WindowsTrueSightPServer\truesightpserver\bin
      • (Linux)TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set tspsProxyHosts <alias1>,<alias2>,<alias3> command.

      Example

      If you have set a single alias name for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston

      If you have set multiple alias names for the TrueSight Presentation Server host:

      tssh properties set tspsProxyHosts HostHouston,HostLondon,HostPune

    3. Run the tssh properties reload command.
     To disable the CSRF filter

    Note

    If implementing the CSRF validation degrades the performance of the UI, you can disable the CSRF filter. However, BMC strongly discourages this action.

    Run the following commands:

    1. Navigate to the following location:

      • (WindowsTrueSightPServer\truesightpserver\bin
      • (Linux) TrueSightPServer/truesightpserver/bin
    2. Run the tssh properties set csrfFilter false command.
    3. Run the tssh properties reload command.

Step B: Upgrade TrueSight Presentation Server on the secondary computer

Note

Before you upgrade TrueSight Presentation Server on the secondary computer, the primary computer must be running and in active mode.

To know the primary computer status, run the tssh ha status command.

  1. On the secondary computer, extract the downloaded files to an appropriate directory:
    • (WindowsC:\Program Files

    • (Linux) /opt

  2. (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

  3. (Linux) Perform the following steps to provide ownership permissions to the non-root user for all the upgrade-related installation files:

    1. Log on as a root user.
    2. 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.

  4. Navigate to the Disk1 directory of the extracted folder, use one of the following options to run the installer.

    Environment typeCommand
    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

  5. Review the welcome page, and click Next.
  6. Read the license agreement, agree to the terms, and click Next
  7. On the Upgrade Confirmation page, click Yes, and click Next.
  8. Preview the details, and verify the configurations.
  9. 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.
  10. 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
  11. Click Done to exit the installer.
  12. 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:

    • (Windowstssh server start

    • (Linuxtssh server start&
      The & character at the end of the tssh server start command ensures that the process runs in the background, and you can continue to use the shell.
  13. (Applicable if you customized Tomcat files before the upgrade) Manually re-add the modifications in the web.xml and server.xml files.
  14. Verify the TrueSight Presentation Server HA upgrade by logging on to the primary and secondary computers. 
    The URL format is: http(s)://<TSPS_FQDN>:<tomcat_port>

    • On the primary computer: You must be able to view the application without any errors.
    • On the secondary computer: You must be able to see the following message:
      You accessed a system that is in standby mode. Contact you system administrator for assistance.

  15. (Applies only if you had configured HTTP access before the upgrade) Reconfigure the TrueSight Presentation Server for HTTP access as described in the steps.

     Steps for configuring HTTP access
    1. Log in to the Presentation Server host computer, and navigate to the following directory:

      • (Windows): <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf
      • (Linux): <Presentation Server installation directory>/truesightpserver/modules/tomcat/conf
    2. In a text editor, edit the \web.xml file and comment out the security-constraint section so that it reads as follows:

      <!--

      <security-constraint>

              <web-resource-collection>

                  <web-resource-name>Secure context</web-resource-name>

                  <url-pattern>/*</url-pattern>

                  </web-resource-collection>

                  

                  <user-data-constraint>

                  <transport-guarantee>CONFIDENTIAL</transport-guarantee>

                  </user-data-constraint>

          </security-constraint>

      -->

    3. In a text editor, edit the <Presentation Server installation directory>\truesightpserver\modules\tomcat\conf\server.xml file:
      1. Modify the following line:

        <Connector connectionTimeout="20000" enableLookups="false" port="80" protocol="HTTP/1.1" redirectPort="443"/>

        Then, remove the redirectPort information and copy the compressableMimeType, compression, and compressionMinSize property information from the HTTPS connector so that it reads as follows:

        <Connector connectionTimeout="20000" enableLookups="false" port="80" protocol="HTTP/1.1" compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json" compression="on" compressionMinSize="1024" />

        Note

        The default port for Windows is 80 and Linux is 8080. If you specified a custom port during installation, enter that port number instead.

      2. Comment out the following line so that it reads as follows:

        <!-- <Connector SSLEnabled="true" ciphers="TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,
        TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_DHE_RSA_WITH_AES_128_GCM_SHA256,
        TLS_DHE_DSS_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_128_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_SHA256,
        TLS_ECDHE_RSA_WITH_AES_128_SHA,TLS_ECDHE_ECDSA_WITH_AES_128_SHA,TLS_ECDHE_RSA_WITH_AES_256_SHA384,
        TLS_ECDHE_ECDSA_WITH_AES_256_SHA384,TLS_ECDHE_RSA_WITH_AES_256_SHA,TLS_ECDHE_ECDSA_WITH_AES_256_SHA,
        TLS_DHE_RSA_WITH_AES_128_SHA256,TLS_DHE_RSA_WITH_AES_128_SHA,TLS_DHE_DSS_WITH_AES_128_SHA256,
        TLS_DHE_RSA_WITH_AES_256_SHA256,TLS_DHE_DSS_WITH_AES_256_SHA,TLS_DHE_RSA_WITH_AES_256_SHA"
        clientAuth="false" compressableMimeType="text/html,text/xml,text/plain,text/css,text/javascript,application/javascript,application/json" compression="on" compressionMinSize="1024" keystoreFile="C:/Program Files/BMC Software/TrueSightPServer/truesightpserver/conf/secure/loginvault.ks" keystorePass="changeit" maxThreads="150" port="4435" protocol="org.apache.coyote.http11.Http11NioProtocol" scheme="https" secure="true" sslProtocol="TLSv1.2" useServerCipherSuitesOrder="true"/>
        -->

    4. From the <Presentation Server installation directory>\truesightpserver\truesightpserver\bin folder, use a command prompt to run the following commands:

      tssh properties set tspsPreferredWebServiceProtocol http

      tssh properties set tsps.xsrf.cookie.secure false

    5. If you want to use the TrueSight console to deploy and install packages on a PATROL Agent, from the <Presentation Server installation directory>\truesightpserver\truesightpserver\bin folder, use a command prompt to run the following command:

      tssh properties set server.port.websrv.protocol http

    6. Restart the TrueSight Presentation Server. 
    7. On each Infrastructure Management server connected to the TrueSight Presentation Server, set the following properties In the <Infrastructure Management installation directory>\pw\custom\conf\pronet.conf file:

      • tsps.tsim.http.enabled=true

      • pronet.xsrf.token.secure=false

    8. On each Infrastructure Management server, reload the newly updated properties of the Infrastructure Management server running the pw jproperties reload command.

    Your upgrade is now complete.
    You do not need additional configurations for the load balancer.

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.

     Steps for changing the IP address to the FQDN
    1. On the TrueSight console, navigate to Administration > Components.
    2. Edit the TrueSight Infrastructure Management components.
    3. Change the host name from the IP address to the FQDN and save the details.

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.

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

Comments