winrpe - Nagios NRPE for Windows

 Winrpe is a Nagios NRPE implementation for windows systems. It is a packaging of Nagios NRPE addon, Xinet, Cygwin and a collection of windows specific NRPE plugins for monitoring cpu, disk, memory, eventlog, services and performance counters. It can easily be expanded by other plugins.

The Nagios NRPE addon allows you to execute Nagios plugins on remote machines, enabling you to monitor local resources like CPU load, memory and disk usage. Since these resources are not usually exposed to other machines, an agent like Winrpe must be installed on the remote Windows machines. Xinetd is an open source super server daemon, which features a variety of access control (tcp wrappers) and configuration mechanisms (time and connection limits) and extensive logging. Cygwin is a Linux-like environment for Windows. It consists of a DLL (cygwin1.dll), which emulates substantial Linux API functionality, and a collection of tools.

 

 

Installation

Winrpe

Name: winrpe_4.2.0_Installer.zip

Size: 8.0 MB

MD5: 348afa1e13498a132c12f7c0154f4606

SHA256: e1fb672aa19ab67a82e760ac315e5e8717d5a72467e12382d42462b4d98c9072

PGP Signature - Our PGP public key is available here.            

 

Supported platforms : XP/2003/Vista/2008/7/2012/8.

Winrpe is available as a zip file containing an installer. Simply unzip your downloaded copy and run the package "winrpe_x.x.x_Installer.exe" or "winrpe_x.x.x_FullSSL_Installer.exe" :

  1. Accept License agreement.
  2. Specify an installation location.
  3. Specify a service account for the Xinet service.
  4. Installation starts. By clicking 'Details' button, you can get more detailed information about installation. Check if everything seems ok.

Winrpe is now installed and Xinet is activated as a manual service with a proper configuration to serve nrpe requests. Consult documentation from start menu for more information about components installed.

 

Usage

You need to update the configuration file nrpe.cfg (available from start menu) according to your needs and change the start mode to  automatic. You can also enhance your Winrpe installation by other NRPE plugins from NagiosExchange or SourceForge.

 

 

Winrpe with FullSSL patch

This is a special build coming with a patch allowing Full SSL capability. Please be aware of that you need to setup a complete certificate infrastructure to be able to use that build. See usage instructions below for more details.

 

Installation steps are same as the plain edition above.

Winrpe

w/FullSSL patch

Name: winrpe_4.2.0_FullSSL_Installer.zip

Size: 8.0 MB

MD5: 73b52b113a3f58154d2231e4e7b082f1

SHA256: 111134b49dbf3b034be1b8340a3997b974b603e5e51a3321742e76c88b015bf1

PGP Signature - Our PGP public key is available here.


Usage instructions for Winrpe with Full SSL patch:

  • You need to create/supply a CA root certificate (cacert.pem as example) for your whole implementation. In addition, create a host certificate (hostname.pem) and the corresponding private key (hostname-key.pem) for each host you want to communicate with. Be aware of that Common name field should correspond to the FQDN of the host name as the best practice. You can find a well written and descriptive guideline here.

At Winrpe side:

  • Copy all three files (cacert.pem, hostname.pem and hostname-key.pem) to the root directory of your Winrpe installation and add following directives to nrpe.cfg:

cert_file=/hostname.pem
cacert_file=/cacert.pem
privatekey_file=/hostname-key.pem

At server side:

  • For Nagwin: Copy hostname.pem, hostname-key.pem and cacert.pem to a location appropriate for certificates (say /certs). Copy bin/check_nrpe.exe from Winrpe FullSSL distribution to plugins directory as check_nrpe_fullssl.exe and use the following syntax for your check definitions (assuming that all certificate files are located at the root directory):

check_nrpe_fullssl -H <host name> -C /certs/hostname.pem -k /certs/hostname-key.pem -r /certs/cacert.pem -c command .....

  • For Unix hosts, you need to compile check_nrpe with the FullSSL patch and follow same steps as above.

 

Licence/Version

This package contains components with different terms of licensing:

Component Version Licensing

Nagios NRPE

2.15

GPL v2 contact Itefix for sources
OpenSSL

1.0.1e

OpenSSL license
Cygwin and GNU Tools

1.7.25

CYGWIN license contact Itefix for sources
winrpe

4.2.0

 BSD two-sentence

 

Uninstallation

This one is easy too:

  1. Make sure that no monitors are connected.
  2. Choose Uninstall from Start menu. Again, you can monitor uninstallation process by clicking 'Details' button. 

 

Thanks!

Let me emphasize that I play a very small role in this big game. I would like to thank to all people that make nagios nrpe+cygwin a powerful and flexible solution for monitoring of Windows systems.