es-gui-imagetool enables you to create agent-update images containing any one of the following items.
Base agent packages
Add-on agent packages
Base and add-on agent packages
Base agent patches and add-on agent patches only
This procedure assumes 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.
Log in as root on the Sun Management Center 4.0 server machine.
Run the Sun Management Center GUI image tool by typing the following command:
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.
Select the update-image components.
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.
Provide the name of a valid Sun Management Center 4.0 source directory.
The installation source default /DiskMountDir/image is displayed.
If you are installing from DVDs, insert Sun Management Center 4.0 DVD in the DVD drive.
Enter a valid source directory: /DiskMountDir//disk1/image
If you are installing from a Sun Management Center 4.0 installation image on disk, either click Browse to navigate to the Sun Management Center installation disk1/image directory, or type the path to the disk1/image directory in the Source Directory field.
Source Directory: /net/machine/installdir/disk1/image
where machine is the machine on which you created the installation image, and installdir is the directory containing the Sun Management Center 4.0 disk1 and disk2 images. See Determining the Installation Source for further information about installation images.
Provide the target directory for Sun Management Center 4.0 installation.
The target directory is the directory where the Sun Management Center 4.0 SUNWsymon directory is created if it does not already exist.
If an agent is not installed, then the new agent is installed in the directory you specify.
If an older version of an agent is already installed in a different directory, then the new agent is installed in the directory you specify.
If the same version of an agent is already installed in a different directory and the update you are applying contains additional components such as add-ons, the agent is updated in the existing directory.
The following scenario provides an example.
Assume you have created a base and add-on agent packages update image, and you have specified /opt as the target directory. Also, assume that you want to apply the update image to five different machines in the following states:
Sun Management Center 3.6.1 is installed in /opt/SUNWsymon on machine A.
Sun Management Center 3.6.1 is installed in /export/home/opt/SUNWsymon on machine B.
No Sun Management Center components are installed on machine C.
The Sun Management Center 4.0 base agent only is installed in /opt/SUNWsymon on machine D.
The Sun Management Center 4.0 base agent only is installed in /export/home/opt/SUNWsymon on machine E.
When you apply the Sun Management Center 4.0 base and add-on agent packages update image to the five machines, each machine is updated as follows.
On machine A, the Sun Management Center 4.0 agent is reinstalled and replaces the version 3.6.1 agent in directory /opt/SUNWsymon.
On machine B, the Sun Management Center 4.0 agent is installed in directory /opt/SUNWsymon.
On machine C, the Sun Management Center 4.0 agent is installed in directory /opt/SUNWsymon.
On machine D, the base agent is upgraded, with add-on packages, to version 4.0 in directory /opt/SUNWsymon.
On machine E, the base agent is upgraded, with add-on packages, to version 4.0 in directory /export/home/opt/SUNWsymon.
Click Next. The Sun Management Center Update-Image Name screen appears.
Provide a name for the agent update-image.
Type a name for the update-image that reflects the update-image type, for example SPARC-Base-agents, x86-Base-agents, Linux agents add-ons or config-readers.
The update-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.
Select the platform (Solaris or Linux) versions that the target machines are running.
The image tool will create images for all platform 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 platform versions, or all.
If you omit a platform version when you create an agent-update image, application of the update-image to the machine whose platform version is omitted will fail.
Click Next. The Checking for Available Products screen appears.
If you selected Base Agent Packages, or Base and Add-on Agent Packages, the image tool verifies that all components of the base layer are available in the image source you specified.
When image source verification completes, the SNMP Port Assignment screen appears. Go to Step 11.
If you selected Add-on Packages, the Select Add-ons for Package and Patch Updates screen appears. Go to Step 8.
If you selected Base and Add-on Agent Patches, the Select Patches screen appears. Go to Step 9.
Select the products that you want to add to the agent update-image, and then click Next.
The image tool checks whether setup responses are needed by any of the add-on products you selected for inclusion in the update-image. Go to Step 10.
If the selected add-on products do not require setup responses, the SNMP Port Assignment screen appears. Go to Step 11.
If any selected add-on product requires setup responses, the Add-on Setup screen appears.
You can select all patches, or you can select individual patches.
When you have finished selecting patches, click Next. The Confirmation screen appears. Step 12.
Provide add-on setup responses.
You are prompted to click Next to answer the setup questions for the selected add-on products. Click Next.
A terminal window appears, and the image tool process steps through each add-on product that you selected for agent update, and prompts you for the responses needed by each product. Refer to the documentation that is provided with each add-on for further information.
When you finish providing responses, the SNMP Port Assignment screen appears.
Specify an SNMP port for the Sun Management Center agent.
In most cases, port 161 is the default port assigned to and used by the SNMP daemon. However, other processes or daemons could be using port 161. Several third-party replacements and enhancements for the SNMP daemon exist, and could be installed on your system. The Sun Management Center agent is one such daemon. Also keep in mind that a port number other than 161 could have been specified during Sun Management Center setup on each target machine.
See To Determine Whether a Port Is Used for procedures on how to determine if a port is unused.
If you select port 161, you must stop and disable any process that uses port 161 on each target machine before you can restart the agent on each machine. Stopping and disabling the SNMP daemon on each machine is not a guarantee that you have stopped the actual process using port 161. To determine which daemon process uses port 161 requires you to manually review all /etc/rcN and /etc/rcN.d files, where N is 0 through 6 and S. When you have identified the file that defines the process using port 161, you can disable the process by renaming the file. For example,
/etc/rc3.d# mv S76snmpdx s76snmpdx
You must disable any daemon that uses port 161 on each target machine.
To use port 161 on each target machine, select Use Port 161, and then click Next. The Stop and Disable SNMP Daemon screen appears.
To assign a different port number, select Use A Different Port Number.
Type the port number in the Port ID field and then click Next.
When the agent-update image is applied on the target client, the update process checks whether an agent is already installed.
If an agent was previously installed and configured, the update process uses the original port assignment. For example, if the previous agent uses port 2261, then the update process assigns port 2261 to the updated agent.
If an agent is not installed and port 161 is not in use, the update process assigns port 161 to the agent .
If an agent is not installed and port 161 is in use, the update process assigns the port you specified to the agent .
The image tool process now checks for sufficient 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 update-image tool. You must increase the amount of free space by the amount listed before you can create an update-image.
If there is enough disk space, the Confirmation screen is displayed.
Confirm the update-image selections.
A list of the components that you selected for inclusion in the agent update-image is displayed.
If the list is not correct, click Back repeatedly to return to either the Select Add-ons for Package and Patch Updates screen, or to the Select Update-Image Components screen. When the appropriate screen is displayed, select the products that you want to add to the update-image and confirm your new selections.
If the list is correct, click Next.
The image tool creates the agent update-image in the directory /var/opt/SUNWsymon/agentupdate using the file name you specified in Step 6.
You are notified when the update image has been created. Click Finish 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.
Apply the agent-update image.
You can now apply the update-image to the target machines.
To install Sun Management Center 4.0 agents on a fresh installation, apply the image using the agent-update.bin executable file, see To Install or Update Agents From an Agent-Update Image Using agent-update.bin.
To upgrade Sun Management Center 3.5 agents, apply the image using the Sun Management Center task manager, see To Create an Agent Update Task in Sun Management Center 3.6.1 User’s Guide.