2 - C H A P T E R -

C H A P T E R 2

Installing Sun Management Center 3.5 Software for Starfire Systems

This chapter, used with the Sun Management Center 3.5 Installation and Configuration Guide, shows you how to install the Sun Management Center software on Starfire servers.

The Sun Management Center software is divided into base packages that provide the Sun Management Center infrastructure and basic support, and add-on components that add support for particular hardware platforms or other options.

Starfire support requires base packages and add-on Starfire packages that are installed during the Sun Management Center software installation described in this chapter. Once this software is installed, set up the Sun Management Center software using the instructions in Chapter 3.

Caution - Use the installation scripts and the setup scripts provided with the Sun Management Center 3.5 software. Do not manually add packages or manually change configuration files.

Your Sun Management Center 3.5 installation and setup scripts or graphical user interface (GUI) panels may not display exactly the same messages in exactly the same sequence as the examples shown in this chapter. However, these examples show the basic messages you receive in approximately the sequence you receive them. Your actual installation and setup scripts depend on the add-on components you choose to install and other choices you make.

Starfire System Add-On Component Packages

The add-on Starfire software includes the following packages for Sun Management Center software support of Starfire platforms (TABLE 2-1):


Package	Description
SUNWessfd	Sun Management Center Domain Agent Support for Starfire servers. This package provides libraries and configuration files needed to monitor the hardware configuration of Starfire domains.
SUNWessfp	Sun Management Center SSP Agent Support for Starfire servers. This package provides libraries and configuration files needed to monitor the hardware configuration of the entire Starfire platform.
SUNWessfs	Sun Enterprise Starfire Server Support for Starfire systems. This package provides files needed by the Sun Management Center server to display the physical view of the Starfire platform.
SUNWessfg	Sun Management Center Common Support for Starfire servers. This package provides master setup and uninstall scripts.
SUNWensfi	Sun Management Center English message file for Starfire servers.

Preparing to Install Sun Management Center Software for Starfire Systems

Your Starfire system must meet certain requirements before you install Sun Management Center 3.5 software for Starfire servers. These requirements are explained in the following sections.

Where to Install Sun Management Center Software for Starfire Systems

The Sun Management Center software must be installed on a number of hosts for Starfire support to be available. Sun Management Center components must be installed on:

Sun Management Center server host

SSP for the Starfire platform

Spare SSP (if configured)

Each Starfire domain you would like to monitor

See Starfire Platform Objects for more information about main and spare SSPs.

In addition, the Sun Management Center console software must be installed on a host in your network. There are no add-on Starfire components for the console layer.

Sun Management Center online help can be installed on a Sun Management Center help server and viewed by web browsers on the network. There are no add-on Starfire components for the help server, but you do need to decide where to install the online Sun Management Center help server. Refer to "Sun Management Center Online Help" in the Sun Management Center 3.5 User's Guide for more information.

Caution - Only the Sun Management Center agent layer should be installed on the SSP. Do not install the Sun Management Center console or server layer on a Starfire SSP. SSP resources are dedicated to managing the Starfire platform; running additional functions on the SSP can result in the SSP software not running correctly.

Note - (Optional) Install Sun Management Center software on each Starfire domain if you want full monitoring capabilities.

Choosing Your Sun Management Center Server Host

Before installing the Sun Management Center software, determine which host is the Sun Management Center server host. The host chosen to be the Sun Management Center server for your network should be a system with high availability; when the Sun Management Center server is down, you are unable to use Sun Management Center software to manage your systems. Refer to the Sun Management Center 3.5 Installation and Configuration Guide for more information about server host requirements.

You can place any of the Sun Management Center layers (console, server, agent) on a Starfire domain. But if you want to be able to manage a Starfire platform when all domains are down, you should not place the Sun Management Center server layer on one of the Starfire platform domains.

For more timely platform monitoring of the Starfire domain hardware configuration, configure the SSP and the Starfire domain Sun Management Center agents to use the same Sun Management Center server.

Required Sun Management Center Version

The Sun Management Center 3.5 Starfire components must be installed and used with Sun Management Center 3.5.

Refer to "Sun Management Center Compatibility" in Chapter 1 of the Sun Management Center 3.5 Installation and Configuration Guide for more information.

The Sun Management Center 3.5 server supports monitoring of Sun Management Center 3.0 agents. If you upgrade Sun Management Center software on any component of a Starfire system from version 3.0 to version 3.5, upgrade all of those components to version 3.5. These components include:

Starfire domains

Starfire SSP

Starfire spare SSP

System Requirements

The Sun Management Center 3.5 Installation and Configuration Guide provides information about general Sun Management Center prerequisites, including minimum disk space requirements. TABLE 2-2 shows the additional disk space required for the add-on Sun Management Center components for Starfire servers.


Layer	Minimum Disk Space Required (MB)
Starfire Domain Agent	0.5
Starfire Platform (SSP) Agent	0.7
Sun Management Center Server Starfire Support	0.5

Supported Operating Environments

