C H A P T E R  2

Installation

This chapter describes how to install and set up the Sun Management Center 3.0 on the supported platforms.

The chapter contains the following sections:


Sun Management Center 3.0 Software

The Sun Management Center 3.0 software comprises:

The Sun Management Center 3.0 Software Installation Guide provides basic information about installing and setting up the Sun Management Center 3.0 core components and starting and stopping the software. For information about the value-added software and integration adapters, please refer to the Sun Management Center web site:

http://www.sun.com/software/solaris/sunmanagementcenter

This chapter describes the processes specifically related to installing and configuring Sun Management Center 3.0 for the supported platforms.

Support for these platforms requires the Sun Management Center 3.0 core packages and the add-on packages for the supported platforms. In this release of the product, the add-on packages are available independently from the Sun Management Center 3.0 core packages.

TABLE 2-1 lists the specific software revisions required to install Sun Management Center 3.0 on the supported platforms.

Your Sun Management Center 3.0 installation and setup scripts may not display the same messages in exactly the same sequence as the examples in this chapter. However, these examples show the basic messages you receive and the approximate sequence in which you receive them.

Specific installation and setup scripts depend on the additional components you install and other choices you make.

TABLE 2-1 Required Software Versions

Host

Required Software

Version

Sun Management Center Server

Solaris operating environment

Sun Management Center[1]

Hardware Platform Module packages

2.6, 2.7, 8, 9

3.0

See TABLE 2-2, TABLE 2-3 and TABLE 2-4

Monitored Platform

Solaris operating environment

Sun Management Center*

Hardware Platform Module packages

[2]

3.0

See TABLE 2-2, TABLE 2-3 and TABLE 2-4


Package Information

TABLE 2-2 lists the common packages that you install on the monitored system and the Sun Management Center server. TABLE 2-3 and TABLE 2-4 list the platform-specific packages for the Sun Fire V210 and V240 and Sun Fire V440, respectively. TABLE 2-5 lists the platform-specific packages for the Sun Blade 1500 and 2500 workstations.



Note - The platform-specific package names for other platforms will be different.



Refer to the Sun Management Center 3.0 Software Installation Guide for information about general Sun Management Center 3.0 prerequisites, including minimum disk space requirements.

TABLE 2-2 Common Hardware Platform Module Packages

Package

Description

Layer

SUNWescci

SunMC Common Config Reader Module Initialization

Server and agent

SUNWesccs

SunMC Common Config Reader Module Server Core Component

Server

SUNWescca

SunMC Common Config Reader Module Agent Core Component

Agent

SUNWescda

SunMC Common Config Reader Module DAQ Component

Agent

SUNWescdl

SunMC Common Config Reader DAQ Library

Agent


TABLE 2-3 Platform-Specific Packages for Sun Fire V210 and V240

Package

Description

Layer

SUNWescps

SunMC Common Config Reader Module Sun Fire V210/V240 Server Component

Server

SUNWescpa

SunMC Common Config Reader Module Sun Fire V210/V240 Agent Component

Agent

SUNWescpl

Common Config Reader Module Sun Fire V210/V240 platform support

Agent


TABLE 2-4 Platform-Specific Packages for Sun Fire V440

Package

Description

Layer

SUNWeschs

SunMC Common Config Reader Module Sun Fire V440 Server Component

Server

SUNWescha

SunMC Common Config Reader Module Sun Fire V440 Agent Component

Agent

SUNWeschl

Common Config Reader Module Sun Fire V440 platform support

Agent


TABLE 2-5 Platform-Specific Packages for Sun Blade 1500 and 2500

Package

Description

Layer

SUNWescws

SunMC Common Config Reader Module Sun Blade 1500/2500 Server Platform Component

Server

SUNWescwa

SunMC Common Config Reader Module Sun Blade 1500/2500 Agent Platform Component

Agent


   

Note - Make sure that you have installed the latest version of any required Sun Management Center 3.0 core patches before installing this product. For details, refer to the Sun Management Center 3.0 Software Installation Guide.



The installation procedure described in this chapter installs the common packages and platform-specific packages automatically.


Obtaining the Add-On Software

