Skip to content
This repository has been archived by the owner on Feb 27, 2020. It is now read-only.

Upgrading a Clearwater Deployment

Jump to bottom
graemerobertson edited this page Mar 4, 2015 · 4 revisions

Upgrading a Clearwater Deployment

This article explains how to upgrade a Project Clearwater deployment.

Quick Upgrade

The quickest way to upgrade is to simply upgrade all your nodes in any order. There is no need to wait for one node to finish upgrading before moving onto the next.

This is recommended if you:

  • Do not have a fault-tolerant deployment (e.g. the All-in-One image, or a deployment with one node of each type) OR
  • Do not need to provide uninterrupted service to users of your system.

Note that during a quick upgrade your users may be unable to register, or make and receive calls. If you do have a fault-tolerant deployment and need uninterrupted service, see "Seamless Upgrade" below.

Manual Install

If you installed your system using the [Manual Install Instructions](Manual Install) simply run sudo clearwater-upgrade on each node.

Chef Install

If you installed your deployment with [chef](Creating a deployment with Chef):

  • Follow the instructions to update the Chef server
  • Run sudo chef-client followed by 'sudo clearwater-upgrade' on each node.

Seamless Upgrade

If your deployment contains at least two nodes of each type (excluding Ellis) it is possible to perform a seamless upgrade that does not result in any loss of service.

To achieve this the nodes must be upgraded one at a time and in a specific order: first all Ralf nodes (if present), then Homestead, Homer, Sprout, Memento (if present), Gemini (if present), Bono, and finally Ellis.

For example if your deployment has two Homesteads, two Homers, two Sprouts, two Bonos, and one Ellis, you should upgrade them in the following order:

  • Homestead-1
  • Homestead-2
  • Homer-1
  • Homer-2
  • Sprout-1
  • Sprout-2
  • Bono-1
  • Bono-2
  • Ellis

Manual Install

If you installed your system using the [Manual Install Instructions](Manual Install) run sudo clearwater-upgrade on each node in the order described above.

Chef Install

If you installed your deployment with [chef](Creating a deployment with Chef):

  • Follow the instructions to update the Chef server
  • Run sudo chef-client followed by 'sudo clearwater-upgrade' on each node in the order described above.
Clone this wiki locally