5.27. Task Console #
A user or the manager can initiate the execution of tasks on agents and instances, as well as create schedules for such tasks.
You can also use mass instance operations to perform an operation on multiple instances at once.
5.27.1. Viewing Tasks #
In the navigation panel, go to Tasks console.
The table of tasks with the following columns will be displayed:
Name: The name of the task with a description.
Agent: The agent assigned to execute the task.
This column includes additional information:
Instance: The instance where the task was executed.
Status.
Possible values:
COMPLETED: The task was completed.
FAILED: An error occurred while executing the task.
Started at and Finished at: The start and end time of the task execution.
Actions.
To view detailed information about the task, click
next to it. The window with the following parameters will open:
Status: The task execution status.
ID: The task ID.
Instance: The instance where the task was executed.
Start and End: The task execution time.
Log: The log entry about the task.
This information is available when the task is in the
COMPLETEDstatus.Errors: The errors occurred during the task execution.
This information is available when the task is in the
FAILEDstatus.
5.27.2. Managing Schedules #
This section explains how to manage schedules. It includes the following instructions:
Viewing Schedules
In the navigation panel, go to Tasks console → Schedule.
The table of schedules with the following columns will be displayed:
Task: The name of the task with a description.
To view the task execution status, hover over its name.
Possible values:
Active: The task is activated.
Deactivated: The task is deactivated.
Instances: The instance where the schedule is created.
User: The user on whose behalf the task was created.
Schedule: The string in the crontab format that specifies the schedule.
Parameters: The task execution parameters, i.e., the task and the task object. Click the name of the task object to open the relevant page.
Actions.
For more information about available actions, refer to other instructions in this section.
Deactivating and Activating a Task
You can deactivate or activate the task to stop or continue its execution.
To deactivate or activate the task:
In the navigation panel, go to Tasks console → Schedule.
Click
or
next to the task.
Deleting a Task
Important
Deleted tasks cannot be restored.
To delete a task:
In the navigation panel, go to Tasks console → Schedule.
Click
next to the task.
Click Delete.
5.27.3. Managing Mass Instance Operations #
Mass instance operations allow you to execute an operation on multiple instances at once instead of doing this on each instance separately.
This section explains how to manage mass instance operations. It includes the following instructions:
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 of this section.
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.
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, and the value is entered automatically.
Configuration preset: The configuration preset that will be applied to the instances.
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.
If the configuration preset increases and decreases the values of the configuration parameters at the same time, split it into two presets: the one that increases values and the other that decreases values.
Then apply both presets individually.
Click Next, and then 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.
Viewing Mass Instance Operations
In the navigation panel, go to Tasks console → Operations.
Name.
Status.
Possible values:
Scheduled: 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.
Actions.
For more information about available actions, refer to other instructions in this section.
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.
Possible values:
Scheduled: 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.
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 instances to which the configuration preset is being applied.
Monitoring Execution of a Mass Instance Operation
You can view information about each operation being executed within a mass instance operation.
To monitor execution 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.
Executed: The step is executed.
Instance: The instance on which the step is being executed.
Started: The date and time the step execution started.
Duration: The step execution duration.
This column includes additional information.
Ended: The date and time the step execution ended.
Actions.
For more information about available actions, refer to other instructions in this section.
Restarting a Mass Instance Operation Step
A step can be restarted only if the step is in the Error status and the operation is in the Executing status.
When you restart a step, its execution begins again.
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.
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.
Click Cancel.