* Network UPS Tools: Quick start docs
* Russell Kroll <rkroll@exploits.org>

If you don't want to bother with the README file then ...

1. Configure the source tree for your system.

	./configure

2. Build the programs, and optionally build the CGI programs.

	make
	make cgi	- OPTIONAL: requires the gd library and a web server

3. Gain privileges for installing software if necessary.

	su

4. Install the files to a system level directory.

	make install
	make install-cgi	- if you built them earlier
	make install-misc	- only required if you plan to build asapm-ups

5. Start the driver for your hardware.  If you don't know which one to
   run, consult the README file for a mapping of drivers to hardware
   in the "Model information" section.

	/usr/local/ups/bin/<model> /dev/<port>

   If it reports an error message, then figure out what's wrong before
   doing anything else in this file.

6. Edit config files in /usr/local/ups/etc

   Be sure to put a UPS line in upsd.conf.  You can look in the state
   file path (typically /var/state/ups) and see what was created by 
   the driver.

7. Start the network server.

	/usr/local/ups/sbin/upsd

8. Verify that some data is available.

	/usr/local/ups/bin/upsc localhost	

To actually have the system shut down when power gets critical, you will
need to perform some additional configuration and run upsmon.  Here are
the basics:

1. Set up the access levels in upsd.conf, including a password.
   Helpful documentation: access.txt

2. Edit upsmon.conf, and put in that password.

3. Restart upsd to make the change take effect, then start upsmon

4. Look for messages in the syslog to indicate success.

5. Optional, but desirable: edit your shutdown scripts to power down the
   UPS after the filesystems are remounted read-only.

For more details, see the README file and the shutdown.txt document.
