NAME

www-spong - display spong system status via the web or generate static HTML pages of system status


SYNOPSIS

www-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 www-spong program interfaces with the spong-server to display the collected information  in HTML format. www-spong can be run in two modes: as a CGI program and from the command line.

When run as a CGI program it does not have to loaded onto the same machine that spong-server is runnning. It queries the spong-server through it's query port. it will display information via a web page that reloads itself at regular intervals.  When run with no parameters it created a page wth two frames.  The left frame displays a summary of systems along with their associated problems (services that are red). The right panel is a table that lists the hosts and services, and the current status is a colored block or an icon depending on how spong-server is configured. For further information on how to use the web interface see the User Guide.

When run from a command line, www-spong generatesHTML pages that are printed to the console. This mode can be used to generate static HTML pages. If www-spong is run with any parameters a page that contains a summary display for all hosts is generated.
 

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 colored block or an icon depending on how spong-server is configured. 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, www-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).