test

Sun Management Center 3.5 Update 1 Supplement

Using the Agent-Update Image Feature for x86

When you use the agent update feature, you create a single image and apply it to multiple hosts. You need to create separate update images for SPARC and x86. The procedures for creating and applying agent-update images varies slightly for x86. For general information on creating an agent installation and update image, see “Creating Agent Installation and Update Images” in the Sun Management Center 3.5 Installation and Configuration Guide.

You can create the agent-update image by using the es-gui-imagetool, which has a graphical user interface, or by using the es-imagetool, which has a command-line interface.

To Create an Agent-Update Image Using es-gui-imagetool for x86

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

  2. Run the Sun Management Center 3.5 Update 1 GUI image tool by typing the following command: 


    # /opt/SUNWsymon/sbin/es-gui-imagetool

    The Welcome screen appears. Click Next. The Overview screen appears, listing the information that you might need to provide. Click Next.

    The Select Update-Image Components screen appears.

  3. Select the update-image components.

    Four choices are provided:

    • Base Agent Packages

    • Add-on Agent Packages

    • Base and Add-on Agent Packages

    • Base and Add-on Agent Patches Only

    Note –

    Any patches needed for a selected package are automatically included when you select the package. If you want to install base agent patches and add-on agent patches only, select Base and Add-on Agent Patches Only.

    Select the type of update-image that you want to create, and then click Next. The Specify the Installation Files Source Directory screen appears.

  4. Provide the name of a valid Sun Management Center 3.5 Update 1 source directory.

    The installation source default /cdrom/cdrom0/image is displayed.

    • If you are installing from CDs, insert Sun Management Center 3.5 Update 1 Software CD 1 of 2 in the CD-ROM drive.

      Enter the following path:


      /cd-rom-mount-point/x86/image

    • If you are installing from a Sun Management Center 3.5 Update 1 image on disk, type the path to the disk1/x86 in the Source Directory field. For example, type:


      Source Directory: cd-image-dir/disk1/x86/image

    Click Next.

  5. Follow Steps 5 to 12 in “To Create an Agent-Update Image Using es-gui-imagetool” in the Sun Management Center 3.5 Installation and Configuration Guide as appropriate.

    Note –

    When you are asked to provide a name for the agent update-image, it is recommended that you use a naming convention that indicates the x86 architecture, for example, x86baseagent.

  6. Apply the agent-update image by following To Install or Update Agents From an Agent-Update Image Using agent-update-bin for x86.

To Create an Agent-Update Image Using es-imagetool for x86

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

  2. Run the Sun Management Center 3.5 Update 1 command-line image tool by typing the following command: 


    # /opt/SUNWsymon/sbin/es-imagetool

  3. Select the components to update.

    You are prompted to select the components that you want to add to the update-image, for example:


    Select the components you want to add to the update-image.

Do you want to upgrade components of Base Agent? [y|n|q] y
Do you want to install/upgrade components of Addons? [y|n|q] y

    Type y to add the component to the update-image, or type n to exclude the component from the update-image.

    You are prompted for a valid source directory.

  4. Provide the name of a valid Sun Management Center 3.5 Update 1 source directory.

    • If you are installing from CDs, insert Sun Management Center 3.5 Update 1 Software CD 1 of 2 in the CD-ROM drive and type the path to the Sun Management Center 3.5 Update 1 installation directory for x86.


      Enter a valid source directory: /cdrom-mount-point/x86/image

    • If you are installing from a Sun Management Center 3.5 Update 1 image on disk, type the path to the image disk1/x86/image directory. Type:


      Enter a valid source directory: /cd-image-dir/disk1/x86/image

  5. Follow Steps 5 to 9 in “To Create an Agent-Update Image Using es-imagetool” in the Sun Management Center 3.5 Installation and Configuration Guide as appropriate.

    Note –

    When you are asked to provide a name for the agent update-image, it is recommended you use a naming convention that includes the x86 architecture. For example, type x86baseagent.

  6. Apply the agent-update image by following To Install or Update Agents From an Agent-Update Image Using agent-update-bin for x86.

Note –

