C H A P T E R  3

Managing Updates by Using the Sun Update Connection Services

This chapter explains how to perform the update management jobs using the Sun Update Connection services. It includes the following sections:


Using the Sun Update Connection Services to Manage Updates

To use the Sun Update Connection services, you must first register your Solaris 10 systems with the Sun Update Manager registration wizard. During registration, you must supply your Update Manager subscription key, and indicate that you want to use the Sun Update Connection web site to remotely manage your systems.



Note - If you use the Update Connection services, you can still use the Update Manager application to perform update management jobs locally.



For more information about Sun Update Manager, see the Sun Update Manager 1.0 Administration Guide.


Accessing the Update Connection


procedure icon  How to Log in to the Sun Update Connection Web Site

1. Open your browser.

Supported browsers include the following:

2. Go to http://updates.sun.com.

Consult your network administrator for network proxy and port settings if you have difficulty connecting.

3. Enter your Sun Online Account user name and password, and click Log In.


procedure icon  How to Retrieve Your Forgotten User Name

Sun stores the email address for each Sun Online Account and the associated user names. One email address can have one or more associated user names. Sun can email the user names linked to an email address.

If you remember your user name and have forgotten your password, see How to Retrieve Your Forgotten Password.

1. From the Update Connection login screen, click Forgot User name or Password.

The Already a Sun Update Connection User window opens.

2. Click the Forgot your User Name or Password? link.

The Forgot Your User Name or Password? window opens.

3. Enter your email address.

This is the email address you provided to Sun when you registered for your Sun Online Account.

4. Click Submit.

Sun verifies that the email address is associated with a valid Sun Online Account.

A confirmation screen directs you to a sent email.

5. Return to the Update Connection login screen.

6. Enter your Sun Online Account user name and password, and click Log In.


procedure icon  How to Retrieve Your Forgotten Password

1. From the Update Connection login screen, click Forgot User name or Password.

The Already a Sun Update Connection User window opens.

2. Click the Forgot your User Name or Password? link.

The Forgot Your User Name or Password? window opens.

3. Enter your email address.

This is the email address you provided to Sun when you registered for your Sun Online Account.

4. Enter your User Name.

5. Click Submit.

Sun verifies that the email address is associated with a valid Sun Online Account.

Enter your correct email address and click Submit.

A confirmation screen directs you to a sent email.

6. Return to the Update Connection login screen.

7. Enter your Sun Online Account user name and password, and click Log In.


procedure icon  How to Change Your Password

1. Click Account.

2. Click Change Your Password.

Your Sun Online Account user name appears.

3. Type your current password.

4. Type your new password.

The new case-sensitive password must be 6-8 characters in length.

5. Retype your new password.

6. Click Submit.


Configuring Your Update Management Environment by Using Update Connection


procedure icon  How to Edit System Settings

1. From the Systems page, click the History icon in the System Name column.

The History icon provides access to the historical data for the system.

The Installed Updates page for the system you selected opens.

2. Click Edit System Settings.

The button is located below the page name and above the list of installed updates.

3. Choose the setting to edit:

See How to Set the Check-In Interval for a System.

See How to Change a System Name.

See How to Delete a System.


procedure icon  How to Set the Check-In Interval for a System

1. From the Systems page, click the History icon in the System Name column.

The History icon provides access to the historical data for the system.

The Installed Updates page for the system you selected opens.

2. Click Edit System Settings.

The button is located below the page name and above the list of installed updates.

3. Set System to check in with Sun Update Connection services.

4. Choose the check-in interval from the menu.

The default check-in interval is two hours. Select from the drop-down list to change the interval.

Your system will check in at the next originally scheduled interval. After that check-in, the newly set interval is activated.

5. Click Save Changes.

After you save the changes, you are returned to the Edit Your System Settings window.



Note - To exit this screen without saving any changes, skip this step and click a navigation button.



6. Exit the System Settings page.

You can exit this page by clicking one of the following buttons:


procedure icon  How to Change a System Name

You can modify the name of the selected system. The populated name is the name sent to Sun during system registration.

1. From the Systems page, click the History icon, on the same line as the system name.

The Systems page includes an icon in the system name column. This icon provides a link to the historical data for the system.

The Installed Updates page for the system you selected opens.

2. Click Edit System Settings.

The button is located below the page name and above the list of installed updates.

3. Enter a System Name.

The default name is the one used when you registered the system. Each of the systems you manage must have a unique name.



Note - If you enter a system name which is already in use and assigned to you, an error message displays in a pop-up window instructing you to re-enter the system name.



4. Click Save Changes.

After you save the changes, you are returned to the Edit Your System Settings window.



Note - To exit this screen without saving any changes, skip this step and click a navigation button.



5. Exit the System Settings page.

You can exit this page by clicking one of the following links:


procedure icon  How to Delete a System

