Jobs
Job Concepts
This section describes Ops Center Protector's job management features.
For further information, refer to:
About jobs
Ops Center Protector monitors jobs that are being performed in the system and provides progress and status information. Jobs are broken down into tasks being processed by the system, each job will have one or more tasks. They are either system initiated tasks (e.g. a scheduled Backup or Report creation) or user initiated tasks (e.g. a Restore or a Repository Analysis). Jobs are executed by various subsystems on various Protector nodes and are tracked by the master node so that it can provide progress and status information to users.
Jobs are split into three types:
- A Job can be in one of the following states:
- Succeeded – All Tasks succeeded
- In Progress – One or more tasks are still running
- Failed – One or more Tasks Failed
- Paused – One or more Tasks Paused
- Cancelled – One or more Tasks Cancelled
- Unknown – The master is unable to communicate with the node on which the job is running. The node may be genuinely offline, or it could be that the network is down between the master and the node. This status will be updated when the nodes can communicate again.
- A Task can be in one of the following states:
- Succeeded – All good
- In Progress – Still running
- Failed – All not so good
- Paused – User has paused the Task
- Cancelled – User has cancelled the Task
- Unknown – The master is unable to communicate with the node on which the Task is running. The node may be genuinely offline, or it could be that the network is down between the master and the node.
- Additionally, a Task/Job can complete with:
- Warnings – the state is SUCCEEDED but something was amiss (e.g., Rules distribution with an offline node)
The Jobs user interface presents the user with a list of currently active jobs and jobs that have recently completed. It enables some jobs to be paused or cancelled.
Jobs UI Reference
This section describes the Jobs UI, accessed via the Main Banner.
For further information, refer to:
Jobs Inventory
The Jobs Inventory displays all currently running or recently completed jobs, for the purpose of operation confirmation and control.
| Control | Description |
 Purge Jobs | Removes all jobs of a given age and older from the job manager database. The Purge Jobs Dialog is displayed prior to the jobs being purged. |
 Edit purge schedule | Allows the automatic job purge schedule to be configured. The Edit Job Purge Schedule is displayed. |
 Export Jobs | Exports the job database as a file, respecting the currently specified filter terms. The Export Jobs Dialog is displayed prior to the jobs being exported. |
 Acknowledge Selected Logs | Enabled only if one or more job entries are selected. Failed jobs will indicate that they have been acknowledged by including “Acknowledged” in their “Progress” column. The Acknowledge Jobs Dialog is displayed prior to the jobs being acknowledged. |
 More Actions | Only enabled if the selected job is actionable. A menu appears with the available actions listed which can include:
|
| Summary | Indicates the type of action being performed. |
| Status | Indicates the status of a job as follows:
|
| Node | The node for which the job is being actioned for. Note that not all job will have a node specified. |
| User | User who initiated the job if not a system initiated job. |
| Tags | List of tags associates with the job see Universal Tags for more detail. |
| Started/Completed | Shows the data and time the job started/completed. |
| Filter on Date Time Range | Filters the job table so that only jobs from the specified Master date and time are displayed. Opens the Date Time Range Picker. |
| Filter on Actioned By Node | Filters the job table so that only jobs relating to the specified node that performs an action are displayed. |
| Filter on Actioned For Node | Filters the job table so that only jobs relating to the specified node that requests an action are displayed. |
| Filter on Acknowledgement | Filters the job table so that only acknowledged or unacknowledged jobs are displayed. |
Purge Jobs Dialog
The Purge Jobs dialog is displayed when the user attempts to remove jobs from the job database.
| Control | Description |
| Purge Jobs Older Than | Specify the date and time, using the Date Time Picker, on and before which jobs must originate for them to be deleted from the job database. Jobs newer than this date and time will not be deleted. |
| I understand job entries... | As an interlock, this checkbox must be ticked in order to proceed with the purge operation. The Confirm button will not be enabled unless the checkbox is ticked. |
Edit Job Purge Schedule
The Job Purge Schedule dialog is displayed when the user clicks on the Edit Job Purge Schedule icon.
The Edit Job Purge Schedule dialogs allows a user to enable or disable the automatic purging of jobs. If enabled the user configures the maximum number of weeks jobs are kept for.
| Control | Description |
| Never | Disable automatic job purging. |
| Older than 13 weeks | Enable automatic job purging causing job messages which are older than, or become older than, the specified number of weeks to be permanently deleted. |
| Acknowledgement checkbox | To enable the automatic purging feature, the user must acknowledge that purged jobs are not recoverable. |
Acknowledge Jobs Dialog
The Acknowledge Jobs dialog is displayed when the user attempts to acknowledge a job in the job database.
| Control | Description |
| Acknowledgment | Optional. Enter a short message that describes the action taken or reason for acknowledging the job. This will be appended with the date and time of acknowledgment upon confirmation. Drag the handle at the bottom right of the edit box to expand it. |
Export Jobs Dialog
The Job Export dialog is displayed when the user clicks on the export icon on the Jobs Inventory.
| Control | Description |
| Export Format | Select one of the following:
|
| Export | Click to begin the export process. The dialog will display progress of the export process and the export file will automatically be downloaded when ready. The export will be automatically downloaded even if the dialog is closed. |
Job Details
This page displays the details of a Job.
| Control | Description |
| More Actions | Only enabled if the selected job is actionable. A menu appears with the available actions listed which can include:
|
| Details | Provides detailed information about the Job. For Restore and Resync jobs a Progress section is added that provides information about theprogress of the job. Refer to Monitor Details. Once a job has completed the progress column will state Completes Successfully, Completed with Errors or Failed. For any status other than Completed Successfully refer to the logs section to determine the error. |
| Parameters | Identifies the Source, Destination, Policy and Data Flow associated with the Job. |
| Tasks | Identifies the Tasks associated with the job in action. For more details refer to Tasks Inventory. |
| Logs | List log messages relating to the job. See Logs UI Reference for more details. |
 Condensed View | Displays a reduced number of parameters in the log table. |
 Extended View | Displays all available parameters in the log table. |
 Show/Hide Search | Toggles the display of the filtering options. |