The packages are supplied in an archive bundle named symon_elsw_<ver>.tar. Z where <ver> is the version number. At the time of publication of this document, the version is <b1.2>. Always use the latest available version of this file for installation.

The file, which is in compressed tar format, is available from:

http://www.sun.com/software/solaris/sunmanagementcenter/get.html



Note - In the future, some of the filenames can vary depending on which version of Solaris you are using, the version of Sun Management Center you have downloaded and the version of this product.




Preparing for Installation

Your environment must meet certain requirements before you can install the management software. This section explains these requirements.

Sun Management Center Server

Before installing the Sun Management Center 3.0 software, determine which server is to be the Sun Management Center server. The available memory in the server must meet the requirements given in the Sun Management Center 3.0 Configuration and Deployment Guide.

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 3.0 Configuration and Deployment Guide for more information about server requirements.


Installation and Configuration



Note - If you are extending an existing Sun Management Center installation to provide support for the supported platforms, it is not necessary to re-install the core Sun Management Center packages.





Note - This document does not describe the installation and setup process for the core Sun Management Center 3.0 product. Refer to the Sun Management Center 3.0 Software Installation Guide for information about installing and setting up the core software.



To simplify the installation procedure, make sure you have the following information to hand before starting your installation:

If you have a previous version of the hardware platform module for the supported platforms already installed, remove the existing packages before you install the new version.

Installation Summary

1. If necessary, uninstall any pre-existing installation of the add-on software.

For details, see Removing Existing Hardware Platform Modules.

2. If necessary, install Sun Management Center 3.0 software on the system used as the Sun Management Center console.

For details, refer to the Sun Management Center 3.0 Software Installation Guide.

3. Install Sun Management Center 3.0 server software and the add-on server software on the Sun Management Center server.

For details of how to install core Sun Management Center 3.0 server software, refer to the Sun Management Center 3.0 Software Installation Guide.

For details of how to install the add-on server software, see To Install the Sun Management Center Server Software.

4. Install Sun Management Center 3.0 agent software and the add-on agent software on the platform(s) to be monitored.

For details of how to install core Sun Management Center 3.0 agent software, refer to the Sun Management Center 3.0 Software Installation Guide.

For details of how to install the add-on agent software, see To Install and Setup the Sun Management Center Agent Component.

Removing Existing Hardware Platform Modules

You must remove all existing packages from the server prior to installation of the new platform module packages.

Refer to Package Information for details of which platform-specific packages apply to your hardware.


procedure icon  To Remove Existing Packages From The Server

1. Check which platform-specific server packages are already installed on the Sun Management Center server.

# pkginfo -l SUNWescps SUNWeschs SUNWescws | grep VERSION
<response not shown>

2. Remove all platform-specific Sun Management Center server packages that are already installed using the pkgrm command.

# pkgrm SUNWescps SUNWeschs SUNWescws

3. Remove all shared Sun Management Center server packages for this product that are already installed using the pkgrm command.

# pkgrm SUNWesccs

4. Remove the shared initialization component using the pkgrm command.

This step will break the agent if it is installed on the same host, however installation of the new packages will reinstate the required shared components.

# pkgrm SUNWescci


procedure icon  To Remove Existing Packages From The Agent

1. Check which platform-specific agent packages are already installed on the monitored system(s).

For example, for the Sun Fire V210 server, type:

# pkginfo -l SUNWescpa SUNWescpl | grep VERSION
<response not shown>

For systems other than the Sun Fire V210, substitute the packages for your platform that correspond to SUNWescpa and SUNWescpl (if applicable), as listed in Package Information.

2. Remove all platform-specific agent packages using the pkgrm command.

For example, for the Sun Fire V210 server, type:

# pkgrm SUNWescpa SUNWescpl

3. Remove all shared agent packages.

# pkgrm SUNWescda SUNWescdl SUNWescca

4. Remove the shared initialization component, if you have not removed it already.

# pkgrm SUNWescci

You can install only one set of agent packages per platform. Therefore, when you remove the platform-specific agent packages you should also remove the common agent packages.



Note - Do not delete the shared initialization component if the host is also the Sun Management Center host. If this is so, the shared initialization component might still be needed.



