Prepare for Upgrade

This topic helps you prepare for upgrading Eucalyptus.

Prerequisites

Before starting the upgrade, ensure that you have:

Verified that your hardware and software are compatible with 4.4. See the Compatibility Matrix in the Release Notes for supported versions.
Verified the health of your current Eucalyptus deployment, as described in Inspect System Health in the Administration Guide.
Followed the prescribed upgrade paths of prior Eucalyptus versions, if needed, to prepare for this upgrade.
Backed up your data and followed best practices for your environment. See RHEL documentation. See also Back Up Eucalyptus Cloud Data in the Administration Guide.
Prepared to upgrade all Eucalyptus services. Eucalyptus does not support services that are on different release versions. For example, you cannot have a CLC at 4.4.4 and a Walrus at 4.4.3.
Verified that you already have the repositories installed for Euca2ools and EPEL from your previous installation. If you do not have these installed, see the installation instructions for that version's Installation Guide in the documentation archive to find out how to add these to your host machines.
Fully updated your existing (pre-4.4.4) Eucalyptus services using yum update where possible.
Removed any hand-written repository files for earlier versions of Eucalyptus and Euca2ools from /etc/yum.repos.d.

Important:

Perform the upgrade steps on every Eucalyptus host machine, as described in this section.
We recommend that you also install the new version of the Management Console, although this is not required. If you don't install the new version, you will not be able to use new features from the console.
We recommend that you install the current version of Euca2ools, although this is not required. If you don't install the new version of Euca2ools, you will not be able to use new features from the command line.
Federated Eucalyptus clouds began with 4.2.0; you can upgrade a 4.2.x cloud to a federated setup. If you have a 4.1.x or earlier cloud, it cannot have any non-Eucalyptus services accounts created, nor can it be an LDAP integrated cloud. For more information, see Manage Regions in the Administration Guide.

Tip: You can preview the install and its dependencies by running the following commands. Be sure and respond with 'N' so you do not start the install before you are ready.

To preview the upgrade of Eucalyptus cloud

The following steps are an optional preview of what the upgrade command will do. If you do not want to do this, continue to Shutdown Services.

(Optional) Test the new Eucalyptus release package on each host machine that runs a Eucalyptus service:
```
yum install http://downloads.eucalyptus.cloud/software/eucalyptus/4.4/rhel/7/x86_64/eucalyptus-release-4.4-2.8.as.el7.noarch.rpm
```
Review the dependencies and install package information.

Enter N when prompted so you do NOT install the package.
(Optional) Test the new Euca2ools release package on each host machine that runs Euca2ools or a Eucalyptus service:
```
yum install http://downloads.eucalyptus.cloud/software/euca2ools/3.4/rhel/7/x86_64/euca2ools-release-3.4-2.2.as.el7.noarch.rpm
```
Review the dependencies and install package information.

Enter N when prompted so you do NOT install the package.
(Optional) If you have a Eucalyptus subscription, test the new subscription release package on each host machine that runs a Eucalyptus service:
```
yum install http://downloads.eucalyptus.com/software/subscription/eucalyptus-enterprise-release-4.4-1.el7.noarch.rpm
```
Review the dependencies and install package information.

Enter N when prompted so you do NOT install the package.

You are now ready to Shutdown Services.