Network UPS Tools User Manual

Recommendations

Info

Network UPS Tools User Manual 15 / 84 5 Installation instructions This chapter describe the various methods for installing Network UPS Tools. Whenever it is possible, prefer installing from packages. Packagers have done an excellent and hard work at improving NUT integration into their system. 5.1 Installing from source These are the essential steps for compiling and installing this software. The NUT Packager Guide, which presents the best practices for installing and integrating NUT, is also a good reading. Keep in mind that. . . • the paths shown below are the default values you get by just calling configure by itself. If you have used --prefix or similar, things will be different. Also, if you didn’t install this program from source yourself, the paths will probably have a number of differences. • 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 your MANPATH, or just do this: man -M /usr/local/ups/man • if your favorite system offers up to date binary packages, you should always prefer these over a source installation. Along with the known advantages of such systems for installation, upgrade and removal, there are many integration issues that have been addressed. 5.1.1 Prepare your system System User creation Create at least one system user and a group for running this software. You might call them "ups" and "nut". The exact names aren’t important as long as you are consistent. The process for doing this varies from one system to the next, and explaining how to add users is beyond the scope of this document. For the purposes of this document, the user name and group name will be ups and nut respectively. 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 start upsd. 5.1.2 Build and install Configuration Configure the source tree for your system. Add the --with-user and --with-group switch to set the user name and group that you created above. ./configure --with-user=ups --with-group=nut If you need any other switches for configure, add them here. For example: • to build and install USB drivers, add --with-usb (note that you need to install libusb development package or files).
Network UPS Tools User Manual 16 / 84 • to build and install SNMP drivers, add --with-snmp (note that you need to install libsnmp development package or files). • to build and install CGI scripts, add --with-cgi. See Configure options from the User Manual, docs/configure.txt or ./configure --help for all the available options. If you alter paths with additional switches, be sure to use those new paths while reading the rest of the steps. Reference: Configure options from the User Manual. Build the programs make This will build the NUT client and server programs and the selected drivers. It will also build any other features that were selected during configuration step above. Installation Note you should now gain privileges for installing software if necessary: su Install the files to a system level directory: make install This will install the compiled programs and man pages, as well as some data files required by NUT. Any optional features selected during configuration will also be installed. This will also install sample versions of the NUT configuration files. Sample files are installed with names like ups.conf.sample so they will not overwrite any existing real config files you may have created. If you are packaging this software, then you will probably want to use the DESTDIR variable to redirect the build into another place, i.e.: make DESTDIR=/tmp/package install make DESTDIR=/tmp/package install-conf State path creation Create the state path directory for the driver(s) and server to use for storing UPS status data and other auxiliary files, and make it group-writable by the group of the system user you created. mkdir -p /var/state/ups chmod 0770 /var/state/ups chown root:nut /var/state/ups
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 21 and 22: Network UPS Tools User Manual 10 /
Page 25: Network UPS Tools User Manual 14 /
Page 77 and 78:
Network UPS Tools User Manual 66 /
Page 79 and 80:
Page 81 and 82:
Page 83 and 84:
Page 85 and 86:
Page 87 and 88:
Page 89 and 90:
Page 91 and 92:
Page 93 and 94:
Page 95:
show all

Network UPS Tools User Manual

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?