Home » Categories » Multiple Categories

NRPE - v3 check_nrpe Config File

Overview

This KB article discusses NRPE v3 and the ability to use a config file for command line arguments.

NRPE v3 has two major improvements over previous versions:

  • Increased packet size up to 64K (referred to as v3 packet)

    • Previous versions were limited to 1K (referred to as v2 packet)
  • Increased SSL security

    • A 2048-bit DH key is used instead of a 512-bit key

    • Certificates can be used for security

 

In particular the ability to use certificates results in a a very long command line. The config file allows you to define check_nrpe arguments in the file and instead point to the config file.

 

Config File Details

The config file is specified with --config-file=<path/file> or -f <path/file> parameters.

/usr/local/nagios/libexec/check_nrpe --config-file=/usr/local/nagios/etc/check_nrpe.config -H 10.25.14.2
/usr/local/nagios/libexec/check_nrpe -f /usr/local/nagios/etc/check_nrpe.config -H 10.25.14.2

 

The config file must look like command line options, but the options can be on separate lines.

It MUST NOT include --config-file (-f), --command (-c) or --args (-a).

If any options are in both the config file and on the command line, the command line options are used.

 

Example One

Executing the check_nrpe plugin with the "-2" (Only use Version 2 packets) and "-P 8192" (payload size) arguments:

/usr/local/nagios/libexec/check_nrpe -2 -P 8192 -H 10.25.14.2

 

Creating a config file with the "-2" and "-P 8192" arguments:

echo "-2" >> /usr/local/nagios/etc/check_nrpe.config
echo "-P 8192" >> /usr/local/nagios/etc/check_nrpe.config

 

Executing the check_nrpe plugin with the config file:

/usr/local/nagios/libexec/check_nrpe -f /usr/local/nagios/etc/check_nrpe.config -H 10.25.14.2

 

 

Example Two

Executing the check_nrpe plugin with certificate arguments:

/usr/local/nagios/libexec/check_nrpe -C /usr/local/nagios/etc/ssl/client_certs/nag_serv.pem -K /usr/local/nagios/etc/ssl/client_certs/nag_serv.key -A /usr/local/nagios/etc/ssl/ca/ca_cert.pem -H 10.25.14.2

 

Creating a config file with the certificate arguments:

echo "-C /usr/local/nagios/etc/ssl/client_certs/nag_serv.pem" >> /usr/local/nagios/etc/check_nrpe.config
echo "-K /usr/local/nagios/etc/ssl/client_certs/nag_serv.key" >> /usr/local/nagios/etc/check_nrpe.config
echo "-A /usr/local/nagios/etc/ssl/ca/ca_cert.pem" >> /usr/local/nagios/etc/check_nrpe.config

 

Executing the check_nrpe plugin with the config file:

/usr/local/nagios/libexec/check_nrpe -f /usr/local/nagios/etc/check_nrpe.config -H 10.25.14.2

 

 

Final Thoughts

For any support related questions please visit the Nagios Support Forums at:

http://support.nagios.com/forum/

1.5 (2)
Article Rating (2 Votes)
Rate this article
  • Icon PDFExport to PDF
  • Icon MS-WordExport to MS Word
Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
Nagios XI - Monitoring AIX With Nagios
Viewed 1292 times since Thu, Jan 28, 2016
Nagios XI - Monitoring Hosts Using NRPE and NRPE Monitoring Wizard
Viewed 2154 times since Thu, Jan 28, 2016
Nagios XI - Installing The Linux Agent
Viewed 2864 times since Wed, Jan 27, 2016
NRPE - Turn Off XINETD Logging On Success
Viewed 2289 times since Tue, Mar 7, 2017
NRPE - v3 Compatibility With Previous Versions
Viewed 6772 times since Fri, Jun 24, 2016
Nagios XI - How to Restart A Windows Service With NRPE
Viewed 1499 times since Thu, Jan 28, 2016
Nagios XI - Installing NSClient++
Viewed 1270 times since Thu, Jan 14, 2016
Nagios XI - Windows Memory Usage - Physical
Viewed 3077 times since Tue, Jan 26, 2016
NRPE - Linux Cached Memory Not Added to Free Memory
Viewed 1593 times since Wed, Jan 27, 2016
NRPE - Upgrading To NRPE v3 From Source
Viewed 2258 times since Mon, Jul 11, 2016