nut/docs/man/upsstats.cgi.txt

64 lines
1.5 KiB
Text
Raw Normal View History

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:
~~~~~~~~~~~~~~~~~~~
2022-06-29 10:37:36 +00:00
2010-03-25 23:20:59 +00:00
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/