upsset.cgi(8) Network UPS Tools (NUT) upsset.cgi(8)NAMEupsset.cgi - Web-based UPS administration program
SYNOPSISupsset.cgiNOTE
As a CGI program, this should be invoked through your web
server. If you run it from the command line, it will sit
there until you give it input resembling a POST request.
DESCRIPTIONupsset.cgi lets you access many administrative functions
within the UPS software from your web browser. You can
change settings and invoke instant commands where avail-
able.
CHANGING SETTINGS
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 line with upsrw(8).
INSTANT COMMANDS
Some UPS hardware also has provisions for performing cer-
tain 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 "Com-
mands" 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.
Note - some dangerous commands like "Turn off load" may
not happen right away. This is a feature, not a bug. The
apcsmart and newapc drivers (among 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 acci-
dentally killing your systems by picking the wrong one.
To actually turn off the load, you have to send the com-
mand 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 upscmd(8).
ACCESS CONTROL
upsset will only talk to upsd(8) servers that have been
defined in your hosts.conf(8). If it complains about
"Access to that host is not authorized", check your
hosts.conf first.
SECURITY
upsset will not run until you convince it that your CGI
directory has been secured. This is due to the possibil-
ity of someone using upsset to try password combinations
against your 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.
FILEShosts.conf(5)SEE ALSO
Internet resources:
The NUT (Network UPS Tools) home page:
http://www.exploits.org/nut/
NUT mailing list archives and information:
http://lists.exploits.org/
Sat Aug 31 2002 upsset.cgi(8)