Product SiteDocumentation Site

14. Upgrade

Warning

The CloudStack upgrade does not preserve UI customizations. Customers with customizations should save altered files before applying the upgrade. Then create a script that will re-apply the changes after the upgrade. Any customizations should be tested on a staging environment prior to upgrade to a new version.

14.1.  Upgrade from 2.2.0, 2.2.1, 2.2.2, 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.2.7, or 2.2.8 to 2.2.9

Perform the following to upgrade from 2.2.0, 2.2.1, 2.2.2, 2.2.3, 2.2.4, 2.2.5, 2.2.6, 2.2.7 or 2.2.8 to 2.2.9.
  1. Stop the Management Servers. Run this on all Management Server hosts.
    # service cloud-management stop
  2. Untar the tgz download and cd into the resulting directory. Then update the software on each Management Server
    # ./install.sh
    Choose "U" to update packages.
  3. Start the management server

    Important

    If you have multiple management servers, start only one at this point.
    # service cloud-management start
  4. Wait until the UI is accessible

    Note

    If you have additional management servers you may start them after the UI is accessible on the first management server.

14.1.1. KVM Hosts

Additional steps are required for each KVM host. These steps should be performed after the after the Management server upgrade above. These teps will not impact running guests in the cloud. These steps are required only for clouds using KVM as the hypervisor and only on the KVM hosts.
On each KVM host:
  1. Copy the install tarball to each host, untar it, and cd into the resulting directory.
  2. Stop the running agent.
    # service cloud-agent stop
  3. Update the agent software.
    # ./install.sh
    Choose "U" to update the packages.
  4. Start the agent.
    # service cloud-agent start

14.1.2. Special steps for Ubuntu management servers

In CloudStack 2.2.7 bug 10343 one of our community members alerted us to an Ubuntu-specific upgrade bug. This bug was introduced by our buildsystem configuration for Ubuntu. The following steps will be necessary to successfully upgrade any version of CloudStack prior to 2.2.8.
  1. Stop the management server
    # service cloud-management stop
  2. Change the database version
    Assuming that the version which you are upgrading from is 2.2.7 open a mysql console with:
    # mysql -u root -t cloud
    Once connected execute:
    update version set version='2.2.7' where id=1;
  3. Upgrade the management server.
    This will require manually installing cloud-agent-deps.
    # dpkg -i --force-overwrite oss/cloud-agent-deps_version_of_2.2.8_amd64.deb
  4. You can now run ./install.sh on the managment server and select 'U'. The management server will automatically start and upgrade the database.