This chapter describes how to install and set up SunTM Management Center 3.6. This chapter assumes that the product has not been installed before.
This chapter has the following topics:
Sun Management Center has three main components, called base layers, that need to be installed: server, agent, and JavaTM Console (console). The server is a collection of processes on a central host that enables management services. The agent is a process that runs on each monitored host. The Java Console is the window through which you monitor and manage the agents. It is the main user interface to the product.
Before you can use Sun Management Center 3.6, you must install the
Server – On at least one machine.
When the server is installed, the Sun Management Center agent is installed on the server machine as well.
Agent – On all machines you want to monitor.
Java Console – On any machine from which users will log into Sun Management Center.
In planning your installation you need to consider the following items:
On which machine do you want to run the Sun Management Center server?
Which machines do you want to monitor and manage? On these machines you need to install the Sun Management Center agent.
On which machines do you want to run the Sun Management Center console? On these machines you need to install the Java Console.
Do you want to install the production environment or the developer environment? In a production environment you use Sun Management Center to manage and monitor your hardware. In a developer environment you use the product to develop and test modules to work with it. For more information on the production environment and the developer environment, see Sun Management Center 3.5 Developer Environment Reference Manual.
Which add-on products do you want to use? Sun Management Center has add-on products to extend its feature set and to make it work with specific software products or hardware platforms. For more information on the product and how it works in these different environments, see the documentation listed in Sun Management Center Documentation Resources.
In addition to installing the product components and the add-ons, you must set up the product components and add-ons before you can start the product.
The following table lists the prerequisite information that you need before installing the product.
Table 1–1 Information Needed Before Installing
Installation Item |
Description |
---|---|
Environment |
Choose the production environment if you want to use the product to manage and monitor your hardware. Choose the developer environment to develop and test modules to work with the product. A machine used for development must meet the minimum hardware and software requirements for the server, agent, and console layers and any add-ons you install. Note – If you plan to install the developer environment, you should install it on a separate, dedicated machine. The server, agent, and console layers are automatically installed on a developer environment machine. |
Base Layers (Components) |
Determine the machines on which you will install each component, for example, server, agent, and console. |
Languages |
Determine which, if any, additional languages (French, Traditional Chinese, Simplified Chinese, Korean, or Japanese) you need. The documentation for Sun Management Center 3.6 is not available on the media. Go to http://docs.sun.com for documentation in English and the supported languages. |
Add-on Products |
Review the add-on supplements to determine which add-ons you want to install. For a list of add-on supplements, see Sun Management Center Documentation Resources. Add-on products are installed on the same machine as the server. |
Space Needed |
If the machine does not have enough space in the default /opt directory, you might need to make one of the following adjustments:
|
You must have permission to write to the /var/opt and /opt/SUNWsymon directories as root on each machine. You also need privileges to run commands such as chmod. |
After installing the product and its add-ons, you will need to set up the product and its add-ons. The following table lists the prerequisite information that you need before setting up the product.
Table 1–2 Information Needed Before Setting Up
Set Up Item |
Description |
---|---|
A valid Solaris/Linux user name is required for assignment as the Sun Management Center administrator on Sun Management Center server machines. |
|
Sun Management Center uses two types of addressing for communication between the server and agent: IP addressing, and Network Address Translation (NAT). You must have the following information:
See Appendix D, Network Address Translation for further information. |
|
Sun Management Center requires an encrypted security key for communication between processes. The security key is generated based on a unique password you provide. Store the password securely. You need the password if you modify your Sun Management Center installation. |
|
Sun Management Center requires an SNMPv1 community string for security. The default is public. You have the option of specifying a more secure custom string. Store the SNMPv1 string securely. You need the SNMPv1 security string if you modify your Sun Management Center installation. |
|
The Sun Management Center Web server requires an encrypted security key. The security key is generated based your organization name and location. Store the organization name and location securely. You need this information if you modify your Sun Management Center Web server. |
|
Ports |
Determine the assignments for the following ports:
See Default Ports for further information. |
The following table provides a summary of Sun Management Center 3.6 requirements.
Some hardware platform config readers (add-ons) do not work on all layers of Sun Management Center when installed on Solaris 10.
For specific information about determining the total amount of resources needed, see Appendix C, Determining Hardware Resources.
Table 1–3 Sun Management Center 3.6 System Requirements
The default maximum heap size for the console and server is 64 Mbytes each.
Java console does not install jar files for add-ons.
You can customize the maximum heap size for the console and server as described in Starting Components Using es-start.
Sun Management Center 3.6 requires JDKTM 1.4.2 (minimum requirement), which is available on the <DiskMountDir>/disk1/jdk_dir/TargetOS_dir directory, where jdk_dir is the name of the JDK directory on the disk and TargetOS_dir is Linux or Solaris or Windows.
Install the JDK from the disk using the pkgadd command.
Type the command pkgadd -d <DiskMountDir>/disk1/jdk_dir.
Press Return to install all of the packages. The JDK packages are installed in the /usr/j2se directory.
Reset the JAVA_HOME environment variable to /usr/j2se.
In a C shell environment, type:
# setenv JAVA_HOME /usr/j2se |
In a Bourne or Korn shell environment, type:
# JAVA_HOME=/usr/j2se # export JAVA_HOME |
Set the JAVA_HOME environment variable in your .login or .cshrc file.
The following table shows the minimum disk space necessary to install the basic add-ons. For installation requirements for other add-ons, see the documentation supplement for that add-on. See Sun Management Center Documentation Resources.
For specific information about determining the total amount of resources needed, see Appendix C, Determining Hardware Resources.
Table 1–4 Add-on Disk Space Requirements by Base Component
On Solaris 10, install Sun Management Center in the global zone. On Linux, you can install only agent and console layers.
This section describes how to install Sun Management Center 3.6 on Solaris and Linux platforms using the graphical user interface (GUI).
This installation procedure assumes that you are installing Sun Management Center from a cd-image directory on your network.
For information on creating an installation CD image, see Creating Installation CD Images.
Set up the installation environment.
If you are installing the product remotely, grant access to the X server by typing the command xhost + machine in a terminal window where machine is the name of the machine where you want to install the product.
Log into the machine. If you are installing the product remotely, type the command rlogin machine and type the password.
Log in as root by typing su - root and the root password.
Do not miss the '-' after the su command
If you prefer a specific UNIX shell, type the command to use the shell, for example, csh.
If you are installing the product remotely, ensure that the DISPLAY environment variable is set to the machine's display, for example, setenv DISPLAY local-machine:0.0.
Ensure that the group entry in the /etc/nsswitch.conf has files as the first token.
group: files nis |
Change to the cd-image directory. Ensure that the cd-image directory is NFS-shared.
For example:
# cd /net/machine/cd-image/disk1/sbin |
where machine is the machine where you created the installation image, and cd-image is the root directory containing the installation CD images.
Review disk1/sbin/README.INSTALL and disk1/sbin/INSTALL_README.HWDS.
Run the installation.
Follow the screen prompts.
To accept the default /opt installation directory, click Next or click Browse to choose another directory.
Select either the production environment or developer environment.
This procedure assumes you have selected the production environment.
Select the components you want to install.
Review the Server Layer Binary Code License and use the scroll bar to scroll down to the end of the text.
To agree to the terms of the license, click I Agree and click Next.
If you want to install the product in additional languages, select the additional languages and click Next. The progress bar appears.
Select the add-on products.
The add-on products screen appears. Your list of add-on products might vary from this screen.
If you selected add-on products that have optional components, select the optional components required and click Next.
Review the add-on products binary license and use the scroll bar to scroll down to the end of the text.
Some add-ons require binary license.
To agree to the terms of the license, click I Agree and click Next.
The Checking Disk Space progress bar appears. If there is not enough disk space, you are asked to provide an alternate file system.
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.
Confirm installation selections and click Next.
The installation process can take from a few minutes to half an hour or more, depending on the products selected.
If installation failed, a summary screen is displayed.
Review the installation log in /var/opt/SUNWsymon/install to find out why the installation failed, and correct the problem.
Choose whether to run the setup wizard.
If you have used gui-inst to install only add-on products, click Close to exit the installation and setup process. You must set up the add-on products as described by To Set Up an Add-on Product Using es-setup. Otherwise, you will overwrite your security keys and will then have to set up all of the agents on all of your machines for the agents to work properly.
You use the graphical setup wizard to set up, configure, and re-configure your Sun Management Center installation.
For information on using the command-line setup script, see To Set Up Sun Management Center Using the es-setup Script.
Set up the installation environment. For more information, see Step 1 in To Install Sun Management Center.
Change to the Sun Management Center sbin directory. For example:
# cd /opt/SUNWsymon/sbin |
If you installed Sun Management Center in a directory other than /opt, Change to /installdir/SUNWsymon/sbin, where installdir is the directory you specified.
Run the set up by typing:
# ./es-guisetup |
The Set Up screen appears.
Follow the screen prompts.
You are given the opportunity to store all of your setup responses in the file /var/opt/SUNWsymon/install/setup-responses-file. The setup-responses-file file is useful if you need to duplicate the setup on the current machine on other machines.
To continue setup without creating the response file, click Next.
To create the response file, select Store Response Data and then click Next.
Generate the Sun Management Center security key.
Type a password in both fields and click Next to generate the security keys.
An encrypted security key is needed for communications between all Sun Management Center processes. The key is generated based on the password you provide, which must be between one and eight characters long and contain no spaces. Entries that are greater than eight characters are truncated to eight characters.
Keep a record of the password you use to generate the security key for this machine in a secure location. You might need to regenerate the key for the machine at a later time. You can also change the security key later, if needed, as described in Regenerating Security Keys.
Specify the SNMPv1 community security string.
The community string is used for SNMP security and is set to public by default.
Set the community string to a value other than public or private to provide better SNMP security.
The same SNMP community string must be used on all of the machines on which you install Sun Management Center. If you use different community strings on each machine, SNMP communications between the machines and Sun Management Center components will not work.
If you want to accept the community string default value of public, click Next.
If you want to use a custom community string:
Select Use Custom Community String.
The community string can be up to 255 characters and must not contain any spaces or blanks.
Type the same community string in both fields, and then click Next.
Enter a valid Solaris/Linux user name as the UNIX administrator account and click Next.
The setup process checks whether the SNMP port is in use.
If the SNMP port is in use, the SNMP Port Conflict screen appears.
Resolve the port conflict.
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 such a daemon.
We recommend that you use a different port number, such as port 1161.
To assign a different port number to Sun Management Center:
Click Use a Different Port Number.
For instructions on how to find out whether a port is used, see To Determine Whether a Port Is Used.
Type the port number, for example, 1161, in the Port ID field and click Next.
Keep a record of this alternate port number. You will need this number if you later install agents using JumpStart or update the Sun Management Center agents using the agent update-image tools.
To use port 161, select Use Port 161 and click Next.
If you use port 161, you are reminded to manually stop and disable the SNMP daemon snmpdx.
(On Solaris 10) If you use port 161, you will be reminded to stop and disable the SNMP daemon SMA manually.
There is no SNMP daemon on Linux by default.
To stop and disable the SNMP daemon snmpdx automatically, make sure that Stop and Disable SNMP Daemon snmpdx has been selected, and then click Next.
Stopping and disabling the system SNMP daemon does not guarantee that you have stopped the actual process using port 161. To determine the actual daemon process that uses port 161, you must 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 stop all other processes that use port 161 before you can start Sun Management Center.
To stop and disable the SNMP daemon SMA, navigate to the /etc/init.d directory. Type ./init.sma stop.
If any Sun Management Center ports are in use, you are prompted to resolve the port conflict.
The ports are checked in the following order: trap service, event service, topology service, configuration service, platform agent, cst service, metadata service, database, look-up service, Web server default port, and Web server secure port.
If any of the ports are in use, you are prompted to provide an unused port number. Type an unused port number in the field, and then click Next.
Generate the Web server security key.
An encrypted security key is needed for the Sun Management Center Web server. The key is generated based on the name of your organization and the name of your location. The names that you provide must not contain any spaces or blanks.
Type the name of your organization and the name of your location to generate the Web server security key and click Next.
For example, you could type admin in the Name of Your Organization field and headquarters in the Name of Your Location field.
Keep a record of the entries you use to generate the security key in a secure location in case you need to regenerate the key for a particular machine at a later time.
Confirm setup selections.
The setup process can take from a few minutes to half an hour or more, depending on the products selected.
If base product setup failed, you are informed that the setup of the base products was not successful. You are directed to see the log file for more details. The name of the log file is provided.
If you installed add-ons, click Next to set them up.
Some add-on products are included with the Sun Management Center 3.6 installation CDs. These add-ons are the ones listed in the Select Add-on Products panel. For information on how to set up each add-on, refer to the Sun Management Center supplement for each add-on. Each supplement provides the setup procedure for the specific add-on.
If you selected the add-on Monitoring and Management of A5x00 and T3 Devices, make sure you apply the necessary patches to the server as described in Sun StorEdge A5x00 Packages. Also, add each T3 IP address, Ethernet address, and name to the server system files, as described in T3 Storage Devices.
Start the product by selecting the components to start and clicking Next.
For more information on starting and stopping Sun Management Center, see Chapter 8, Starting and Stopping Sun Management Center.
If your network uses Network Address Translation (NAT), click Close. Use the es-config command-line utility described in To Enable NAT Support to configure the machine for NAT before you start Sun Management Center.
Start the console by typing this from a terminal window: ./es-start —c&.
The Java Console login screen appears.
If help does not come up in Java Console, modify the browser path in the javaconsole.properties file. This file is available in /var/opt/SUNWsymon/cfg/ if you have installed the console layer. Otherwise, this file will be available in /opt/SUNWsymon/cfg/.
You are prompted to select the default domain and then a screen similar to this appears.
(On Solaris 10) When Sun Management Center is installed and set up, the services run as Service Management Facility (SMF) services. Based on the layers chosen, appropriate services will be started.
For information on using the product, see Sun Management Center 3.6 User's Guide.
Zone is a virtualized operating system environment that you can set up for systems that run the Solaris 10 Operating System. Every Solaris system contains a global zone, the default zone for the system. You can create local (non-global) zones. You can monitor a zone by running an agent inside a local zone.
You can create a local zone either through zone commands or through the zone wizard of Solaris Container Manager.
If you create a local zone using Solaris Container Manager, ensure that you add the base directory of Sun Management Center to the inherit-pkg-dir directory. You can specify this in the “Provide Inherit Package” step of the wizard.
For more information, see “Managing Zones” in Installing and Administering Solaris Container Manager 1.1.
Create a local zone using zone commands.
Become superuser and open two terminal windows.
From the first terminal window, type the following lines to create a local zone.
#zonecfg -z localzonename, where localzonename is the name of the local zone.
No such zone configured Use 'create' to begin configuring a new zone.
zonecfg:localzonename> create
zonecfg:localzonename> export
zonecfg:localzonename> add inherit-pkg-dir
zonecfg:localzonename:inherit-pkg-dir> set dir=/opt, where /opt is the installation directory.
zonecfg:localzonename:inherit-pkg-dir> end
zonecfg:localzonename> add net
zonecfg:localzonename:net> set address=ipaddress
zonecfg:localzonename:net> set physical=networkinterface
zonecfg:localzonename:net> end
zonecfg:localzonename> set zonepath=/export/zone/localzonename
zonecfg:localzonename> verify
zonecfg:localzonename> commit
zonecfg:localzonename> exit
#zoneadm -z localzonename install
From the second terminal window, type zlogin -C localzonename to log in to the local zone
From the first terminal window, type zoneadm -z localzonename boot to boot the zone.
The boot messages are displayed in the second terminal window where you logged in to the zone.
Type the appropriate values for locale, terminal type, host name, naming service etc.
The zone will be rebooted.
This procedure assumes that the local zone does not inherit /opt/SUNWsymon and that the path of the local zone is /export/zone/localzonename.
Become superuser.
From the terminal window, log in to the local zone.
zlogin localzonename mkdir -p /opt/SUNWsymon
Do a loopback mounting of /opt/SUNWsymon.
mount -F lofs /opt/SUNWsymon /export/zone/localzonename/root/opt/SUNWsymon
Install and set up Sun Management Center in the global zone.
Create a local zone as described in To Create a Local Zone or use an existing local zone as described in To Use an Existing Local Zone.
From the global zone, set up an agent to run inside this local zone.
/opt/SUNWsymon/sbin/es-setup -z localzonename
From the global zone, log in to the local zone.
zlogin localzonename
From the local zone, complete the setup.
/opt/SUNWsymon/sbin/es-setup
You can start and stop the agent from within the local zone. You can use es-config to change the port number of the agent.
The commands supported inside the local zone are es-start, es-stop, es-setup, es-config, and es-load-default.
The list of modules that will be available for the agent inside the local zone is available at /var/opt/SUNWsymon/cfg/zone-modules-d.dat. If you remove a module from this file, that module will not be available when the agent is restarted.
This release supports setting up and running of Advanced System Monitoring, Service Availability Manager, System Reliability Manager, and Performance Reporting Manager inside a local zone.
Java Console is not supported inside a local zone.
Sun Management Center works in production and developer environments. It also has many add-on products. For more information on the product and how it works in these two environments, see the documentation listed in the following table.
For updated information on documentation resources, see the Sun Management Center 3.6 Installation and Configuration Guide.
Documentation for Sun Management Center is not installed with the product. The documents are available at http://docs.sun.com.
Environment |
Documentation |
---|---|
If you install and use the product in a production environment, see |
Sun Management Center 3.6 User's Guide- Describes how to use the product. |
Sun Management Center 3.6 Installation and Configuration Guide- Describes how to install and configure the product. |
|
If you use the product in a developer environment, see |
Sun Management Center 3.5 Developer Environment Reference Manual |
If you use the product with other software products or add-ons (listed alphabetically), see |
|
Advanced System Monitoring |
Not Applicable |
Hardware Diagnostic Suite 2.0 |
Hardware Diagnostic Suite 2.0 User's Guide |
Solaris Container Manager 3.6 |
Solaris Container Manager 3.6 Release Notes |
Installing and Administering Solaris Container Manager 3.6 |
|
Performance Reporting Manager |
Sun Management Center 3.5 Update 2 Performance Reporting Manager User’s Guide |
Service Availability Manager |
Sun Management Center 3.5 Service Availability Manager User’s Guide |
Sun Cluster |
Task Map: Installing the Sun Cluster Module for Sun Management Center in the Sun Cluster Software Installation Guide for Solaris OS |
System Reliability Manager |
Sun Management Center 3.6 System Reliability Manager User’s Guide |
Tivoli TEC Adapter |
Sun Management Center Tivoli TEC Adapter Installation Guide |
Unicenter TNG |
Sun Management Center CA Integration Package User's Guide for Unicenter TNG |
If you use the product with these hardware platforms (listed alphabetically), see |
|
ELP Config Reader (CommonConfigReader) |
See Sun FireTM V210/V240/V250/V440/1500/2500 |
Desktop |
See Sun BladeTM 100/150/1000/1500/2000/2500 |
Dynamic Reconfiguration for Sun Fire high-end and midrange |
See Sun Fire V880/V890/15K to 3800 |
hPCI+ board and CP2140 system controller for Sun Fire high-end systems |
See Sun Fire high-end systems |
NetraTM 20/120/1280 |
Sun Management Center 3.5 Supplement for Netra Servers |
Netra 240/440 |
Sun Management Center 3.6 Supplement for Sun Fire, Sun Blade and Netra Systems |
Netra T4/20 |
Sun Management Center 3.5 Supplement for Netra Servers |
PCI+ support for Sun Fire midrange systems |
See Sun Fire midrange systems |
Sun BladeTM 100/150/1000/2000 |
Sun Management Center 3.5 Supplement for Workstations |
Sun Blade 1500/2500 |
Sun Management Center 3.6 Supplement for Sun Fire, Sun Blade and Netra Systems |
Sun CobaltTM LX50 |
See the software product, Sun Management Center Linux Agent |
Sun Fire V60x/V65x/V20z/V40z |
See the software product, Sun Management Center Linux Agent |
Sun Fire 280R/V480/V490/V880/V890 |
Sun Management Center 3.5 Supplement for VSP High-End Entry Servers (Workgroup Servers) |
Sun Fire high-end E25K/E20K/15K/12K |
Sun Management Center 3.5 Version 6 Release Notes and Supplement for Sun Fire High-End Systems |
Sun Fire midrange E6900/E4900/6800/4810/4800/3800 |
Sun Management Center 3.5 Version 6 Release Notes and Supplement for Sun Fire Midrange Systems |
Sun Fire entry-level midrange E2900 |
Sun Management Center 3.5 Version 6 Release Notes for Sun Fire Entry-Level Midrange Systems Sun Management Center 3.5 Version 6 Supplement for Sun Fire Entry-Level Midrange Systems |
Sun Fire V100/V120 |
Sun Management Center 3.5 Supplement for Netra Servers |
Sun Fire V210/V240/V250/V440 |
Sun Management Center 3.6 Supplement for Sun Fire, Sun Blade and Netra Systems |
Sun LX50 |
See the software product, Sun Management Center Linux Agent |
Sun StorEdgeTM A5x00/T3 |
Sun Management Center 3.5 Supplement for the Sun StorEdge A5x00 and T3 Arrays |
UltraSPARC® IV CPU board support for Netra 1280 |
Requires midrange systems firmware 5.17.0 and Netra-T add-on packages for Sun Management Center |
UltraSPARC IV CPU board support for Sun Fire 6800/4800 |
See Sun Fire 6800/4800 |