NAME
spong - display spong system status from the command line
SYNOPSIS
spong [--summary [hostlist] | --problems [hostlist] | --history
[hostlist] | --host host | --services host | --stats host
| --config host | --info host | --service host:service ] [--brief | --standard
| --full ]
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 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-servr 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 ledgend 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 host
list is not specified, all hosts defined in spong.hosts are displayed.
--host host
Shows all information availiable for the given host.
--services host
Shows detailed service information for the given host.
--stats host
Show statistical information for the given host.
--config host
Shows configuration intomation for the given host.
--info host
Shows admin supplied text for the given host.
--service host:service
Shows detailed information for the given host/service. The
--brief
Display output in a brief format
--standard
Display output in standard format (the default)
--full
Display the maximum amount of information possible.
CONFIGURATION
By default, spong reads the /usr/local/etc/spong/spong.conf
file which define some specific variables that you probably don't need
to override.
By default the /usr/local/etc/spong/spong.conf
file is read on startup. It defines some specific variable that you probably
don't need to override.
After reading the configuration fil, it then reads the /usr/local/etc/spong/spong.conf.[host]
file where [host] is the hostname 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.
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 numbr that spong-server listens at for database queries.
FILES
-
/usr/local/etc/spong/spong.conf
-
Configuration file. This contains variables that detail spong and OS specific
definitions used by spong-server. See spong.conf for additional
documentation.
DEPENDENCIES
Perl v5.003 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
AUTHOR
Ed Hill (ed-hill@uiowa.edu), Unix
System Administrator, The University of Iowa
Stephen L Johnson (stephen.johnson@mail.state.ar.us)
or (sjohnson@monsters.org),
Unix System Administator, DIS - State of Arkansas
Based on code/ideas from Sean MacGuire (BB), and Helen Harrison (Pong).