Service actions

ADCM UI provides actions to manage services of ADQM Control. These actions are available on the Services page. To open this page, click an ADQM Control cluster name on the Clusters page and switch to the Services tab.

ADQM Control cluster services in the ADCM interface
ADQM Control cluster services in the ADCM interface

The Services page contains a table with the following columns:

  • Name — service name.

  • Version — service version.

  • State — the current state of the service (for example, created or installed).

  • Concerns. The icon concern red dark concern red light indicates if there are critical errors in the service configuration (for example, mandatory components are not deployed on cluster hosts) or some job is running. When you hover over it, a pop-up window appears showing a description with a link that you can follow to perform the required configuration or get details. If the service is configured correctly and there are no currently running actions, the column is empty.

  • Actions. When you click the icon actions default dark actions default light, a drop-down list offers actions to manage the service. A set of actions depends on the service type.

     
    Actions available for all services:

    • Install (if a service state is created) — installs a service.

    • Check — checks the health of a service.

    • Start — starts a service.

    • Stop — stops a service.

     
    Service-specific actions:

    ADQM Control
    • Reconfigure and restart — updates the service configuration files according to settings specified on the service configuration page, and restarts the service.

    • Reinstall — reinstalls the service.

    ADPG
    • Reconfig and restart — updates the service configuration and restarts the service.

    • Collect recommendations — collects optimal values ​​for postgresql.conf configuration parameters to improve ADPG performance.

       
      After the action is performed, open the corresponding job on the Jobs page (by clicking Collect recommendations in the list of jobs) and in the Ansible [check] section, make sure that the Collect optimal values ​​for postgresql.conf parameters subtask has been completed successfully. The result of this subtask contains a list of optimal parameter values — assign these values ​​to the corresponding parameters in the ADPG configurations section of the ADPG service configuration page and run the Reconfig and restart action for the service.

      The result of the Collect recommendations action
      The result of the "Collect recommendations" action
    • Remove — removes the service from the cluster. This action can be used to delete an already installed service, unlike the icon delete default that allows you to remove a non-mapped service (a service whose components have not yet been distributed among cluster hosts).

    Zookeeper
    • Reconfig and restart — updates the service configuration and restarts the service.

    • Expand — installs the Zookeeper Server component on more hosts.

       
      When you select this action, ADCM opens the Run an action dialog where you can add new hosts on which you want to install the Zookeeper Server component.

      Add Zookeeper Server to hosts
      Add Zookeeper Server to hosts
    • Shrink — removes the Zookeeper Server component from hosts.

       
      In the Run an action dialog that appears when you select the Shrink action, remove hosts on which the Zookeeper Server component should not be installed.

      Remove Zookeeper Server from hosts
      Remove Zookeeper Server from hosts
    Monitoring
    • Add/Remove components — opens the component-host mapping interface where you can add, remove, or redistribute service components.

    • Reconfigure and restart — applies configuration to the service according to settings specified on the service configuration page, and restarts the service.

    • Reinstall — reinstalls the service.

    When an action starts, ADCM displays its execution process and result on the Jobs page. On this page, you can also analyze errors if they occur.

     
    The Actions column also displays separate icons for the following actions:

    • mainenace disabled dark mainenace disabled light — sets up the maintenance mode for a service. This functionality is currently not implemented in the ADQM Control bundle.

    • delete default — removes a service from the cluster.

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