Add hosts

Daria Barysheva

In ADCM a host means a representation of a real hardware or virtual host. It doesn’t matter what infrastructure the original host uses — a cloud or bare metal.

The process of configuring hosts in ADCM differs depending on the selected hostprovider. This topic explains how to add and configure hosts in ADCM using the SSH hostprovider, that is, essentially, a connector to already created hosts.

IMPORTANT

Before adding hosts in ADCM using the SSH hostprovider, make sure that:

  • The SSH hostprovider is installed in ADCM.

  • Hosts with the ability to connect via the SSH protocol are created in a cloud or on-premises. Notice that this operation is performed manually and is not supported by the current hostprovider.

The steps for adding the hosts that are based on the SSH hostprovider are listed below:

  1. Select the HOSTS tab and click Create host.

    hosts add
    Adding a host in ADCM

  2. In the opened dialog:

    • Select the created hostprovider in the Hostprovider field. Notice that hostproviders are displayed with the names that you have assigned to them.

    • Enter the host name without domains in the Fully qualified domain name field.

      CAUTION

      Do not use fully qualified domain names (FQDN) for ADB hosts.

    • Click Create.

    host card
    Description of the host being added
    NOTE

    Do not fill in the Cluster field before your cluster being added. For more details on how to add a cluster, see Create a cluster.

  3. Receive the message on the new host being successfully added and click Cancel, if you do not need more hosts.

    host add
    The host is successfully added

  4. Return to the HOSTS tab and switch to the host configuring. To do this, click the row that contains the added host and select the Configuration tab in the opened window, or click the icon in the Config column. Both methods open the configuration window.

    host config open
    Switching to the host configuring

  5. In the opened window, select the Configuration tab, fill in the necessary parameters, and click Save.

    host config make
    Configuring the host

    The assignment of parameters is listed in the table below.

    Hosts configuration parameters
    Parameter Description

    Username

    A user name that is used for connecting to a host via SSH

    Password

    A user password that is used for connecting to a host via SSH. If you don’t use a password, leave this field blank

    SSH private key

    A private SSH key that is used for connecting to a host via SSH. It is created in a pair with the public key that you define for a host when configuring it. If you don’t use SSH keys, leave this field blank

    Hostname

    An IP address of a host

    Port

    A port number that is used for connecting to a host via SSH (by default, 22)

    SSH args

    SSH arguments for Ansible. Can be left at the default value. Thus, StrictHostKeyChecking=no and UserKnownHostsFile=/dev/null parameters disable strict host key checking for SSH. Otherwise, when this checking is enabled, the SSH client connects only to the known hosts, that are stored in the known hosts list

    Ansible become

    A flag that grants the superuser privileges to the user specified in the Username field. The default value should be used (flag is set)

    Ansible become password

    A password that is used during the granting of the superuser privileges to the user specified in the Username field. Can be left at the default value

  6. Return to the Hosts tab. In the row that contains the added host, click the icon in the Actions column and select the Check connection drop-down menu item. Confirm the action in the opened window.

    host check run
    Switching to the connection check
    adcm hosts add 07
    Confirming the connection check

  7. Wait until the connection check is completed. If the connection check runs successfully, it means that the host is configured correctly and can be added to a new cluster.

    NOTE
    In case of errors, you can find the logs at the JOBS tab.

  8. After the connection check is completed, install statuschecker. It is a special daemon that periodically checks the status of the services and components added to the cluster hosts via ADCM. To install this daemon, click the icon in the Actions column again and select the Install statuschecker drop-down menu item. Then confirm the action in the opened window.

    host statuschecker run
    Switching to the statuschecker installation
    adcm host verify checker
    Confirming the statuschecker installation

  9. Wait until the statuschecker installation is completed.

Found a mistake? Seleсt text and press Ctrl+Enter to report it