Sun Update Connection System 1.0.8 Administration Guide

Chapter 5 Managing Solaris Updates by Using the Sun Update Connection Hosted Browser Interface

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

Managing Solaris Updates by Using the Sun Update Connection Hosted Web Application (Task Map)

To use the Sun Update Connection Hosted web application, you must first register your Solaris 10 systems with the 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 Hosted web application to remotely manage your systems.


Note –

If you use the Sun Update Connection Hosted web application, you can still use the Update Manager application to perform update management jobs locally.


You can access the Summary page, the Systems page, the Updates page, or the Jobs page by clicking the tabs at the top of the page.

The Summary page appears each time you log in to the Sun Update Connection System web site. It shows summary information about systems, updates, and jobs.

From this page, you can get the following information about systems, updates, and jobs, each in their own section:

Each page includes a Jobs Summary sidebar, which shows up to 25 of the jobs created this session. When the Jobs Summary queue is full and you create a new job, the first one drops off of the list. You can access job details from the sidebar.

If your session is inactive for 20 minutes, you are automatically logged out. The web application issues a warning after 15 minutes and enables you to extend the session for another 20 minutes.

The following table identifies the tasks that you might perform when you use the Sun Update Connection Hosted web application.

Task 

Description 

For Instructions 

Access the web application. 

Log in to the browser interface and manage your Sun Online Account. 

Accessing the Sun Update Connection System (Task Map)

Manage your systems. 

You can use the browser interface to set the check-in interval for your system, change a system name, view your systems, view applicable updates, and remove systems from the list of those managed by the Sun Update Connection System. 

Managing Systems by Using the Sun Update Connection System (Task Map)

Manage updates. 

Install updates and update dependencies, uninstall updates, and view update details. 

Managing Updates by Using Sun Update Connection System (Task Map)

Manage jobs. 

View jobs and job details, create jobs, track running jobs, archive jobs, view job status, and cancel pending jobs. 

Managing Jobs (Task Map)

Accessing the Sun Update Connection System (Task Map)

The following table identifies the tasks that you might perform when you access the Sun Update Connection Hosted web application.

Task 

Description 

For Instructions 

Log in to the Sun Update Connection System web site. 

Access the Sun Update Connection Hosted web application to manage updates on one or more of your systems. 

How to Log In to the Sun Update Connection System Web Site (Browser Interface)

(Optional) Retrieve your forgotten Sun Online Account user name. 

If you forgot your Sun Online Account user name, you can request that it is sent to you. 

How to Retrieve Your Forgotten User Name (Browser Interface)

(Optional) Retrieve your forgotten Sun Online Account password. 

If you forgot your Sun Online Account password, you can request that it is sent to you. 

How to Retrieve Your Forgotten Password (Browser Interface)

(Optional) Change your Sun Online Account password. 

Periodically change your password to improve the security of your account. 

How to Change Your Password (Browser Interface)

(Optional) Create a Sun Online Account. 

If you do not already have a Sun Online Account, you can create one from the Sun Update Connection System web site. 

How to Create a Sun Online Account (Browser Interface)

(Optional) Modify your Sun Online Account information. 

You can modify your system's registration information. 

How to Modify Your Sun Online Account Information (Browser Interface)

ProcedureHow to Log In to the Sun Update Connection System Web Site (Browser Interface)

  1. Open your browser.

    Supported browsers include the following:

    • At least Mozilla 1.3

    • At least Internet Explorer 5.0

    • At least Firefox 1.0

  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.

    If you have forgotten your user name, see How to Retrieve Your Forgotten User Name (Browser Interface).

    If you have forgotten your password, see How to Retrieve Your Forgotten Password (Browser Interface).

ProcedureHow to Retrieve Your Forgotten User Name (Browser Interface)

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 (Browser Interface).

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

    The Already a Sun Update Connection System 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.

    • If the email address is validated, Sun sends you an email with the user names associated with the email address.

    • If the email address is not found or is not valid, you receive one of the following error messages:

      • Email does not correspond to a Sun Online Account

      • Email and user name do not correspond to a Sun Online Account

      • Email and user name do not correspond to the same Sun Online Account

        A confirmation screen directs you to a sent email.

  5. Return to the Sun Update Connection System login screen.

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

