Setting Up the Daemon Service for Nagios
This documentation is required only if you're not using Livestatus to retrieve data from your Nagios server.
- Prerequisites & Dependencies
- Check the installation
- Set the Authentication Token
- Start the Service
In the document we assume that you have read and understood the Concepts and Technologies underlying RealOpInsight.
To install and run the software properly, your system needs to satisfy the following dependencies:
- libstdc++ >= 4.6.x
- zeromq (libraries and development files, tested with zeromq 2.x)
- libcrypt (if you are using GNU/Linux systems, that should be already installed)
These software are included in the major GNU/Linux distributions and can be easily installed through the package manager (yum, apt-get, zypper...). The package names vary slightly from a distribution to another, see below the installation process for Fedora, openSUSE and Ubuntu.
Install the dependencies on Fedora
$ sudo yum install gcc-c++ libstdc++ make zeromq-devel
Install the dependencies on openSUSE
$ sudo zypper install gcc-c++ libstdc++ make zeromq-devel
Install the dependencies on Ubuntu
$ sudo apt-get install libstdc++6 libzmq1 libqt4-dev
Go to the download page and get a appropriate tarball or binary package.
Once the download completed, go to the suitable installation section:
Once the dependencies installed as mentioned previously, perform the following steps:
$ tar zxf ngrt4n-d4n-X.Y.Z.tar.gz # replace X.Y.Z by the suitable version $ cd ngrt4n-d4n-X.Y.Z $./install-sh # requires root privileges
This installs the program in /usr/local/sbin by default. An alternative location can be set using the -d switch, type install-sh -h for more details.
Note: If you're using zeromq 2.x and c++11, a compiling issue (error: ‘swap’ is not a member of ‘std’) has been reported. The solution is to patch zmq.hpp by adding #include <algorithm> in the header. See here for more details.
Here we assumed that you already installed all the dependencies and also that you already downloaded a suitable binary package of the Daemon Service.
Installation on Fedora and on openSUSE
$ sudo rpm -i /path/to/ngrt4n-d4n.rpm
Replace /path/to/ngrt4n-d4n.rpm with the path to the binary package (e.g. ngrt4n-d4n-1.1.0-opensuse12_2.x86_64.rpm).
Installation on Ubuntu
$ sudo dpkg -i /path/to/ngrt4n-d4n.deb
Replace /path/to/realopinsight.deb with the path to the binary package (e.g. ngrt4n-d4n-1.1.0-i386.deb).
Perform the following command as root. You'll be prompted to enter a passphrase.
$ ngrt4nd -P
Once the authentication token is set, you can start the service by performing the following command.
$ ngrt4nd # requires root privileges
This runs the program in daemon mode assuming that the path to the Nagios Status File is /usr/local/var/lib/status.dat and that the listening port is 1983. These default parameters can be overridden using appropriate options. See the help (ngrt4nd -h) or the man page for more details.
Important Note: If you have a firewall between the monitoring server and the operator workstation, you may need to update your filtering rules for enabling traffic on the listing port (1983, if you haven't changed the default port).