JavaScript must be enabled to correctly display this content

Chapter 8 Jobs Tab

Table of Contents

Use the Jobs tab for information on current and past tasks, or jobs. A job is a set of one or more operations made in Oracle VM Manager. Jobs are discussed in detail in Understanding Jobs, Events and Errors in the Oracle VM Concepts Guide.

The Jobs tab provides comprehensive information on all completed and in-progress jobs in the virtualization environment. The Jobs tab is used to get a global view on jobs, to evaluate information on jobs completed or aborted, or to cancel a job in progress.

The default view on the Jobs tab is the Summary view.

Figure 8.1, “Jobs tab” shows the Jobs tab.

Figure 8.1 Jobs tab

This figure shows the Jobs tab with the Summary subtab displayed.

Click to view larger image ui_jobs_tab.png

The Jobs tab contains the subtabs set out in Table 8.1, “Jobs Subtabs”.

Table 8.1 Jobs Subtabs

Subtab	Description
Summary	Displays the Summary subtab. Use this tab to get a global view on jobs, to evaluate information on jobs completed or aborted, or to cancel a job in progress. See Section 8.1, “Summary” for more information on the Summary tab.
Recurring	Displays the Recurring subtab. Use this tab to configure recurring jobs, such as the Server Upgrade Checker Task that periodically checks that the Oracle VM Servers have the latest product versions installed. See Section 8.2, “Recurring” for more information on recurring jobs.

Subtab

Description

Summary

Displays the Summary subtab. Use this tab to get a global view on jobs, to evaluate information on jobs completed or aborted, or to cancel a job in progress.

See Section 8.1, “Summary” for more information on the Summary tab.

Recurring

Displays the Recurring subtab. Use this tab to configure recurring jobs, such as the Server Upgrade Checker Task that periodically checks that the Oracle VM Servers have the latest product versions installed.

See Section 8.2, “Recurring” for more information on recurring jobs.

8.1 Summary

The Summary view provides a listing of all jobs that have been triggered within Oracle VM Manager, whether those jobs were triggered within the UI, from the CLI, the Web Services API or internally by Oracle VM Manager itself. Jobs can be displayed for all users, or just for the administrator.

The Jobs calendar enables you to display the jobs for a particular date. Select a date in the Jobs calendar and the jobs for that date are displayed in the Jobs table.

This subtab includes a toolbar that consists of the following options:

Table 8.2 Summary Subtab Toolbar Icon Options

Toolbar Icon Option	Icon	Description
Export to Excel		Use this option to save a list of the jobs to a spreadsheet file.
Details...		Displays the View Job Properties dialog box. Use this option to view details about the job.
Debug Transcript...		Displays a Message dialog box. Use this option to view a complete log for all of the actions and events surrounding the run status of the job.
Abort Job		Displays the Abort Job dialog box. Use this option to abort a job.
Help		Displays context sensitive help.

8.1.1 Status Filters

The Status Filters toolbar provides a set of icons that can be used to filter jobs according to their status. By default all of the filters are enabled and all of the icons appear to be depressed. By clicking on the filter icons you can enable or disable the filter to expand or limit the jobs listed in the management pane.

The following filter icons appear in the toolbar:

Total Jobs: Globally enable or disable all of the other filter options in the toolbar
Pending: Enable or disable the filter for jobs with Pending status
In Progress: Enable or disable the filter for jobs with In Progress status
Failed: Enable or disable the filter for jobs with Failed status
Aborted: Enable or disable the filter for jobs with Aborted status
Complete: Enable or disable the filter for jobs with Completed status

8.1.2 Export to Excel

To export the job list as a Microsoft Office Excel spreadsheet:

Select the Jobs tab and then select the Summary subtab.
Click Export to Excel in the toolbar.
The browser Save/Open File dialog opens and allows you to download a spreadsheet containing all of the jobs listed.

8.1.3 Job Details

To view job details:

