Cluster actions

This article describes the actions available for the ADPG cluster in the ADCM UI. You can find cluster actions on the Clusters page.

The Clusters page
The "Clusters" page

The Clusters page displays a table with the following columns:

  • Name is a name specified during the cluster creation.

  • State is the current cluster state (for example, created, installed, running).

  • Product — product name.

  • Version — version of a bundle used to install the cluster.

  • Description — description specified during the cluster creation.

  • Concerns — displays an icon that indicates a state of running processes in the cluster. The icon concern default shows that the cluster works correctly. If critical errors are detected in the configuration or a job is running, the icon image is changed to concern red dark concern red light. 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.

  • Actions — shows icons for managing a cluster:

    • actions default dark actions default light — opens the drop-down list that offers actions to manage the cluster.

    • upgrade default — indicates whether a new version of a bundle is available and allows you to upgrade the cluster.

    • delete default — deletes information about the cluster from ADCM. This action does not remove ADPG services or make any changes to the hosts that belong to the cluster.

You can use icons described above to perform cluster actions. When an action starts, ADCM shows its execution process and result on the Jobs page. On this page, click a job name to open a page with detailed information on an individual job. If the job has inner steps, click the ellipsis in the Details column for additional information on the current step.

The Jobs page
The "Jobs" page

Actions

Click actions default dark actions default light in the Actions column to display a drop-down list with the available actions and select an action to run it.

Actions
Actions

When you choose an action, ADCM displays a dialog window to confirm the choice. In this dialog window, you can select the Verbose checkbox to see additional execution details on the Jobs page.

The Run an action window
The "Run an action" window

Check and Precheck

The Precheck action verifies if hosts have correct settings and all components and services are configured according to the ADPG cluster requirements. Precheck is available before the cluster installation.

The Check action includes Precheck and also checks if the installed cluster components operate correctly. Check is available after the cluster installation.

You can find the result on the Jobs page. If the action completes successfully, the corresponding task changes its status from running to success. If the job fails, it switches to the failed status. The actions also store the result in the global_adcm_precheck_fail ADCM variable to implement a postponed failure. The result is a boolean value. It is true if the last Check or Precheck action is successful. The false value indicates that an error occurred during checking. In this case, the status of the Check global_adcm_precheck_fail operation is changed to failed. In some cases, when Check global_adcm_precheck_fail is failed, you need to review inner steps of the Check or Precheck action that are marked as successful to determine the cause of the problem.

An error occurs while performing the action
An error occurs while performing the action

Reconfigure monitoring agents

The Reconfigure monitoring agents action reads monitoring configuration defined in ADCM UI, updates configuration files of pgwatch2 and monitoring agents according to specified settings, and restarts them.

Reinstall

The Reinstall action reinstalls the ADPG cluster. In its Run an action dialog window, you can choose whether ADCM reboots cluster servers after installation.

The Run an action window
The "Run an action" window

Reinstall statuschecker

The Reinstall statuschecker action reconfigures and restarts the status checker for all cluster services.

Start

The Start action starts all cluster services.

Stop

The Stop action stops all cluster services.

Upgrade

To upgrade an ADPG cluster version, upload a new bundle first. To do this, go to the Bundles page, click Upload bundle and select a new bundle file in your environment.

The Bundles page
The Bundles page

When a new bundle is loaded, open the Clusters page. Click the icon upgrade default that becomes active for the cluster in the Actions column.

Start the Upgrade action
Start the "Upgrade" action

In the Upgrade Cluster window that opens, select a version to upgrade ADPG and click Upgrade.

Select version
Select version

Click Run in the confirmation dialog window that appears.

Confirm the version of upgrade
Confirm the version of upgrade

As a result, ADCM changes the cluster state to ready to upgrade and fills the drop-down list in the Actions column with two items: Precheck and Upgrade. Click the icon actions default dark actions default light in the Actions column and run the Precheck action to make sure that hosts have correct settings and all components and services are configured according to the ADPG cluster requirements.

If Precheck is successful (you can find the result on the Jobs page), execute the Upgrade action. The action name includes versions: minor/major and CE/EE. For example, Upgrade minor EE means that the cluster will be upgraded to the next minor Enterprise edition.

Run the Upgrade action
Run the "Upgrade" action

Click Run in the confirmation dialog window that appears. In this window, you can also choose whether ADCM reboots cluster servers after installation.

Confirm the Upgrade action
Confirm the "Upgrade" action

After upgrade, ADCM changes the cluster state to installed.

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