README
1bkpupsd-1.0a
2
3 bkpupsd ver. 1.0 A
4 The UPS daemon for APC Back-UPS Pro series
5
6README file
7Aug. 3 1997.
8
9
101. Overview
11
12 The bkpupsd is a program to monitor and control UPS.
13bkpupsd is designed for FreeBSD 2.2.1R and work with APC Back-UPS Pro.
14 300 and 500 J plug and play model.
15
16
17
182. Disclaimer
19
20 I cannot warranty or guarantee any of these programs or
21 informations will work properly for you. Controling UPS is a tricky
22business. If anything is damaged, I take NO RESPONSIBILITY. Please use
23it at your own risks.
24 The informations based on this program are obtained only with
25reverse-engineering. So, accuracy of my informations is not certain.
26I am a doctor, not a computer engineer. :-) I may have made mistake.
27Please be careful.
28
29
30
313. The interface cable
32
33 The interface cable connecting UPS to computer serial port must
34be compatible with manufacturer's interface kits. I do not know about
35how connected lines of the cable internally.
36
37
38
394. Tested model of UPS
40
41 APC Back-UPS Pro. series
42 1. BK-Pro 300J PnP
43 2. BK-Pro 500J PnP
44Any other model is not tested. These UPSes are working good with my
45server PCs for 3 months by now.
46
47
485. Install
49
50 This program code is very simple. After untar the "bkpupsd-1.0",
51you should just excute a "make" command under this directory. "make install"
52will install following files:
53 1. bkpupsd - upsd program
54 /usr/local/sbin/bkpupsd
55 2. scripts
56 /usr/local/libexec/bkpupsd/
57 bkpups.failed
58 bkpups.restored
59 bkpups.shutdown
60 bkpups.battlow
61 3. manual
62 /usr/local/man/man8/bkpupsd.8
63
64
658. How to set up
66
67 What you need to do is summerized as followings:
68 1. Plug the PC power plug into the UPS power output.
69 2. Connect the PC's serial port to the UPS interface port.
70 3. Plug the UPS power input plug into wall power socket.
71 4. Run bkpupsd on the PC.
72
73 According to your system environments, settings may be varied.
74 The followings are only examples of setting up.
75 1. Edit /etc/rc.local. Append something like followings:
76 # Start up bkpupsd.
77 if [ -x /usr/local/sbin/bkpupsd ]; then
78 echo 'Starting bkpupsd.'
79 /usr/local/sbin/bkpupsd /dev/cuaa0
80 fi
81 2. Shutdown the system.
82 3. Switch off the PC.
83 4. Connect the PC's serial port1 to the UPS computer interface port.
84 5. Plug the PC's power plug into the UPS power output.
85 6. Plug the UPS power input into wall power socket.
86 7. Turn on the UPS.
87 8. Turn on the PC.
88
89 I recommand you to run some test, before you plug the PC power to
90the UPS using dummy load like a light. Connecting PC to UPS is a very tricky
91business. You would better to test the setting many times. Pulling off and
92plugging in the UPS power input to wall socket, check that the PC displays
93warning and recovery message and the light stays on. Pulling off the UPS
94power input for 6 to 7 minutes, check that the PC shutdown the system itself
95properly. After the shutdown, the UPS goes into sleep and the light also
96goes off. Plugging the UPS power input to the socket after that events, the
97UPS wake up and the light goes on again.
98
99
1007. Notes
101
102 Porting this program for linux or same other Sys V OS is not
103recommanded. This upsd is designed for BSD OS and not supporting Sys V
104SIGPWR and SysVinit features. There are more powerful UPSd programs for
105linux. Please use these ports.
106
107 I used informations of linux "The UPS Howto" by Harvey J. Stein,
108et al. and Alexis Yushin's experimental upsd. I would like to say "Thank you"
109to them.
110 Please inform me, if you find any bugs or security holes of this
111program.
112
113
114Yoshifumi Watanabe
115<mwatts@edu1.tokyo-med.ac.jp>
116Tokyo Medical College Hospital
117