-<html>
-<head>
- <title>Son of Pong - Help DISK</title>
-</head>
-
-<body>
<h1>HELP - disk</h1>
-This check tests to make sure that your disks have enough free space available
+<p>This check tests to make sure that your disks have enough free space available
to make you comforatble. If a disk fills up or doesn't have enough room for
additional information, then services could be impacted, or data could be
-lost.<p>
+lost.</p>
-A summary of the disks that are most "full" is provided. A full "df" output is
-also provided to show you the overall status of your storage system.<p>
+<p>A summary of the disks that are most "full" is provided. A full "df" output is
+also provided to show you the overall status of your storage system.</p>
-Swap space is also show here. Swap space is used by the virtual memory system on the server. If the amount of available swap space get to low, the system system perform will be impacted.<p>
+<p>Swap space is also show here. Swap space is used by the virtual memory system on the server. If the amount of available swap space get to low, the system system perform will be impacted.</p>
-The summary output of the command that displays swap space will be provided after the full "df" output.<p>
+<p>The summary output of the command that displays swap space will be provided after the full "df" output.</p>
-</body>
-<html>
-<head>
- <title>Son of Pong - Help dns</title>
-</head>
-
-<body>
<h1>Help - dns</h1>
-DNS stands for Domain Name Service. This is the service that provides maps
+<p>DNS stands for Domain Name Service. This is the service that provides maps
between hostnames and IP addresses. This check is performed by connecting to
the DNS server at the remote machine and asking it to provide it's own IP
address based on it's name. If the server is down, it won't be able to do this
-function, and an error will be returned.<p>
+function, and an error will be returned.</p>
-If this service is down, many problems could appear. People will report slow
+<p>If this service is down, many problems could appear. People will report slow
networks or systems (due to timeouts while looking up addresses). People might
not be able to connect to services or systems. In general if DNS is down you
-will run into multiple widespread problems.<p>
-
-
-</body>
+will run into multiple widespread problems.</p>
--- /dev/null
+<!-- footer.html start -->
+
+<!-- don't insert </body> </html>, ... here, this will be -->
+<!-- done by footer() -->
+
+<!-- footer.html end -->
-<html>
-<head>
- <title>Son of Pong - Help ftp</title>
-</head>
-
-<body>
<h1>ftp</h1>
-This is a network service that some systems provide. It allows you to upload
+<p>This is a network service that some systems provide. It allows you to upload
and download files. This check is performed by actually connecting to the ftp
-service on the remote machine and verifies that it responds correctly.<p>
-
-If this service is down, users will not be able to "ftp" to that machine.<p>
+service on the remote machine and verifies that it responds correctly.</p>
-</body>
+<p>If this service is down, users will not be able to "ftp" to that machine.</p>
--- /dev/null
+<!-- header.html start -->
+
+<!-- don't insert <html> <body>, ... here, it has already -->
+<!-- been done by header() -->
+
+<!-- header.html end -->
-<html>
-<head>
- <title>Son of Pong - Help</title>
-</head>
-
-<body>
<h1>Spong Basics</h1>
-Son of Pong (spong) is a simple system monitoring package, that will monitor
+<p>Son of Pong (spong) is a simple system monitoring package, that will monitor
system attributes and network services on a variety of machines. It will
gather status reports and contact staff if there are problems. It will also
summarize the information and display it via web interface (which is what you
-are using).<p>
+are using).</p>
-Systems and the status of the services provided by those hosts are summarized
+<p>Systems and the status of the services provided by those hosts are summarized
in a tables on the right of the screen. Hostnames make up the vertical axis
of each table, and services make up the horizontal axis. For each row, and
column of the table, if that service is running on that host, then a colored
dot is located in that position. The color of the dot represents the status
of that service. A green dot indicates that everything appears ok, a yellow
dot indicates that there might be a problem, and a red dot indicates that
-there is a problem that requires attention.<p>
+there is a problem that requires attention.</p>
-Problems that require attention are summarized and listed in the column on the
+<p>Problems that require attention are summarized and listed in the column on the
left of the screen. Information about each problem (such as the host, and
service having the problem, the time that the problem occured, and the person
to contact about the problem) is provided for each host that requires
-attention.<p>
+attention.</p>
-Help is provided by clicking the "Help" link on the main screen (which takes
+<p>Help is provided by clicking the "Help" link on the main screen (which takes
you to this page). You can also get additional information about each service
-by clicking on the service headings at the top of each table.
+by clicking on the service headings at the top of each table.</p>
-If you click on the hostnames in the table, you will be taken to a screen
+<p>If you click on the hostnames in the table, you will be taken to a screen
which provides more detailed information about that host. A table of the
services running on that host is listed at the top of the page, with the
bottom of the page having two columns. The column on the left shows any host
specific text that you supply. The column on the right shows the history of
-problems that have occured on that host.<p>
+problems that have occured on that host.</p>
-If you click on any of the "dots" in the table, you will be taken to a page
+<p>If you click on any of the "dots" in the table, you will be taken to a page
showing more detailed service information. At the top of the page shows
detailed information that might be useful in diagnosing the problem, the
-bottom of the page shows the history of that service.<p>
+bottom of the page shows the history of that service.</p>
-<hr>
+<hr />
<h1>Nitty Gritty Details</h1>
-If you are just a casual user of spong - someone who keeps track of the web
+<p>If you are just a casual user of spong - someone who keeps track of the web
page, or someone who reacts to problems reported by spong, then hopefully the
-above documentation is sufficient to your needs.<p>
+above documentation is sufficient to your needs.</p>
-However, if you are someone who needs to install spong, or configure either
+<p>However, if you are someone who needs to install spong, or configure either
the client thresholds, or the network services that should be monitored, then
-the following the link below to the full Spong documentation.<p>
+the following the link below to the full Spong documentation.</p>
<ul>
-<li><a href="!!WWWDOCS!!/spongtoc.html">spongtoc</a> - table of contents
+<li><a href="!!WWWDOCS!!/spongtoc.html">spongtoc</a> - table of contents</li>
</ul>
-</td>
-</tr>
-</table>
-
-<hr>
+<hr />
Written by <a href="http://strobe.weeg.uiowa.edu/~edhill/">Ed Hill</a>
(<a href="mailto:ed-hill@uiowa.edu">ed-hill@uiowa.edu</a>)
-<br>
+<br />
and <a href="http://monsters.org/sjohnson/">Stephen L Johnson</a>
(<a href="mailto:sjohnson@monsters.org">sjohnson@monsters.org</a>).
-<html>
-<head>
- <title>Son of Pong - Help http</title>
-</head>
-
-<body>
<h1>Help - http</h1>
-This is a network service that some systems provide. It is what web servers
+<p>This is a network service that some systems provide. It is what web servers
and browsers use to communicate. If this service is running on a machine, it
means that machine has a web server running. This check is performed by
requesting the "/robots.txt" document - this is a common file that "web
-spiders" look at to see if they have permission to scan through the server.<p>
-
-If this service is down, users will not be able to access web pages or programs
-from that host.<p>
+spiders" look at to see if they have permission to scan through the server.</p>
-</body>
+<p>If this service is down, users will not be able to access web pages or programs
+from that host.</p>
-<html>
-<head>
- <title>Son of Pong - Help https</title>
-</head>
-
-<body>
<h1>Help - https</h1>
-This is a network service that some systems provide. It is what
+<p>This is a network service that some systems provide. It is what
web servers and browsers use to communicate over a secure, encrypted
connection. If this service is running on a machine, it means that
machine has a secure web server running. This check is performed by
requesting the "/robots.txt" document - this is a common file that
"web spiders" look at to see if they have permission to scan through
-the server.<p>
-
-If this service is down, users will not be able to access secure web
-pages or programs from that host.<p>
+the server.</p>
-</body>
+<p>If this service is down, users will not be able to access secure web
+pages or programs from that host.</p>
-<html>
-<head>
- <title>Son of Pong - Help imap</title>
-</head>
-
-<body>
<h1>Help - imap</h1>
-This is a network service that some systems provide. It is a mail service,
+<p>This is a network service that some systems provide. It is a mail service,
that allows people to access their mail on the remote machine. This check is
performed by actually connecting to the imap service on the remote machine and
-verifies that it responds correctly.<p>
-
-If this service is down, users will not be able to access their mail on that
-machine.<p>
-
+verifies that it responds correctly.</p>
-</body>
+<p>If this service is down, users will not be able to access their mail on that
+machine.</p>
-<html>
-<head>
- <title>Son of Pong - Help jobs/procs</title>
-</head>
-
-<body>
<h1>Help - jobs / procs</h1>
-This check looks to make sure certain "key" processes are running. For example
+<p>This check looks to make sure certain "key" processes are running. For example
if you have a Oracle database installed on a system, you want to make sure all
-the oracle processes associated with the database are running.<p>
+the oracle processes associated with the database are running.</p>
-A summary message is provided indicating what processes are not running (if
+<p>A summary message is provided indicating what processes are not running (if
any), and more detailed information is also provided showing the complete
-process list of all the processes that you expect to be running.<p>
+process list of all the processes that you expect to be running.</p>
-If this service not "green", it indicates that some program that should be
+<p>If this service not "green", it indicates that some program that should be
running is not, which could prevent people from accessing a service, or cause
-other problems.<p>
-
-
-</body>
+other problems.</p>
-<html>
-<head>
- <title>Son of Pong - Help logs</title>
-</head>
-
-<body>
<h1>Help - logs</h1>
-This check looks for "keywords" in log files that shouldn't exist. If lines
+<p>This check looks for "keywords" in log files that shouldn't exist. If lines
having those words are found they are reported. You would typically check for
words like "ALERT" in your syslog file, and other phrases that indicate a
-problem.<p>
-
-Log entries that have the words you are looking for are reported to the spong
-server, so that you can view them while looking at the problem.<p>
-
-If this service is "red", it could indicate a variety of problems - depending
-on the log and words you are checking for.<p>
-
+problem.</p>
+<p>Log entries that have the words you are looking for are reported to the spong
+server, so that you can view them while looking at the problem.</p>
-</body>
+<p>If this service is "red", it could indicate a variety of problems - depending
+on the log and words you are checking for.</p>
-<html>
-<head>
- <title>Son of Pong - Help nntp</title>
- <meta http-equiv="REFRESH" content="__RELOAD__">
- <meta http-equiv="EXPIRES" content="__EXPIRE_DATE__">
-</head>
-
-<body>
<h1>Help - nntp</h1>
-This is a network service that few systems provide. It is the Usenet news
+<p>This is a network service that few systems provide. It is the Usenet news
service. This check is performed by actually connecting to the nntp service on
-the remote machine and verifies that it responds correctly.<p>
-
-If this service is down, then people will not be able to read or post Usenet
-news messages.<p>
-
+the remote machine and verifies that it responds correctly.</p>
-</body>
+<p>If this service is down, then people will not be able to read or post Usenet
+news messages.</p>
-<html>
-<head>
- <title>Son of Pong - Help ping</title>
-</head>
-
-<body>
<h1>Help - ping</h1>
-This check tests the network connectivity of the machine. Periodically, every
+<p>This check tests the network connectivity of the machine. Periodically, every
machine is "pinged" from the spong server machine to check to see if it is
accessible via the network. If this service is "red", it could indicate a
-couple of different problems.<p>
+couple of different problems.</p>
-Either the machine itself is down or frozen, or there is a network problem
+<p>Either the machine itself is down or frozen, or there is a network problem
between the spong server and the machine. If you find that a large majority
of machines have their ping service marked as "red", this would typically
indicate a networking problem (or a wide scale problem associated with a
-power failure or some other disaster).<p>
+power failure or some other disaster).</p>
-If the ping service is not available, then chances are most services running
+<p>If the ping service is not available, then chances are most services running
on that machine are also marked "red" (or "purple"), since if the machine can
not be accessed via the network, any client information probably won't be
-reported either.<p>
+reported either.</p>
-If there is a connectivity problem, then a traceroute is done between the spong
+<p>If there is a connectivity problem, then a traceroute is done between the spong
server and the machine being monitored. This information might be helpful to
someone trying to determine where the problem lies (if it is a networking
-problem).<p>
-
-
-</td>
-</tr>
-</table>
-<hr>
+problem).</p>
-<html>
-<head>
- <title>Son of Pong - Help pop3</title>
-</head>
-
-<body>
<h1>Help - pop3</h1>
-This is a network service that some systems provide. It is a mail service,
+<p>This is a network service that some systems provide. It is a mail service,
that allows people to access their mail on the remote machine. This check is
performed by actually connecting to the pop3 service on the remote machine and
-verifies that it responds correctly.<p>
-
-If this service is down, users will not be able to access their mail on that
-machine.<p>
-
+verifies that it responds correctly.</p>
-</body>
+<p>If this service is down, users will not be able to access their mail on that
+machine.</p>
-<html>
-<head>
- <title>Son of Pong - Help jobs/procs</title>
-</head>
-
-<body>
<h1>Help - jobs / procs</h1>
-This check looks to make sure certain "key" processes are running. For example
+<p>This check looks to make sure certain "key" processes are running. For example
if you have a Oracle database installed on a system, you want to make sure all
-the oracle processes associated with the database are running.<p>
+the oracle processes associated with the database are running.</p>
-A summary message is provided indicating what processes are not running (if
+<p>A summary message is provided indicating what processes are not running (if
any), and more detailed information is also provided showing the complete
-process list of all the processes that you expect to be running.<p>
+process list of all the processes that you expect to be running.</p>
-If this service not "green", it indicates that some program that should be
+<p>If this service not "green", it indicates that some program that should be
running is not, which could prevent people from accessing a service, or cause
-other problems.<p>
-
-
-</body>
+other problems.</p>
-<html>
-<head>
- <title>Son of Pong - Help smtp</title>
- <meta http-equiv="REFRESH" content="__RELOAD__">
- <meta http-equiv="EXPIRES" content="__EXPIRE_DATE__">
-</head>
-
-<body>
<h1>Help - smtp</h1>
-This is a network service that some systems provide. It is a mail service,
+<p>This is a network service that some systems provide. It is a mail service,
that allows people to send mail to other users. This check is performed by
actually connecting to the smtp service on the remote machine and verifies that
-it responds correctly.<p>
-
-If this service is down, users will not be send email messages to others. It
-could also indicate that mail messages are being delayed.<p>
-
+it responds correctly.</p>
-</body>
+<p>If this service is down, users will not be send email messages to others. It
+could also indicate that mail messages are being delayed.</p>
projects / spong.git / commitdiff