Network UPS Tools User Manual

Network UPS Tools User Manual 5 / 84
2.10.3 Additional Information
More information on configuring upsmon can be found in these places:
• The upsmon(8) man page
• Typical setups for big servers
• Configuring automatic UPS shutdowns chapter
• The stock upsmon.conf that comes with the package
2.11 Clients
Clients talk to upsd over the network and do useful things with the data from the drivers. There are tools for command line
access, and a few special clients which can be run through your web server as CGI programs.
For more details on specific programs, refer to their man pages.
2.11.1 upsc
upsc is a simple client that will display the values of variables known to upsd and your UPS drivers. It will list every variable
by default, or just one if you specify an additional argument. This can be useful in shell scripts for monitoring something without
writing your own network code.
upsc is a quick way to find out if your driver(s) and upsd are working together properly. Just run upsc to see what’s
going on, i.e.:
morbo:~$ upsc sparky@localhost
ambient.humidity: 035.6
ambient.humidity.alarm.maximum: NO,NO
ambient.humidity.alarm.minimum: NO,NO
ambient.temperature: 25.14
...
If you are interested in writing a simple client that monitors upsd, the source code for upsc is a good way to learn about using
the upsclient functions.
See the upsc(8) man page and NUT command and variable naming scheme for more information.
2.11.2 upslog
upslog will write status information from upsd to a file at set intervals. You can use this to generate graphs or reports with
other programs such as gnuplot.
2.11.3 upsrw
upsrw allows you to display and change the read/write variables in your UPS hardware. Not all devices or drivers implement
this, so this may not have any effect on your system.
A driver that supports read/write variables will give results like this:
$ upsrw sparky@localhost
( many skipped )