Overview of the Hosts tab in the ADCM UI

Adelya Zvyagintseva

After you install and configure a hostprovider, you can create and manage hosts on the Hosts tab in the ADCM web interface via the host actions described below.

List of hosts

On the Hosts tab, you can see the list of created hosts in tabular form which contains information described below.

The Hosts tab
The Hosts tab
Fields of the Hosts tab
Field Description

Name

Name of the host specified during the host creation. When hovering over a host row, the copy dark copy light icon appears, allowing you to copy the host name.

The dot located next to the host name determines the host status. The green dot indicates that statuschecker is installed and the host regularly sends heartbeats. The yellow one indicates that statuschecker is not installed and the host does not send heartbeats to ADCM

State

Status of the host. Possible values:

  • created — the host is created;

  • running — the host is created and configured.

Hostprovider

Name of the hostprovider used to create the host

Cluster

Name of the cluster the host belongs to

Concerns

One of the following icons:

A pop-up window with the error description appears when hovering over the concern red dark concern red light or concern yellow dark concern yellow light icon

Operations

Icons for managing the host:

  • create subhost default dark create subhost default light — creates a subhost to enable host sharing between multiple clusters. The icon is available starting with ADCM 2.8.0.

  • actions default dark actions default light — opens the drop-down list with actions to manage the host.

  • maintenance default — turns on the maintenance mode on the host if supported by the product in use. If maintenance mode is not supported by the product, the icon image is changed to maintenace disabled dark maintenace disabled light. After the action is executed, the host changes its state and the icon is changed to the maintenance active dark maintenance active light icon. In this state, the host can be transferred to normal mode.

  • link default — adds the host to a cluster. After the action is executed, the icon is changed to the unlink default icon which performs the opposite action.

  • delete — deletes the information about the host from ADCM. The host removal is possible only after removing the host from a cluster using the Unlink action.
NOTE
Add/remove and delete options, and the actions default dark actions default light icon are also available on the host page.

To sort the hosts alphabetically, click the arrow down dark arrow down light (from Z to A) or arrow up default dark arrow up default light (from A to Z) icon in the Name column.

To search for a host in the list, enter its name in the Search hostname field.

To filter hosts:

  • by hostprovider name — select the required value from the drop-down list in the field next to Hostprovider;

  • by cluster name — select the required value from the drop-down list in the field next to Cluster.

To reset search and filter settings, click the reset dark reset light icon.

Operations with a host

Create and configure a host

ADCM allows you to create and configure hosts.

To create and configure a single host, follow these steps:

  1. Open the Hosts tab.

  2. On the page that opens, click Create host.

  3. For further action, refer to the following links, depending on the hostprovider type:

NOTE
To add several hosts with the SSH or Yandex Cloud hostproviders simultaneously, run the hostprovider action Create hosts.

Run host actions

After you create and configure a new host, you can manage it on the Hosts page. Click the actions default dark actions default light icon in the Operations column to select one of the available host actions.

For more information on actions for hosts based on different hostprovider types, refer to the following links:

NOTE
For hosts based on the ADB Cloud Bundle and ADQM Cloud Bundle hostproviders, actions are not yet provided.

When you select an action, ADCM opens a modal window.

Modal window for running the Check connection action
Modal window for running the Check connection action

The modal window allows you to run the action without blocking the object if necessary, add a comment with a brief description of the action to be launched, and select the Verbose checkbox to view additional information about the action execution on the Jobs page. For some actions, such as Create user, you should first fill in additional options on a separate tab.

Enable host sharing

To enable host sharing between multiple clusters that you have created, follow these steps:

  1. In the row with the required host, click the create subhost default dark create subhost default light icon. The window for creating a subhost (representation of the host in the cluster) opens.

    The Create subhost window
    The Create subhost window

  2. In the Create subhost window:

    • in the Name field, enter the name of the subhost;

    • in the Cluster field, select the name of a cluster from the drop-down list to add the subhost (optional).

  3. Click Create. As a result, the added subhost will be displayed under the row of the corresponding host. The subhost can be used to enable host sharing between multiple clusters.

    The Hosts tab with the added subhost
    The Hosts tab with the added subhost

The subhost list is displayed in tabular form with the following fields:

  • Name — name of the subhost specified during the subhost creation.

  • Cluster — name of the cluster the subhost belongs to.

  • Concern — one of the following icons:

  • Actions — icons for managing the subhost:

    • maintenance default — turns on the maintenance mode on the subhost if supported by the product in use. If maintenance mode is not supported by the product, the icon image is changed to maintenace disabled dark maintenace disabled light. After the action is executed, the subhost changes its state and the icon is changed to the maintenance active dark maintenance active light icon. In this state, the subhost can be transferred to normal mode.

    • link default — adds the subhost to a cluster from the drop-down list. After the action is executed, the icon is changed to the unlink default icon which performs the opposite action.

    • delete — deletes the information about the subhost from ADCM. The subhost removal is possible only after removing the subhost from a cluster using the Unlink action.

To expand or collapse the list of subhosts under the row of the corresponding host, click the three dots dark three dots light or three dots active default dark three dots active default light icon respectively.

Perform bulk operations on hosts

The Bulk operations button allows you to perform the same operation on multiple hosts at once. For example, you can add multiple hosts to a cluster, remove them, or perform an action available for the selected hosts depending on the hostprovider type.

To perform a bulk operation:

  1. Select the checkboxes next to the required hosts.

    The Hosts tab with selected hosts
    The Hosts tab with selected hosts

  2. Click Bulk operations.

  3. Select the required operation from the drop-down list:

    • Link — adds the selected hosts to a cluster;

    • Unlink — removes the selected hosts from a cluster;

    • Delete — deletes information about the selected hosts from ADCM;

    • Actions — opens the drop-down list with actions to manage the selected hosts.

      NOTE
      The Actions option is available only if all selected hosts were created using the same hostprovider.

Host details

To get detailed information about the host, click the host name in the Name column of the table located on the Hosts tab.

The host page
The host page

At the top of the host page, the following is displayed:

  • host name with the host status;

  • hostprovider name that contains a link to the hostprovider page;

  • ratio of successfully installed components on the host to their total number;

  • buttons Actions and Link/Unlink (depending on the state of the link between the host and its cluster).

Also, this page includes the following tabs:

  • Host-Components

  • Primary configuration

The Host-Components tab allows you to get more information about the current host, such as the host components and their statuses.

Fields of the Host-Components tab
Field Description

Name

Name of the component.

The dot located next to the component name determines the component status. The green dot indicates that a component operates correctly. The yellow one means that a problem occurs

Concerns

One of the following icons:

A pop-up window with the error description appears when hovering over the concern red dark concern red light or concern yellow dark concern yellow light icon

Operations

The actions default dark actions default light icon opens the drop-down list with actions to manage the component

To sort the components alphabetically, click the arrow down dark arrow down light (from Z to A) or arrow up default dark arrow up default light (from A to Z) icon in the Name column.

To search for a component in the list, enter its name in the Search component field.

The Primary configuration tab allows you to configure the general host settings. The tab description and information about working with configuration parameters are given in the Configuration parameters in the ADCM UI article.

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