Install a cluster

Step 1. Run installation

To install a cluster, you need:

  1. Apply the Install action to the cluster selected in the CLUSTERS tab.

    adcm services install 02
    Proceed to cluster installation
  2. In the dialog box that opens, select the required options for installation.

    adcm services install 10
    Selecting options for installation

    The purpose of the parameters is given below.

    Parameter Description

    Disable SELinux

    Disable 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

    Disabling firewalld on hosts

    Install OpenJDK

    Install package java-1.8.0-openjdk on hosts

    Set vm.swappiness to 0

    Disabling swapping on hosts

    Configure /etc/hosts

    Write added nodes to /etc/hosts on cluster hosts. It is recommended to disable this option if DNS is configured

  3. Confirm the action in the window by clicking Run.

  4. Wait until the job is completed.

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 at the JOBS tab.

The status of ADCM jobs is displayed in the upper-right corner of the web interface. The yellow circle represents the number of running jobs, and the green and red circles represent the number of successfully and unsuccessfully completed jobs, respectively. You can move to the necessary block of jobs by clicking at the corresponding circle.
adcm services install 04
The JOBS tab

The successful completion of the service installation is determined by the transition of the job from the running status to the success status at the JOBS tab. 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 via clicking the failed job at the JOBS tab.

adcm services install 06
Switching to a job page

A job page contains two sections displayed at the left side of the screen: 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.

adcm services install 07
A job page

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 at the CLUSTERS tab, is being changed from created to installed.

    adcm services install 09
    The cluster state after successful installation
  • The service status displayed on the Services tab in the cluster menu changes from created to installed.

    adcm services install 08
    Status of cluster service after successful installation
Found a mistake? Seleсt text and press Ctrl+Enter to report it