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 - Upgrading The Linux NRPE Agent
Viewed 2195 times since Wed, Aug 30, 2017
Nagios XI - Using Scripts / Plugins With NSClient++
Viewed 9244 times since Wed, Jul 27, 2016
Nagios XI - How To Check For Windows Updates With Nagios XI
Viewed 1200 times since Wed, Jan 27, 2016
NRPE - Upgrading To NRPE v3 From Source
Viewed 4290 times since Mon, Jul 11, 2016
NRPE - Agent and Plugin Explained
Viewed 22012 times since Fri, Jul 14, 2017
Nagios XI - Adding Windows Disk Usage Checks In XI
Viewed 2265 times since Thu, Jan 14, 2016
Nagios XI - How to Restart A Windows Service With NRPE
Viewed 2736 times since Thu, Jan 28, 2016
Nagios XI - Monitoring AIX With Nagios
Viewed 2224 times since Thu, Jan 28, 2016
Nagios XI - Windows Memory Usage - Physical
Viewed 5959 times since Tue, Jan 26, 2016
Nagios XI - Installing The Linux Agent
Viewed 4795 times since Wed, Jan 27, 2016