Home » Categories » Products » NRPE » Troubleshooting » Common Problems

NRPE - Return Code Of 127 Is Out Of Bounds - Plugin May Be Missing

Problem Description

This KB article addresses the following NRPE error:

Return Code Of 127 Is Out Of Bounds - Plugin May Be Missing

 

Assumed Knowledge

The following KB article contains an explanation of how NRPE works and may need to be referenced to completely understand the problem and solution that is provided here:

NRPE - Agent and Plugin Explained

 

Troubleshooting The Error

This error is usually experienced when the plugin referenced by the command directive in nrpe.cfg is either missing from the libexec folder or the command directive is named incorrectly. It could also imply that the command name passed through NRPE from the Nagios XI server is not defined in the nrpe.cfg file on the remote host.

The first troubleshooting step is to know the name of the command you are requesting NRPE to execute. Referring to the following screenshot from a service definition in the Nagios XI Core Configuration Manager (CCM):

 

 

You can see the command is called:

check_foo

 

On your remote host make sure that the command is defined in nrpe.cfg, for example:

command[check_foo]=/usr/local/nagios/libexec/check_foo.sh $ARG1$


Now that you have identified the command definition, verify the spelling of check_foo in $ARG1$ (in CCM) matches the exact spelling of the command directive name command[check_foo].

Next, make sure the plugin being executed on the remote host actually exists. In this example, the name of the plugin is:

/usr/local/nagios/libexec/check_foo.sh


Execute the following command on the remote host to see if it exists:

ls -la /usr/local/nagios/libexec/check_foo.sh


If it does not exist, then the output would be something like:

ls: cannot access /usr/local/nagios/libexec/check_foo.sh: No such file or directory

 

If this is your problem, you will have to copy the plugin to the /usr/local/nagios/libexec/ folder.

Make sure the filename check_foo.sh has the correct file extension. Different plugins have different file extensions (.sh, .bin, .pl, .py, etc.).  The path must include the extension of the plugin, but the command directive name, wrapped in 'command[]' does not need an extension.

 

 

Final Thoughts

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

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

0 (0)
Article Rating (No 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
NRPE - CHECK_NRPE: Socket Timeout After n Seconds
Viewed 12793 times since Sun, Jul 16, 2017
NRPE - Remote does not support Version 3 Packets
Viewed 2675 times since Mon, Nov 27, 2017
NRPE - General Troubleshooting Tips
Viewed 2032 times since Mon, Jul 17, 2017
CHECK_NRPE: Error - Could not connect to xxx.xxx.xxx.xxx: Connection reset by peer
Viewed 4594 times since Fri, Jul 14, 2017
NRPE - Turn Off XINETD Logging On Success
Viewed 1570 times since Tue, Mar 7, 2017
NRPE - Agent and Plugin Explained
Viewed 8074 times since Fri, Jul 14, 2017
NRPE - Warning: This Plugin Must Be Either Run As Root Or Setuid
Viewed 1244 times since Mon, Jul 17, 2017
NRPE - Connection Refused Or Timed Out
Viewed 1298 times since Mon, Jul 17, 2017
NRPE - Linux Cached Memory Not Added to Free Memory
Viewed 1106 times since Wed, Jan 27, 2016
NRPE - CHECK_NRPE: Error Receiving Data From Daemon
Viewed 1832 times since Mon, Jul 17, 2017