System Installation Requirements

You must install these software packages from the CD as defined in Table 2-1.

Table 2-1

Package	Package File Name	Installed On	Disk Space
Server Subsystem	SUNWsys SUNWsyrt	Monitored server	~ 1.3 MBytes ~ < 1.0 Mbyte
Event Handler	SUNWsye SUNWsyrt	Another system	~ 1.3 MBytes ~ < 1.0 MByte
GUI	SUNWsyu SUNWsyrt	Users desktop system	~ 11.8 MBytes ~ < 1.0 MByte
man Pages	SUNWsym	Any system	~ <1.0 MByte

Follow these rules when installing the Solstice SyMON software:

• Install only one instance of the Event Handler per Server Subsystem.
• Install only one instance of the Server Subsystem per server.
• Install many instances of the GUI Subsystems per Server Subsystem.

Installing the Software

Determine if you are installing the software from the CD-ROM or from a remote CD-ROM, by determining if the machine on which you are doing the installation on has a CD-ROM.

There are three parts to installing Solstice SyMON:

1. Install the Server Subsystem packages.

2. Install the Event Handler packages.

3. Install the GUI Subsystem packages.

Installing From CD-ROM

Mount the CD with Volume Manager or with the mount command and install Solstice SyMON on the host.

· To Mount the CD with Volume Manager

1. Become superuser and create the /cdrom directory.

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

   The CD is now mounted.

· To Mount the CD with the mount command

1. Become superuser and create the /cdrom directory.

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

3. Mount the CD-ROM by typing:

# mount -r -F hsfs /dev/sr0 /cdrom

Installing the Server Subsystem

A general README file regarding the contents of the CD is located in the /cdrom/sup_sol_2_5_1_smcc directory. A README file for Solstice SyMON is located in the /cdrom/sup_sol_2_5_1_smcc/SMCC/Docs directory. This README file has detailed information about installing, de-installing, and activating Solstice SyMON subsystems.

---

Note - The SUNWsye, SUNWsyu, and SUNWsys packages depend on SUNWsyrt, the Solstice SyMON runtime library, and SUNWdtbase, the CDE-base package. If you do not install SUNWsyrt first or if you do not plan to run Solstice SyMON under the CDE environment, ignore the warning messages.

---

· To Locate the Install Directory

1. Go to the install directory:

# cd /cdrom/sup_sol_2_5_1_smcc

2. Add the packages:

# pkgadd -d 'pwd' SUNWsyrt SUNWsys

Installing the Event Handler

Install the Event Handler anywhere (except on the Server Subsystem host). The following example shows how to install the Event Handler on a desktop machine.

---

Note - If you don't have a CD-ROM drive on the Event Handler machine, then you need to export /cdrom from another server to continue the software installation (see Steps 1, 2, and 3 below.) Otherwise, mount the CD as you did on the Server Subsystem machine.

---

· To Install the Event Handler

1. Export the /cdrom directory from the host by performing these steps:

   a. Add the following line at the end of the /etc/dfs/dfstab file:

share -F nfs -o ro /cdrom

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 on the desktop machine by performing these steps on the desktop machine:

• If the automounter is running, type:

# cd /net/server_hostname/cdrom/sup_sol_2_5_1_smcc/SMCC

• If the automounter is not running, type:

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

3. To install the Event Handler packages, type the following on the desktop machine:

# pkgadd -d 'pwd' SUNWsyrt SUNWsye

---

Note - If you are installing both the Event Handler and the GUI Subsystem on the same system, you only need to install SUNWsyrt once.

---

Installing the GUI Subsystem

You can install the GUI Subsystem on any machine. The example below shows how it is installed on a desktop machine.

---

Note - If you don't have a CD-ROM drive on the GUI Subsystem machine, then you need to export /cdrom from another server to continue the software installation (see steps 1, 2, and 3 below.) Otherwise, mount the CD as you did on the Server Subsystem machine.

---

· To Install the GUI

1. Export the /cdrom directory from the server.

   a. On the host, add the following line at the end of the

   /etc/dfs/dfstab file:

# share -F nfs -o ro -d /cdrom/sup_sol_2_5_1_smcc

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 host on the desktop machine.

• If the automounter is running, type:

# cd /net/serve hostname/cdrom/sup_sol_2_5_1_smcc/SMCC

• If the automounter is not running, type:

# mkdir /cdrom # mount server_ hostname:/cdrom /cdrom # cd /cdrom # cd /cdrom/sup_sol_2_5_1_smcc/SMCC

3. Install the GUI Subsystem packages by typing:

# pkgadd -d 'pwd' SUNWsyrt SUNWsyu

---

Note - If the CDE packages are not installed, pkgadd will warn you that the SUNWdtbas and SUNWmfrun packages are missing. Respond yes to both of the warnings.

---

Installing the man Pages

· To Install the man Pages

* If you do not have a Windex database for the man pages, become superuser and enter:

# pkgadd -d 'pwd' SUNWsym

* If you have a Windex database for the man pages, enter:

# catman -w M /opt/SUNWsymon/man

Configuring Solstice SyMON

You must configure Solstice SyMON before you can run it in your environment. This process is explained in the sections that follow.

· To Configure the Host

* Configure the host by entering:

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

where EventHandler_host is the host the Event Handler is installed on.

· To Configure the Event Handler

* Become superuser and type:

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

where agent_host is the host name of the server running the Server Subsystem.

Setting Up the User Environment

· To Configure the GUI

Bourne and Korn Shells

• Add the following to .profile:

PATH=symon_home/bin:$PATH MANPATH=symon_home/man=$MANPATH export PATH export MANPATH

