INSTALL: Call "launchctl" with root privileges, use sudo
[nagcollect.git] / INSTALL
1
2              NagCollect: Nagios Data Collector for Passive Checks
3            Copyright (c)2009-2010 Alexander Barton, alex@barton.de
4
5                                    INSTALL
6
7
8 Server
9 ~~~~~~
10
11 1. Run "make install-server".
12
13 2. Adjust /etc/nagios3/system.cfg and your Nagios3 templates.
14
15 3. Use visudo(8) to add the following to your /etc/sudoers file:
16
17 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
18 ALL=(nagios) NOPASSWD: /usr/local/sbin/nagios-submit-host, \
19                         /usr/local/sbin/nagios-submit-service
20 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
21
22 4. Configure client keys in /etc/nagios3/nagcollect.keys.
23
24
25 Client
26 ~~~~~~
27
28 1. Run "make install-client".
29
30 2. Adjust the client configuration in /usr/local/etc/nagcollect.conf.
31
32 3. Make sure /usr/local/sbin/nagcollect is run periodically.
33
34 On Mac OS X, you can use the following to commands to start and stop the
35 periodic execution, which "make install-client" does on this platform:
36
37 - Start: sudo launchctl load -w /Library/LaunchDaemons/de.barton.nagcollect
38 - Stop:  sudo launchctl unload -w /Library/LaunchDaemons/de.barton.nagcollect