C H A P T E R 2 |
Installation and Setup |
This chapter describes how to install, set up, uninstall, reinstall, and reconfigure the Sun Management Center software for the Sun Fire high-end systems using Sun Management Center Wizards.
The Sun Management Center software is divided into:
Sun Fire high-end systems support requires the Sun Management Center base packages and the Sun Fire high-end systems add-on packages. The Sun Management Center Installation and Configuration Guide describes basic information about installing, setting up, starting, and stopping the Sun Management Center software. This chapter describes the processes specifically related to the Sun Fire high-end systems.
Caution - Use the installation scripts and the setup scripts provided with the Sun Management Center software. Do notmanually add packages or manually change configuration files. |
Your Sun Management Center scripts or Wizard panels might not display exactly the same messages in exactly the same sequence as the examples shown in this supplement. However, these examples show the basic messages you will receive in approximately the sequence you will receive them. Your actual installation and setup scripts depend on the add-on components you choose to install and other choices you make.
The Sun Fire high-end system-specific packages received with the Sun Management Center basic functionality is listed in TABLE 2-1. Refer to the Sun Management Center Installation and Configuration Guide for information about general Sun Management Center prerequisites.
Sun Management Center software requires network ports to communicate with various components of the system. The default port addresses for these components are listed in TABLE 2-2:
In some cases, this default port configuration conflicts with software already running on your system. Some Sun Fire high-end systems domains might have port 161 conflicts because of the presence of legacy SMNP agents. During the Sun Management Center software setup, specify an alternative network port to avoid this conflict. Refer to the Sun Management Center Installation and Configuration Guide for further information about solving port conflicts.
To create and access topology objects, the Sun Management Center agent layer software uses port 161 by default. If you configure an agent to use an alternative port, you must specify that port when the topology object is created or discovered. To simplify your Sun Management Center network configuration and management and enable more efficient discovery of Sun Management Center agents, choose an alternative port number and use that number for all agent installations that cannot use the default port configuration.
The Sun Fire high-end and midrange system controller has two Sun Management Center agents: the agent and the platform agent. The agent provides information about the system controller and the platform agent provides information about the Sun Fire high-end systems. Usually there are no port conflicts with the default port configuration for the platform agent. When a platform topology object is created or discovered, the correct default port is provided and does not need to be specified.
With Sun Management Center software, you can install, set up, uninstall, and update the software in several different ways. TABLE 2-3 lists the various methods with a cross-reference to the information in this supplement and the Sun Management Center Installation and Configuration Guide.
Appendix B of the Sun Management Center Installation and Configuration Guide |
|
Set up Sun Fire high-end systems add-on packages using the CLI |
Appendix B of the Sun Management Center Installation and Configuration Guide |
Updating Multiple Hosts Using Agent Update Creating Agent Installation and Update Images" in Chapter 6 of the Sun Management Center Installation and Configuration Guide |
|
Uninstalling Software Using the CLI Appendix B of the Sun Management Center Installation and Configuration Guide |
|
Starting Sun Management Center Software Using the CLI "Starting Components Using es-start" in Chapter 8 of the Sun Management Center Installation and Configuration Guide |
|
Stopping and Exiting Sun Management Center Software Using the CLI "Stopping Components Using es-stop" in Chapter 8 of the Sun Management Center Installation and Configuration Guide |
|
Install software using the Sun Management Center Installation Wizard |
Installing the Sun Fire High-End Systems Add-On Software Using the Sun Management Center Installation Wizard "Installing Sun Management Center on the Solaris Platform" in Chapter 6 of the Sun Management Center Installation and Configuration Guide |
Setting Up the Sun Fire High-End Systems Add-On Software Using the Sun Management Center Setup Wizard "Setting Up Base Products and Add-Ons on the Solaris Platform" in Chapter 6 of the Sun Management Center Installation and Configuration Guide |
|
"Starting Components Using es-guistart" in Chapter 8 of the Sun Management Center Installation and Configuration Guide |
|
"Stopping Components Using es-guistop" in Chapter 8 of the Sun Management Center Installation and Configuration Guide |
|
"Uninstalling Sun Management Center" in Appendix A of the Sun Management Center Installation and Configuration Guide |
FIGURE 2-1 shows a high-level view of the installation process.
If you are updating existing Sun Management Center 3.5 add-on software for Sun Fire high-end systems, you must:
Note - Before you start, be aware that you can use Agent Update to install Sun Management Center software on multiple agent hosts. For instructions about updating multiple hosts using agent update, see Updating Multiple Hosts Using Agent Update. |
See the following references depending on whether you are installing and setting up using the CLI or GUI:
Refer to Chapter 5 of the Sun Management Center Installation and Configuration Guide for detailed information about upgrading from Sun Management Center 3.0 software.
This section summarizes new installation and setup procedures for Sun Management Center software on Sun Fire high-end systems. FIGURE 2-2 illustrates the Sun Management Center software that needs to be installed on the system controllers and other hosts in Sun Fire high-end systems.
Before you install the Sun Management Center software, determine which server is to be the Sun Management Center server machine. The server must have a minimum of 512 megabytes of memory available. If you try to install the base server component on a server with less than 512 megabytes of memory available, you receive an error message and the server installation stops.
The server should be a system with high availability. When the Sun Management Center server is down, you will not be able to use Sun Management Center software to manage your system. Refer to the Sun Management Center Installation and Configuration Guide for more information about server machine requirements.
Install and set up the Sun Management Center base server layer and Sun Fire high-end systems and system controller server add-on components on the designated Sun Management Center server machine. The Sun Management Center base agent layer is automatically installed on the Sun Management Center server machine if you install the base server layer. This is so you can monitor the server machine itself.
Following is a summary of the procedures for installing and setting up Sun Management Center software on the system controllers and Sun Fire high-end systems domains:
1. Install and set up the Sun Management Center base agent layer and the Sun Fire high-end systems platform agent and system controller add-on components on the main and spare system controllers.
2. Install and set up the Sun Management Center base agent layer and Sun Fire high-end systems domain agent add-on component for each Sun Fire high-end systems domain you want to monitor.
Install and set up the Sun Management Center base console layer, basic help component, and console DR support on a common network location or on each workstation from which you want to monitor by using the GUI.
For Sun Fire high-end systems support, install and set up the Sun Management Center software on the Sun Fire high-end systems hosts as shown in TABLE 2-4. The Sun Management Center Installation and Configuration Guide provides information about installing and setting up the base software. It also provides instructions for starting and stopping Sun Management Center software.
Note - You can install the Sun Fire high-end and midrange systems Platform Agents on any machine where you have Sun Management Center software running. |
"Installing Sun Management Center on the Solaris Platform" in Chapter 6 of the Sun Management Center Installation and Configuration Guide describes in detail how to install all the software. An overview of the process follows.
1. As superuser, run the Sun Management Center Installation Wizard, es-guiinst, as described in Chapter 6, "Sun Management Center Installation and Setup," of the Sun Management Center Installation and Configuration Guide.
a. If you are installing separately released add-on software, change the directory to where the current Sun Fire high-end systems add-on software is located and run the es-guiinst script again. Then go to Step 3.
b. If you are installing add-on software from the Sun Management Center CD, go to Step 3.
3. The Select Add-On Product screen provides a selectable list of add-on products that you can install. Choose those add-on products that apply to Sun Fire high-end systems, and click Next.
4. The Sun Management Center Setup Wizard starts automatically after all the software is installed.
This section describes how to set up the Sun Fire high-end systems add-on software using the Sun Management Center Setup Wizard.
To Set Up Sun Fire High-End Systems Add-On Software on the System Controllers |
1. On a system controller, type es-guisetup to start the Sun Management Center Setup Wizard.
Once the Sun Management Center base software setup is complete, the Select Add-On Products panel appears with a list of add-on products by platform installed on your system. In this example, Sun Fire High-End Systems Monitoring is the product and platform.
The following add-on products are newly installed on this system and will be set up. - Sun Fire High-End Systems Monitoring |
2. Click Next to start the Platform Setup.
The Sun Fire High-End Systems Platform Setup panel displays the following message.
Checking configuration files... Status: Set the platform server: <SChostname> Checking for default platform agent port... Default platform agent port: 166 Checking of configuration files complete. |
If the default platform port was not set previously, the Sun Fire High-End Systems Platform Setup panel displays the following message.
The default port for the Sun Management Center platform agent is 166 Would you like to use the default Sun Management Center platform agent port? O Yes O No |
The Sun Fire High-End Systems Platform Setup panel displays the following.
The Sun Fire High-End Systems Platform Setup panel confirms the port number that you chose.
If you have added or changed the port number, the Sun Fire High-End Systems Platform Setup panel displays this message.
The Sun Management Center security keys must be regenerated because the platform agent port number has been changed. Would you like to regenerate the security keys now? O Yes O No |
If you select yes, the Sun Fire High-End Systems Platform Setup panel displays this message.
Note - Ensure you store the seed password securely. It will be needed if you perform any modifications to your Sun Management Center installation. |
i. Enter a unique password for the seed if this is a first-time installation. If not, enter the seed used in previous versions of Sun Management Center.
ii. Reenter the seed to confirm.
Select No if you do not want to regenerate the security keys now.
If you select no, the Sun Fire High-End Systems Platform Setup panel displays this message.
The Sun Management Center security keys have not been regenerated. Remember to regenerate them prior to starting Sun Management Center. |
The Sun Fire High-End Systems Platform Setup panel displays the following.
ii. Enter the spare SC hostname.
The Sun Fire High-End Systems Platform Setup panel displays this message.
The Platform Agent will create a composite object that includes Sun Management Center agents loaded on Sun Fire High-End Systems domains. |
The Sun Fire High-End Systems Platform Setup panel displays the default Sun Fire high-end systems domains port.
The default port to check for Sun Fire High-End Systems domains is 161. Would you like to change the port to be checked? O Yes O No Domain port number: (leave empty for none) |
ii. Enter the port number or leave blank for no ports to be checked.
The Sun Fire High-End Systems Platform Setup panel displays this message.
Updating configuration files... Status: Updated Discovery Table information via es-dt Creating Agent Update configuration file. Update of configuration files complete. |
The Sun Fire High-End Systems Platform Setup panel displays this message.
The System Controller Agent Setup panel for Sun Fire high-end systems displays one of the following messages depending on the machine you are using for an SC.
The System Controller Agent Setup panel for Sun Fire high-end systems displays this message.
Updating configuration files... Status: Created deviceinfo.conf file .... Update of configuration files complete. |
The System Controller Agent Setup panel for Sun Fire high-end systems displays this message.
To Set Up Sun Fire High-End Systems Add-On Software on the Domains |
1. On a Sun Fire high-end systems domain, type es-guisetup to start the Sun Management Center Setup Wizard.
Once the Sun Management Center base software setup is complete, the Select Add-On Products panel appears with a list of add-on products by platform installed on your system. In this example, Sun Fire High-End Systems Monitoring is the product and platform.
The following add-on products are newly installed on this system and will be set up. - Sun Fire High-End Systems Monitoring |
2. Click Next to start the Domain Setup.
The Sun Fire High-End Systems Domain Setup panel displays the following:
If your tape drive controllers do not allow concurrent access, you will want to disable this feature.
The Sun Fire High-End Systems Domain Setup panel displays the status of updating configuration files.
The Sun Fire High-End Systems Domain Setup panel displays this message.
To Set Up Sun Fire High-End Systems Add-On Software on the Server Machine |
1. On the Sun Management Center server machine, type es-guisetup to start the Sun Management Center Setup Wizard.
Once the Sun Management Center base software setup is complete, the Select Add-On Products panel appears with a list of add-on products by platform installed on your system. In this example, Sun Fire High-End Systems Monitoring is the product and platform.
The following add-on products are newly installed on this system and will be set up. - Sun Fire High-End Systems Monitoring |
The Sun Fire High-End Systems Server Setup panel displays this message.
When the update is complete, the Sun Fire High-End Systems Server Setup panel displays this message.
The System Controller Server Setup panel for Sun Fire high-end systems displays this message.
When the update is complete, the System Controller Server Setup panel for Sun Fire high-end systems displays this message.
This section describes how to update multiple hosts at once using Agent Update. The Agent Update process itself must be run on the Sun Management Center server machine. You must also ensure that Sun Management Center agents are running on all the target hosts.
To use Agent Update to fully install and set up the Sun Fire high-end systems platform agent modules, you must create an Agent Update configuration file for the module on the target hosts before you run the Agent Update Process on the Sun Management Center server machine.
To Create the Agent Update Configuration File on the Target Hosts |
1. Ensure that the Sun Fire high-end systems platform agent modules are installed on the target hosts.
2. Ensure that the Sun Fire high-end systems platform agent modules are set up on the target hosts using either the es-setup script or the es-guisetup Wizard.
After this has been done, subsequent platform agent setup operations using Agent Update will work automatically, using the host-specific information provided during setup.
Using the Agent Update process, create an Image File of the add-on components to be distributed to the target machines, and then add a New Job to the Manage Jobs Task list to be run when you specify.
Using Agent Update you can update the following configurations:
To Update From Sun Management Center Add-On Software |
This procedure applies only to updating from Sun Management Center add-on software.
1. Create an Image File of the desired Sun Fire high-end systems add-on components to be distributed to the desired agent machines using one of the base Sun Management Center scripts es-gui-imagetool or es-imagetool.
Refer to Chapter 7, "Sun Management Center Post-Installation Tasks," in the Sun Management Center Installation and Configuration Guide for detailed instructions about using either the Wizard or the CLI Image Tool.
2. From your main Sun Management Center console window, choose the Manage Jobs... option from the Tools menu.
The system displays the Manage Jobs panel (FIGURE 2-9), which allows you to distribute the Image File.
3. In the Manage Jobs panel, select the New Task... button.
The system displays the New Task panel (FIGURE 2-10), which allows you to specify the Agent Update Image File to distribute.
4. In the New Task panel (FIGURE 2-10), do the following:
a. Choose Agent Update for the Task Type.
b. Choose the Image File you created in Step 1.
5. In the Manage Jobs panel (FIGURE 2-9), do the following:
b. Choose the Task you created in Step 4.
c. Do one of the following to schedule when you want the Task to run.
d. Do one of the following to choose the objects (agent machines) to which you want to distribute the Image File.
e. Preview the objects (agent machines) you have chosen and redo your selections if necessary.
The job starts and distributes the Image File to the objects (agent machines) you selected. When the job is running, it appears in the Job list of the Manage Jobs panel. The panel shows the status of the job when running and when complete.
To Update From No Add-On Software or Sun Management Center 3.0 Platform Update 4 Add-On Software |
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 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 install directory you specified.
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
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 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 server host.
To Uninstall All Sun Management Center Software |
This example assumes that your software is in the default area /opt/SUNWsymon/sbin. If it is not, replace the default directory with your own path.
The system displays this message.
2. Type y to uninstall the Production Environment, which uninstalls all Sun Management Center software.
The system displays this message.
This will uninstall ALL Sun Management Center Products. !!! Do you want to change selection? [y|n|q] |
The system displays your selection; go to the beginning of Step 2.
The system displays this message.
Select Save Data to save all user and configuration data. Your data is saved and can be restored when you re-install Sun Management Center. Do you want to preserve data? [y|n|q] |
4. Type y to keep any existing topology and event data; or type n to discard the data.
The system displays this message.
5. Type y to proceed with the uninstall; or type n to not proceed with the uninstall.
If you type y to proceed, the system displays the list of packages to be uninstalled, the packages as they are uninstalled, the status of the uninstallation, and the location of the log file.
To Uninstall Add-On Software from
|
The system displays this message.
2. Type n to not uninstall the Production Environment.
Caution - If you type yto uninstall the Production Environment, all Sun Management Center software will be removed including the base software. |
The system displays this message.
3. Type y to uninstall Sun Fire High-End Systems Monitoring.
The system displays the product that will be removed and this message.
The system displays your selections; go to the beginning of Step 2.
The system displays this message.
Select Save Data to save all user and configuration data. Your data is saved and can be restored when you re-install Sun Management Center. Do you want to preserve data? [y|n|q] |
5. Type y to keep any existing topology and event data; or type n to discard the data.
The system displays this message.
6. Type y to proceed with the uninstall; or type n to not proceed with the uninstall.
If you type y to proceed, the system displays the list of packages to be uninstalled, the packages as they are uninstalled, the status of the uninstallation, and the location of the log file.
The es-start command requires different command arguments, depending on which component you are starting. Refer to the Sun Management Center Installation and Configuration Guide for a list of the options for es-start. The -h option for es-start also lists all the options. The following procedure describes some common es-start options.
To Start Sun Management Center Software |
1. Log in as superuser on the machine where the components are to be started (see TABLE 2-4 for the location of the components).
2. Change the directory to the /opt/SUNWsymon/sbin directory.
This example assumes that your software is installed in the default area /opt. If it is not, replace /opt with your own path.
On the system controller, start the Sun Management Center agents.
This command starts the base and platform agents. The platform agent provides all the system information for Sun Fire high-end systems to Sun Management Center software.
3. To start the Sun Management Center agent on a Sun Fire high-end systems domain with only the Sun Management Center agent layer installed, type:
4. To start all the Sun Management Center components on the Sun Management Center server host with all layers installed, type:
Note - Upon rebooting, all Sun Management Center agents start automatically. |
5. To start the console, type:
Note - To start the console, you can also be logged in as your own user ID; you do not have to be logged in as superuser. However, to access the Platform or Domain Config Reader, you must be in the appropriate security access groups. See Security Considerations for Defining Groups. |
This section describes stopping and exiting Sun Management Center software.
To Stop Server and Agents |
The es-stop command requires different command arguments depending on which component you are stopping. Refer to the Sun Management Center Installation and Configuration Guide for a list of the es-stop options. The -h option for es-stop also lists all the options. The following procedure describes some common es-stop options.
1. Log in as superuser on the machine where the components are to be stopped (see TABLE 2-4 for the location of the components).
2. Change the directory to the /opt/SUNWsymon/sbin directory.
This example assumes that your software is in the default area /opt. If not, replace /opt with your own path.
3. To stop the server and agent components on the server machine, type:
4. To stop the domain agent components on the host machine for a domain, type:
5. On the system controller, to stop the host agent, which monitors the SC and platform agent, type:
To Exit Console |
1. From the menu bar on the main console window, choose File and Exit.
2. Click the Exit button on the Exit Sun Management Center panel.
You can reconfigure the Sun Fire high-end systems setup parameters at any time by running the setup script (es-setup) again. You must reconfigure the appropriate Sun Fire high-end systems setup parameters if certain changes occur, including:
For information about where these components are located, see TABLE 2-4.
To Rerun Setup Script |
1. Log in as superuser on the machine where the components are that you want to reconfigure (see TABLE 2-4 for the location of the components).
2. Change the directory to the /opt/SUNWsymon/sbin directory.
This example assumes that you are using the default area /opt. If you are not, replace /opt with your own path.
3. Stop the components to be reconfigured.
The command you use to stop the component depends on which component you are reconfiguring.
4. Run the setup script to reconfigure Sun Management Center base and add-on software.
For information about using other arguments for the es-setup command, refer to the Sun Management Center Installation and Configuration Guide.
5. Follow the instructions in the setup procedures for the corresponding components with these two additional prompts.
In the Sun Management Center server setup, the system displays this message.
a. Type y to keep any existing topology and event data; or type n to discard the data.
In the Sun Fire high-end systems domain agent setup, the system displays this message.
server-hostname appears to be configured as your Sun Management Center server. Is this correct? [y|n|q] |
b. Type y for yes if this is your Sun Management Center server, or type n for no if not. If you type n, you are prompted to type your correct server host name.
6. Restart the components that you stopped.
The Sun Management Center Web Interface is an optional, licensed Sun Management Center feature that provides most of the functionality available in the Sun Management Center Java-based Console. For a detailed description of the Sun Management Center Web Interface, refer to the Sun Management Center User's Guide.
Note - Be aware that the Web Interface provides no physical or logical views of the Sun Fire high-end systems. See Chapter 5 in this document for more information about physical and logical views. |
This section provides examples of messages the system displays at the end of the installation and setup scripts. You can look at these files to see if there were any problems during installation and setup, and you can use these files for diagnosing errors.
This example shows a message when an installation script completes, where nnnnnnnnnnnn.nnnnn is the identifying number of the installation log.
This example shows a message when a setup script completes, where nnnnnnnnnnnn.nnnn is the identifying number of the setup log.
Copyright © 2005, Sun Microsystems, Inc. All Rights Reserved.