spong

• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• CONFIGURATION
  • Configuration Files
  • Configuration Variables
• FILES
• DEPENDENCIES
• BUGS
• SEE ALSO
• AUTHOR
• HISTORY

NAME

spong - character based Spong client interface program

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'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 the spong.conf manpage 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

the spong.hosts manpage, the spong.conf manpage

 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.