home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / DemoApps / Utilities / Other / ups / GACUPS / GACUPS.README < prev    next >
Encoding:
Text File  |  1993-08-14  |  2.3 KB  |  49 lines
  1. GACUPS is a NeXTstep program for monitoring a Best Fortress
  2. Uninterruptible Power Supply (UPS).  It was written at Gustavus
  3. Adolphus College (GAC) by Max Hailperin <max@nic.gac.edu> on August
  4. the 12th, 1993.  It is in the public domain and utterly without
  5. warranty.  I would, however, appreciate hearing of any improvements.
  6.  
  7. This program has only been tested under NeXTstep 2.x, not 3.x.
  8.  
  9. To build the program, you should be able to just say "make".
  10.  
  11. There are actually two separate programs: GACUPS and GACUPS.daemon
  12.  
  13. GACUPS.daemon should be run from the /etc/rc.local bootup script on
  14. the NeXT to which the UPS is attached (see below regarding cabling).
  15. It should be given the name of the serial device (/dev/ttya or
  16. /dev/ttyb) as a command-line argument.  Its responsibility is to
  17. handle the communication with the UPS, to provide syslog messages when
  18. there is a power outage, and to provide graceful shutdown when the
  19. battery runs low.  In all these regards it is quite similar to Best's
  20. own "CheckUPS" program.  The only major functional difference is that
  21. it also listens for information requests from the GACUPS program.
  22.  
  23. GACUPS is a user-interface application, which you might want to
  24. install in /LocalApps, for example.  It can be run on any NeXT on the
  25. network, not just the one on which GACUPS.daemon is running.  It
  26. connects over the network to the GACUPS.daemon in order to get
  27. information about the UPS's status, which it displays.  The first time
  28. you run it you'll need to supply the hostname to which it should
  29. connect, if it isn't the localhost; thereafter it will start up with
  30. the same hostname as the previous use.
  31.  
  32. Hardware:
  33.   The correct cable wiring is as follows:
  34.       UPS (DB-9 male)      NeXT (Mini DIN-8 male)
  35.       ---------------      ----------------------
  36.            1                      3
  37.            2                      5
  38.            4                      4
  39.  
  40. Security:
  41.   If you don't make the protection modes on /dev/ttya (or /dev/ttyb;
  42.   whichever you plug the UPS into; I'll assume a) more restrictive,
  43.   then any normal user, even logging in remotely, will be able to
  44.   power your machine down by just sending the right string to that
  45.   serial port.  So, I'd recommend making that device accessible only to
  46.   root.  In fact, I'd go further and do the same for all the various
  47.   flow controlled and dial in/out variations on tty, i.e.
  48.   /dev/{tty{d,},cu}{f,}a
  49.