02.12.2015 Views

Network UPS Tools User Manual

Network UPS Tools User Manual

Network UPS Tools User Manual

SHOW MORE
SHOW LESS

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).

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!