Install a cluster

Step 1. Run installation

There are two ways of cluster services installation:

  1. Whole cluster. In this method all services are installed automatically one by one after applying the Install action to the cluster.

  2. Single services. In this method each service is installed manually after applying one or more actions to it. This way is also suitable for installing new services into the already deployed cluster.

In both cases each service starts automatically after the installation.

Whole cluster

To install all cluster services within a single action, make the following steps:

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

    adcm services install 02
    Switching to the whole cluster installation
  2. In the opened window select advanced installation options.

    adcm services install 10
    Selecting options for installation

    The brief description of parameters is listed below.

    Option Description

    Disable SELinux

    Disable SELinux on added hosts. In order for this setting to take effect, after the Install operation is completed, you must restart the hosts manually

    Disable Firewalld

    Shutting down firewalld on hosts

    Install OpenJDK

    Installing java-1.8.0-openjdk package 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. Verify the action in the window by clicking Run.

  4. Wait until the job is completed.

Single services

To install one or several cluster services manually, you should add these services to the cluster and then perform the actions described below.

Notice that services are installed one by one. Do not install another service until the installation of the previous one is completed.
  1. Open the Services tab in the cluster menu. For each service that should be installed, click the icon in the Actions column and choose the Install action.

    adcm services install 01
    Switching to installing single services
  2. In the opened window select advanced installation options.

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

  4. Wait until the job is completed. Then check that the service state has changed from created to installed.

  5. Repeat the previous actions for other services that should be installed.


When you install services manually, one by one, use the following order:

  1. ZooKeeper;

  2. Kafka manager, Kafka, NiFi (one by one);

  3. other services.

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 state of cluster services, displayed in the cluster menu at the Services tab, is being changed from created to installed.

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