Because Sun Management Center 3.5 Update 1 is the first version to have the x86 agent, you can update agents initially by using the agent-update.bin method only. For incremental add-on installations of agents, you can use the manage jobs tasks, described in “To Install Agents From an Agent-Update Image Using the Manage Jobs Task” in the Sun Management Center 3.5 Installation and Configuration Guide.

To Install or Update Agents From an Agent-Update Image Using agent-update-bin for x86

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

  2. Create an agent-update image using either of the image tools.

  3. Download the appropriate agent-update.bin from the Sun Management Center server to each target machine's root directory.

    • For x86 agents, the file is found in /opt/SUNWsymon/base/bin/i386-sun-solaris/agent-update.bin.

    • For SPARC agents, the file is found in /opt/SUNWsymon/base/bin/sparc-sun-solaris/agent-update.bin.

  4. Log in as root on the target machine.

  5. Go to the directory where you downloaded agent-update.bin.

  6. Type ./agent-update.bin -s server -r http-port -p image-name, where

    • server is the server that you logged into in Step 1.

    • http-port is the Sun Management Center 3.5 Update 1 Web server port.

    • image-name is the name of the agent-only image you created in Step 2.

    For example, assume that the Sun Management Center 3.5 Update 1 server name is Production1 and that the Web server port is 8080. Also, assume that the agent-update image name is x86baseagent. You would then type:


    # ./agent-update.bin -s Production1 -r 8080 -p x86baseagent

  7. Provide the security seed and the SNMPv1 community string.

    The agent-update process prompts you for the security seed and the SNMPv1 community string.

    • The security seed must be the same seed that you provided when you set up the Sun Management Center 3.5 Update 1 server and agent.

    • The SNMPv1 community string must be the same community string you provided when you set up the Sun Management Center 3.5 Update 1 server and agent.

    The update process applies the update to the machine without prompting for further information.

    When the update process completes, check the update status by viewing the log file /var/opt/SUNWsymon/log/agent-update.log on the target machine.

To Create an Agent-Only Installation Image Using es-makeagent for x86

  1. Log in as root.

  2. Put the Sun Management Center 3.5 Update 1 Software CD 1 of 2 in the CD-ROM drive.

  3. Type the command /opt/SUNWsymon/sbin/es-makeagent.

    You are prompted for the installation source files directory.

  4. Type the source directory.

    If you are installing from CD-ROM, type:


    cdrom-mount-point/x86/image

    If you are installing from a CD image, type:


    cdrom-image-dir/x86/image

  5. Type the name of the target directory.

    If the directory does not exist, you are asked whether you want to create it. Type y to create the directory, or type n or q to exit to the system prompt.

    The directory you specify must have write permission for root.

    For example:


    # enter the target directory: /es-makeagent-image
Directory /es-makeagent-image does not exist
Do you want to create it (y|n|q) y

    The es-makeagent script creates the subdirectories disk1 and disk2 in the directory you specified, and then copies the files required to the subdirectories.

    When es-makeagent completes copying files from Sun Management Center 3.5 Update 1 Software CD 1 of 2, the CD is ejected, and you are prompted to insert the second CD or specify the source directory for disk 2.

    1. Remove the first Sun Management Center 3.5 Update 1 installation CD.

      Place the Sun Management Center 3.5 Update 1 CD 2 of 2 in the CD-ROM drive, then close the drive.

    2. When the CD-ROM drive LED turns off, press Return.

      es-makeagent copies the remaining files from the CD.

      You are informed that the agent-only product is available in the directory you specified. The command required to install the agent on the local machine is also displayed.

    Tip –

    Mount the target directory using NFS, so that the directory is accessible by other machines on your network.

  6. Type the command eject to eject the CD.

    You can now install the Sun Management Center 3.5 Update 1 x86 agent using any of the following methods.

    • Use the es-inst -a command. When prompted for the installation source directory, provide the name of the agent-only installation image that you specified. Make sure that you have shared the agent-only installation image by using Network File Sharing.

    • Apply the agent-only installation image using the JumpStart software.

    Note –

    The agent-only installation image also contains a tar file that you can ftp to other agent machines and uncompress on each agent machine to create an installation image. The uncompressed installation image directory contains the subdirectories disk1 and disk2. To install from the uncompressed image on each agent machine, change directory to the disk1/sbin directory, and use the es-inst command.