Network UPS Tools User Manual
Network UPS Tools User Manual
Network UPS Tools User Manual
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
<strong>Network</strong> <strong>UPS</strong> <strong>Tools</strong> <strong>User</strong> <strong>Manual</strong> 15 / 84<br />
5 Installation instructions<br />
This chapter describe the various methods for installing <strong>Network</strong> <strong>UPS</strong> <strong>Tools</strong>.<br />
Whenever it is possible, prefer installing from packages. Packagers have done an excellent and hard work at improving NUT<br />
integration into their system.<br />
5.1 Installing from source<br />
These are the essential steps for compiling and installing this software.<br />
The NUT Packager Guide, which presents the best practices for installing and integrating NUT, is also a good reading.<br />
Keep in mind that. . .<br />
• the paths shown below are the default values you get by just calling configure by itself. If you have used --prefix or similar,<br />
things will be different. Also, if you didn’t install this program from source yourself, the paths will probably have a number of<br />
differences.<br />
• by default, your system probably won’t find the man pages, since they install to /usr/local/ups/man. You can fix this by editing<br />
your MANPATH, or just do this:<br />
man -M /usr/local/ups/man <br />
• if your favorite system offers up to date binary packages, you should always prefer these over a source installation. Along<br />
with the known advantages of such systems for installation, upgrade and removal, there are many integration issues that<br />
have been addressed.<br />
5.1.1 Prepare your system<br />
System <strong>User</strong> creation<br />
Create at least one system user and a group for running this software. You might call them "ups" and "nut". The exact names<br />
aren’t important as long as you are consistent.<br />
The process for doing this varies from one system to the next, and explaining how to add users is beyond the scope of this<br />
document.<br />
For the purposes of this document, the user name and group name will be ups and nut respectively.<br />
Be sure the new user is a member of the new group! If you forget to do this, you will have problems later on when you try to<br />
start upsd.<br />
5.1.2 Build and install<br />
Configuration<br />
Configure the source tree for your system. Add the --with-user and --with-group switch to set the user name and group that you<br />
created above.<br />
./configure --with-user=ups --with-group=nut<br />
If you need any other switches for configure, add them here. For example:<br />
• to build and install USB drivers, add --with-usb (note that you need to install libusb development package or files).