You need to know which versions of the Solaris Operating Environment are running on each system on which you plan to install Sun Management Center 3.5 software. The following Solaris Operating Environments are supported by the Sun Management Center software add-on component for Starfire servers:

Solaris 8 Operating Environment (32-bit and 64-bit modes)

Solaris 9 Operating Environment (32-bit and 64-bit modes)

Supported SSP Releases

The Sun Management Center software add-on component for Starfire servers requires SSP version 3.5 software. Any of the supported operating environments may be used on the SSP.

Required SSP Memory Configuration

The SSP must have a minimum of 128 megabytes (MB) of memory.

Required Patches

Starfire domains running the Solaris Operating Environment may require Solaris software patches to run correctly with the Sun Management Center software. Refer to "Required Patches" in the Sun Management Center 3.5 Release Notes for general Sun Management Center patch information. Refer to any README files associated with these patches for information about any dependencies or prerequisites the patches may have.

Required Network Port Configuration

Sun Management Center software requires the use of network ports to communicate with various components of the system. The default port addresses for these components are shown in TABLE 2-3:


Layer	Component	Default Port Number
Agent	Agent	161
Server	Trap handler	162
Server	Event manager	163
Server	Topology manager	164
Server	Configuration manager	165
Server	Server	2099
Agent	Platform agent	166

In some cases, this default port configuration conflicts with software already running on your system. The Starfire SSP always has a port 161 conflict, since the SSP snmpd agent or Solaris software snmpdx agent uses this port. Some Starfire domains may also have port 161 conflicts due to the presence of legacy SMNP agents. During the Sun Management Center software setup, specify a different network port to avoid this conflict. Refer to Appendix B of the Sun Management Center 3.5 User's Guide for information about how to determine what ports are in use.

To create and access topology objects, Sun Management Center software uses port 161 by default. If you configure an agent to use an alternate 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, select an alternate port number and use that number for all agent installations that cannot use the default port configuration.

The Starfire SSP has two Sun Management Center agents: the agent and the platform agent. The agent provides information about the SSP and the platform agent provides information about the Starfire platform. 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.

SSP Config Reader Support

You can add Config Reader support for some SSP Sun Ultra trademark workstation architectures by installing and setting up the workstation add-on component of the Sun Management Center software. Refer to the Sun Management Center 3.5 Supplement for Workstations for a complete list of supported workstations.

Note - Sun SPARCstation trademark workstation architectures are not supported by the workstation add-on component. Sun Management Center software can be installed on a SPARCstation workstation, but no SSP hardware configuration information is available.

If you want, you can install this add-on component during the installation and setup of the Sun Management Center 3.5 software. If you install the base software from a CD-ROM drive, the workstation add-on packages are installed during the base installation. If you install from the Web, you must download and install the required workstation images.

Sun Management Center Installation Files

The Sun Management Center 3.5 CD-ROM contains all files necessary to install Sun Management Center software on Starfire servers. This software is also available from the Sun Management Center Web site at:

http://www.sun.com/sunmanagementcenter

If you obtain this software from the Web site, be sure that you download:

Sun Management Center base packages

Add-on Starfire components

(Optional) Desktop add-on component for SSP

Documentation

When downloading Sun Management Center software from the Web, choose which Solaris Operating Environment releases you need to support. Each operating environment release has a separate set of downloadable images. If more than one release is running anywhere in your Starfire configuration, you need to download multiple versions for each software component.

Once you have downloaded all the required components, extract these files into a single directory. This builds an installation directory containing all the Sun Management Center software components you need, and allows you to install with one command the Sun Management Center base software, the add-on Starfire component and, optionally, the add-on Desktop component.

For detailed instructions on downloading and extracting these files, refer to the README file accompanying each downloadable installation package available on the Sun Management Center Web site at:

http://www.sun.com/sunmanagementcenter

Considerations When Installing Sun Management Center 3.5 Software on Starfire Systems

Detailed directions for installing and setting up Sun Management Center 3.5 software are provided in the Sun Management Center 3.5 Installation and Configuration Guide. For Starfire configurations, you should be aware that if you are installing the Sun Management Center software from a CD-ROM onto a Starfire domain, you must mount a remote CD-ROM drive since the Starfire host does not have a local CD-ROM drive. See To Mount a Remote CD-ROM Drive for instructions.

To Mount a Remote CD-ROM Drive

If you are installing from a CD-ROM, you first need to mount a remote CD-ROM drive from the SSP since the Starfire domain does not have a local CD-ROM drive and the SSP does.

1. Log in to the SSP as superuser.

2. Insert the Sun Management Center 3.5 CD into the CD-ROM drive on the SSP.

3. Type the share(1M) command on the SSP to make the CD-ROM usable across the network.

ssp# share -o ro,anon=0 -F nfs /cdrom/sun_management_center_3_0

4. Log in to a Starfire domain as superuser.

5. Make a local directory, if it does not already exist, on which to mount the CD-ROM:

# mkdir /cdrom

6. Mount the SSP /cdrom directory on /cdrom:

# mount ssp_hostname:/cdrom/sun_management_center_3_5/cdrom

7. Change to the Sun Management Center software installation directory:

