Managing Jobs (Task Map)

A job can be in one of four active statuses, or Archived.

• Pending. The job is created and has not been executed. The job may be awaiting the system check-in, system reboot, or other manual intervention. A pending job can be canceled.

• In Progress. The job has been started and is not yet completed. Jobs can be started at system check-in or system reboot, or at other manual intervention.

• Failed. The job completed unsuccessfully. A failed job is eligible to be archived.

• Succeeded. The job completed successfully. A succeeded job is eligible to be archived.

• Archived. The completed job has been removed from the default list of jobs in the Sun Update Connection System pages. To see archived jobs, set the filter to Archived.

The following table identifies the common job-related tasks you can perform.

How to View Jobs (Browser Interface)

From the Jobs page, you can view jobs with any status. Use the Filter menu to choose one of the following categories:

• All Jobs. Lists all jobs except for those that have been archived.

• Archived Jobs. Lists completed jobs that have been archived.

• Completed. Lists non-archived jobs that are in the Succeeded or Failed status.

• Active. Lists jobs which are in the Pending or In Progress status.

1. From the Jobs page, choose the value from the Filter menu for the jobs you want to view.

2. Click the View Selected button to see the job details.

   This page does not automatically refresh. To refresh the screen to see progress, click your browser Reload or Refresh button.

How to View Job Details (Browser Interface)

1. From the Jobs page, select one or more jobs.

   Select the check box for each job for which you want to display details. The jobs included in the display depends on the Filter choice. If you do not see the jobs in which you are interested, change the Filter choice to All Jobs.

2. Click View Selected.

   The details about the selected jobs display. The links on this screen enable you to view system and update details by clicking on the system name or the update synopsis.

3. (Optional) Click the system name to view details about the system.

4. (Optional) Click the update synopsis to view details about the update.

How to Create a Job From the Systems Page (Browser Interface)

You can use jobs to install and uninstall an update. To create a job from the Updates page, see How to Create a Job From the Updates Page (Browser Interface).

1. From the Systems page, select one or more systems.

2. Click View Available Updates.

   This opens the list of updates available for each of the systems you selected. Each selected system displays with updates available for that system.

3. Select one or more updates for the listed systems.

   To select all listed updates for a listed system, select the check box for the system.

4. Click Apply Updates.

   Selected updates are reviewed against the updates that are already installed on the selected system to determine if any of the selected updates have dependencies.

5. (Optional) If one or more dependencies are detected, agree to install the dependencies.

   You must agree to install the listed dependencies along with the selected updates to create a job and insert the job in the queue. Click Cancel on the Dependencies window to close the window and discard the selections and to not create a job.

6. Review the Confirmation screen which lists the created and scheduled jobs.

   The confirmation screen lists the update to be installed, the system host name where the update is to be installed, and the expected installation time and date.

   ---

   Note –

   The job scheduled time and date is the next scheduled check-in for the system where the update is to be installed.

   ---

   These jobs will be queued and run at the next check-in of each affected system.

How to Create a Job From the Updates Page (Browser Interface)

A job is one update being installed on one or more selected systems. You can create an installation job or an uninstallation job from a Systems page or an Updates page. See How to Create a Job From the Systems Page (Browser Interface).

1. From the Updates page, select one or more updates.

   Each update installed creates one job, regardless of the number of affected systems. If you select multiple updates, multiple jobs are created: one per update.

2. Click View Systems Affected.

   This opens the list of systems available for each of the updates you selected. Each selected system displays in a group format with updates available for that system.

3. Select one or more updates for the listed systems.

   To select all listed updates for a listed system, select the check box for the system.

4. Click Apply Updates.

   Selected updates are reviewed against the updates that are already installed on the selected system to determine if any of the selected updates have dependencies.

5. (Optional) If one or more dependencies are detected, agree to install the dependencies.

   You must agree to install the listed dependencies along with the selected updates to create a job and insert the job in the queue. Click Cancel on the dependencies window to close the window and discard the selections and to not create a job.

6. Review the Confirmation screen which lists the created and scheduled jobs.

   The confirmation screen lists the update to be installed, the system host name where the update is to be installed, and the expected installation time and date.

   ---

   Note –

   The job scheduled time and date is the next scheduled check-in for the system where the update is to be installed.

   ---

   These jobs will be queued and run at the next check-in of the affected system.

How to Track a Running Job (Browser Interface)

A running job is one with the In Progress status.

From the Jobs page, you can view jobs with any status. Use the Filter menu to choose one of the following categories.

• All Jobs. Lists all jobs except for those that have been archived.

• Archived Jobs. Lists completed jobs that have been archived.

• Completed. Lists non-archived jobs that are in the Succeeded or Failed status.

• Active. Lists jobs which are in the Pending or In Progress status.

1. From the Jobs page, choose In Progress from the Filter menu.

   The jobs which have started and are not completed display in the list. If the job does not display, perhaps the job is complete or pending.

2. Click the View Selected button to see the job details.

   This page does not automatically refresh. To refresh the screen to see progress, click your browser Reload or Refresh button.

How to Archive a Completed Job (Browser Interface)

Each completed job has either a failed or a succeeded status. Only a job that has completed can be archived. Those jobs with the icon can be archived.

1. From the Job page, choose All from the Filter menu.

   All current (non-archived) jobs are listed.

2. Select one or more of the completed jobs you want to archive.

   Select the check box for any completed job with a status of either Failed or Succeeded.

3. Click Archive Selected.

   A pop-up message displays confirming that the selected jobs with a completed status are archived. Any jobs with a status of Pending or In Progress cannot be archived.

How to View the Status of a Job (Browser Interface)

From the Jobs page, choose All Jobs from the Filter menu.

A list of all current (non-archived) jobs displays with the status of each. Archived jobs do not display in this list.

How to Cancel a Pending Job (Browser Interface)

Only a job with a status of Pending can be canceled. The Cancel Updates for Selected Systems window displays. This window includes the update details and the system details of the job that you have requested to be canceled.

1. From the Jobs page, choose Pending (under Active) from the Filter menu.

2. Select the check box for the job to be canceled.

3. Select one or more jobs that you want to cancel.

4. Click Cancel Selected Jobs.

5. Confirm that you want to cancel the job.

   • Click OK to cancel the job.

     The job moves to a Failed status, and the job is removed from the queue to be executed.

   • Click Cancel to discard the job cancellation request.

     The window closes, the request is discarded, and you are returned to the Job Details window.