Backup and Rollback During CA APM Upgrade

If you experience a failure during the upgrade process, performance issues, or loss of functionality, roll back the changes to return the application to its previous state.
apmdevops106
If you experience a failure during the upgrade process, performance issues, or loss of functionality, roll back the changes to return the application to its previous state.
Rollback is supported only for the Postgres Database.
The installer backs up the current state of CA APM and lets you proceed with upgrade. If you encounter any errors, roll back to the previous CA APM instance.
CA Technologies recommends that you use one of the following options when upgrading in GUI or console mode, otherwise rollback can fail:
  • Select custom installation to upgrade only Enterprise Manager or upgrade Enterprise Manager and WebView.
  • Select complete installation to upgrade all components.
Prerequisites
To backup the existing CA APM instance, you must meet the minimum disk space. The installer backs up the existing instance to the hard disk or storage area network. When the upgrade is successful, clean up the unwanted backup.
Minimum Disk Space Requirement:
You must have a minimum disk space equal to 1.5 times the Enterprise Manager Home disk space. You must have at a minimum, 1.5 times the Database disk space to back up the existing instance of CA APM and Database.
For more information about how to backup the CA APM, see Upgrade the Enterprise Manager.
Roll Back the Enterprise Manager or APM Database
If the installer encounters an error, manually roll back to the previous working version of CA APM. The installer places a backup file with the backup identification number in the 
APMRollback
 directory.
Rollback is supported only for the Postgres Database.
Note the Rollback ID Number
For Enterprise Manager only or complete upgrade:
Open the 
backup.id
 file available at 
<EM_HOME>
 of the newly installed Enterprise Manager and note the ID number.
For a Database only upgrade:
Open the 
backup.id
 file available at the new 
<DB_HOME>,
 and note the id number.
APMRollback Directory Location
In the Enterprise Manager only or complete upgrade, the directory is available at the parent directory of 
<EM_Home>
. In the Database only upgrade, the directory is available at the parent directory of 
<DB_Home>
.
Roll Back CA APM
(Windows only) Run the following rollback command as the administrator from the 
APMRollback
 directory:
rollback.bat rollback <id>
(UNIX only) Run the following rollback command from the 
APMRollback
 directory as the user who performed the upgrade:
./rollback.sh rollback <id>
Clean up the Backup Directory
(Windows only) Run the following cleanup command as the administrator from the 
APMRollback
 directory:
rollback.bat cleanup <id>
(UNIX only) Run the following cleanup command from the 
APMRollback
 directory as the user who performed the upgrade:
./rollback.sh cleanup <id>