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

Getting Started

Step 1

Install the latest ClusterControl:

$ wget 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=192.168.1.10 ./install-cc # as root or sudo user
Note

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 one-liner installation, you can assign each variable with its value beforehand, similar to the example below:

$ SEND_DIAGNOSTICS=0 S9S_CMON_PASSWORD=SeCR3TP455w0rd S9S_ROOT_PASSWORD=SeCR3TP455w0rd S9S_DB_PORT=3306 HOST=10.10.10.100 ./install-cc

Where,

  • SEND_DIAGNOSTICS=0, to skip the prompt for sending the installation diagnostic information back to us.
  • S9S_CMON_PASSWORD=SeCR3TP455w0rd, the password for the CMON MySQL database user (will be created automatically by the installer script).
  • S9S_ROOT_PASSWORD=SeCR3TP455w0rd, the password for MySQL root user (will be configured automatically by the installer script).
  • S9S_DB_PORT=3306, the MySQL port to host the CMON database (will be configured automatically by the installer script).
  • HOST=10.10.10.100, the primary IP address of the ClusterControl server, commonly if the host has multiple IP addresses.

Step 2

Open your web browser https://{ClusterControl IP address or hostname}/and create the default admin user and password.

Step 3

Set up 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
Note

You may skip this step for cloud infrastructure since all nodes should have been configured with an SSH key or key pair. Ensure the private key exists in the ClusterControl node and you are good for the next step.

Attention

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 monitoring your database instances:

Step 6

Articles

Was this article helpful to you? Yes 1 No