Table of Contents
There are several ways to upgrade ClusterControl to the latest version. However, we recommend users to perform Online Upgrade where the instructions are mostly up-to-date.
Online Upgrade
This is the recommended way to upgrade ClusterControl. The following upgrade procedures require an internet connection on the ClusterControl node.
1) Clear yum cache so it will retrieve the latest repository list and perform the upgrade:
yum clean all
yum install clustercontrol \
clustercontrol-controller \
clustercontrol2 \
clustercontrol-ssh \
clustercontrol-notifications \
clustercontrol-cloud \
clustercontrol-clud \
s9s-tools2) Optionally, it’s recommended to remove the deprecated CMONAPI component:
yum remove clustercontrol-cmonapi3) Restart the ClusterControl services:
For sysvinit/upstart:
service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restartFor systemd:
systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloudThe upgrade is now complete. Verify the new version at ClusterControl UI → Settings → Runtime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.
If you are upgrading to ClusterControl v1.8.2, we strongly advise you to create a new admin user and re-create the whole users/groups in the new user management system. See User Management for details. To activate the new user management system, please refer to Enabling New User Management. For LDAP settings, please refer to the LDAP Migration Procedure section.
1) Update the repository list and perform the upgrade:
sudo apt-get update
sudo apt-get install clustercontrol \
clustercontrol-controller \
clustercontrol2 \
clustercontrol-ssh \
clustercontrol-notifications \
clustercontrol-cloud \
clustercontrol-clud \
s9s-tools2) Optionally, it’s recommended to remove the deprecated CMONAPI component:
sudo apt-get remove clustercontrol-cmonapi3) Restart the ClusterControl services:
For sysvinit/upstart:
service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restartFor systemd:
systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloudThe upgrade is now complete. Verify the new version at ClusterControl UI → Settings → Runtime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.
If you are upgrading to ClusterControl v1.8.2, we strongly advise you to create a new admin user and re-create the whole users/groups in the new user management system. See User Management for details. To activate the new user management system, please refer to Enabling New User Management. For LDAP settings, please refer to the LDAP Migration Procedure section.
Offline Upgrade
The following upgrade procedures can be performed without an internet connection on the ClusterControl node.
1) Download the latest version of ClusterControl related RPM packages from Severalnines download site and Severalnines Repository. There are a number of packages you need to download as explained below:
clustercontrol– ClusterControl UIclustercontrol-controller– ClusterControl Controller (CMON)clustercontrol-notifications– ClusterControl event moduleclustercontrol-ssh– ClusterControl web-ssh moduleclustercontrol-cloud– ClusterControl cloud moduleclustercontrol-clud– ClusterControl cloud’s file manager modules9s-tools– ClusterControl CLI (s9s)
2) Install using yum to satisfy all dependencies:
yum localinstall clustercontrol*
yum localinstall s9s-tools*3) Restart the ClusterControl services:
For sysvinit/upstart:
service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restartFor systemd:
systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloudThe upgrade is now complete. Verify the new version at ClusterControl UI → Settings → Runtime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.
If you are upgrading to ClusterControl v1.8.2, we strongly advise you to create a new admin user and re-create the whole users/groups in the new user management system. See User Management for details. To activate the new user management system, please refer to Enabling New User Management. For LDAP settings, please refer to the LDAP Migration Procedure section.
1) Download the latest version of ClusterControl related DEB packages from the Severalnines download site and Severalnines Repository. There are a number of packages you need to download as explained below:
clustercontrol– ClusterControl UIclustercontrol-controller– ClusterControl Controller (CMON)clustercontrol-notifications– ClusterControl event moduleclustercontrol-ssh– ClusterControl web-ssh moduleclustercontrol-cloud– ClusterControl cloud moduleclustercontrol-clud– ClusterControl cloud’s file manager modules9s-tools– ClusterControl CLI (s9s) – Download it from here.s9s-tools-lib– ClusterControl CLI (s9s) library – Download it from here.
2) Upload the packages to the server and install them using dpkg command:
sudo dpkg -i clustercontrol*.deb
sudo dpkg -i libs9s0*.deb
sudo dpkg -i s9s*.deb3) Restart the ClusterControl services:
For sysvinit/upstart:
service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restartFor systemd:
systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloudThe upgrade is now complete. Verify the new version at ClusterControl UI → Settings → Runtime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.