Select the Jobs tab and then select the Summary subtab.
Select a job in the management pane and click Details... in the toolbar. Alternatively, you can select a job in the Job Summary pane and click Details in the Details column.
The View Job Properties: job_name dialog opens displaying detailed information about the job. Depending on the selected job, the dialog contains different tabs:
- Job Detail: This tab is always visible and includes the following fields:
  - Description: A description of the selected job.
  - Message: An error message describing the reason the job failed. This field is only populated if there is an error associated with the job.
  - ID: The ID for the job.
  - Status: The running state of the job.
  - Summary Status: The status for the job and its child jobs.
  - Progress Message: The most recent progress message for this job and any of its child jobs.
  - Created By: The user which created the job.
  - Creation Time: The date and time that the job was created.
  - Start Time: The date and time that the job was started.
  - End Time: The date and time that the job ended.
  - Duration: The time it has taken to run the job.
  - Error Type: The job error type which resulted from the job execution.
  - Abortable: Whether or not the job is abortable.
  - Aborted: Whether or not the job has been aborted.
  - Aborted By: The user which aborted the job.
  - Result ID Name: The ID of the object that was acted on.
  - Result ID Value: The value of the object that was acted on.
- Parent: This tab is only visible when the selected job is a child job and it has a parent. This tab includes the following fields:
  - Description: A description of the selected job.
  - Message: An error message describing the reason the job failed. This field is only populated if there is an error associated with the job.
  - ID: The ID for the job.
  - Status: The running state of the job.
  - Summary Status: The status for the job and its child jobs.
  - Progress Message: The most recent progress message for this job and any of its child jobs.
  - Created By: The user which created the job.
  - Creation Time: The date and time that the job was created.
  - Start Time: The date and time that the job was started.
  - End Time: The date and time that the job ended.
  - Duration: The time it has taken to run the job.
  - Error Type: The job error type which resulted from the job execution.
  - Abortable: Whether or not the job is abortable.
  - Aborted: Whether or not the job has been aborted.
  - Aborted By: The user which aborted the job.
  - Result ID Name: The ID of the object that was created.
  - Result ID Value: The value of the object that was created.
- Child Jobs: This tab is only visible when the selected job is a parent job that has related child jobs. This tab contains a table with the following columns of information:
  - Timestamp: The date and time that the job occurred.
  - Status: The running state of the job.
  - Progress: The most recent progress message for the job.
  - Description: A description of the selected job.
  - Created By: The user which created the job.
  - Duration: The time it has taken to run the job.
  - End Time: The date and time that the job ended.
- Child Error Summary: This tab is only visible when the selected job has related child jobs. This tab displays information about any child job errors.
- Queued Info: This tab is always visible and displays information about any queued jobs associated with the selected job.
- Job Events: This tab is always visible and contains a table with the following columns of information per event:
  - Severity: The severity level assigned to the event.
  - Timestamp: The date and time that the event occurred.
  - Type: The type of event according to Oracle VM Manager's event categorization model.
  - Summary: A summary description of the event.
- Export Summary: This tab is only visible for a virtual machine export to Oracle Cloud Infrastructure. This tab displays text information about the export operation.
Click Close to close the dialog.

8.1.4 Debug Transcript

To view the debug transcript

Select the Jobs tab and then select the Summary subtab.
Select a job in the management pane.
Click Debug Transcript... in the toolbar.
A dialog opens displaying a complete log for all of the actions and events surrounding the run status of the job. If the job failed, log information providing the error details is provided.
Click OK to close the dialog.

8.1.5 Abort Jobs

There are two ways to abort a job:

Using the Jobs tab
Using the Job Summary pane

Both procedures for aborting jobs are listed below.

To abort jobs using the Jobs tab:

Select the Jobs tab.
Select one or more jobs in the Jobs table.
Click Abort Job in the toolbar.
In the Abort Job Confirmation dialog box, click OK to abort the jobs.

To abort jobs using the Job Summary pane:

Select a job in the Job Summary pane.
Click Abort in the Abort column.
In the Abort Job Confirmation dialog box, click OK to abort the job.

8.2 Recurring

