CloudLinux - Setting up KuberDock with CEPH
Getting started with KuberDock

 

In this article, we will show you how to install KuberDock with CEPH storage.

The process starts by downloading the installation script and running it in on KuberDock master server.

Log in to the master server console as root using your preferred SSH terminal application and perform the following steps:

If you haven’t installed “w-get” then install it first:

yum install wget

Download the installation script by running the following command:

wget http://repo.cloudlinux.com/kuberdock/deploy.sh

To install the cluster with CEPH support, the following options for the deploy script must be defined:

Name of a user in CEPH cluster, (in CEPH config it is referred to as the `client.<username>`).

The second option is the path to the CEPH configuration file. It should be copied to KuberDock master server from CEPH admin host. For example, if the file is copied to E-T-C ceph folder, then the option will be --ceph-config /etc/ceph/ceph.conf.

The third option is the CEPH user keyring which defines the path to the keyring file with credentials for CEPH user. It should be copied from CEPH admin host to KuberDock master server. If you cannot find this file, you can create one by running the following command on the CEPH admin host:

ceph auth export client.username > ceph.client.username.keyring

Finally, to start KuberDock installation deploy script with CEPH support you need to run the command which looks as follows:

bash ./deploy.sh --ceph-user your_ceph_user --ceph-config /path/to/ceph.conf --ceph-user-keyring /path/to/client.your_ceph_user.keyring

You’ll need to enter just a bit of additional technical information during the installation process:

Enter the IP address of the KuberDock internal network interface for master server to connect to the nodes or press ENTER.

Enter interface to bind public IP addresses to on nodes or press ENTER.

When the installation is completed, you will see the completion message and the saved log location. It is important to copy and save the KuberDock admin credentials, including the unique IP.

Installation completed and log saved to /var/log/kuberdock_master_deploy.log
KuberDock is available at https://master-ip/
login: admin
password: [your password]

Now, we need to activate the newly installed KuberDock cluster using the license activation key.

You can obtain a license key in your CLN account. It’s also sent to you via e-mail upon the trial activation or license purchase.

In the web browser, log in to KuberDock admin interface using your administrator credentials, provided to you at the end of the installation process.

Go to the SETTING page and click LICENCE. Click EDIT icon next to the Installation ID field, fill in your activation key and click Apply.

Your KuberDock cluster will be activated within a few minutes. The type of license is displayed at the top.

That’s it. We have just finished the KuberDock master server installation with CEPH support.