ngrt4nd is an utility that can be installed and enabled on a Nagios server to provide the service of retrieving status data to RealOpInsight Workstation and RealOpInsight Ultimate. As alternative to Livestatus, it depends on the Nagios’s status.dat file and enables a ZeroMQ-based RPC API to get status data.
Use it with caution! Since relying on status.dat, ngrt4nd requires disc I/O, instead of in-memory operations than with Livestatus. Therefore, it’s not a scalable solution and should be used for testing purpose or on small installation only.
To install and run the software properly, your system needs to satisfy the following dependencies:
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.
$ sudo yum install gcc-c++ libstdc++ make zeromq-devel
$ sudo zypper install gcc-c++ libstdc++ make zeromq-devel
$ sudo apt-get install libstdc++6 libzmq1 libqt4-dev
Once the download completed, go to the suitable installation section according to that you’re using sources or binary packages.
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.
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
Here we assumed that you already installed all the dependencies and also that you already downloaded a suitable binary package of the Daemon Service.
$ sudo rpm -i /path/to/ngrt4n-d4n.rpm
/path/to/ngrt4n-d4n.rpm with the path to the binary
$ sudo dpkg -i /path/to/ngrt4n-d4n.deb
/path/to/realopinsight.deb with the path to the binary
Daemon Service is comprised of one command line program named
ngrt4nd. As standard UNIX commands, it has a help page
ngrt4nd -h) as well as a man page.
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).