Upgrading Stratus Cloud Workload Services

This topic describes how to upgrade Stratus Cloud Workload Services to a newer version. Use this procedure only to upgrade Workload Services from Version 1.5 to 1.5.x or higher. If you need to upgrade a Version 1.0.x system, contact your service representative for assistance.

Upgrading Workload Services upgrades only the Stratus appliance. If there are associated upgrades for the KVM-FT hypervisors and quorum servers, you must install them separately. See Upgrading Stratus Cloud Availability Services.

To upgrade Workload Services:

1. Log on to Workload Services and verify that your cloud and applications are in a healthy state. Resolve any outstanding advisories before upgrading the software.
2. Log on to the Stratus appliance as the cloud-user and execute the su command to become the root user (or be prepared to use sudo to run commands as root).

3. Optionally, verify the current version number of Workload Services by entering a command similar to the following:

   # rpm -qa | grep stratus
   stratus-clouds-0.1.5.24.3-0.fc14.noarch

4. If you have not already done so, install the yum-utils package for access to additional yum commands:

   # yum install yum-utils

5. Verify that there are no unfinished yum transactions by entering the following yum command:

   # yum-complete-transaction --cleanup-only
   Loaded plugins: fastestmirror
   Loading mirror speeds from cached hostfile
   * base: mirror.sanctuaryhost.com
   * epel: mirror.cogentco.com
   * extras: centos.mirror.nac.net
   * updates: mirror.wiredtree.com
   No unfinished transactions left.

   If there are unfinished transactions, resolve them before continuing with the upgrade.

6. If you have not already done so, in the /opt directory, create a directory called Release:

   # mkdir /opt/Release

7. Download the new Workload Services installation script from the Stratus Cloud Solution Downloads and Support page at http://www.stratus.com/services-support/downloads to a local management PC.
8. Transfer the installation script to the /opt/Release directory. For example, use a secure copy (SCP) utility to copy the file from the local management PC to the Stratus appliance. (If you copy the script to your /home/cloud-user account, move the script to the /opt/Release directory.)

9. In the Stratus appliance, switch to the /opt/Release directory:

   # cd /opt/Release

10. Run the following command to make the installation script an executable file, where script is the name of the script:

    # chmod a+x script.sh

11. Ensure that the installation configuration file for the appliance (for example, install.conf) is in the same /opt/Release directory. Verify that the settings in the configuration file are up to date. For information, see Creating an Installation Configuration File for Stratus Cloud Workload Services.

12. Run the install script specifying the install option and the name of the installation configuration file; for example:

    # ./clouds-n.n.n.n.n.sh install install.conf

    The installation script begins the upgrade process for the Workload Services software.

    Notes:  

    • The install option automatically detects and upgrades the existing cloud software, if present. For more information about the installation script options, see Stratus Cloud Workload Services Installation Script Options.
    • Do not stop an upgrade while it is running; otherwise, it will leave your cloud in an inconsistent state. If an upgrade fails for any reason, contact your service representative for assistance.

13. When the installation script is finished, optionally verify the new version number of Workload Services by entering a command similar to the following:

    # rpm -qa | grep stratus
    stratus-clouds-0.1.5.25.8-0.fc14.noarch

14. Go to https://ThisCentOSFloatingIP and verify that Workload Services is functioning properly.
15. If needed, upgrade your KVM-FT hypervisors. See Upgrading Stratus Cloud Availability Services.

Related Topics

Uninstalling Stratus Cloud Workload Services