test

Sun Management Center 3.5 Installation and Configuration Guide

Applying Agent Installation, Update, and Patch-Only Images

The following procedures describe how to install or update agents from agent-update images using the Manage Jobs task, and the agent-update.bin executable file, and how to install agent-only installation images using the es-inst -a command.

Note –

If you want to use the JumpStart software to install the Solaris operating environment and the agent, see Installing Agents Using JumpStart.

To Install Agents From an Agent-Update Image Using the Manage Jobs Task

If you want to upgrade Sun Management Center 3.0 agents, apply the agent-update image by using the agent-update.bin executable file as described in To Install or Update Agents From an Agent-Update Image Using agent-update.bin. The Manage Jobs task is used to upgrade existing Sun Management Center 3.5 agents.

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

  2. Start the Sun Management Center console, and then log in to the console as an authorized Sun Management Center user.

    See To Start the Console on the Solaris Platform.

  3. Choose Tools -> Manage Jobs.

    The Manage Jobs window is displayed.

    The Manage Jobs window enables you to propagate your agents on multiple hosts simultaneously. For further details on the Manage Jobs feature, refer to the Sun Management Center 3.5 User's Guide.

  4. Create a multiple-agent upgrade task.

    Note –

    Make sure the Sun Management Center agent is installed and running on the target hosts.

    1. Select target hosts for upgrades, and then create a group.

    2. Create a task of type Agent Update

      Select an appropriate image name for the upgrade operation. This name should be the name of an image you created using either the es-imagetool or the es-gui-imagetool.

      For detailed instructions, see “To Create an Agent Update Task” in the Sun Management Center 3.5 User's Guide.

    The status displayed in the Job Manager window only shows the success or failure of the entire job. The job is marked Failed if the upgrade fails on a single agent in the entire group, even though the rest of the agent upgrades succeeded. Click View Log next to the Job list to check the status of individual upgrades.

    To view the intermediate upgrade status while the job is in progress, click View Logs tab, and then click InstallServer.log.

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

The space requirements on the target machine /tmp directory are as follows depending on the contents of the update-image:

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

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

  3. Download the file /opt/SUNWsymon/base/bin/agent-update.bin from the Sun Management Centerserver to each target machine's root directory.

    If you installed Sun Management Center in a different directory than /opt, download /installdir/SUNWsymon/base/bin/agent-update.bin, where installdir is the directory you specified in Step 8 in the procedure To Install Sun Management Center 3.5 on the Solaris Platform. This step must be done for each target machine.

    When you have finished downloading the file agent-update.bin to each target machine, you must log in to each target machine and perform the following four steps on each machine.

  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 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 server name is Production1 and that the Web server port is 8080. Also, assume that the agent-update image name is baseagent. You would then type:


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

  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 server and agent.

      Type the security seed password that you provided in Step 7, Setting Up Base Products and Add-ons on the Solaris Platform. Type the password again to confirm the password.

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

      If you specified a custom community string, make sure that you type the same community string that you provided in Setting Up Base Products and Add-ons on the Solaris Platform, Step 8. If you used the default community string of public, press Return.

    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 Install Agents From an Agent-Only Installation Image Using es-inst -a

  1. Create an agent-only installation image as directed in To Create an Agent-Only Installation Image Using es-makeagent.

  2. Log in as root on the machine where you want to install the agent.

  3. Go to the agent-only install image disk1/sbin directory.

    For example, if you created the agent-only image in the /export/agentsource directory on a machine that is named appserver, you would type:


    # cd /net/appserver/export/agentsource/disk1/sbin

  4. Type the command ./es-inst -a to install the Sun Management Center agent.

    You are prompted for the target directory

  5. Type the name of the directory in which to install Sun Management Center

    The default location is /opt.

    Sun Management Center software can be installed in any location on your system where the minimum required disk space is available. Press Return to accept the default location /opt or, if you want to install to a directory other than /opt, type the directory name.

    Tip –

    The command df -ak lists the used space and free space for each file system on the machine.

    The install process checks for any applicable add-ons.

  6. Select the Sun Management Center add-on products.

    The install process lists each add-on product, and asks whether you want to install the product.

    Note –

    Only the agent component of a selected add-on is installed.

    Type y to select the product for installation, or type n if you do not want to install the product.

    If you did not select any add-on products, you are asked whether you want to proceed. Type y to continue. The install process checks disk space. Go to Step 8.

    If you selected any add-ons, your selections are listed.

  7. Review your selections.

    Type y to continue, or type n to repeat the selection process.

    The install process checks disk space.

  8. Check disk space.

    The installation process checks whether there is enough disk space to install the agent and the agent component of any add-on that you selected.

    • If there is enough disk space, the agent is installed. You are asked whether you want to run setup. Go to Step 10.

    • If there is not enough disk space, you are asked to provide an alternate file system. The amount of space available and the amount of space that is needed are displayed.

  9. Provide the name of an alternate file system with enough disk space.

    At the prompt requesting a different file system, type the name of a file system and directory that has enough free space.

    Tip –

    In a terminal window on the machine where you are installing Sun Management Center, type df -ak to list the amount of used and free space for each file system on the machine.

    The installation process checks disk space again. If there is enough disk space, the agent is installed. You are asked whether you want to run setup.

  10. Decide whether to set up the agent.

    To set up Sun Management Center agent and any add-on products that you selected, type y. Follow the instructions in To Set Up Sun Management Center 3.5 on the Solaris Platform.

    If you chose to run setup later, you must set up the agent on the machine before you can run the agent. Use either es-guisetup or es-setup to set up the agent.