Dealing with Failed Upgrades

The upgrade process creates a backup to /var/lib/eucalyptus/upgrade/eucalyptus.backup.<timestamp>. For example:

/var/lib/eucalyptus/upgrade/eucalyptus.backup.1326905212

If the upgrade fails and needs to be reverted to your earlier version, you can find your preserved data in this directory.

If for any reason your upgrade fails, all changes to the database and configuration files will be rolled back. You can retry the upgrade by following the upgrade instructions in the sections, Shutdown Components and Upgrade Eucalyptus Packages.

In the event that you choose not to go ahead with the upgrade after a failure, you can downgrade your installation back to the previous version. Please note that downgrade instructions are different, depending on whether your Eucalyptus services are co-located or each run on their own machine. You will need to perform the downgrade for all services running on a single machine at the same time.

Downgrade to the Eucalyptus 3.2.1 release package on each host.

yum downgrade http://downloads.eucalyptus.com/software/eucalyptus/3.1/centos/6/x86_64/eucalyptus-release-3.1.noarch.rpm

If you have a Eucalyptus subscription, downgrade your subscription release package on each host to the release package you obtained for Eucalyptus 3.1.
```
yum downgrade eucalyptus-enterprise-3.1*.rpm
```
Expire the cache for the yum repositories on each host.
```
yum clean expire-cache
```
Log in to each NC host and downgrade it. To downgrade to a specific version, append the version number to each package name. For example, to downgrade to 3.1.1, add -3.1.1 to each of the packages in the following list:
```
yum downgrade eucalyptus eucalyptus-gl eucalyptus-admin-tools eucalyptus-nc python-eucadmin
```

Important

Use the yum shell command for the following instructions. This will allow you to perform more complex transactions that are required for the downgrade.

Log in to each machine running a Eucalyptus service and run the following command:
```
yum shell
```
Add the transaction commands listed below for each component installed on the machine. If more than one component asks you to use the same transactional command, you only need to specify that command once.

CLC Service Transaction Commands:

downgrade eucalyptus-cloud
downgrade eucalyptus
downgrade eucalyptus-common-java
remove eucalyptus-common-java-libs
downgrade eucalyptus-admin-tools
downgrade python-eucadmin

Additional CLC Service Transaction Commands for Eucalyptus Subscription customers:

downgrade eucalyptus-enterprise-vmware-broker-libs
remove eucalyptus-enterprise-storage-san-common-libs
install eucalyptus-enterprise-storage-san-libs

CC Service Transaction Commands:

downgrade eucalyptus-cc
downgrade eucalyptus
downgrade eucalyptus-gl
downgrade eucalyptus-admin-tools
downgrade python-eucadmin

SC Service Transaction Commands:

downgrade eucalyptus-sc
downgrade eucalyptus
downgrade eucalyptus-common-java
remove eucalyptus-common-java-libs
downgrade eucalyptus-admin-tools
downgrade python-eucadmin

Walrus Service Transaction Commands:

downgrade eucalyptus-walrus
downgrade eucalyptus
downgrade eucalyptus-common-java
remove eucalyptus-common-java-libs
downgrade eucalyptus-admin-tools
downgrade python-eucadmin

SAN EMC Transaction Commands:

remove eucalyptus-enterprise-storage-san-emc
remove eucalyptus-enterprise-storage-san-emc-libs
remove eucalyptus-enterprise-storage-san-common
remove eucalyptus-enterprise-storage-san-common-libs
install eucalyptus-enterprise-storage-san
install eucalyptus-enterprise-storage-san-libs

SAN EqualLogic Transaction Commands:

remove eucalyptus-enterprise-storage-equallogic
remove eucalyptus-enterprise-storage-san-common
remove eucalyptus-enterprise-storage-san-common-libs
install eucalyptus-enterprise-storage-san
install eucalyptus-enterprise-storage-san-libs

SAN NetApp Transaction Commands:

remove eucalyptus-enterprise-storage-san-netapp
remove eucalyptus-enterprise-storage-san-netapp-libs
remove eucalyptus-enterprise-storage-san-common
remove eucalyptus-enterprise-storage-san-common-libs
install eucalyptus-enterprise-storage-san
install eucalyptus-enterprise-storage-san-libs

VMWare Broker Transaction Commands:

downgrade eucalyptus-enterprise-vmware-broker
downgrade eucalyptus-enterprise-vmware-broker-libs

When all transaction commands have been entered run the following command to verify that the transaction will be successful:
```
ts solve
```
Perform the downgrade by running the following command in the transaction shell:
```
run
```
Exit the transaction shell using the following command:
```
exit
```
Remove the /etc/eucalyptus/.upgrade file from each machine:
```
rm /etc/eucalyptus/.upgrade
```
Enter y when prompted, to remove this file. It is important to remove this file from every Eucalyptus host.