Sun Management Center 4.0 Installation and Configuration Guide

ProcedureTo Create a Patch-Only Image Using the Image Tools

Sun Management Center-specific patches are released periodically on the Sun Management Center web site at http://www.sun.com/sunmanagementcenter. Sun Management Center enables you to create a patch-only image, and then apply the patch-only image to multiple agent machines.

  1. Log in as root on the Sun Management Center 4.0 server machine.

  2. Create a directory in which to download the Sun Management Center patches.

    Change to the directory you just created. Create directories for each Solaris operating environment version for which you want to download patches.

    For example, assume you created the directory /sunmcpatches. Furthermore, assume you plan to create patch-only update images for each supported Solaris version. You would create the directories as follows.


    # mkdir /sunmcpatches
    # cd /sunmcpatches
    /sunmcpatches# mkdir Solaris_8 Solaris_9
    

    The directories must be created using the names shown.

  3. Log on to SunSolve.

    Click the Login button to display the login screen, and then enter your SunSolve ID and password.

    If you do not have a SunSolve ID, click the Register button to obtain a SunSolve ID.

  4. Download the patches for each Solaris version.

    Click the patch number corresponding to the Solaris version.

    The SunSolve Online Web page is displayed.

    1. Type the number of the patch you want to view, and then click Find Patch.

      A description of the patch is displayed.

      Make note of the supported Solaris versions. If the patch applies to more than one Solaris version, you must download the patch file for each Solaris version.

    2. Click either the HTTP or FTP download link to download the patch.

      The Save As panel appears.

      Save the patch file to the applicable Solaris version directory you created in Step 2.

      For example, assume patch 111222-33 is applicable to Solaris version 8 and Solaris version 9. Assume that you also created the subdirectories Solaris_8 and Solaris_9 within the root directory sunmcpatches. You would then download the patch file to both /sunmcpatches/Solaris_8 and /sunmcpatches/Solaris_9.

    If you want to download more patches, click Back to return to the SunSolve Online Web page. Repeat the previous two steps to download each patch you have selected.

    When you have completed downloading patches, go to the next step.

  5. Uncompress the patch files.

    Change to each directory where you downloaded the patch files and uncompress the files.

    For example, assume you downloaded the patch file for patch 111222–33 and patch 111222–34 to /sunmcpatches/Solaris_8. Also assume that the patch file for patch file 111222–33 is 111222–33.tar.Z, and the patch file for 111222–34 is 111222–34.zip. You would then uncompress the patch files as follows:


    /sunmcpatches # cd Solaris_8
    /sunmcpatches/Solaris_8 # ls
    111222-33.tar.Z        111222-34.zip
    /sunmcpatches/Solaris_8 # zcat 111222-33.tar.Z | tar xvf -
    x 111222-33, 0 bytes, 0 tape blocks
    x 111222-33/installpatch, 119239 bytes, 233 tape blocks
       .
       .
       .
    x 111222-33/README.111222-33, 136444 bytes, 267 tape blocks
    /sunmcpatches/Solaris_8 # unzip 111222-34.zip
    Archive: 111222-34.zip
       creating: 111222-34/
    ..inflating: 111222-34/prepatch
       .
       .
       .
      inflating: 111222-34/README.111222-34
    /sunmcpatches/Solaris_8 # ls -p
    111222-33/     111222-33.tar.Z.....111222-34/     111222-34.zip

    You can create the patch-only image using either the graphical tool es-gui-imagetool as described next in Step 7 , or by using the command-line tool es-imagetool as described in Step 8.

  6. Move the download patch files to another directory.

    Either move the compressed download patch files to another directory for safekeeping, or delete the compressed patch files.

  7. Create the patch-only image file using es-gui-imagetool.


    Note –

    The following steps assume that you installed Sun Management Center in the default directory /opt. If you installed Sun Management Center in a different directory, replace /opt with the name of the directory you specified.


    1. Type the command /opt/SUNWsymon/sbin/es-gui-imagetool.

      The Welcome screen appears. Click Next. The Overview screen appears. Click Next.

      The Select Update-Image Options screen appears.

    2. Select Base and Add-on Agent Patches Only.

      Click Next.

      The Specify the Installation Files Source Directory screen appears.

    3. Specify the patch file source directory.

      Type the name of the patch directory you created in Step 2, or Click Browse to navigate to and select the directory.

      Click Next. The Update Image Name screen appears.

    4. Provide a name for the patch-only image.

      Type a name for the patch-only image that reflects the image type, for example base-and-addon-patches.

      The image is created in /var/opt/SUNWsymon/agentupdate/update-image-name where update-image-name is the name that you provide.

      Click Next. The OS Selection screen appears.

    5. Select the Solaris versions that the target machines are running.

      The image tool will create images for all Solaris versions supported by Sun Management Center irrespective of the version of the machine on which the tool is running. You have a choice of selecting any of the Solaris versions, or all versions.


      Caution – Caution –

      If you omit a Solaris version when you create a patch-only image, application of the patches to the machine whose Solaris version is omitted will fail.


      Click Next. The Checking for Patches screen appears. When the image tool has completed checking for patches, the Select Patches screen appears.

    6. Select the patches you want to add to the patch-only update image.

      You can select all patches, or you can select individual patches.

      When you have finished selecting patches, click Next. The image tool checks for disk space.

      • If there is not enough space to create the image, you are notified. The amount of free space that is needed is listed. Click Cancel to exit the image tool. You must increase the amount of free space by the amount listed before you can create a patch-only image.

      • If there is enough disk space, the Confirmation screen is displayed.

    7. Confirm Update-Image Selections

      A list of the patches and the Solaris versions that you selected for the patch-only image is displayed.

      • If the list is not correct, click Back twice to return to the Solaris version selection screen, or click Back once to return to the Select Patches screen. Select the Solaris versions and patches that you want to add to the patch-only image and confirm your new selections.

      • If the list is correct, click Next.

        The image tool creates the patch-only image in the directory /var/opt/SUNWsymon/agentupdate using the file name you specified in Step d.

      You are notified when the update image has been created. Click Close to return to the system prompt.

      You can check the update image creation status by viewing the log file /var/opt/SUNWsymon/install/es-gui-imagetool_host-name.date-and-time-string.process-id where:

      • host-name is the name of the Sun Management Center 4.0 server that you used to create the update image.

      • date-and-time-string is the year, date, and time the image was created.

      • process-id is the process ID of the imagetool session that created the agent-update image.

    8. Apply the patch-only image.

      You can now apply the image to the target machines.

  8. Create the patch-only image file using es-imagetool.


    Note –

    The following steps assume that you installed Sun Management Center in the default directory /opt. If you installed Sun Management Center in a different directory, replace /opt with the name of the directory you specified.


    1. Type the command /opt/SUNWsymon/sbin/es-imagetool.

      You are asked whether you want to upgrade components of the Base agent. Type n and press Return.

      You are asked whether you want to install or upgrade components of add-ons. Type n and press Return.

      You are asked whether you want to install patches. Type y and press Return.

      You are prompted for the patch-only source directory.

    2. Specify the patch file source directory.

      Type the name of the patch directory you created in Step 2, and then press Return.

      You are prompted to provide a name for the patch-only image.

    3. Provide a name for the patch-only image.

      Type a name for the patch-only image that reflects the image type, for example base-and-addon-patches.

      The image is created in /var/opt/SUNWsymon/agentupdate/update-image-name where update-image-name is the name that you provide.

      Press Return. The supported Solaris versions are listed.

    4. Select the Solaris versions that the target machines are running.

      The image tool will create images for all Solaris versions supported by Sun Management Center irrespective of the version of the machine on which the tool is running. You have a choice of selecting any Solaris version, or all versions.


      Caution – Caution –

      If you omit a Solaris version when you create an patch-only image, application of the patches to the machine whose Solaris version is omitted will fail.


      • To select all Solaris versions, type y.

      • To select only specific Solaris versions, type n.

        You are prompted to select each Solaris version sequentially. Type y to select a Solaris version, or type n to exclude the Solaris version from the image.

      Press Return. The image tool lists the patches that are available for selection.

    5. Select the patches that you want to add to the patch-only update image.

      You are prompted to select each patch.

      Type y to select a patch for inclusion in the patch-only image, or type n to exclude the patch from the image.

      When you have completed selecting patches, press Return. The image tool checks for disk space.

      • If there is not enough space to create the image, you are notified. The amount of free space that is needed is listed. Type q to exit the image tool. You must increase the amount of free space by the amount listed before you can create a patch-only image.

      • If there is enough disk space, the patch-only image is created in the directory /var/opt/SUNWsymon/agentupdate using the file name that you specified in Step c.

      You can check the update image creation status by viewing the log file /var/opt/SUNWsymon/install/es-imagetool_host-name.date-and-time-string.process-id where:

      • host-name is the name of the Sun Management Center 4.0 server that you used to create the update image.

      • date-and-time-string is the year, date, and time the image was created.

      • process-id is the process ID of the imagetool session that created the agent-update image.

    6. Apply the patch-only image.

      You can now apply the image to the target machines.