GAPCMON (a.k.a gapcmon, and gpanel_apcmon)

	A Gtk2/GLib2 GUI application used to monitor UPS devices controlled
by the APCUPSD package.  The program uses the NIS interface from apcupsd to
collect event and status information for display to the end-user.  Because of
this great interface, this program can be executed on any OS supported machine
and use the network socket interface to connect back to apcupsd.  Of course
apcupsd must be compiled with nis support (i.e. ./configure --enable-nis ).

	One program is included for your use in this package; gapcmon is a 
regular gtk+ application.


FEATURES: 
    * FreeDesktop.org Spec for Notification Area Icons.
    * Unlimited support for multiple UPSs.
    * Historical Graph of five data points are charted.  A total of 40 points
      are maintained on the graph. The data points are LINEV, BATTV, BCHARGE,
      LOADPCT, and TIMELEFT.
    * Clicking an notification icon will cause the information window for that
      monitor to become visible or be hidden, if its already visible.
    * Monitor tooltips are available when hovering the mouse over the icon, and 
      contain a quick summary of the ups status.
    * Icons are dynamically added or removed when enabled in preferences.
    * Icon changes to reflect the operational condition of the UPS.
		- where state is (online, onbattery, charging, not communicating, no cable)
	* right click popup menu with "JumpTo" window and "Quit" window menu choices.
    * Chart support popup tooltip for data point under the mouse pointer, showing
      dataseries name and value.
    * Chart legend of the colors for each data point can be toggled on or off by
      clicking anywhere on the chart once.
    * Configuration of the tcpi/ip hostname, tcp port number, and whether that
      monitor is current enabled is provided via a central Preferences page.
	* background thread for all network io to keep user interface responsive.

	
  { the monitor information window }
	* notebook layout with four tabs:
		- History
			* Historical Line Graph tracking VAC, battery charge, batt voltage, 
			  ups load, and time remaining.  Data collection for this chart is
			  ten times the regular refresh time in seconds, and displays 40
			  collection cycles on screen. 
		- Information
			* more detailed view of apcupsd current state and ups current state
		- Events
			* current apcupsd events as reported by apcaccess
		- Status
			* current apcupsd status  as reported by apcaccess		
    	- refresh button, and quit button:  
			* refresh button causes and immediate refresh of all data values
			* quit button closes the application, or hides the window for monitors

  { the monitor information window }
	* notebook layout with four tabs:
		- Active Monitors List
			* Status icon, state text, brief summary of active UPS monitor.
		- Preferences
			* configuration page allows user to specify the hostname, port, and 
			  refresh interval in seconds of the server/workstation running 
			  apcupsd with NIS configured.
		- Glossary
			* Quick help text
		- About 
			* Program version and information panel

REQUIREMENTS:

	Gtk2/Glib-2.4 runtime support. (Created on Fedora Core 4)
	APCUPSD installed and configured to NIS support.
		{ get at http://apcupsd.sourceforge.net  }
		
	X11 and openGL libraries: used for history line graph
		{ comes with X }

	* the following packages may need to be installed to build program and
	  for runtime of binaries on some platforms.

	gapcmon			{gtk version 2.4 is minimum package level required}
		glib-devel  
		gtk-devel
		X11 Libraries		
		gconf2
						 		

DISTRIBUTION METHOD:

	Source RPM	gapcmon-{version}-{release}.src.rpm
	Binary RPM	gapcmon-{version}-{release}.i686.rpm
	Source tar	gapcmon-{version}.tar.bz2

INSTALL INFO:
	Configure Source with 
	for gapcmon : 
			'# ./configure --prefix=/usr '
    		
	Then compile with 'make clean all', then 'sudo make install'
	Binary RPM install with this command 'rpm -ivh gapcmon-{version}-{release}.i686.rpm'

	Both methods result in '/usr/bin/gapcmon' 
	being installed according to your system defaults for prefix.  
	Note: the configure step requires the parm 'prefix=/usr'.


INSTRUCTIONS: 

  gapcmon -- Gtk Application
    
    1. look in gnome menus for the "Applications" group, then select "APCUPSD monitor"
    	- or enter '# gapcmon' on the command line.
	2. To configure.
		- select preferences choice,
		- enter hostname and port, choose refresh interval in seconds.
		- be sure to click or unclick enable to activate the selection.

KNOWN BUGS:
 Occasionally a segfault may occur when editing the hostname in the preferences page.

MAILING LIST:

 http://sourceforge.net/projects/apcupsd,   choose the 'users mailing list'
 	apcupsd-users-request@lists.sourceforge.net
 											
 http://sourceforge.net/projects/gapcmon,   choose the 'Help Forum'

WEB SITE:

 http://apcupsd.sourceforge.net/  or  http://gapcmon.sourceforge.net/  

CVS CHECKOUT:

 See sourceforge.net project page for cvs info and checkout module "gapcmon"

REPORTING BUGS:

 Please report bugs and feature requests to 
 "James Scott Jr"<skoona@users.sourceforge.net>
 or use the HELP Forums on SourceForge for this project.

 I also respond to apcupsd-users-request@lists.sourceforge.net, list.
 

ACKNOWLEDGMENTS & CONTRIBUTORS

 Thanks goes to project team creating and 
 maintaining APCUPSD.

 	