symon_home is the full path name to the installation directory, typically /opt/SUNWsymon.

• If Solstice SyMON was installed in a directory other than

  /opt/SUNWsymon, add the following to .profile:

SYMONHOME=symon_home LD_LIBRARY_PATH=symon_home/lib:$LD_LIBRARY_PATH export SYMONHOME export LD_LIBRARY_PATH

• If the CDE packages are not installed, add the following to .profile:

export LD_LIBRARY_PATH LD_LIBRARY_PATH=symon_home/lib:$LD_LIBRARY_PATH

• To make the previous setup parameters effective, log out and then log in.

C Shell

• Add the following to .login:

set path = ( symon_home/bin $path ) setenv MANPATH symon_home/man:$MANPATH

symon_home is the full path name to the installation directory, typically /opt/SUNWsymon.

• If Solstice SyMON was installed in a directory other than

  /opt/SUNWsymon, add the following to .login:

setenv SYMONHOME symon_home setenv LD_LIBRARY_PATH symon_home/lib:$LD_LIBRARY_PATH

• If the CDE packages are not installed, add the following to .login:

setenv LD_LIBRARY_PATH symon_home/lib:$LD_LIBRARY_PATH

• To make the previous setup parameters effective, type rehash at the

  % prompt.

Starting Solstice SyMON

The following section describes how to start Solstice SyMON.

Starting the Server Subsystem

The Solstice SyMON Server Subsystem and the Event Handler start automatically after you reboot your system.

· To Start the Solstice SyMON Server Subsystem without rebooting

1. Enter as the following as superuser on the Server Subsystem host:

# /opt/SUNWsymon/sbin/sm_control start

2. Start the Solstice SyMON Event Handler on the Event Handler machine, and enter the following as superuser:

# /opt/SUNWsymon/sbin/sm_control start

· To start the Solstice SyMON Launcher

* Enter the following:

rehash /opt/SUNWsymon/bin/symon -t agent_host

where agent_host is the host name of a server running the Solstice SyMON monitor agents.

Refer to the symon man page for a complete description. The symon command has a number of options and configurations.

Stopping Solstice SyMON

You can stop Solstice SyMON by following the procedures described below.

* Enter the following as superuser to stop the Solstice SyMON Server Subsystem:

# /opt/SUNWsymon/sbin/sm_control stop

This stops Solstice SyMON Server Subsystem. You must also stop the Solstice SyMON Event Handler on the Event Handler machine.

* Enter the following as superuser to stop the Event Handler on the Event Handler host:

# /opt/SUNWsymon/sbin/sm_control stop

Exiting the GUI

The Launcher window contains a File menu that includes an Exit button. After responding "yes" to the exit inquiry, the current window and all other Solstice SyMON windows are closed.

Removing the Software

---

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

---

You can remove the Solstice SyMON software as described in the sections that follow. You must be superuser to remove the software.

* To Remove the Server Subsystem, enter

# pkgrm SUNWsys SUNWsyrt

Removing the SUNWsys package removes the server binaries and executables. Removing the SUNWsyrt package removes the runtime library.

* To Remove the Event Handler, enter

# pkgrm SUNWsye SUNWsyrt

---

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

---

Removing the SUNWsye package removes the Event Handler binaries and data. Removing the SUNWsyrt package removes the runtime library.

* To Remove the GUI, enter

# pkgrm SUNWsyu SUNWsyrt

Removing the SUNWsyu package removes the binaries and executables. Removing the SUNWsyrt package removes the runtime library.

---

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

---

* To Remove the man pages

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

# pkgrm SUNWsym

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

# pkgrm SUNWsym # rm /opt/SUNWsymon/man/windex

Installing and Setting Up SNMP Traps

The Event Handler can send SNMP traps to applications that listen for SNMP traps, such as SunNet Manager. Traps include information about events occurring on the system that may be useful to someone running a SunNet Manager console. An SNMP trap is an asynchronous message directed at a specific monitor.

To install SNMP version 2.2.3 packages on the machine named "snmphost," refer to the SNMP installation menu.

1. On the machine snmphost, copy the following three files in the

   /opt/SUNWsymon/etc/snm directory on the event host to the /opt/SUNWconn/agents directory as superuser. This is the default SNMP directory.

· symon.mib.oid
· symon.mib.traps
· symon.mib.schema

2. Run the following command on the event host:

# sm_confsymon -e server_host -S "list"

where -S "list" indicates a space-separated list of hosts to receive the SNMP traps.

3. Start the Event Handler daemon by entering:

# /opt/SUNWsymon/sbin/cm_control start

4. Run snm -i and select BasicStart.

   Wait for the SNMP Console to come up from the main menu.

5. Select Edit-->Create. Make sure your "Category" is Component and select your "Type" to be WorkStation; click the Create button.

6. A Create Form pop-up window appears; type the following:

• Name: snmp_hostname
• IP address: snmp_hostname's IP address
• SNMP Rdcommunity: public
• SNMP Wrcommunity: public

7. Select the SYMONMIB check button then click Apply.

8. Select the workstation icon you just created and from the main menu, select View-->Event/Trap Report.

9. Type the following on the event host:

/opt/SUNWsymon/sbin/trapsend -a "1.3.6.1.4.1.42 STRING (STATUS | FAIL)"

If you receive the message above in double quotes in your Event/Trap Report, you are ready to receive SNMP traps from the server.

Setting Up SNMP Hosts

Use the following command to set up SNMP hosts:

/opt/SUNWsymon/sbin/sm_confsymon -e server_host -S "list_of_snmphost"