Sprint Aragorn Release Note

The release for Project Clearwater sprint “Aragorn” has been cut. The code for this release is tagged as release-118 in GitHub.

This release includes the following bug fixes:

Note that in this release, we are changing the way that Geographically Redundant (GR) deployments are set up. Specifically, we were splitting the etcd cluster so that there is one cluster for each site, rather than a single cluster spanning both. Because of this change, there are some one-time extra steps that must be taken prior to upgrading to this release. These steps differ depending on whether you are using a GR deployment or not:

If you are using a non-GR deployment (which is the norm):

Before you upgrade to this release, you must perform the following steps on any one node:

  1. Add sprout_registration_store=sprout.<zone> to /etc/clearwater/shared_config
  2. If you are using Ralf nodes, add ralf_session_store=ralf.<zone> to /etc/clearwater/shared_config
  3. Run cw-upload_shared_config
  4. Wait for all nodes to pick up the  new config by using cw-check_restart_queue_state to check when all nodes have restarted

Once this is done and all nodes have restarted, you can upgrade as normal.

If you are using a GR deployment:

Because of the move to split the etcd clusters across sites, upgrading a GR deployment is not supported using the usual methods. If you want help upgrading a GR deployment, contact us on the mailing list for instructions.


If you are deploying an all-in-one node, the standard image (http://vm-images.cw-ngv.com/cw-aio.ova) has been updated for this release.

Adam Lindley is a Software Engineer at Metaswitch Networks. Prior to moving into software engineering he studied Oriental Studies, specialising in classical literature. Outside work, his interests include music, food, drink and computer gaming.

Leave a Reply


captcha *