8.2.1 Edit a Recurring Job

Oracle VM Manager periodically performs recurring jobs, such as repositories and file systems refresh, and Yum updates for Oracle VM Servers. Select the Jobs tab and then select the Recurring subtab to view and edit the settings for these jobs. To edit a recurring job, see Section 8.2.1, “Edit a Recurring Job”. Note that some recurring jobs are considered internal and are not listed within Oracle VM Manager.

Recurring jobs are listed in Table 8.3, “Recurring Jobs”.

Table 8.3 Recurring Jobs

Recurring Job	Definition
Refresh Repositories' File Systems Task	As of Oracle VM 3.4, the file system statistics are automatically sent to Oracle VM Manager by each Oracle VM Server periodically along with other statistics used for health monitoring. Previous releases used a less efficient algorithm that required Oracle VM Manager to regularly poll each Oracle VM Server to refresh file system statistics. This recurring task is required for environments that are in the process of an upgrade and where some Oracle VM Servers in the environment are running a previous version of the software. When enabled, the Refresh Repositories' File Systems Task polls any Oracle VM Servers running a previous release of the software and requests current file systmem statistics. This information is used so that Oracle VM Manager is able to accurately represent the size of any used file systems and the free space available for each of these. This helps to minimize the time that a file system is locked during an operation. The default setting for this job is disabled with an interval of 61 minutes. It is important to understand that this task does not refresh the contents of a repository. If you manually add repository elements to a repository file system without using Oracle VM Manager, this task does not automatically update Oracle VM Manager. Instead, you should refresh the repository manually, as described in Section 4.3.1.5, “Refresh Repository”.
Server Upgrade Checker Task	The Server Upgrade Checker Task periodically checks that all owned Oracle VM Servers known to Oracle VM Manager have the latest product versions installed. This check is performed against the updates available in the Yum repository. The default setting for this job is enabled with an interval of 1464 minutes.

Recurring Job

Definition

Refresh Repositories' File Systems Task

As of Oracle VM 3.4, the file system statistics are automatically sent to Oracle VM Manager by each Oracle VM Server periodically along with other statistics used for health monitoring. Previous releases used a less efficient algorithm that required Oracle VM Manager to regularly poll each Oracle VM Server to refresh file system statistics. This recurring task is required for environments that are in the process of an upgrade and where some Oracle VM Servers in the environment are running a previous version of the software. When enabled, the Refresh Repositories' File Systems Task polls any Oracle VM Servers running a previous release of the software and requests current file systmem statistics. This information is used so that Oracle VM Manager is able to accurately represent the size of any used file systems and the free space available for each of these. This helps to minimize the time that a file system is locked during an operation. The default setting for this job is disabled with an interval of 61 minutes.

It is important to understand that this task does not refresh the contents of a repository. If you manually add repository elements to a repository file system without using Oracle VM Manager, this task does not automatically update Oracle VM Manager. Instead, you should refresh the repository manually, as described in Section 4.3.1.5, “Refresh Repository”.

Server Upgrade Checker Task

The Server Upgrade Checker Task periodically checks that all owned Oracle VM Servers known to Oracle VM Manager have the latest product versions installed. This check is performed against the updates available in the Yum repository. The default setting for this job is enabled with an interval of 1464 minutes.

This subtab includes a toolbar that consists of the following options:

Table 8.4 Recurring Subtab Toolbar Icon Options

Toolbar Icon Option	Icon	Description
Edit		Displays the Edit Recurring Job dialog. Use this option to edit a recurring job.
Help		Displays context sensitive help.

Toolbar Icon Option

Icon

Description

Edit

Displays the Edit Recurring Job dialog. Use this option to edit a recurring job.

Help

Displays context sensitive help.

8.2.1 Edit a Recurring Job

To edit a recurring job

Select the Jobs tab and then select the Recurring subtab.
Select a job in the Recurring Jobs table.
Click Edit... in the toolbar.
The Edit Recurring Job: job_name dialog box is displayed. Edit the recurring job as required and click OK.