To remove a system from remote update management, click Delete System. A confirmation message displays in a pop-up window. If you click OK, the system information is removed from the Update Connection records, including all job information. The deleted system's job queue is removed and pending jobs are not started. In addition, the automatic system analysis and check-in processes are stopped.

You can manage the deleted system in the Update Manager application. You can re-register the system for remote management at the Update Manager client application.

1. From the Systems page, click the History icon, on the same line as the system name.

The Systems page includes an icon in the system name column. This icon provides a link to the historical data for the system.

The Installed Updates page for the system you selected opens.

2. Click Edit System Settings.

The button is located below the page name and above the list of installed updates.

3. Choose Delete System.

The information sent to Sun when you registered this system for remote management at the Update Connection is displayed. This information is read only.

4. Click Save Changes.



Note - To exit this screen without saving any changes, skip this step and click a navigation button.



After you save the changes, you are returned to the Edit Your System Settings window.

5. Exit the System Settings page.

You can exit this page by clicking one of the following links:


Managing Systems by Using the Update Connection


procedure icon  How to View Your Systems

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

All systems linked to your Sun Online Account are listed.

2. (Optional) If a system is not listed, register the system for remote update management at the Sun Update Connection web site.

You can do this from the Update Manager application:

If the system is not registered for remote management, the registration screen displays. You can enter your Sun Online Account user name and password in this screen.

A confirmation window displays asking if you want to open the Update Connection services.


procedure icon  How to View System Details

single-step bulletFrom the Systems Page, click the name of a system.

A message pops up which includes the details of the system which were sent to Sun when you registered the system in the Sun Update Manager application.


procedure icon  How to View the Applicable Updates for One or More Systems

The list of available updates is automatically updated when the system checks in with Sun. Updates remain in the list until the system check-in, so the list may not reflect real time changes.

1. From the Systems page, check the check box for the systems for which you want to view available updates.

2. Click View Available Updates.

All updates available for the selected system are listed.



Note - If you uninstalled an update, it might not be listed until the system checks in and the analysis for that system is performed. The uninstalled update might not be appropriate, so it is not automatically added to the list of available updates.




Managing Updates by Using Update Connection


procedure icon  How to Install an Update

This procedure describes how to create a job to install one update on one or more of your systems. After you have created your jobs, each of your systems checks in to Sun or to your Sun Update Connection Proxy to perform their queued jobs.

If an update you install requires a system reboot to activate it, the update is staged for installation at the next system shutdown. You must use one of the following commands to initiate the system shutdown:



Note - Do not use the reboot command, the halt command, the uadmin command, or press the Reset or Power button to initiate the shutdown. Taking any of these actions bypasses the required shutdown processing, and prevents the updates from being staged for later installation.



1. From the Updates page, select one or more systems, and click View Available Updates.

A window that shows a list of all updates for each system you selected appears.

2. Select one or more updates you want installed on the systems you selected.

The window shows the time of the next check-in for each system. This is the time at which your system will check in to Sun or to your Sun Update Connection Proxy and run queued jobs for that system.

A confirmation window appears to show you the details about the jobs you created.



Note - If the installation of an update that you selected requires that another update be installed, a dialog box appears to show you this dependency. To successfully install the update you originally selected, you must agree to install the dependency or the job will not be created.



3. Click Apply Updates to create the job.

The job is queued for execution at the next check-in time. One job is created for each update to be installed on one or more systems.

4. Click Cancel to discard the job information.


procedure icon  How to Uninstall an Update

Some updates that affect core Solaris functionality cannot be uninstalled. On the Updates page these updates are designated by a dash in the check box column and cannot be selected.

From the Systems page, you can click completed jobs to view the list of updates that have already been installed on the system you selected and the date when each update was installed.

1. From the Updates page, select the updates you want to uninstall.

2. Click Uninstall Selected.



Note - If you try to uninstall an update that has one or more dependencies (updates which must be uninstalled along with the selected update), a dialog box appears that lists the dependencies and gives details about the dependency updates. You must agree to uninstall the dependencies along with the selected updates to proceed with the uninstall. Click OK to agree.



The uninstallation operation runs. An acknowledgment dialog box appears when the uninstallation operation successfully completes. If the operation fails, an acknowledgement dialog box appears that explains the failure.


procedure icon  How to View Update Details

single-step bulletFrom the Updates page, click the update ID of the update for which you want to see details.

The README for the update displays in a pop-up window.


Managing Jobs

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


procedure icon  How to View Jobs

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

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.


procedure icon  How to View Job Details

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.


procedure icon  How to Create a Job From the Systems Page

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.

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.


procedure icon  How to Create a Job From the Updates Page

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.

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.


procedure icon  How to Track a Running Job

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.

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.


procedure icon  How to Archive a Completed Job

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.


procedure icon  How to View the Status of a Job

single-step bulletFrom 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.


procedure icon  How to Cancel a Pending Job

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.

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

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