Installation Requirements

Table 2-1 lists the required disk space for each of the packages and the system on which the packages should be installed.

Table 2-1

Package	Package Name	Description	Install On	Disk Space
Server Subsystem	SUNWsys SUNWsyrt	Server subsystem package Runtime package	Monitored server	~ 1.15 Mbytes ~ 0.30 Mbytes
Event Manager	SUNWsye SUNWsyrt	Event Generator package Runtime package	Any SPARC system other than the monitored server	~ 1.26 Mbytes ~ 0.30 Mbytes
GUI	SUNWsyu SUNWsyua	GUI subsystem package Images for Ultra Enterprise 3000, 4000,	Desktop SPARC system	~ 4.06 Mbytes ~ 9.81 Mbytes
	SUNWsyub	5000, and 6000 servers Images for the SPARCserver 1000(E) and		~1.65 Mbytes
	SUNWsyuc	SPARCcenter 2000(E) Images for the Ultra Enterprise 2 and		~ 4.57 Mbytes
	SUNWsyrt	Ultra Enterprise 150 Runtime package		~ 0.30 Mbytes
man Pages	SUNWsym	Man pages	Any SPARC system	~ 0.03 Mbytes
SunVTS Online Diagnostics	SUNWsyc	Standalone configuration reader; prerequisite for SunVTS Online Diagnostics	Monitored server	~ 0.29 Mbytes
	SUNWodu	SunVTS Online Diagnostic utility	Monitored server	~ 1.6 Mbytes
	SUNWvts	SunVTS kernel GUI, and tests	Monitored server	~ 23.0 Mbytes

---

Note - The SUNWsyrt package is required on the Server Subsystem, Event Manager, and GUI configurations.

---

Only one instance of the Server Subsystem and the Event Manager operate on a given server. However, you can have many instances of the GUI subsystem on different systems to monitor one server.

Installing the Software

Installing Solstice SyMON requires these steps:

1. Mounting the Updates CD

2. Saving any user-customized Solstice SyMON event rules and removing Solstice SyMON 1.0 or 1.1 and all previously installed packages (if upgrading from a previous release).

3. Installing the packages

4. Setting up your environment

5. Configuring the software

6. Starting agents

Installing Solstice SyMON from the Updates CD

The Solstice SyMON software is located on the SMCC Updates CD. You need to mount the SMCC Updates CD so you can retrieve the Solstice SyMON 1.3 software from the SMCC Updates CD.

Mounting the CD

Follow the procedure "To Mount the Locally Connected CD-ROM" or "To Mount the Remotely Connected CD-ROM."

· To Mount the Locally Connected CD-ROM