ProcedureHow to Retrieve Your Forgotten Password (Browser Interface)

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

    The Already a Sun Update Connection System 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.

    • If the email address is validated, your password is reset to a system-generated password, and your generated password is emailed to you.

    • If the email address is not found or is not valid, you receive one of the following error messages:

      • Email does not correspond to a Sun Online Account

      • Email and user name do not correspond to a Sun Online Account

        Enter your correct email address and click Submit.

        A confirmation screen directs you to a sent email.

  6. Return to the Sun Update Connection System login screen.

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

ProcedureHow to Change Your Password (Browser Interface)

  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.

    • If the password change succeeds, click Continue.

    • If the password change fails, reenter the password and click Submit.

ProcedureHow to Create a Sun Online Account (Browser Interface)

If you have not previously created a Sun Online Account, you can create one from the Log In screen.


Note –

A Sun Online Account is required for you to register each client system. If you are creating your Sun Online Account here, you have not registered your Sun systems for remote update management in the Update Manager application. You must log into each client system and register each system for Manage at Sun Update Connection System to view and manage your systems using the Sun Update Connection System services.


  1. Click the Not Registered: Create Account link in the Existing Users Log in panel.

    The Registration window appears.


    Note –

    The system where you are logged in must be connected to the Internet to create the Sun Online Account. The information you enter into the fields is saved locally and sent to Sun. Sun requests that you use English characters for the information you supply.


  2. Complete the fields.

    Some fields are required. Your account creation will fail if any of these fields are blank.

  3. Click Next to connect to Sun and validation of the entered data.

    If a required field is blank, or an invalid entry is detected, a message displays, the screen is displayed again, and you are prompted to correct the error or fill in the blank field.

    Data is validated to make sure of the following:

    • User name is not already taken (at Sun).

    • Required fields are completed.

    • All entered data matches field validation logic.

  4. Click Continue.

    The Terms of Use window displays.

  5. Review the Sun Terms of Use.

    • If the terms are acceptable, click I Accept and click Submit.

      Your registration is completed, and the Home page appears.

    • If you have questions or concerns about the Terms of Use, click Cancel to discard your account changes.

      Contact your Sun representative to discuss your questions or concerns.

      The Summary screen appears, but no system information is displayed as no systems are registered.

  6. Launch the Update Manager application and register your system.

ProcedureHow to Modify Your Sun Online Account Information (Browser Interface)

You can manage your Sun Online Account from the Sun Update Connection System web site. You can modify your registration information and change your password.

  1. Click Account.

    The button is at the top of your screen.

  2. Click Update Registration Information.

    The Sun Online Account registration form appears, which shows the current values.

  3. Modify the values in the appropriate fields.

  4. Enter your password.

  5. Click Continue.

    Your account information is modified, and a confirmation of success displays.

Managing Systems by Using the Sun Update Connection System (Task Map)

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

Task 

Description 

For Instructions 

View your systems. 

You want to see the systems you manage. View system update status. 

How to View Your Systems (Browser Interface)

View details about each system being managed. 

You want to see configuration information about each of your systems. 

How to View System Details (Browser Interface)

View applicable updates for one or more systems. 

You want to see the list of applicable updates that can be applied to one or more of your systems. 

How to View the Applicable Updates for One or More Systems (Browser Interface)

Modify system settings. 

You want to modify some of your system settings. 

How to Edit System Settings (Browser Interface)

Set the check-in interval for your systems. 

You want to specify how often each of your systems check in to the Sun Update Connection System web site to run jobs. 

How to Set the Check-In Interval for a System (Browser Interface)

Change a system name. 

You want to change the name of one or more of your systems. 

How to Change a System Name (Browser Interface)

Delete a system. 

