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 SPARC Enterprise Mx000 servers using Sun Management Center Wizards. It includes the following sections:
You can also install and set up the software using a command-line interface (CLI) using the es-inst and es-setup commands. Refer to the Sun Management Center Installation and Configuration Guide for information about using the CLI for installation.
Sun Management Center software is provided in three ways:
Support for Sun SPARC Enterprise Mx000 servers requires the Sun Management Center core packages and the add-on software for Sun SPARC Enterprise Mx000 servers. 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 Sun SPARC Enterprise Mx000 servers.
Sun Management Center software and the add-on software for specific hardware platforms must generally be installed in three places:
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 see 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.
For information about general Sun Management Center prerequisites, refer to the Sun Management Center Installation and Configuration Guide.
For information about minimum requirements for your current release of this add-on software, refer to the Sun Management Center Add-On Software Release Notes for the current release.
In some cases, this default port configuration conflicts with software already running on your system. Some Sun SPARC Enterprise Mx000 server domains might have port 161 conflicts because of the presence of legacy agents. During the Sun Management Center software setup process, 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.
For information about default network port configuration, refer to Reference: setsunmc and showsunmc Man Pages and Reference: Network Port Configuration.
For the add-on software to support Service Processor failover on high-end servers, you must set up the takeover IP address of the active Service Processor (such as lan#0). Refer to the man pages for XSCF commands setnetwork(8) and setroute(8) for more detailed information.
You can use the Discovery Manager to populate administrative domains automatically. Refer to the chapter "Adding Objects to the Topology Database Using the Discovery Manager" in the Sun Management Center User's Guide for detailed information.
When defining and initiating a Discover Objects request for Sun SPARC Enterprise Mx000 server domains, you must change the default community string for SNMP to oplsunmc in the SNMP section of the Preferences tab. Refer to "To Set Preferences for a Discover Objects Request" in the Sun Management Center User's Guide for instructions.
To set up the software on the domains, you must also set the SNMPv1 community string to oplsunmc when setting up the software on the domains. Refer to Setting Up the Add-On Software Using the Sun Management Center Setup Wizard.
With Sun Management Center software, you can install, set up, uninstall, and update the software in several different ways. You must also set up access privileges for users. TABLE 2-1 lists the various methods with a cross-reference to the information in this supplement and the Sun Management Center Installation and Configuration Guide.
Install software using the Sun Management Center Installation Wizard |
For core software: Sun Management Center Installation and Configuration Guide For this add-on software: Installing the Add-On Software Using the Sun Management Center Installation Wizard |
Set up software using the Sun Management Center Setup Wizard |
For core software: Sun Management Center Installation and Configuration Guide For this add-on software: Setting Up the Add-On Software Using the Sun Management Center Setup Wizard |
For core software: Sun Management Center User's Guide For this add-on software: Setting Up Security Access |
|
"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 |
|
Appendix A of the Sun Management Center Installation and Configuration Guide |
|
Appendix B of the Sun Management Center Installation and Configuration Guide |
|
Appendix B of the Sun Management Center Installation and Configuration Guide |
|
Appendix B of the Sun Management Center Installation and Configuration Guide For this add-on software, Uninstalling Software Using the CLI |
|
"Starting Components Using es-start" in Chapter 8 of the Sun Management Center Installation and Configuration Guide For this add-on software, Starting Sun Management Center Software Using the CLI |
|
"Stopping Components Using es-stop" in Chapter 8 of the Sun Management Center Installation and Configuration Guide For this add-on software, Stopping and Exiting Sun Management Center Software Using the CLI |
FIGURE 2-1 shows a high-level view of the installation process for the Sun Management server, console, and server domains software. (The software is preinstalled on the Service Processor.)
If you have not yet installed the core Sun Management Center 3.6.1 software, you must install it before installing this Version 2 add-on software.
To Install Core Sun Management Center 3.6.1 Software |
Refer to the Sun Management Center Installation and Configuration Guide for instructions for installing the core software.
If you are updating a previous release of Sun Management Center software, read the information about updating the software from your currently installed release, including any add-on software you have installed.
This section summarizes installation and setup procedures for this add-on software for Sun SPARC Enterprise Mx000 servers.
Install and set up the Sun Management Center core server layer and add-on components for Sun SPARC Enterprise Mx000 servers on the designated Sun Management Center server machine. The Sun Management Center core agent layer is automatically installed on the Sun Management Center server machine if you install the core server layer. This is so you can monitor the server machine itself.
Install and set up the Sun Management Center core 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.
You do not need to install the Sun Management Center software on the Sun SPARC Enterprise Mx000 server Service Processors that you will be monitoring. Both the core software and add-on software are preinstalled on the Service Processors.
For Sun SPARC Enterprise Mx000 server support, install and set up the Sun Management Center add-on software as shown in TABLE 2-2. The Sun Management Center Installation and Configuration Guide provides information about installing and setting up the core software on the server and console hosts. It also provides instructions for starting and stopping Sun Management Center software.
Note - Installation using the Agent Update is supported only on the server domains. |
"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.
To Install the Add-On Software Using the Sun Management Center Installation Wizard |
1. As superuser, run the Sun Management Center Installation Wizard, es-guiinst.
The es-guiinst command is described in the Sun Management Center Installation and Configuration Guide.
a. If you have not already installed the correct version of the core software, first follow the instructions for installing or updating the core Sun Management Center software.
b. Once the correct version of the core software is already installed, use the
es-guiinst command available in your local installation.
The default location is /opt/SUNWsymon/sbin/esguiinst.
c. Click Next to proceed to the next window.
2. Enter or browse to locate and select the source directory for the add-on software image; then click Next.
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 SPARC Enterprise Mx000 servers, and click Next.
4. After the software is installed, you can use the Sun Management Center Setup Wizard to set up the software.
If you have not yet set up the core software, refer to Chapter 1 of the Sun Management Center Installation and Configuration Guide. To set up the add-on software, refer to Setting Up the Add-On Software Using the Sun Management Center Setup Wizard.
5. Use the setsunmc command to set up the software on the Sun SPARC Enterprise Mx000 servers Service Processors to be monitored.
This section describes how to set up the add-on software using the Sun Management Center Setup Wizard. The sample procedure describes setting up the software on the server machine. Also note:
To Set Up the Add-On Software on the Server Machine |
1. Refer to Chapter 7 of the Sun Management Center Installation and Configuration Guide and follow the instructions for setting up an add-on product using the
es-guisetup command.
When the Select Add-On Products panel appears the list of add-on products installed on your system will include the products included in the add-on software for Sun SPARC Enterprise Mx000 servers:
The following add-on products are newly installed on this system and will be set up. - DomMonit SPARC Enterprise Mx000 - Dom DR SPARC Enterprise Mx000 - PlatAdmin SPARC Enterprise Mx000 |
2. If required, choose the add-ons that you want to set up. Click Next to continue.
The Server Setup panel displays this message.
When the update is complete, the Server Setup panel displays this message.
The Server Setup panel displays this message.
When the update is complete, the Server Setup panel displays this message.
To Set Up the Add-On Software on the Service Processor |
On the Service Processor, set up the Sun Management Center agents using the setsunmc command at the XSCF prompt:
Refer to setsunmc for more information about the setsunmc command.
To Set Up Default Sun Management Center Access Privileges |
Refer to the "Sun Management Center Security" chapter in the Sun Management Center User's Guide for information about security features, users and groups, and their privileges.
Refer to Reference: Administrative Groups for Access Privileges for information about administrative groups on Sun SPARC Enterprise Mx000 servers.
To Set Up Platform and Domain Views Administrative Groups |
1. Using the groupadd command, add the administrative group names for Platform and Domain views to the /etc/group file:
For Domain views, the value of groupname can be one of these:
and so on for all possible domains, through
For Platform views, the value of groupname can be one of these:
Note - Note the difference between the platadmn group name and the platadm privilege mentioned in To Set Up Privileges on the Service Processor: Ensure that you include the n at the end of the platadmn group name. |
2. Add the user names to the groups by editing the /etc/group file.
To Set Up Privileges on the Service Processor |
You must have an XSCF account with useradm privileges to perform these procedures. For more information, refer to the administrator's guide or reference manual for Sun SPARC Enterprise Mx000 servers or to the adduser(8), password(8), and setprivileges(8) man pages.
1. If the XSCF user account does not exist, create the account and a password using the adduser and password commands.
b. Set the password for the user:
2. Add platadm privileges for the user, using the setprivileges command:
3. If the user will be replacing FRUs (Replacing FRUs), add fieldeng privileges for the user.
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-2 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.
3. On the Service Processor, activate the SNMP agent and start the Sun Management Center agent using the setsnmp and setsunmc commands at the XSCF prompt: .
Refer to setsunmc and the setsnmp(8) and setsunmc(8) man pages for more information.
4. To start the Sun Management Center agent on a Sun SPARC Enterprise Mx000 server domain with only the Sun Management Center agent layer installed, type:
5. 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. |
6. 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. |
Note - The platform administration module is listed in the "Module Manager" tab of the Details window for the Service Processor. This platform administration module should never be unloaded. In case it is mistakenly unloaded, refer to To Reload the Platform Administration Module for instructions to reload the module. |
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-2 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 Service Processor, to stop the host agent, which monitors the Service Processor and platform agent, go to the XSCF prompt and type:
Refer to setsunmc for more information about using the setsunmc command.
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 setup parameters for your Sun SPARC Enterprise Mx000 server at any time by running the setup script (es-setup) again. You must reconfigure the appropriate setup parameters if certain changes occur, including:
For information about where these components are located, see TABLE 2-2.
To Rerun Setup |
1. Log in as superuser on the machine where the components are that you want to reconfigure (see TABLE 2-2 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.
Refer to setsunmc for more information about using the setsunmc command.
4. Rerun setup on the components to be reconfigured.
For information about using other arguments for the es-setup command, refer to the Sun Management Center Installation and Configuration Guide.
Refer to setsunmc for more information about using the setsunmc command.
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 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.
To Reload the Platform Administration Module |
1. Log in to the Service Processor.
Ensure that you have platadm or fieldeng privileges.
2. Use setsunmc disable to disable the Sun Management Center agent on the Service processor:
3. At the XSCF prompt, use setsunmc -s to reset the server name:
4. Use setsunmc enable to enable the Sun Management Center agent on the Service Processor:
The platform administration module will now appear again in the Details window.
For more information about the setsunmc command, refer to setsunmc.
You cannot uninstall the Sun Management Center software that is preinstalled on the Service Processors of your Sun SPARC Enterprise Mx000 servers.
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 Only the Add-On Software |
1. Unload the domain DR module in the Module Manager tab in the Details window of the Sun SPARC Enterprise Mx000 domain.
If you want to uninstall the domain DR module, you must first unload the module. Refer to the Sun Management Center User's Guide for information about loading and unloading modules.
The system displays this message.
3. 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 core software. |
The system displays this message:
4. Type y to uninstall DomMonit SPARC Enterprise Mx000.
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] |
6. Type y to keep any existing topology and event data; or type n to discard the data.
The system displays this message:
7. 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.
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.
This section contains the man pages for the setsunmc(8) and showsunmc(8) commands. These man pages are also intalled on the Service Processor. Access them and the other XSCF man pages by using the man(1) command at the XSCF prompt on your SPARC Enterprise Mx000 server Service Processor.
setsunmc - start or stop the Sun Management Center agent and make changes to its configuration
setsunmc [-s server] [-z seed] [-p agent_port] [-c community_string] [-t trap_port] [-e event_port] [-a SNMP_agent_port] [-a dmn_agent_port]
When invoked with one or more options, setsunmc makes changes to the Sun Management Center agent configuration, as described in the Options section.
When invoked with the enable operand, setsunmc activates the Sun Management Center agent. This activation includes starting the Sun Management Center agent and notifying the startup daemon to start the agent on subsequent reboots. When invoked with the disable operand , the agent is stopped and the startup daemon will be notified to disable starting the agent on subsequent reboots.
The operands cannot be used together with the options.
You must have platadm or fieldeng privileges to run this command.
Refer to setprivileges(8) for more information.
The following options are supported. The options cannot be used together with the operands.
showsunmc - show setup information and status of Sun Management Center agent
This command is used to show the setup information and current status of the Sun Management Center agent. When used with the isenabled option, the showsunmc command output displays the agent status: 1 if the agent is enabled, 0 if the agent is disabled.
The following options are supported.
Displays only the agent status. The value 1 indicates the agent is enabled, 0 indicates the agent is disabled. |
|
You must have platadm, platop, or fieldeng privileges to run this command.
Refer to setprivileges(8) for more information.
There are no operands for this command.
The add-on software for Sun SPARC Enterprise Mx000 servers is delivered in the packages listed in TABLE 2-3. They are installed on the agent, console, and server layers.
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-4.
After the Sun Management Center software is installed and set up, you must set up users according to the tasks they will perform. This section lists and describes default Sun Management Center administrative groups for use with this add-on software. Refer to Setting Up Security Access for information about setting up users in these groups, setting up administrative groups for Domain views in the platform administration module, and setting privileges for Sun Management Center users on the Service Processor.
TABLE 2-5 lists the default Sun Management Center administrative groups that apply to Sun SPARC Enterprise Mx000 servers.
Copyright © 2007, Sun Microsystems, Inc. All Rights Reserved.