1. Home
  2. Docs
  3. ClusterControl
  4. Getting Started

Getting Started

Step 1

Install the latest ClusterControl:

$ wget --no-check-certificate https://severalnines.com/downloads/cmon/install-cc
$ chmod +x install-cc
$ ./install-cc # as root or sudo user

If you have multiple network interface cards, assign one IP address for the HOST variable as per the example below:

$ HOST= ./install-cc # as root or sudo user

ClusterControl relies on a MySQL server as a data repository for the clusters it manages and an Apache server for the User Interface. The installation script will always install an Apache server on the host. An existing MySQL server can be used or a new MySQL server install is configured for minimum system requirements. If you have a larger server please make the necessary changes to the my.cnf file and restart the MySQL server after the installation.

If you want to perform a non-interactive installation, you can assign each variable with its value beforehand, similar to the example below:

$ S9S_CMON_PASSWORD=cmon S9S_ROOT_PASSWORD=root123 S9S_DB_PORT=3306 HOST= ./install-cc

Step 2

Open your web browser to https://{ClusterControl IP address or hostname}/clustercontrol and create the default admin user by entering a valid email address and password.

Step 3

Setup passwordless SSH to all target nodes (ClusterControl and all database nodes). Run the following commands on the ClusterControl server:

$ ssh-keygen -t rsa # press enter on all prompts
$ ssh-copy-id -i ~/.ssh/id_rsa {ClusterControl IP address}
$ ssh-copy-id -i ~/.ssh/id_rsa {Database nodes IP address} # repeat this to all target database nodes

For cloud infrastructure, you may skip this step since all nodes should have been configured with a key pair. Ensure the key pair exists in the ClusterControl node and you are good for the next step.


If you use a non-root user, then it must be in sudoers on all nodes. Read here for details.

Step 4

Deploy a new server/cluster or import an existing database server/cluster into ClusterControl via:

Step 5

Start managing and monitor your database instances:

Step 6

Was this article helpful to you? Yes No

How can we help?