spong(1)
NAME
spong - character based Spong client interface program
SYNOPSIS
DESCRIPTION
The spong program interfaces with the spong-server to display the
collected information; in text format. The spong program does not have
all of the functionality of the web-based interface. It's designed to
be used from character based consoles. The spong program doesn't not
have to load onto the same machine that spong-server is running on. You
load this program onto any machine. It is a good ideal to load this
onto machines, when possible, to allow the administrator of the machine
to query the spong-server when alert of received.
When run with any parameters, spong will display a table that lists the
hosts and services. All of the displays are text based with the legends
at the top.
OPTIONS
- --summary [HOSTLIST]
- Summarize the status of hosts, in HOSTLIST, in a table that lists
the hosts and services, and the current status is a single letter
with the meaning defined in the legend at the top of the display.
If HOSTLIST if not specified all hosts defined in spong.hosts are displayed. - --problems [HOSTLIST]
- Shows a summary of all the problems (services that are red) for the all the hosts in <HOSTLIST>. If HOSTLIST is not specified, all hosts defined in spong.hosts are displayed.
- --history [HOSTLIST]
- Show history information for the the list of hosts in HOSTLIST. If HOSTLIST is not specified, all hosts defined in spong.hosts are displayed.
- --host HOST
- Shows all information available for the given HOST
- --services host
- Shows detailed service information for the given HOST.
- --stats HOST
- Show statistical information for the given HOST. (Not currently implemented.)
- --config HOST
- Shows configuration information for the given HOST. (Not currently implemented.)
- --info HOST
- Shows admin supplied text for the given HOST.
- --service HOST:SERVICE
- Shows detailed information for the given HOST/SERVICE.
- --brief
- Display output in a brief format.
- --standard
- Display output in standard format (the default)
- --full
- Display the maximum amount of information possible.
CONFIGURATION
- Configuration Files
- By default the spong.conf file is read on startup. It defines some
specific variable that you probably don't need to override. - After reading the configuration file, then reads the spong.conf.[host]
file where [host] is the host name of the machine that you are running
on. Since these configuration files are just standard perl code that
gets imported, the variables that you define in the host specific
config file will take precedence over the standard configuration
settings. - Configuration Variables
- Here are a list of variables in the spong.conf file that are applicable to the spong-server program:
- $SPONGSERVER
The make of the server that spong-server is running on.
- $SPONG_QUERY_PORT
The port number that spong-server listens at for database queries.
FILES
- spong.conf
- Configuration file. This contains variables that detail spong and
OS specific definitions used by spong-server.
DEPENDENCIES
Perl v5.005_03 or greater is required.
BUGS
The --stats, --config, and --info parameters are currently not
implemented in the spong-server. When specified they will just generate
a blank HTML page.
SEE ALSO
- spong.hosts, spong.conf
- http://spong.sourceforge.net/ the Spong Home Page
AUTHOR
Ed Hill <ed-hill@uiowa.edu>, Unix System Administrator, The University
of Iowa
Stephen L Johnson <sjohnson@monsters.org>
HISTORY
- Based on code/ideas from Sean MacGuire (BB), and Helen Harrison (Pong).
Ed Hill original converted Big Brother (http://www.bb4.com) into Perl
which diverged from Big Brother to become Spong. Ed Hill continued
Spong development until version 2.1. Stephen L Johnson took over
development in October, 1999 with his changes which became Spong 2.5.