57.3. Managing Mass Instance Operations #
- 57.3.1. Creating a Mass Instance Operation
- 57.3.2. Viewing Mass Instance Operations
- 57.3.3. Viewing Detailed Mass Operation Information
- 57.3.4. Viewing Mass Instance Operation Steps
- 57.3.5. Viewing Detailed Step Information
- 57.3.6. Restarting a Mass Instance Operation Step
- 57.3.7. Canceling a Mass Instance Operation
- 57.3.2. Viewing Mass Instance Operations
Mass instance operations allow you to execute an operation on a group of instances at once instead of doing this on each instance separately.
Important
The mass instance operations functionality is in the beta phase. Currently, the only supported mass instance operation is applying a configuration preset. Other existing limitations are specified in the corresponding instructions.
57.3.1. Creating a Mass Instance Operation #
In the navigation panel, go to Tasks console → Operations.
In the top-right corner of the page, click Create operation.
In Operation, enter parameters of the new mass instance operation (parameters marked with an asterisk are required):
Operation: The type of the mass instance operation.
Currently, the only supported mass instance operation is applying a configuration preset.
Configuration preset: The configuration preset that will be applied to the instances.
If a configuration preset both increases and decreases configuration parameters, split it into two separate presets: one for increasing values and one for decreasing values.
Then apply both presets individually.
Error limit: The amount of errors that can occur when executing the operation on an instance. If the error limit is exceeded, the operation is canceled.
Currently, the error limit cannot be set, and the
-1value is entered automatically.Step execution timeout, s: The maximum step duration. If a step is not completed within this time, it is terminated with the Error status.
A step in the Error status can be restarted later if the operation is in the Executing status.
Default value: 60 seconds
Click Next.
In Instances, select the instances to which the configuration preset will be applied.
The configuration preset is applied to the instances in the order you select them.
Important
For nodes of a standard primary-standby or BiHA cluster, consider the following:
If you apply a configuration preset that increases the values of the configuration parameters, first apply it to standby/follower nodes.
If you apply a configuration preset that decreases the values of the configuration parameters, first apply it to primary/leader nodes.
Applying a configuration preset in the wrong order may cause standby/follower nodes to shut down.
Click Next.
In Compatibility check, review the list of instances and configure compatibility check:
Review the list of instances and the order in which the configuration preset is applied to them.
Select whether to verify compatibility between the configuration preset and the instance before applying the preset. If the compatibility check fails, the configuration preset is not applied to the instance.
The compatibility check does not guarantee that no errors will occur when applying the configuration preset.
You can select one of the following values:
For each instance
No check
Click Execute operation.
57.3.2. Viewing Mass Instance Operations #
In the navigation panel, go to Tasks console → Operations.
The table of mass instance operations with the following columns will be displayed:
Name.
Status.
A progress bar is displayed next to this status. Use it to monitor the progress of the mass instance operation.
Possible values:
Ready for execution: The mass instance operation was scheduled.
Executing: The mass instance operation is being executed.
Error: An error occurred when executing the mass instance operation.
Canceling: The mass instance operation is being canceled.
Canceled: The mass instance operation was canceled.
Completed: The mass instance operation was executed.
Owner: The user that executed the mass instance operation.
Last execution: The date and time when the mass instance operation started executing.
Duration: The duration of the mass instance operation.
This column includes additional information:
Completed: The date and time when the mass instance operation stopped executing.
Timeout: The configured step execution timeout.
Actions.
For more information about available actions, refer to other instructions in this section.
57.3.3. Viewing Detailed Mass Operation Information #
In the navigation panel, go to Tasks console → Operations.
Click
next to the mass operation. The window with the following detailed information about the mass instance operation will open:
Operation: The name of the mass instance operation.
Status: The status of the mass instance operation and the number of performed steps.
A progress bar is displayed next to this status. Use it to monitor the progress of the mass instance operation.
Possible values:
Ready for execution: The mass instance operation was scheduled.
Executing: The mass instance operation is being executed.
Error: An error occurred when executing the mass instance operation.
Canceling: The mass instance operation is being canceled.
Canceled: The mass instance operation was canceled.
Completed: The mass instance operation was executed.
Configuration preset: The configuration preset being applied to the instances.
Step execution timeout, sec: The configured step execution timeout.
Compatibility check: Specifies whether compatibility between the configuration preset and the instance is verified before applying the preset. If the compatibility check fails, the configuration preset is not applied to the instance.
The compatibility check does not guarantee that no errors will occur when applying the configuration preset.
Possible values:
For each instance
No check
Selected instances: The list of instances and the order in which the configuration preset is applied to them.
57.3.4. Viewing Mass Instance Operation Steps #
Every mass instance operation consists of one or more steps. You can view the step list to monitor an operation progress and to manage individual steps.
To view steps of a mass instance operation:
In the navigation panel, go to Tasks console → Operations.
In Status, click the status of the mass instance operation.
The table of steps being executed with the mass instance operation will be displayed.
The block with the summary data is located above the table, displaying the following information:
The status of the mass instance operation.
The number of errors, if any.
The table has the following columns:
Step number: The step sequence number.
Name: The descriptive step name, which is generated automatically.
Status: The step status.
Possible values:
Not started: The step execution did not start.
Executing: The step is being executed.
Error: An error occurred when executing the step.
Canceling: The step execution is being canceled.
Canceled: The step execution is canceled.
Skipped: The step execution is skipped.
Completed: The step execution is completed.
Instance: The instance where the step is being executed.
Start: The date and time the step execution started.
Duration: The step execution duration.
This column includes additional information.
Completed at: The date and time the step execution ended.
Actions.
For more information about available actions, refer to other instructions in this section.
57.3.5. Viewing Detailed Step Information #
In the navigation panel, go to Tasks console → Operations.
In Status, click the status of the mass instance operation.
Click
next to the step.
The window with the following detailed information about the step of the mass instance operation will open:
Status: The step status.
Possible values:
Not started: The step execution did not start.
Executing: The step is being executed.
Error: An error occurred when executing the step.
Canceling: The step execution is being canceled.
Canceled: The step execution is canceled.
Skipped: The step execution is skipped.
Completed: The step execution is completed.
Start: The date and time the step execution started.
End: The date and time the step execution ended.
Duration: The step execution duration.
Cluster: The cluster where the step is being executed.
Instance: The instance where the step is being executed.
Role: The role of the instance.
Preset: The configuration preset being applied to the instance.
Instance ID.
Preset ID.
Compatibility check: Specifies whether compatibility between the configuration preset and the instance is verified before applying the preset. If the compatibility check fails, the configuration preset is not applied to the instance.
The compatibility check does not guarantee that no errors will occur when applying the configuration preset.
Possible values:
For each instance
No check
57.3.6. Restarting a Mass Instance Operation Step #
When you restart a step, its execution begins again.
A step cannot be restarted if any of the following conditions is met:
The operation that includes the step is not completed (not in the Completed or Error status).
The step is not in the Not started or Error status.
The previous step, if any, is not in the Completed status.
To restart a mass instance operation step:
In the navigation panel, go to Tasks console → Operations.
In Status, click the status of the mass instance operation.
Click
next to the step. Click Restart.
57.3.7. Canceling a Mass Instance Operation #
When you cancel a mass instance operation, its execution stops, but already executed steps are not reverted.
To cancel a mass instance operation:
In the navigation panel, go to Tasks console → Operations.
Click
next to the mass operation. Alternatively, on the mass operation steps page, in the top-right corner of the page, click Cancel operation.
Click Cancel.