1. Home
  2. Docs
  3. ClusterControl
  4. Administration
  5. Upgrading ClusterControl

Upgrading ClusterControl

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.

Red Hat/CentOSDebian/Ubuntu

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-tools

2) Optionally, it’s recommended to remove the deprecated CMONAPI component:

yum remove clustercontrol-cmonapi

3) Restart the ClusterControl services:

For sysvinit/upstart:

service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restart

For systemd:

systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloud

The upgrade is now complete. Verify the new version at ClusterControl UISettingsRuntime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.

Attention

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-tools

2) Optionally, it’s recommended to remove the deprecated CMONAPI component:

sudo apt-get remove clustercontrol-cmonapi

3) Restart the ClusterControl services:

For sysvinit/upstart:

service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restart

For systemd:

systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloud

The upgrade is now complete. Verify the new version at ClusterControl UISettingsRuntime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.

Attention

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.

Red Hat/CentOSDebian/Ubuntu

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 UI
  • clustercontrol-controller – ClusterControl Controller (CMON)
  • clustercontrol-notifications – ClusterControl event module
  • clustercontrol-ssh – ClusterControl web-ssh module
  • clustercontrol-cloud – ClusterControl cloud module
  • clustercontrol-clud – ClusterControl cloud’s file manager module
  • s9s-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 restart

For systemd:

systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloud

The upgrade is now complete. Verify the new version at ClusterControl UISettingsRuntime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.

Attention

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 UI
  • clustercontrol-controller – ClusterControl Controller (CMON)
  • clustercontrol-notifications – ClusterControl event module
  • clustercontrol-ssh – ClusterControl web-ssh module
  • clustercontrol-cloud – ClusterControl cloud module
  • clustercontrol-clud – ClusterControl cloud’s file manager module
  • s9s-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*.deb

3) Restart the ClusterControl services:

For sysvinit/upstart:

service cmon restart
service cmon-ssh restart
service cmon-events restart
service cmon-cloud restart

For systemd:

systemctl daemon-reload
systemctl restart cmon cmon-ssh cmon-events cmon-cloud

The upgrade is now complete. Verify the new version at ClusterControl UISettingsRuntime Configuration or by using the command cmon -v. You should re-login if your ClusterControl UI session is active.

Was this article helpful to you? Yes No