Preparing to upgrade TrueSight Server Automation - Data Warehouse


Where you are in the Upgrade process

Preparing to upgrade TrueSight Server Automation - Data Warehouse

Upgrading TrueSight Server Automation - Data Warehouse requires you to complete various pre-upgrade tasks. Do the following:

  1. Download the product files from the BMC Electronic Product Distribution (EPD) location:TrueSight Server Automation - Data Warehouse 
  2. Review the System-requirements-for-TrueSight-Server-Automation-Data-Warehouse.
  3. Ensure that you are upgrading from one of the versions supported by upgrade paths.
  4. Ensure that all extract, transform, and load (ETL) runs have completed and that ETL is not running. For more information, see Viewing-the-ETL-status.

  5. Ensure that you have disabled the NSH proxy on the reports server to avoid failure during upgrade. To disable the NSH proxy, run the following command on the NSH client:

    secadmin -m default -p 5 -appserver_protocol clear -T encryption_only -e tls

    This command removes the appserver_protocol=ssoproxy entry from the default line in the secure file (in the rsc folder).

    Important

    After the upgrade completes, remember to add this entry back into the secure file. Use the following command to add the entry:

    secadmin -m default -p 5 -appserver_protocol ssoproxy

  6. Back up the following:

    Note

    You need to backup files only for the artifacts or the authentication mechanism you are using. For example, if you are using the PKI authentication, backup only the .jks or PKI truststore file and bdsSslCertificate.cert file from the path shown below in the following table.

    Artifact/authentication mechanism if being used

    Files to back up (back up files only for the artifact/authentication mechanism you are using)

    Databases

    • Reports data warehouse
    • TrueSight Smart Reporting - Platform repository database

    User roles and permissions related file 

    The user_roles.csv file at the following path:
    <tssadw_installation_directory>\shared\ConfigurationManagement\

    CA-signed certificate files 

    server.xml and keystore.jks (or the custom keystore file) at the following path:
    <tssadw_installation_directory>/tomcat/conf/

    Domain authentication files

    The blappserv_krb5.conf and blappserv_login.conf files at the following path:
    <tssadw_installation_directory>/br/

    LDAP authentication file

    The ldapTrustStore.p12 file at the following path:
    (Linux)<tssadw_installation_directory>/br/ldapTrustStore.p12
    (Windows)<tssadw_installation_directory>\bin\ldapTrustStore.p12

    Remedy Single Sign-On (SSO) related files

    • Remedy SSO keystore file (for example, tssadw-keystore.jks) from the directory where you stored it
    • rsso.cert file from the directory where you stored it

    PKI authentication related files

    • .jks or PKI truststore file at the following path:
      <tssadw_installation_directory>/br/
    • bdsSslCertificate.cert file at the following path:
      <tssadw_installation_directory>/tomcat/conf/

    RSA secure ID authentication file

    The sdconf.rec file at the following path:
    <tssadw_installation_directory>/br/

  7. Disable all the authentications that you configured:
    1. On the reports server, start the Application Server Administration console (the blasadmin utility):
      • (Windows) Navigate to the <TSSA-DWInstallationDirectory>\bin directory and enter the following command: blasadmin.
      • (UNIX) Navigate to the <TSSA-DWInstallationDirectory>/br directory and enter the following command: blasadmin.

    2. Disable the authentications that you are using by running the following commands:

      Authentication type

      Command to disable the authentication

      Domain

      set AuthServer isDomainAuthEnabled false

      LDAP

      set AuthServer IsLdapAuthEnabled false

      Remedy Single Sign-On 

      set RemedySsoAuth IsEnabled false

      PKI

      set PkiAuth IsEnabled false

      RSA Secure ID

      set AuthServer IsSecurIDAuthEnabled false

      For more information about the authentication types, see Implementing-authentication.

  8. If TrueSight Server Automation - Data Warehouse and TrueSight Smart Reporting - Platform are installed on the same computer, stop the TrueSight Smart Reporting - Platform services.
    • (Windows) Navigate to the <TSSR_INSTALL_DIR>\appserver\bin directory and run the following command: shutdown.bat
    • (Linux) From the command line, navigate to the <TSSR_INSTALL_DIR/appserver/bin directory and run the following command: ./shutdown.sh

Where to go from here:

Depending on your environment, upgrade TrueSight Server Automation - Data Warehouse using one of the following options:

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*