Install a cluster
Prerequisites
Before you install the ADS Control service on hosts with the CentOS 7 operating system, the current version of Docker must be preinstalled.
The Docker pre-installation is configured on the configuration page of the ADS Control service in the Advanced docker settings group (available after enabling the Show advanced switch).

The configuration can be done in two independent ways.
First way:
-
Set the Disable seccomp parameter in the Advanced docker settings group to
true
and save the configuration. -
Run the cluster installation as described below.
Second way:
-
Install Docker on the host according to the Install Docker Engine on CentOS instruction.
-
Install the python-docker-py package on the host.
-
Set the Install docker package parameter in the Advanced docker settings group to
false
and save the configuration. -
Run the cluster installation as described below, with SELinux disabled on the host in installation options. After installation, reboot the host.
Step 1. Run installation
To install a cluster, you need to:
-
Apply the Install action to the cluster selected on the Clusters page by clicking the
icon in the Actions column.
Switch to cluster installation -
In the dialog box that opens, select the required options for installation.
Select parameters for installationThe purpose of the parameters is given below.
Parameter Description Disable SELinux
Disables SELinux on added hosts. In order for this setting to be applied, after the completion of the Install operation, you must restart the hosts manually
Disable Firewalld
Disables firewalld on hosts
Set vm.swappiness to 0
Disables swapping on hosts
Configure /etc/hosts
Writes added nodes to /etc/hosts on cluster hosts. It is recommended to disable this option if DNS is configured
-
Verify the action in the opened window.
Verify the action -
Wait until the job is completed.
NOTE
In case of errors, you can find logs on the Jobs page.
|
Step 2. View the results of installation
ADCM starts a single job for installation process, as well as for any other task. You can find out about the status of jobs more specifically on the Jobs page.

The successful completion of the service installation is determined by the transition of the job from the running
status to the success
status on the Jobs page. If the job fails, it switches to the failed
status. In this case it is possible to see more detailed information about the errors that occurred by clicking the failed job on the Jobs page.

A job page contains two sections: ansible [ stdout] and ansible [ stderr ]. These are technical logs of the job that include information from standard I/O streams stdout/stderr. These logs can help to understand what caused the problems.
There can also be the optional third section ansible [ check ]. These are the logs of the most frequent errors checks. The description of these errors is more simple and specific, than in two previous technical logs.
The contents of all three sections should be studied if errors occur.

Step 3. Check the cluster state after installation
As a result of successful installation, the cluster and its services change their state according to the following rules:
-
The cluster state, displayed in the State field on the Clusters page, is being changed from
created
toinstalled
.The cluster state after successful installation -
The service status displayed on the Services tab in the cluster menu changes from
created
toinstalled
.The state of cluster services after successful installation