2011-01-26 09:35:08 +00:00
|
|
|
UPSSTATS.CGI(8)
|
|
|
|
|
===============
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
|
|
|
|
|
upsstats.cgi - Web-based UPS status viewer
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
*upsstats.cgi*
|
|
|
|
|
|
|
|
|
|
NOTE: As a CGI program, this should be invoked through your web server.
|
2010-03-25 23:20:59 +00:00
|
|
|
If you run it from the command line, it will either complain about
|
|
|
|
|
unauthorized access or spew a bunch of HTML at you.
|
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
*upsstats.cgi*
|
2010-03-25 23:20:59 +00:00
|
|
|
uses template files to build web pages containing status information
|
|
|
|
|
from UPS hardware. It can repeat sections of those template files to
|
|
|
|
|
monitor several UPSes simultaneously, or focus on a single UPS.
|
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
These templates can also include references to linkman:upsimage.cgi[8]
|
2010-03-25 23:20:59 +00:00
|
|
|
for graphical displays of battery charge levels, voltage readings, and
|
|
|
|
|
the UPS load.
|
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
ACCESS CONTROL
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
upsstats will only talk to linkman:upsd[8] servers that have been defined
|
|
|
|
|
in your linkman:hosts.conf[5]. If it complains that "Access to that host
|
2010-03-25 23:20:59 +00:00
|
|
|
is not authorized", check that file first.
|
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
TEMPLATES
|
|
|
|
|
---------
|
|
|
|
|
|
2010-03-25 23:20:59 +00:00
|
|
|
The web page that is displayed is actually a template containing
|
|
|
|
|
commands to upsstats which are replaced by status information. The
|
|
|
|
|
default file used for the overview is upsstats.html.
|
|
|
|
|
|
|
|
|
|
When monitoring a single UPS, the file displayed is
|
2011-01-26 09:35:08 +00:00
|
|
|
`upsstats-single.html`.
|
2010-03-25 23:20:59 +00:00
|
|
|
|
|
|
|
|
The format of these files, including the possible commands, is
|
2011-01-26 09:35:08 +00:00
|
|
|
documented in linkman:upsstats.html[5].
|
|
|
|
|
|
|
|
|
|
FILES
|
|
|
|
|
-----
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
linkman:hosts.conf[5], linkman:upsstats.html[5], upsstats-single.html
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
linkman:upsimage.cgi[8]
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
Internet resources:
|
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
2010-03-25 23:20:59 +00:00
|
|
|
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|
