Every now and then, we come out with updates for ClusterControl, and we warmly recommend that you keep your software up-to-date. Let alone all the new features that help you better manage your database cluster, using the latest version ensures that you can avoid issues that have already been corrected.

You can review the changelog to see the list of changes in previous versions, as well as the list of things we are working on for the next release.

In this post, we will explain how you can upgrade ClusterControl to the latest version (1.2.2 at the time of writing). ClusterControl versions below 1.2.0 do not have the new ClusterControl UI (accessible at http://ClusterControl_IP_address/clustercontrol). The upgrade will install the new UI. Note that you can still use the old UI, although it is deprecated.

To help you upgrade, we have some options for you to consider.



Automatic Upgrade


This is the recommended way to keep ClusterControl up-to-date. Download the upgrade tool available from our Git repository, and execute it from the ClusterControl server. It will automatically find the latest stable version, and apply the upgrade to the ClusterControl server and agents. For more information, please read this article from our knowledge base

Let’s look at a couple of examples.

Example #1: Upgrading from 1.1.35a on CentOS 6.3 64-bit

1. Check the current version by going to ClusterControl > Settings > Configuration > Version:

2. From the ClusterControl server, start the upgrade process:

$ git clone
$ cd s9s-admin/ccadmin
$ ./s9s_upgrade_cmon --latest

3. Since the upgrade is from a version prior to 1.2.0, we need to finalize the installation of the new UI by going to http://ClusterControl_IP_address/install. You should see the following:


4. Enter required details (email address, password and MySQL root password) and click “Install”.

5. You will then be prompted to register your cluster. Login to ClusterControl and you will be redirected to a Cluster Registrations form. Just click “Register” to complete the process.


6. From the new UI, you can view the version number by going to Settings > General Settings > Version :



Example #2: Upgrading from ClusterControl 1.2.0 on Ubuntu 12.04 LTS 64-bit


1. Check the current version by going to Settings > Configuration > Version :


2. Start the upgrade process:

$ git clone
$ cd s9s-admin/ccadmin
$ sudo ./s9s_upgrade_cmon --latest


3. Verify the new version number after the upgrade:


Manual Upgrade

For advanced users who prefer to have more control over the process, it is possible to upgrade manually. A manual upgrade is also required for those running v1.1.33 or older. 

You can find the latest manual upgrade instructions in our knowledge base.

Related Post