You no longer want a system to be managed by the Sun Update Connection Hosted web application, so you delete it. A deleted system is still registered. 

How to Delete a System (Browser Interface)

ProcedureHow to View Your Systems (Browser Interface)

  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 by using the Sun Update Connection Hosted web application.

    You can do this from the Update Manager application:

    • Click Manage at Sun Update Connection System.

      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.

    • Complete the registration for remote management.

      A confirmation window displays asking if you want to open the Sun Update Connection Hosted web application.

ProcedureHow to View System Details (Browser Interface)

    From 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 Update Manager application.

ProcedureHow to View the Applicable Updates for One or More Systems (Browser Interface)

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.


ProcedureHow to Edit System Settings (Browser Interface)

  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:

ProcedureHow to Set the Check-In Interval for a System (Browser Interface)

  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 the Sun Update Connection System.

  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:

    • View Available Updates

    • View Installed Updates

    • View All Jobs

ProcedureHow to Change a System Name (Browser Interface)

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:

    • View Available Updates

    • View Installed Updates

    • View All jobs

ProcedureHow to Delete a System (Browser Interface)

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 Sun Update Connection System 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 Sun Update Connection System 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:

    • View Available Updates

    • View Installed Updates

    • View All Jobs

Managing Updates by Using Sun Update Connection System (Task Map)

The following table identifies the common update-management tasks you can perform.

Task 

Description 

For Instructions 

Install an update. 

You want to install updates to one or more of your systems. 

How to Install an Update (Browser Interface)

Install updates on which other updates depend. 

You want to install updates on which other updates depend. 

How to Install Dependent Updates With Selected Updates (Browser Interface)

Remove updates from one or more systems. 

You want to remove updates from one or more of your systems. 

How to Uninstall an Update (Browser Interface)

View details about an update. 

You want to view the details about an update in the update README file. 

How to View Update Details (Browser Interface)

ProcedureHow to Install an Update (Browser Interface)

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 want 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:

  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.

ProcedureHow to Install Dependent Updates With Selected Updates (Browser Interface)

  1. From the Systems page, select one or more check boxes for any systems where updates are to be installed.

  2. Click View Available Updates.

  3. Select the check boxes of the updates you want installed, and click Apply Updates.

    Sun Update Connection System searches the information for the selected updates, and if one or more updates must be installed before you can install a selected update, the dependencies are displayed in an Install Dependencies and Confirmation window.


    Note –

    You must install any dependencies or no job can be created to install the selected updates.


  4. Click the Install All Above Updates button to agree to install the listed dependencies and the selected updates.

    The job is created, and a confirmation window opens.

    If you choose not to install the dependencies, click Cancel to close the window and discard your update installation request.

  5. Click a tab to navigate from the confirmation window.

ProcedureHow to Uninstall an Update (Browser Interface)

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.

ProcedureHow to View Update Details (Browser Interface)

    From 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 (Task Map)

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

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

Task 

Description 

For Instructions 

View your jobs. 

You want to see the jobs that you have created to run on one or more of your systems. 

How to View Jobs (Browser Interface)

View details about each job you created. 

You want to see detailed information about the jobs you created. 

How to View Job Details (Browser Interface)

Create a job from the Systems page. 

You want to create a job to install updates to one or more of your systems. 

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

Create a job from the Updates page. 

You want to create a job to install updates to one or more of your systems. 

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

Track a running job. 

You want to see which jobs are running on your systems. 

How to Track a Running Job (Browser Interface)

Archive a completed job. 

You want to move a completed job to the archive. 

How to Archive a Completed Job (Browser Interface)

View the status of a job. 

You want to see the status of a job. 

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

Cancel a pending job. 

You no longer want to run a job you created. You can only cancel a pending job, which has been scheduled but has not run. 

How to Cancel a Pending Job (Browser Interface)

ProcedureHow 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:

  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.

ProcedureHow 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.

ProcedureHow 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.

ProcedureHow 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.

ProcedureHow 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.

  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.

ProcedureHow 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.

ProcedureHow 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.

ProcedureHow 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.