Network UPS Tools User Manual

Recommendations

Info

Network UPS Tools User Manual 79 / 84 Last login Sat May 11 21:33 (MDT) on ttyp0 from intrepid.rmi.net Plan: Welcome to the UPS monitor service at kadets.d20.co.edu. The Smart-UPS attached to kadets generated a report at 14:24:01 on 05/17/96. During the measured period, the following data points were taken: Voltage ranged from 115.0 VAC to 116.3 VAC. The UPS generated 116.3 VAC at 60.00 Hz. The battery level was at 27.60 volts. The load placed on the UPS was 024.9 percent. UPS temperature was measured at 045.0 degrees Celsius. Measurements are taken every 10 minutes by the upsd daemon. This report is generated by a script written by Russell Kroll. Modified for compatibility with the BSD/OS cron daemon by Neil Schroeder This same status data could also be seen with a web browser, since we had rigged up a CGI wrapper script which called finger. J.1.2 January 1997: initial protocol tests Initial tests with a freestanding non-daemon program provided a few basic status registers from the UPS. The 940-0024C cable was not yet understood, so this happened over the [attachment:apcevilhack.jpg evil two-wire serial hack]. Communicating with SMART-UPS 700 S/N WS9643050926 [10/17/96] Input voltage range: 117.6 VAC - 118.9 VAC Load is 010.9% of capacity, battery is charged to 100.0% of capacity Note that today’s apcsmart driver still displays the serial number when it starts, since it is derived from this original code. J.1.3 September 1997: first client/server code The first split daemon/client code was written. upsd spoke directly to the UPS (APC Smart models only) and communicated with upsc by sending binary structures in UDP datagrams. The first CGI interface existed, but it was all implemented with shell scripts. The main script would call upsc to retrieve status values. Then it would cat a template file through sed to plug them into the page.
Network UPS Tools User Manual 80 / 84 upsstats actually has since returned to using templates, despite having a period in the middle when it used hardcoded HTML. The images were also created with shell scripts. Each script would call upsc to get the right value (utility, upsload, battcap). It then took the value, plugged it into a command file with sed, and passed that into fly, a program which used an interpreted language to create images. fly actually uses gd, just like upsimage does today. This code later evolved into Smart UPS Tools 0.10. J.2 Smart UPS Tools J.2.1 March 1998: first public release Version 0.10 was released on March 10, 1998. It used the same design as the pre-release prototype. This made expansion difficult as the binary structure used for network communications would break any time a new variable was added. Due to byte-ordering and struct alignment issues, the code usually couldn’t talk over the network to a system with a different architecture. It was also hopelessly bound to one type of UPS hardware. Five more releases followed with this design followed. The last was 0.34, released October 27, 1998. J.2.2 June 1999: Redesigned, rewritten Following a long period of inactivity and two months of prerelease testing versions, 0.40.0 was released on June 5, 1999. It featured a complete redesign and rewrite of all of the code. The layering was now in three pieces, with the single driver (smartups) separate from the server (upsd). Clients remained separate as before and still used UDP to talk to the server, but they now used a text-based protocol instead of the brittle binary structs. A typical request like "REQ UTILITY" would be answered with "ANS UTILITY 120.0". The ups-trust425-625 driver appeared shortly after the release of 0.40.0, marking the first expansion beyond APC hardware. Over the months that followed, the backupspro driver would be forked from the smartups driver to handle the APC Back-UPS Pro line. Then the backups driver was written to handle the APC Back-UPS contact-closure models. These drivers would later be renamed and recombined, with smartups and backupspro becoming apcsmart, and backups became genericups.
Page 1 and 2:
Network UPS Tools User Manual i Net
Page 3 and 4:
Network UPS Tools User Manual iii C
Page 5 and 6:
Network UPS Tools User Manual v Ins
Page 7 and 8:
Network UPS Tools User Manual vii 9
Page 9 and 10:
Network UPS Tools User Manual ix F
Page 11 and 12:
Network UPS Tools User Manual xi J.
Page 13 and 14:
Network UPS Tools User Manual 2 / 8
Page 15 and 16:
Page 17 and 18:
Page 19 and 20:
Page 21 and 22:
Network UPS Tools User Manual 10 /
Page 23 and 24:
Page 25 and 26:
Page 27 and 28:
Page 29 and 30:
Page 31 and 32:
Page 33 and 34:
Page 35 and 36:
Page 37 and 38:
Page 39 and 40: Network UPS Tools User Manual 28 /
Page 89: Network UPS Tools User Manual 78 /
Page 95: Network UPS Tools User Manual 84 /
show all

Network UPS Tools User Manual

Create successful ePaper yourself

Delete template?

Save as template?