SYNOPSIS

       upsset.cgi

NOTE

       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.

DESCRIPTION

       upsset.cgi lets you access many administrative functions within the UPS
       software from your web browser.  You can  change  settings  and  invoke
       instant commands where available.

CHANGING SETTINGS

       Some  UPS hardware allows you to change certain variables to other val-
       ues.  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 com-
       mand line with upsrw(8).

INSTANT COMMANDS

       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.

       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  acciden-
       tally killing your systems by picking the wrong one.

       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.
       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.

FILES

       hosts.conf(5)

SEE ALSO

   Internet resources:
       The NUT (Network UPS Tools) home page: http://www.networkupstools.org/



                                Sat Aug 31 2002                  upsset.cgi(8)