powercom - UPS model driver for powercom kind of interface


SYNOPSIS

       powercom [-h]
       powercom [-d <num> ] -k <device>
       powercom [-i <str> ] [-l <num> ] [-m <str> ] [-s  <str>  ]
       <device>


DESCRIPTION

       powercom  is a driver for the PowerCom UPS. It serves as a
       communication channel between the UPS attached on <device>
       and  the  upsd  daemon.  The driver's task is to pass upsd
       process information about UPS state and  parameters.   The
       driver   can also send the UPS instant commands.  Alterna­
       tively it can instruct the UPS to shutoff the  load  in  a
       timely fashion when instructed to on the command line.
       powercom  has  two modes of operation which are determined
       by the command line switches.  In the first mode, which is
       what  will be activated almost all the time, powercom will
       periodically inquire the UPS for its state and  parameters
       and  have  the  results of this inquiries avaiable to upsd
       and there after for the various clients. In this  mode  of
       operation  it will also have instant commands sent by upsd
       transferred to the UPS. This mode is operational  whenever
       the -k switch has not been given on the command line.
       In  its  second mode of operation, powercom will instructs
       the UPS to cut of the power, possibly  after  some  delay.
       This  mode  of  operation is intended for cases when it is
       known that the UPS is on battery and the mains electricity
       supply will not be back in a short while and therefore the
       machine has to be turned off.


OPTIONS

       -h     display an  help  message  without  doing  anything
              else.  This  option  is  the only one for which the
              <device> parameter is ignored and can  be  omitted.
              This option overides any other option.

       -d <num>
              this  optional flag might be used only when the UPS
              is instructed to cut off the power. It is meant  to
              have  powercom wait additional <num> seconds before
              announcing that driver failed command  the  UPS  to
              turn off the power to the load.

       -k     instructs  powercom  to  order  the  UPS  which  is
              attached to <device> to cut off the power.

       -i <str>
              gives the UPS that  is  attached  to  <device>  the
              identification  of  the  string <str>.  The default
              value for it is "myups".

              indicates which is the  mains  electricity  voltage
              that  is  fed  to the UPS which it is connected to.
              <device>.  Consequently,  this  voltage  should  be
              regarded  as  on  line.  The  default  value is 230
              volts.

       -m <str>
              A string that represents the model of the UPS  that
              is  attached  to  <device>.   The  default  name is
              "Unknown".

       -s <str>
              A string that represents the serial number  of  the
              UPS  that  is  attached  to  <device>.  The default
              string is "Unknown".


DIAGNOSTICS

       In addition to recording activities such as first  activa­
       tion, instant commands and cutting the power in the system
       logs and the console there are clients for inspecting  the
       state  and parameters values of the UPS as well as clients
       for sending the UPS instant commands.


FILES

       In normal operation powercom will be called only from  the
       system  init  scripts.  These might be /etc/init.d/nut and
       /etc/init.d/halt.  In this way of using it the  configura­
       tion  files  upsd.conf and upsmon.conf controls its opera­
       tion. These files might be in /etc/nut.  Please note  that
       all paths are system dependant.


BUGS

       Some of the conversions of binary data that is reported by
       the UPS into numerical values, notably the battery precen­
       tage, are wrong. Yet the UPS also reports when its battery
       is low, which is why the bad  conversion  of  the  battery
       precentage  does  not  harm the functionality of the model
       driver.
       The -d switch is ignored when not being  given  with  con­
       junction with the -k switch.
       There  is  no  verification  or  otherwise  cross matching
       between the -i name and the corresponding name in the con­
       figuration files.


AUTHOR

       The   author   of   this   model  driver  is  Shaul  Karl,
       <shaulk@israsrv.net.il>.


SEE ALSO

   The main controlling process is
       upsd(8)

       multimon,  upsc,  upscmd,  upsct,  upsct2,   upsimage.cgi,
       upslog,  upsmon, upsset,  upsstats.cgi

   Other models drivers are:
       apcsmart(8),     belkin(8),    bestfort(8),    bestups(8),
       engetron(8), fentonups(8),  genericups(8),   ipt-anzen(8),
       mustekups(8),  optiups(8), victronups(8)

   Internet resources:
       The   NUT   (Network   UPS   Tools)   home   page   is  at
       http://www.exploits.org/nut.  The  user  mailing  list  is
       ups@lists.exploits.org


Man(1) output converted with man2html