Sun Management Center 4.0 Installation and Configuration Guide

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

If you use a seed-file to specify the security seed and SNMP community string automatically, the seed-file must have the following format:


ES_SECURITY_SEED=seed 
ES_SNMPV1_STRING=string

where seed and string are the actual seed and community string specified when the Sun Management Center server was installed. If you do not specify a value for ES_SNMPV1_STRING, the default SNMP value is used. In this case, the file will be:


ES_SECURITY_SEED=seed
ES_SNMPV1_STRING=string
  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 relevant agent-update.bin file from the Sun Management Center server to each target machine's root directory.

    • (SPARC) /opt/SUNWsymon/base/bin/sparc-sun-solaris/agent-update.bin

    • (x86) /opt/SUNWsymon/base/bin/i386-sun-solaris/agent-update.bin

    • (Linux)/opt/SUNWsymon/base/bin/i686-sun-Linux/agent-update.bin

    If you installed Sun Management Center in a different directory than /opt, replace the /optwith installdir in the paths mentioned, where installdir is the directory you specified. This step must be performed 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. Change to the directory where you downloaded agent-update.bin.

  6. Type this command:


    ./agent-update.bin -s server -r http-port -p image-name [-f seed-file]

    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

    • seed-file is a file containing the security seed and SNMP community string. By using this option, you can make agent installation automatic after running the command. The seed-file must be owned by root and have read/write permissions for root only as a security precaution. If the file does not meet these requirements, the script exits.

    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 sparc-baseagent. You would then type:


    # ./agent-update.bin -s Production1 -r 8080 -p sparc-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 b, Setting Up Sun Management Center. 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 Sun Management Center, Step c. 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.