# cd /cdrom/sun_management_center_3_5

Sun Management Center Software Licensing

Sun Management Center 3.5 software support for Starfire servers requires only the basic functionality included with Sun Management Center 3.5 software. No license is required for this basic functionality.

Installing the Sun Management Center 3.5 Software

For Starfire support, install the following Sun Management Center software on these Starfire platform hosts:


Host	Layer	Software Installed
Sun Management Center Server Host	Server	Base Sun Management Center server layer and Sun Management Center server add-on component for Starfire servers
Starfire Domain	Agent	Base Sun Management Center Agent layer and add-on Starfire Domain component
Main SSP	Agent	Base Sun Management Center Agent layer and Starfire Platform add-on component. No other Sun Management Center layers should be installed here.
Spare SSP (if configured)	Agent	Base Sun Management Center Agent layer and Starfire Platform add-on component. No other Sun Management Center layers should be installed here.

Note - In addition to the Sun Management Center agent layer, any of the Sun Management Center layers can be installed on Starfire domain hosts. See Choosing Your Sun Management Center Server Host for more information.

You must also install the Sun Management Center console and online help somewhere on your network, as described in the Sun Management Center 3.5 Installation and Configuration Guide.

Starfire Software Installation Sequence

For best results, install the Sun Management Center software on the hosts in the following order:

1. Sun Management Center server host

2. Starfire domains

3. Main SSP

4. Spare SSP (if configured)

5. Sun Management Center console host

6. Sun Management Center online help (if not installed on the Sun Management Center console host)

Proceeding With the Installation

You are now ready to install the base Sun Management Center software. Follow the instructions in the Sun Management Center 3.5 Installation and Configuration Guide carefully. After selecting the Sun Management Center components to install, the required Sun Management Center software and the add-on Starfire components are installed on your host.

Remember to:

Install the Sun Management Center software on the hosts in the sequence shown in Starfire Software Installation Sequence.

For each host, install the Sun Management Center layers as described in TABLE 2-4.

Once the Starfire add-on components are installed, a setup confirmation message is displayed:

Do you want to run setup now? [y|n|q]

To set up the Sun Management Center software, answer y (for Yes) and continue with Setting Up Sun Management Center 3.5 Components for Starfire Systems.

Installing the Starfire Add-on Software Using the Sun Management Center 3.5 Installation Wizard

Chapter 6, "Installation and Setup" of the Sun Management Center 3.5 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 3.5 Installation Wizard, es-guiinst, as described in Chapter 6, "Installation and Setup," of the Sun Management Center 3.5 Installation and Configuration Guide.

2. After the base software is installed, the Select Add-on Product screen provides a selectable list of add-on products that you can install. Select those add-ons that apply to Starfire systems, and click Next.

3. The Sun Management Center Setup Wizard starts automatically after all the software is installed.

Uninstalling Software Using the CLI

You can uninstall:

All the Sun Management Center software (see To Uninstall All Sun Management Center Software)

One, two, or all three modules of the Starfire add-on software (see To Uninstall Individual Add-on Modules)

To Uninstall All Sun Management Center Software

1. As superuser, type:

# ./es-uninst

The system displays this message.

This script will help you to uninstall the Sun Management Center software.

Following Sun Management Center Products are installed:

---------------------------------------------------------------------------

PRODUCT                                              DEPENDENT PRODUCTS

---------------------------------------------------------------------------

Production Environment                               All Addons

Starfire Monitoring                                  None

Do you want to uninstall Production Environment? [y|n|q]

2. Type y to uninstall 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]

3. Do one of the following

Type y to change your selection.

The system displays your selection; go to the beginning of Step 2.

Type n to not change your selection.

The system displays this message.

Do you want to preserve database? [y|n|q]

Note - If you answer y for yes, the system preserves any data in the database, including open and closed alarms, loaded modules and their configurations, discoveries, managed objects, and rule thresholds.

4. Type y to keep any existing topology and event data; or type n to discard the data.

The system displays this message.

Proceed with uninstall? [y|n|q]

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 Individual Add-on Modules

1. As superuser, type:

# ./es-uninst

The system displays this message.

This script will help you to uninstall the Sun Management Center software.

Following Sun Management Center Products are installed:

---------------------------------------------------------------------------

PRODUCT                                              DEPENDENT PRODUCTS

---------------------------------------------------------------------------

Production Environment                               All Addons

Starfire Monitoring                                  None

Do you want to uninstall Production Environment? [y|n|q]

2. Type n to not uninstall the Production Environment; in other words, type n to uninstall individual modules.

The system displays this message.

Do you want to uninstall Starfire Monitoring? [y|n|q]

3. Type y beside Starfire Monitoring if you do want to uninstall it, or n beside Starfire Monitoring if you do not want to uninstall.

The system displays the module that will be uninstalled and this message.

Do you want to change selection? [y|n|q]

4. Do one of the following:

Type y to change the selections.

The system displays your selections; go to the beginning of Step 3.

Type n to not change your selections.

The system displays this message.

Proceed with uninstall? [y|n|q]

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.