Installing the Hardware Platform Module

This section describes the procedures for installing and setting up Sun Management Center 3.0 software on the supported platforms.


procedure icon  To Install and Setup the Sun Management Center Agent Component

1. Log on to the monitored platform as root.

2. If the agent is running, stop it by typing:

# /opt/SUNWsymon/sbin/es-stop -a

3. Create a temporary directory and move to it.

For example:

# mkdir /var/tmp/<temp_directory>
# cd /var/tmp/<temp_directory>

4. Copy the platform-specific software archive file, symon_elsw_<ver>.tar. Z , to the directory you have created.

5. Uncompress and untar the file.

For example:

# zcat ../symon_elsw_<ver>.tar. Z | tar xvf -



Note - The exact filename depends on the software release you have downloaded.



6. Add the Sun Management Center platform agent package using the es-inst command.

# /opt/SUNWsymon/sbin/es-inst

When installation is complete, you are prompted to run es-setup to configure the software.

# /opt/SUNWsymon/sbin/es-inst
This script will help you to install the Sun Management Center software.
 
Please enter the source directory: /var/tmp/<temp_directory>/disk1/image
 
Target directory: /opt
 
=====================================================================
                Sun Management Center 3.0 Addons Product Selection:
=====================================================================
 
  Do you want to install the product: ELP Config-Reader Monitoring? [y|n|q] y
Installing the product: ELP Config-Reader Monitoring
  
Checking disk space...
Processing package instance <SUNWescci> from </tmp/<temp_directory>/disk2/image/Addons/CommonConfigReader/Common/Basic>
 
<truncated>
 
Do you want to run setup now? [y|n|q] y
-----------------------------------
Sun Management Center Setup Program
-----------------------------------
 
This program does setup of Sun Management Center components that are installed on your system.
 
Checking for Sun Management Center components installed on your system.
 
You have the following Sun Management Center components installed
 
Sun Management Center Agent
 
Stopping all Sun Management Center processes. This may take a few moments...
tortilla appears to be configured as your Sun Management Center server.


Is this correct? [y|n|q] y
----------------------------------------------------------
Starting Sun Management Center ELP Config Reader Setup
----------------------------------------------------------
Sun Fire V210
 
Added module Config-Readerelp to /var/opt/SUNWsymon/cfg/base-modules-d.dat.
For seting up Sun Fire (6800/4810/4800/3800) platform administration module
you need to provide SC IP address, community strings, port numbers for domain agent etc.
 
Do you want to setup Sun Fire (6800/4810/4800/3800) platform administration module [y|n|q] n
 
Sun Management Center setup complete.
Do you want to start Sun Management Center agent now [y|n|q] y
 
Log file: /var/opt/SUNWsymon/install/install.021205115507.11373
 
 
                        End of Installation
#
 

 

Note - The name of the Sun Management Center server depends on your own environment.



7. When the installation is complete, you can delete the downloaded file from the temporary directory you created at Step 4, then delete the directory itself.


procedure icon  To Install the Sun Management Center Server Software

1. Make sure that the Sun Management Center 3.0 core packages are installed and set up on the Sun Management Center server.

For details of how to install core Sun Management Center 3.0 server software, refer to the Sun Management Center 3.0 Software Installation Guide.

2. Log on to the Sun Management Center server as root.

3. Create a temporary directory and move to it.

For example:

# mkdir /var/tmp/<temp_directory>
# cd /var/tmp/<temp_directory>

4. Copy the platform-specific software archive file, symon_elsw_<ver>.tar. Z, to the directory you have created.

5. Uncompress and untar the file.

For example:

# zcat symon_elsw_<ver>.tar. Z | tar xvf -



Note - The filename depends on the software release you have downloaded.



6. Add the Sun Management Center platform server package using the es-inst command.

# /opt/SUNWsymon/sbin/es-inst

When installation is complete, you are prompted to run es-setup to configure the software.

# /opt/SUNWsymon/sbin/es-inst
 
This script will help you to install the Sun Management Center software.
 
Please enter the source directory: /var/tmp/<temp-directory>/disk1/image
 
