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:

   Artifacts to be backed up	Details
   Databases	Reports data warehouse TrueSight Smart Reporting - Platform repository database
   RSA secure ID authentication file	The sdconf.rec file at the following path: <tssadw_installation_directory>/br/
   User roles and permissions related file (if changed)	The user_roles.csv file at the following path: <tssadw_installation_directory>\shared\ConfigurationManagement\
   CA-signed certificate files (if used)	server.xml and keystore.jks (or the custom keystore file) at the following path: <tssadw_installation_directory>/tomcat/conf/
   PKI authentication related files (if used)	.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/
   Remedy Single Sign-On (SSO) related files (if used)	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

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
      PKI	set PkiAuth IsEnabled false
      RSA Secure ID	set AuthServer IsSecurIDAuthEnabled false
      Remedy Single Sign-On	set RemedySsoAuth IsEnabled 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:

• Upgrading using the wizard
• Upgrading silently