Rolling back a failed IT Data Analytics 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 various scenarios. For example, if you do not have sufficient permissions to perform the installation. For more information, see Preparing for installation.

This topic contains the following sub-topics:

Files automatically backed up when performing an upgrade

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

  • The upgrade utility does not back up the indexed data. For information about backing up Indexed data, see Backing up and restoring indexed data .
  • Archived data is not backed up automatically.
  • The environment variable is:
    -(Windows) %BMC_ITDA_HOME%
    -(Linux) $BMC_ITDA_HOME.
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 .

To rollback a failed upgrade to an earlier version

  1. Uninstall the product to which you upgraded. For more information, see Uninstalling.
  2. Delete all directories and files except the backed up directory Upgrade_Backup_<version> from the location %BMC_ITDA_HOME%.

  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. Ensure that you do not delete the older folder. 

    FromTo
    %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\configdb

    %BMC_ITDA_HOME%\data\configdb

    %BMC_ITDA_HOME%\Upgrade_Backup_version\tomcat\webapps

    %BMC_ITDA_HOME%\tomcat\webapps
    %BMC_ITDA_HOME%\Upgrade_Backup_version\itdaInstalledConfiguration.xml%BMC_ITDA_HOME%\itdaInstalledConfiguration.xml
  5. Replace the %BMC_ITDA_HOME%\data\indexer folder by the indexed data folder backed up manually before upgrading.
  6. (Linux) The owner must be same for TrueSight IT Data Analytics installation directory and all its files. There is a possibility that, the owner may have changed during installation of TrueSight IT Data Analytics 11.3 or while copying the backed-up files. It is mandatory to change the owner of TrueSight IT Data Analytics installation directory and all its files to the appropriate owner (or previous owner). You can change the owner of TrueSight IT Data Analytics installation directory by using the following command:

    chown -R <PREVIOUS_OWNER>:<GROUP_NAME> <ITDA_INSTALLATION_DIRECTORY>
  7. Start the product services. For more information, see  Starting or stopping product services .
  8. 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.
Was this page helpful? Yes No Submitting... Thank you

Comments