Preface

---

Solstice^(TM) SyMON^(TM) is a system monitoring tool that collects various system information and displays it through a graphical user interface (GUI). This manual, which explains how to install and use Solstice SyMON, also describes how to modify the rules used to monitor the server. It also explains how to customize Solstice SyMON.

---

How This Book Is Organized

This manual is divided into six chapters and four appendixes:

Chapter 1 "Solstice SyMON Overview," provides an overview of the features and architecture.

Chapter 2 "Installing Solstice SyMON," describes how to install the software.

Chapter 3 "Using the Solstice SyMON Consoles," provides instructions on how to use the consoles.

Chapter 4 "Understanding and Writing Event Rules," explains how to modify event rules to meet specific monitoring needs. This chapter describes the basic Tcl commands and gives examples of event rules.

Chapter 5 "Command Line Options," describes the options you can invoke on the command line.

Chapter 6 "Troubleshooting," describes troubleshooting tips.

Appendix A "Kernel Reader," provides a summary of the Kernel Reader data hierarchy.

Appendix B "Config Reader," provides a summary of the Configuration Reader data hierarchy.

Appendix C "Installing and Setting Up SNMP Traps," describes how to install and set up SNMP traps.

Appendix D "Default Solstice SyMON Rules," describes the default Solstice SyMON rules.

---

Related Documents

Refer to the following documents for more information on the Tcl scripting language and Sun system performance tuning:

• Tcl and the Tk Toolkit, John K. Ousterhout, Addison-Wesley Publishing Company, 1994.
• Practical Programming in Tcl and Tk, Brent B. Welch, Prentice Hall, 1995.
• Reference card on Tcl, available from Specialized Systems Consultants, Inc., P.O. Box 55549, Seattle WA, 98155-0549, USA.
• Sun Performance and Tuning, Adrian Cockcroft, SunSoft Press, 1995.
• X Window System User's Guide, Motif Edition (Volume 3), O'Reilly and Associates, 1993.

---

Typographic Conventions

TABLE P-1

Typeface or Symbol	Meaning	Examples
AaBbCc123	The names of commands, files, and directories; on-screen computer output.	Edit your .login file. Use ls -a to list all files. % You have mail.
AaBbCc123	What you type, when contrasted with on-screen computer output.	% su Password:
AaBbCc123	Book titles, new words or terms, words to be emphasized; Command-line variable.	Read Chapter 6 in the User's Guide. These are called class options. You must be root to do this. To delete a file, type rm filename.

---

Shell Prompts

TABLE P-2

Shell	Prompt
C shell	machine_name%
C shell superuser	machine_name#
Bourne shell and Korn shell	$
Bourne shell and Korn shell superuser	#

---

Ordering Sun Documents

SunDocs^SM is a distribution program for Sun Microsystems technical documentation. Contact SunExpress^(TM) for easy ordering and quick delivery. You can find a listing of available Sun documentation on the Web.

TABLE P-3

Country	Telephone	Fax
Belgium	02-720-09-09	02-725-88-50
Canada	1-800-873-7869	1-800-944-0661
France	0800-90-61-57	0800-90-61-58
Germany	01-30-81-61-91	01-30-81-61-92
Holland	06-022-34-45	06-022-34-46
Japan	0120-33-9096	0120-33-9097
Luxembourg	32-2-720-09-09	32-2-725-88-50
Sweden	020-79-57-26	020-79-57-27
Switzerland	0800-55-19-26	0800-55-19-27
United Kingdom	0800-89-88-88	0800-89-88-87
United States	1-800-873-7869	1-800-944-0661
World Wide Web: http://www.sun.com/sunexpress/

---

Sun Documentation on the Web

The docs.sun.com web site enables you to access Sun technical documentation on the Web. You can browse the docs.sun.com archive or search for a specific book title or subject at:

http://docs.sun.com

---

Sun Welcomes Your Comments

We are interested in improving our documentation and welcome your comments and suggestions. You can email your comments to us at:

smcc-docs@sun.com

Please include the part number of your document in the subject line of your email.