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.2_Installer.zip

Size: 8.7 MB

SHA256: f87442388509cc332c005ceb22daf78954f37b5c134935140735fa1c11f924d6

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.2_FullSSL_Installer.zip

Size: 8.7 MB

SHA256: 0834ca3b7bb3eb03b07a65894abca26d46cb973659391a4c82d0575eb041a2d0

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.1k

OpenSSL license
Cygwin and GNU Tools

1.7.33

CYGWIN license contact Itefix for sources
winrpe

4.2.2

 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.