Target directory: /opt
 
=====================================================================
                Sun Management Center 3.0 Addons Product Selection:
=====================================================================
 
  Do you want to install the product: ELP Config-Reader Monitoring? [y|n|q] y
Installing the product: ELP Config-Reader Monitoring
  
 

Checking disk space...
Processing package instance <SUNWescci> from </var/tmp/<temp-directory>/disk2/image/Addons/CommonConfigReader/Common/Basic>
SunMC Common Config Reader Module Initialization
 
<truncated>
/opt/SUNWsymon/classes/base/console/cfg/topoimages/V240-small.gif
/opt/SUNWsymon/classes/base/console/cfg/topoimages/V240-xlarge.gif
[ verifying class <none> ]
 
Installation of <SUNWescps> was successful.
 
 
Do you want to run setup now? [y|n|q] y
 
 
-----------------------------------
Sun Management Center Setup Program
-----------------------------------
 
This program does setup of Sun Management Center components that are installed on your system.
 
Checking for Sun Management Center components installed on your system.
 
<truncated>
Configuring the system for setup, please wait.
The Sun Management Center base URL is relative to the Sun Management Center Console.
The Sun Management Center Console is able to request help documentation via the network.
If you have installed Sun Management Center help documentation in an http-accessible
location within your network, you may specify this location.
If Sun Management Center help is installed on the console host, simply accept the default value.
Please enter base URL to Sun Management Center help [local]: 
 
The base URL has been set to file:/opt/SUNWsymon/lib/locale
------------------------------------------------------------------------------
Starting Sun Management Center Entry Level Platform Config Reader Server Setup
 
------------------------------------------------------------------------------
 
For seting up Sun Fire (6800/4810/4800/3800) platform administration module
you need to provide SC IP address, community strings, port numbers for domain agent etc.
 


Do you want to setup Sun Fire (6800/4810/4800/3800) platform administration 
module [y|n|q] n
 
Sun Management Center setup complete.
 
Do you want to preserve your existing data [y|n|q] y
 
Please wait, Sun Management Center database setup in progress. It may take 15 to 20 minutes
Do you want to start Sun Management Center agent and server components now [y|n|q] y
 
Log file: /var/opt/SUNWsymon/install/install.030317133530.26312
 
                        End of Installation
#

  

7. When the installation is complete, you can delete the downloaded file from the temporary directory you created at Step 4, then delete the directory itself.


procedure icon  To Uninstall the Existing Localization Packages

1. Check that the localization packages listed in TABLE 2-6 are installed on the Sun Management Center Server.

TABLE 2-6 Sun Management Center Server Localization Packages

Package

Name

SUNWcsccs

Simplified Chinese Sun Management Center Common Config Reader Module Core Component

SUNWfsccs

French Sun Management Center Common Config Reader Module Core Component

SUNWjsccs

Japanese Sun Management Center Common Config Reader Module Core Component

SUNWhsccs

Traditional Chinese Sun Management Center Common Config Reader Module Core Component

SUNWksccs

Korean Sun Management Center Common Config Reader Module Core Component


# pkginfo SUNWcsccs SUNWfsccs SUNWjsccs SUNWhsccs SUNWksccs

 

2. Remove the packages from the Sun Management Center server using the pkgrm command.

# pkgrm SUNWcsccs SUNWfsccs SUNWjsccs SUNWhsccs SUNWksccs


procedure icon  To Install the New Localization Packages

To install the localized packages, perform the following steps after installation of the the English Sun Management Center 3.0 software and the English version of the packages.

1. Change to the current directory to /var/tmp/<temp-directory>/disk2/localization.

# cd /var/tmp/<temp-directory>/disk2/localization

2. Execute the command es-inst-l10n to install the localization packages.

# ./es-inst-l10n


1 (TableFootnote) Ensure that you have the latest patch for this software. The Sun Management Center patch procedure requires that you run es-inst, install the patch, then run es-setup. For further details, refer to the Sun Management Center 3.0 documentation.
2 (TableFootnote) The Solaris operating environment is dependent on the supported platform. Refer to the platform
documentation for details of the Solaris version(s) supported by your platform.