Upgrading

Performing the upgrade

1. Start the installation program by running the setup (for Windows) or setup.bin (for Linux) file. Click Next.
2. Read the license agreement and agree to the terms. Click Next.

3. Depending on the type of upgrade, perform the steps described in the following table:

   Upgrade type	Steps
   Typical install	Depending on your platform, you can choose to keep the following check box selections unchanged and click Next: (Windows only) Check box for pinning the product to your Start menu, and starting the product services immediately after the upgrade is complete.   (Windows and Linux) Check box for starting the product services immediately after the upgrade is complete.
   Custom install	The features to be upgraded are automatically displayed as per your earlier installation. Click Next. (Windows only) The check box for pinning the product to your Start menu is displayed. You can choose to keep the default selection unchanged and then click Next.

   The Installation Preview screen is displayed, providing information about the features to be installed, the total disk size, the destination directory, and so on.    

4. Click Install to start the upgrade.  

5. (Optional) Click View Log to see the installation log.

6. To exit the installation program, click Done.
   By default, the following environment variable pointing to the product installation path is automatically set: 
    

   Windows	Linux
   %BMC_ITDA_HOME%	$BMC_ITDA_HOME

7. To view the upgraded version of the product, reload the current browser page so that the cached content is ignored.

   Tip

   Reload the page by pressing Ctrl+F5 on the browser page.

     

8. With Version 2.0.00, BMC TrueSight IT Data Analytics has enhanced security checks to prevent CSRF attacks. You might have to configure the system before you can access it. For more information, see Configuring access URLs. 

9. If you want to enable security for the Console Server, you need to configure the system. For more information, see  Enabling security for third-party certificates.

Rolling back a failed upgrade

If your upgrade fails or the product does not work after the upgrade is completed, you can rollback the failed upgrade to an earlier version of the product. An upgrade failure might occur in one of the following scenarios:

• If you made any changes to the Configuration Database.
• If the ports used for the upgrade are unavailable.
• If you do not have sufficient permissions to perform the installation. For more information, see Preparing for installation.

When you perform an upgrade, the following files are automatically backed up at %BMC_ITDA_HOME%\Upgrade_Backup_version:

For more information, see Modifying the configuration files.

Note: The product does not automatically back up the indexed data, therefore you need to manually create a back up.

To rollback a failed upgrade to an earlier version

1. Create a back up of the indexed data at an appropriate location.
2. Uninstall the product to which you upgraded. For more information, see Uninstalling.
3. Install the previous version of the product.
   Note: During installation, ensure that the product services are not started immediately after the installation is complete.

4. After the installation is complete, copy the backed up files to the appropriate locations:

   From	To
   %BMC_ITDA_HOME%\Upgrade_Backup_version\conf	%BMC_ITDA_HOME%\conf
   %BMC_ITDA_HOME%\Upgrade_Backup_version\custom	%BMC_ITDA_HOME%\custom
   %BMC_ITDA_HOME%\Upgrade_Backup_version\station\collection	%BMC_ITDA_HOME%\station\collection
   %BMC_ITDA_HOME%\Upgrade_Backup_version\data\configdb	%BMC_ITDA_HOME%\data\configdb
   %BMC_ITDA_HOME%\Upgrade_Backup_version\data\indexer	%BMC_ITDA_HOME%\tomcat\webapps

5. Start the product services. For more information, see Starting or stopping product services.
6. Start the product. For more information, see Accessing the console.
   The product is restored to the earlier version along with the indexed data, configuration data, and any customizations you must have made.