                              P G   M O N I T O R

pgmonitor, version 0.44

The main web site for pgmonitor is:
	http://greatbridge.org/project/pgmonitor/projdisplay.php

You can download the most recent version from
	ftp://ftp.greatbridge.org/pub/pgmonitor

This tool allows monitoring of PostgreSQL activity.  It requires Tcl/Tk
8.0 or later.  The postmaster startup/shutdown button only appears for
the PostgreSQL superuser and root.

Pgmonitor only works when run on the database server machine.  To use it
remotely, log into the remote machine, set the DISPLAY variable to point
to your local X server, and start pgmonitor.  Pgmonitor will then run on
the remote machine, but will display on your local machine.

Pgmonitor uses 'ps' to display backend process activity.  It uses 'gdb'
to display running queries, and 'kill' to cancel queries and terminate
database connections.

Pgmonitor stores your most recent refresh and sort settings in the file
~/.pgmonitor.  This file is used to reload your defaults every time
pgmonitor is started.

If you are running PostgreSQL 7.1.0 or earlier, the 'query' button will
not work unless you compile PostgreSQL with debug symbols (-g), or apply
the supplied patch 'query_display.diff' and recompile PostgreSQL.  The
later method is recommended.

It is known to run on *BSD, Linux, and HPUX.  It does not run on Solaris
and perhaps other SVr4-based systems because PostgreSQL's ps status
display doesn't work on those platforms.  It may require modification of
the 'ps' flags for certain platforms.  

For porting assistance, there are 'set debug' and 'set show_all' options
in the script.  'debug' outputs status information while pgmonitor
running, and 'show_all' shows all PostgreSQL user processes, such as the
postmaster.

Bruce Momjian <pgman@candle.pha.pa.us>
