2011-01-26 09:35:08 +00:00
|
|
|
UPSSET.CGI(8)
|
|
|
|
=============
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
|
|
|
|
upsset.cgi - Web-based UPS administration program
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
|
|
|
|
*upsset.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 sit there until you
|
|
|
|
give it input resembling a POST request.
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
|
|
|
|
*upsset.cgi*
|
2010-03-25 23:20:59 +00:00
|
|
|
lets you access many administrative functions within the UPS software
|
|
|
|
from your web browser. You can change settings and invoke instant
|
|
|
|
commands where available.
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
CHANGING SETTINGS
|
|
|
|
-----------------
|
|
|
|
|
2010-03-25 23:20:59 +00:00
|
|
|
Some UPS hardware allows you to change certain variables to other values.
|
|
|
|
To see what's available, pick a UPS from the chooser and select "settings",
|
|
|
|
then select "View" to update the page.
|
|
|
|
|
|
|
|
You should see a list of items with the descriptions on the left side
|
|
|
|
and the possible options or input spaces on the right. After changing
|
|
|
|
something, be sure to "Save changes" to update the values in your UPS.
|
|
|
|
|
|
|
|
If your UPS doesn't support any read/write variables, there will be
|
|
|
|
nothing to do on this page.
|
|
|
|
|
|
|
|
Setting values in read/write variables can also be done from the command
|
2011-01-26 09:35:08 +00:00
|
|
|
line with linkman:upsrw[8].
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
INSTANT COMMANDS
|
|
|
|
----------------
|
2010-03-25 23:20:59 +00:00
|
|
|
|
|
|
|
Some UPS hardware also has provisions for performing certain actions at the
|
|
|
|
user's command. These include battery tests, battery calibration, front
|
|
|
|
panel tests (beep!) and more. To access this section, do as above, but
|
|
|
|
pick "Commands" as the function.
|
|
|
|
|
|
|
|
If your UPS supports any instant commands, they will be listed in a
|
|
|
|
chooser widget. Pick the one you like and "Issue command" to make it
|
|
|
|
happen.
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
NOTE: some dangerous commands like "Turn off load" may not happen right
|
|
|
|
away. This is a feature, not a bug.
|
|
|
|
|
|
|
|
The apcsmart driver and some others require that you send this command twice
|
|
|
|
within a short window in order to make it happen. This is to keep you from
|
|
|
|
accidentally killing your systems by picking the wrong one.
|
2010-03-25 23:20:59 +00:00
|
|
|
|
|
|
|
To actually turn off the load, you have to send the command once, then
|
|
|
|
send it again after 3 seconds elapse but before 15 seconds pass. If
|
|
|
|
you do it too quickly or slowly, you have to wait at least 3 seconds
|
|
|
|
but not 15 seconds again.
|
|
|
|
|
|
|
|
You can also invoke instant commands from the command line with
|
2011-01-26 09:35:08 +00:00
|
|
|
linkman:upscmd[8].
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
ACCESS CONTROL
|
|
|
|
--------------
|
|
|
|
|
|
|
|
upsset will only talk to linkman:upsd[8] servers that have been defined
|
|
|
|
in your linkman:hosts.conf[8]. If it complains about "Access to that host
|
2010-03-25 23:20:59 +00:00
|
|
|
is not authorized", check your hosts.conf first.
|
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
SECURITY
|
|
|
|
--------
|
2010-03-25 23:20:59 +00:00
|
|
|
|
|
|
|
upsset will not run until you convince it that your CGI directory has
|
|
|
|
been secured. This is due to the possibility of someone using upsset
|
2011-01-26 09:35:08 +00:00
|
|
|
to try password combinations against your linkman:upsd[8] server.
|
|
|
|
|
|
|
|
See the example `upsset.conf` file for more information on how you do this.
|
|
|
|
The short explanation is--if you can't lock it down, don't try to run it.
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
FILES
|
|
|
|
-----
|
2010-03-25 23:20:59 +00:00
|
|
|
|
2011-01-26 09:35:08 +00:00
|
|
|
linkman:hosts.conf[5], linkman:upsset.conf[5]
|
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
|
|
|
Internet resources:
|
|
|
|
~~~~~~~~~~~~~~~~~~~
|
2010-03-25 23:20:59 +00:00
|
|
|
The NUT (Network UPS Tools) home page: http://www.networkupstools.org/
|