C H A P T E R 2

Installation

This chapter describes how to install the management software.

The chapter contains the following sections:

System Requirements

Installation Packages

Effects on System Files

Installing the SNMP Software

Starting the SNMP Agent

System Requirements

Before installing SNMP Management Agent, ensure that your system complies with the prerequisites and dependencies discussed in this section.

Operating System (Solaris OS) Requirements

Refer to the system manuals for your platform for Solaris operating system requirements. See Related Documentation of the Preface.

Disk Space Requirements

At least 10 Mbytes must be available on the server.

Patches

The following patches must be installed in addition to the standard Solaris Operating System software:

Writers note: Bryan...are there any required patches?

Installation and Additional Required Packages

Installation packages (TABLE 2-1) are supplied in the tar archive bundle SUNWmasf.<ver>.tar.Z, where <ver> is the version number. At the time of publication of this document, the version is 1.4 Update 2. Always use the latest version of this file for installation.

Additional required packages (TABLE 2-2) are available from the Solaris 10 Operating System DVD, under:

/cdrom/cdrom0/s0/Solaris_10/Product

These additional packages, as well as the packages listed in the following note, must be installed to enable support of the SNMP Management Agent.

Note - TABLE 2-1 lists all packages contained in the tar archive bundle. However, the Sun Fire V1280, E2900, and Netra 1280 and 1290 servers require only the SUNWmasf and SUNWmasfr packages.

Installation Packages

TABLE 2-1 SNMP Management Agent Software Installation Package Descriptions
Package	Package Name	Function
`SUNWescdl`	Common Config Reader DAQ Library	Framework for providing configuration information
`SUNWescpl`	Common Config Reader Sun Fire V210/V240 and Netra 210 platform support	Configuration reader platform support for the Sun Fire V210,V215,V240,V245 and Netra 210
`SUNWescfl`	Common Config Reader Sun Fire V250 platform support	Configuration reader platform support for the Sun Fire V250
`SUNWeschl`	Common Config Reader Sun Fire V440 platform support	Configuration reader platform support for the Sun Fire V440/V445
`SUNWescnl`	Common Config Reader Netra 440 platform support	Configuration reader platform support for the Netra 440/V445
`SUNWmasf`	Sun SNMP Management Agent for Sun Fire and Netra systems	SNMP Agent common components
`SUNWmasfr`	Sun SNMP Management agent for Sun Fire and Netra systems (root)	Startup and configuration scripts for the SNMP agent

Additional Required Packages

Note - The packages listed in TABLE 2-2 must be installedto enable support of the SNMP Mangement Agent.

TABLE 2-2 SNMP Management Agent Additional Required Software Packages
Package	Package Name
SUNWfruid	FRU ID Utility and Library (Usr)
SUNWfruip	FRU ID Platform Modules (Usr)
SUNWmfrun	Motif RunTime Kit
SUNWpiclh	PICL Header Files (Usr)
SUNWpiclr	PICL Framework (Root)
SUNWpiclu	PICL Libraries, and Plugin Modules (Usr)

To upgrade the software, you must remove the existing software before reinstalling the new version (see Chapter 5).

Effects on System Files

A new startup file is created in /etc/init.d, as shown in TABLE 2-3, with links to /etc/rc<n>.d..

TABLE 2-3 Startup Script
Component	Startup Script	Package Name	Package Description
Agent	`masfd`	`SUNWmasfr`	Configuration and startup script for SNMP agent

After installation, the following MIBs, supported by the agent, are located in the directory /opt/SUNWmasf/lib/mibs:

TABLE 2-4 MIB Files
MIB	Function
`ENTITY-MIB.txt`	Describes physical and logical entities
`RFC1155-SMI.txt`	Defines additional object types used by other MIBS
`RFC1213-MIB.txt`	Models network interfaces (note, this agent only supports system part)
`SUN-PLATFORM-MIB.txt`	Extends the Entity MIB to provide additional information about hardware components

Installing the SNMP Software

This section describes the procedure for installing the monitoring software.

Before installing the software, ensure that:

You have the requisite level of Solaris installed on both the domain or target and the platform agent server (see Operating System (Solaris OS) Requirements).

You have installed all the necessary patches (see Patches) and any additional essential packages (TABLE 2-2) not supplied as part of the SNMP software,.

When you are certain that your system meets all these requirements, you can proceed to install the SNMP software.

To Install the SNMP Agent

1. Unpack the tar file by typing:

$ zcat SUNWmasf.<ver>.tar.Z | tar xf -

2. Ensure you are the root user before proceeding with installation.

3. Change to the directory where the tar file was extracted (at the root of the packages provided by the tar file).

If you wish to start installation from a different directory, when using pkgadd you must specify the path of the root of the directory hierarchy where the files where extracted using the -d option (rather than -d . as shown in step 4).

Caution - If you have installed Sun trademark Management Center on your monitored platform, skip to Step 5.

4. Install the support for platform instrumentation:

For the Sun Fire V1280, E2900 and Netra 1280 and 1290 servers, skip to Step 5.

To install the Sun Fire V210/V215/V240/V245 and Netra 210/240 instrumentation, type:

# pkgadd -d . SUNWescdl SUNWescpl

To install the Sun Fire V250 instrumentation, type:

# pkgadd -d . SUNWescdl SUNWescfl

To install the Sun Fire V440 instrumentation, type:

# pkgadd -d . SUNWescdl SUNWeschl

To install the Netra 440 instrumentation, type:

# pkgadd -d . SUNWescdl SUNWescnl

5. Install the SNMP agent by typing:

# pkgadd -d . SUNWmasf SUNWmasfr

After installation, the agent must be configured before you attempt to start it. A full description of the configuration options for the SNMP agent is provided in Chapter 3.

Before using the agent, you must assign it a network port to use. In deciding which network port to use, consider:

Whether other SNMP agents may be installed on the system

Where management application(s) may attempt to discover SNMP agents

The conventional port for SNMP access is port 161 for data. By default, the Solaris snmpdx daemon uses this port. You must make sure that this port is available for use by other agents, such as snmpdx and Sun Management Center, by using a port other than 161 for SNMP access to the agent provided by this product.

Configure the SNMP agent using the /etc/opt/SUNWmasf/conf/snmpd.conf file. To set the port number, add a line to the file in the form:

agentaddress     9161

This enables the agent to communicate on the port 9161. Make sure that the port you select is not currently in use by another application. If you are using SNMPv1 or SNMPv2c, no further configuration is required unless you wish to use traps, in which case you must specify the trap destinations. See Chapter 3 for more information.

Starting the SNMP Agent

Type:

# /etc/init.d/masfd start

You can confirm that the agent is correctly running by typing:

# ps -ef |  fgrep snmpd

You should see a line of the form:

root 29394  1 0 Feb 18 ?  4:11 /opt/SUNWmasf/sbin/snmpd

If you do not see this output, review the /var/adm/messages logfile to locate any error messages from the agent. For more information on troubleshooting, see Chapter 4.

On subsequent reboots the agent starts automatically without any user intervention.