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 - ERROR: Missing Argument Exception
Viewed 882 times since Mon, Jul 17, 2017
NRPE - Turn Off XINETD Logging On Success
Viewed 2310 times since Tue, Mar 7, 2017
CHECK_NRPE: Error - Could not connect to xxx.xxx.xxx.xxx: Connection reset by peer
Viewed 6634 times since Fri, Jul 14, 2017
NRPE - NRPE: Unable To Read Output
Viewed 15094 times since Mon, Jul 17, 2017
NRPE - Warning: This Plugin Must Be Either Run As Root Or Setuid
Viewed 1694 times since Mon, Jul 17, 2017
NRPE - CHECK_NRPE: Socket Timeout After n Seconds
Viewed 18973 times since Sun, Jul 16, 2017
NRPE - CHECK_NRPE: Received 0 Bytes From Daemon. Check The Remote Server Logs For Error Messages
Viewed 1686 times since Mon, Jul 17, 2017
NRPE - v3 Compatibility With Previous Versions
Viewed 6845 times since Fri, Jun 24, 2016
NRPE - No Output Returned From Plugin
Viewed 3876 times since Mon, Jul 17, 2017
NRPE - Connection Refused Or Timed Out
Viewed 1866 times since Mon, Jul 17, 2017