1. Become superuser and create the /cdrom directory (if one doesn't exist).

2. Place the SMCC Updates CD in the CD-ROM drive and close the drive door.

   If Volume Manager is running the CD is mounted and the path is: /cdrom/upd_sol_2_5_1_hw497_smcc/SMCC.

   If Volume Manager is not running complete Step 3, mounting the /cdrom directory manually.

3. Mount the CD manually by typing:

# mount -r -F hsfs /dev/dsk/c0t6d0s0 /cdrom

· To Mount the Remotely Connected CD-ROM

1. Export the /cdrom directory from the server:

   a. Edit the /etc/dfs/dfstab file by adding the following line at the end of the /etc/dfs/dfstab file:

share -F nfs -o ro /cdrom/upd_sol_2_5_1_hw497_smcc/SMCC

where: /cdrom/upd_sol_2_5_1_hw497 is the CD-ROM directory

b. Start NFS and the mount daemon:

# /usr/lib/nfs/nfsd -a 16 # /usr/lib/nfs/mountd

c. Export the /cdrom file system:

# shareall

2. Mount the /cdrom directory from the server.

• If automountd is running, type:

# cd /net/server_hostname/cdrom/upd_sol_2_5_1_hw497_smcc/SMCC

• If automountd is not running, type:

# mkdir /cdrom # mount server_hostname:/cdrom /cdrom # cd /cdrom/upd_sol_2_5_1_hw497_smcc/SMCC

Installing Packages

---

Note - The packages you install for the Server Subsystem, Event Manager, and GUI subsystem are dependent on SUNWsyrt, the SyMON Runtime Library package, and SUNWdtbase, the CDE-base package. Ignore warning messages if you do not install the SUNWsyrt package first.

---

Updating Solstice SyMON from a Previous Release

Before you can install the Solstice SyMON 1.3 packages, you must completely remove the currently installed Solstice SyMON configuration and remove the previously installed packages.

· To Save Customized Rules Files and Remove Solstice SyMON

1. Save any customized rules files.

   Some older Solstice SyMON rules and Solstice SyMON 1.3 rules are incompatible.

2. Completely remove the currently installed Solstice SyMON configuration by typing as superuser:

# /opt/SUNWsymon/sbin/sm_confsymon -D

3. Install Solstice SyMON 1.3 by following the procedures that follow.

   The first step in each procedure describes how to remove the existing packages.

Identifying Previously Installed Packages with pkginfo

Before removing all previously installed packages, you must identify which previously installed packages are installed on each system with the pkginfo command. For example:

# pkginfo SUNWsyrt

If the SUNWsyrt package is installed, the following is displayed:

application scripts SUNWsyrt Solstice SyMON Runtime library and Tcl

If the SUNWsyrt package is not installed, the following is displayed:

ERROR: information for "SUNWsyrt" was not found

Use pkginfo to identify the remaining previously installed packages.

· To Install the Server Packages

1. If you are upgrading from a previous release, remove the existing

   SUNWsys and SUNWsyrt packages on the monitored server by typing the following as superuser:

# /usr/sbin/pkgrm SUNWsys SUNWsyrt

a. Answer yes to all questions.

2. Go to the installation directory on the monitored server:

# cd dirname

where:

dirname is the directory where the Solstice SyMON packages are located

3. Add the SUNWsyrt and SUNWsys packages:

# /usr/sbin/pkgadd -d source_directory SUNWsyrt SUNWsys

where:

source_directory is the full path name of the directory where the packages you want to add are located. You can also use 'pwd' for the source_directory.

· To Install SunVTS for Online Diagnostics

1. Install the SUNWsyc package, which is a prerequisite for SunVTS, on the monitored system by typing:

# /usr/sbin/pkgadd -d source_directory SUNWsyc

where:

source_directory is the full path name of the directory where the packages you want to add are located. You can also use 'pwd' for the source_directory.

---

Note - You also need to install the SunVTS Online Diagnostics packages which are SUNWvts and SUNWodu. Refer to Chapter 4 in the section on SunVTS installation of the SMCC SPARC Hardware Platform Guide, shipped in the Solaris 2.5.1 Hardware: 4/97 carton.

---

· To Install the Event Generator Packages

---

Note - If you are installing both the Event Generator and the User GUI subsystem packages on the same system, install SUNWsyrt only one time.

---

1. If you are upgrading from a previous release, remove the existing Solstice SyMON Event Generator software from your desktop system (or on any other system other than the server) (by typing:

# /usr/sbin/pkgrm SUNWsye SUNWsyrt

2. Install the Event Generator packages on your desktop system (or on any other system other than the server) by typing:

# /usr/sbin/pkgadd -d source_directory SUNWsyrt SUNWsye

where:

source_directory is the full path name of the directory where the packages you want to add are located.

· To Install the GUI Subsystem Packages

---

Note - If you are installing the Event Generator and User GUI Subsystem packages on the same system, do not remove SUNWsyrt (see Step 1, which follows) since you previously installed SUNWsyrt in Step 2 of the previous procedure.

---

1. If you are upgrading from a previous release, remove the existing

   SUNWsyu and SUNWsyrt packages from the desktop system by typing:

# /usr/sbin/pkgrm SUNWsyu SUNWsyrt

2. Install the GUI subsystem packages on the desktop system by typing:

# /usr/sbin/pkgadd -d source_directory SUNWsyrt SUNWsyu [SUNWsyua SUNWsyub SUNWsyuc]

where:

• source_directory is the full directory path name where the packages are located
• SUNWsyua contains images for the Ultra Enterprise 3000, 4000, 5000, and 6000 systems
• SUNWsyub contains the images for the SPARCserver 1000(E) and SPARCcenter 2000(E)
• SUNWsyuc contains the images for the Ultra Enterprise 2 and 150

Installing the man Pages

You can install the man pages in two ways:

• Without using the Windex database for man pages
• Using the Windex database for man pages

Review the following information before deciding which method to use.

The Windex database is generated with the catman command. The Windex man page database is used by the man -k and apropos commands. For example, if you need to know every man page that mentions disk, you would type man -k disk. You can also use the apropos command. For example, typing apropos logout returns man pages related to logout.

Use pkgadd to install the Windex database of man pages. The catman command indexes the Windex database.

· To install the man pages if you do not have a Windex database for man pages

1. If you are upgrading from a previous release, remove the existing

   SUNWsym package by typing:

# /usr/sbin/pkgrm SUNWsym

2. Add the new man page package by typing:

# /usr/sbin/pkgadd -d source_directory SUNWsym

where:

source_directory is the full path name of the directory where the packages you want to add are located.

· To install the man pages if you have a Windex database for the man pages

1. If you are upgrading from a previous release, remove the existing

   SUNWsym packages and the Windex database by typing:

# /usr/sbin/pkgrm SUNWsym # rm /opt/SUNWsymon/man/Windex

2. Add the new man page package by typing:

# /usr/sbin/pkgadd -d source_directory SUNWsym

where:

source_directory is the full path name of the directory where the packages are located that you want to add.

3. Create the new Windex database by typing:

# catman -w M /opt/SUNWsymon/man

Setting Up Your Environment

You can set up your environment for the GUI using the Bourne, Korn, or C shells as follows.

· To Set Up the Environment for the GUI

• For Bourne and Korn shells

1. Add the following lines to the .profile file:

SYMONHOME=/opt/SUNWsymon PATH=$SYMONHOME/bin:/opt/SUNWvts/bin:$PATH MANPATH=$SYMONHOME/man:$MANPATH LD_LIBRARY_PATH=$SYMONHOME/lib:$LD_LIBRARY_PATH export SYMONHOME export PATH export MANPATH export LD_LIBRARY_PATH

---

Note - If the software is not installed in /opt/SUNWsymon, replace the /opt/SUNWsymon path with the path you used to install the software in the line beginning with SYMONHOME.

---

2. Make the previous setup parameters effective by logging out and then logging in.

• For the C Shell

1. Add the following lines to the .cshrc file:

setenv SYMONHOME /opt/SUNWsymon set path= $SYMONHOME/bin /opt/SUNWvts/bin $path setenv MANPATH $SYMONHOME/man:$MANPATH setenv LD_LIBRARY_PATH $SYMONHOME/lib:$LD_LIBRARY_PATH

---

Note - If the software is not installed in /opt/SUNWsymon, replace the /opt/SUNWsymon path with the path you used to install the software in the line beginning with setenv.

---

2. Make the previous setup parameters effective by typing:

# source .cshrc # rehash

Configuring Solstice SyMON

Before you can run Solstice SyMON in your environment, you must configure the host and the Event Generator host (Event Host). For example, if you have two systems, server A and a desktop system B, and you want desktop system B to monitor server A, a diagram of the monitoring configuration would look something similar to Figure 2-1.

Figure 2-1

· To Configure the Host

1. Type the following on server A:

# /opt/SUNWsymon/sbin/sm_confsymon -s EventMonitor_host

where:

EventMonitor_host is the host that monitors this server, which is Server A in this example.

· To Configure the Event Generator

1. Invoke the uname -i command on server A. This command returns the platform name of the system. Use the platform name (for example SUNW,Ultra-Enterprise) as an argument to the sm_confsymon -e command.

---

Note - If the uname -i command returns SUNW,Ultra-1 this platform name is for the Ultra Enterprise 150, which is supported by Solstice SyMON. The same platform name is used for the Ultra Enterprise 1 system, which is not supported by Solstice SyMON.

Also, the uname -i command returns SUNW,Ultra 2 for both the Ultra Enterprise 2 server, which is supported by Solstice SyMON and the Ultra Enterprise 2 workstation, which is not supported by Solstice SyMON.

---

2. Type the following on the Event Host:

# /opt/SUNWsymon/sbin/sm_confsymon -e agent_host -P platformname

where:

• agent_host is the host name of the server running the Server Subsystem, which is Server A in this example.
• platformname (SUNW,Ultra-Enterprise in this example) is the platform type returned by the uname -i command.

Starting Solstice SyMON

This section describes how to start running Solstice SyMON. The Server Subsystem and the Event Manager start automatically after you reboot your system. To start the server subsystem without rebooting, follow the next procedure, "To Start Solstice SyMON without Rebooting."

· To Start Solstice SyMON without Rebooting

---

Note - You can also use the -v flag (verbose installation) with the sm_confsymon command. The system echoes all actions and requests permission to continue when you use the -v flag.

---

1. Start Solstice SyMON on the Server Subsystem host by typing:

# /opt/SUNWsymon/sbin/sm_control start

2. Start the Event Generator on the Event Generator machine by typing:

# /opt/SUNWsymon/sbin/sm_control start

3. Run the GUI from your desktop as a regular user by typing:

CTRL-d (to become a regular user) % rehash % /opt/SUNWsymon/bin/symon -t target_system &

where:

target_system is the name of the server running the monitor agents.

Solstice SyMON also recognizes command line options (see Chapter 5, "Command Line Options)." For example, in the previous screen, the -t option refers to the target system to monitor.

Exiting the GUI

This section describes how to exit the GUI. Exiting the GUI shuts down the GUI but does not shut down the software application, which continues to monitor the server.

· To Exit the GUI

The Launcher window contains a File menu that includes an Exit button.

* Close the current window and all other windows by clicking the Yes button to the exit inquiry.

If you need to view the information that the software has collected about the server, restart the GUI.

Shutting Down Solstice SyMON

---

Note - Normally, the agents and the Event Generator should run continuously, even if GUIs are not attached. Running them continuously monitors the server for events and gathers historical data.

---

· To Shut Down Solstice SyMON

* As superuser, type the following command on the server or the Event Host:

# /opt/SUNWsymon/sbin/sm_control stop

Removing Solstice SyMON

---

Caution - SUNWsyrt is the runtime library. Remove SUNWsyrt only if all the SyMON packages are removed from that machine.

---

· To Remove Solstice SyMON

---

Caution - If the Event Generator is also installed on this machine and you want to continue running the Event Generator on this machine, do not remove the SUNWsyrt package.

---

Table 2-2

If you remove	The following is removed
SUNWsye package	Event Generator binaries and data
SUNWsyrt package	Runtime library
SUNWsys package	Server binaries and executables
SUNWsyu package	GUI binaries and executable

Table 2-2

If you remove	The following is removed
SUNWsym package	Man pages
SUNWsyua package	(TM)...(TM) Images for the Ultra Enterprise 3000, 4000, 5000, and 6000
SUNWsyub package	(TM) Images for the SPARCserver 1000/E and (TM) SPARCcenter 2000/E
SUNWsyuc package	Images for the Ultra Enterprise 2 and 150
SUNWsyc package	Standalone configuration reader (prerequisite for SunVTS)
SUNWvts package	SunVTS kernel, test suite, and utilities
SUNWodu package	SunVTS Online Diagnostic utilities

1. Remove the Server Subsystem and runtime library on the Server Subsystem host by typing:

# /usr/sbin/pkgrm SUNWsys SUNWsyrt SUNWsyc

2. Remove the Event Manager and runtime library on a desktop system or any system except for the server host by typing:

# /usr/sbin/pkgrm SUNWsye SUNWsyrt

3. Remove the GUI and runtime library on the desktop system by typing:

# /usr/sbin/pkgrm SUNWsyu [SUNWsyua SUNWsyub SUNWsyuc] SUNWsyrt

4. Remove the man pages.

• If you do not have the Windex database of man pages, type:

# /usr/sbin/pkgrm SUNWsym

• If you have the Windex database of man pages, type:

# /usr/sbin/pkgrm SUNWsym # rm /opt/SUNWsymon/man/Windex

Troubleshooting

If you have problems installing Solstice SyMON, see Chapter 6, "Troubleshooting."

Installing and Setting Up SNMP Traps

To install and set up SNMP traps, see Appendix C, "Installing SNMP Traps." A SNMP trap is an asynchronous message directed at a specific monitor.