Page tree

This section provides information about upgrading the BMC TrueSight IT Data Analytics product from an earlier version.

Before you begin

Ensure that the earlier version of the product is up and running.

Related topics
If a problem occurs

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 typeSteps
    Typical installDepending 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: 

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


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

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:

Type of dataFile location
Configuration Database%BMC_ITDA_HOME%\data\configdb
Collection Station%BMC_ITDA_HOME%\station\collection
Console Server + Search%BMC_ITDA_HOME%\tomcat\webapps
Configuration files%BMC_ITDA_HOME%\conf
Customized settings%BMC_ITDA_HOME%\custom

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:

    %BMC_ITDA_HOME%\Upgrade_Backup_version\conf %BMC_ITDA_HOME%\conf
    %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.