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 .
- Archived data is not backed up automatically.
- The environment variable is:
|Type of data||File location|
|Console Server + Search||%BMC_ITDA_HOME%\tomcat\webapps|
For more information, see .
To rollback a failed upgrade to an earlier version
- Uninstall the product to which you upgraded. For more information, see Uninstalling.
Delete all directories and files except the backed up directory Upgrade_Backup_<version> from the location %BMC_ITDA_HOME%.
Install the previous version of the product.
During installation, ensure that the product services are not started immediately after the installation is complete.
After the installation is complete, copy the backed up files to the appropriate locations. Ensure that you do not delete the older folder.
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%\tomcat\webapps %BMC_ITDA_HOME%\Upgrade_Backup_version\itdaInstalledConfiguration.xml %BMC_ITDA_HOME%\itdaInstalledConfiguration.xml
- Replace the %BMC_ITDA_HOME%\data\indexer folder by the indexed data folder backed up manually before upgrading.
(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>
- Start the product services. For more information, see .
- Start the product. For more information, see
The product is restored to the earlier version along with the indexed data, configuration data, and any customizations you must have made.