| Filter on Log Level | Filters the displayed log results based on Log Level. |
Tasks Inventory
The Task Inventory displays all tasks in the system that belong to a job depending on the filter criteria.
| Control | Description |
| More Actions | Only enabled if the selected task is actionable. A menu appears with the available actions listed which can include:
|
| Operation | Click on the Operation link in the tasks list to open the Task Details for the selected task. |
| Progress | Indicates the status of a task as follows:
|
| Node | The node for which the task is being actioned for. |
| Subsystem | The part of the product responsible for the task being initiated. |
| Description | Description of the task being carried out. |
| Started/Completed | Shows the data and time the task started/completed. |
| Filter on Date Time Range | Filters the task table so that only tasks from the specified Master date and time are displayed. Opens the Date Time Range Picker. |
| Filter on Status | Filters the displayed results based on Status. |
| Filter on Node | Filters the displayed results based on Node name. |
Export Tasks Dialog
TheTask Export dialog is displayed when the user clicks on the export icon on the Tasks Inventory page.
| Control | Description |
| Export Format | Select one of the following:
|
| Export | Click to begin the export process. The dialog will display progress of the export process and the export file will automatically be downloaded when ready. The export will be automatically downloaded even if the dialog is closed. |
Task Details
This page displays the details of a Task.
| Control | Description |
 Export Session Tasks | Exports the task database entries for the displayed session as a file, respectingthe currently specified filter terms. The Export Tasks Dialog is displayed prior to the tasks being exported. |
| More Actions | Only enabled if the selected task is actionable. A menu appears with the available actions listed which can include:
|
| Details | Provides detailed information about the Task. Once a task is completed, the progress column will state Completed Successfully,Completed with Errors or Failed. |
| Job | Identifies Summary, Status, Started/Completed data. Click on View Job to open the associated Jobs Details. |
| Parameters | Identifies the Source, Destination, Policy and Data Flow associated with the Task. |
| Logs | List log messages relating to the task. See Logs UI Reference for more details. |
| Condensed View | Displays a reduced number of parameters in the log table. |
| Extended View | Displays all available parameters in the log table. |
| Show/Hide Search | Toggles the display of the filtering options. |
| Filter on Log Level | Filters the displayed log results based on Log Level. |
Job Tasks
For further information, refer to:
How to view and control running jobs
Ops Center Protector tracks background asynchronous operations through jobs which can be viewed as follows:
Procedure
Click Jobs on the Main Banner to open the Jobs Inventory.
Jobs can also be viewed from the Monitor Details.All currently running and recently completed jobs are displayed in a table with the most recently started job listed first.From the Jobs Inventory select one or more jobs you want to control, by clicking the radio buttons to the left.
Click on the More Actions button above the table to see a menu of the available actions.
Depending on the type of job selected and the phase it has reached, some or all of the actions may not be available.To view the details of a specific job, click on the Job Type in the table.
The Job Details are displayed.