Scribd Logo
Upload

Welcome to Scribd!

  • 126 views

    Enabling The NRPE Listener in NSClient 0.4.x For Nagios XI

    Uploaded by

    emma
    nrpe

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd

    Enabling The NRPE Listener in NSClient 0.4.x For Nagios XI

    Uploaded by

    emma
    126 views4 pages
    nrpe

    Original Title

    Enabling the NRPE Listener in NSClient 0.4.x for Nagios XI

    Copyright

    © © All Rights Reserved

    Available Formats

    PDF, TXT or read online from Scribd

    Did you find this document useful?

    Is this content inappropriate?

    nrpe

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    126 views4 pages

    Enabling The NRPE Listener in NSClient 0.4.x For Nagios XI

    Uploaded by

    emma
    nrpe

    Copyright:

    © All Rights Reserved
    Download as PDF, TXT or read online from Scribd
    Download as pdf or txt
    of 4

    Nagios XI - Enabling the NRPE Listener In

    NSClient++ 0.4.x

    The Industry Standard in IT Infrastructure Monitoring

    Purpose
    This document describes how to enable and configure the NRPE Listener in NSClient++ 0.4.x (and newer) for Nagios XI on a remote
    windows machine. The NRPE listener allows the Nagios XI server to perform more advanced and customized monitoring methods
    using check_nrpe (compared to requests using check_nt).

    Some reasons you may want to use check_nrpe instead of check_nt are:
    The built in CPU / memory / disk checks are more flexible and customizable
    The CheckExternalScripts module can execute various user written script (VB / BAT / EXE / Perl / Python / PowerShell).
    Uses SSL

    Target Audience

    This document is intended for use by Nagios XI Administrators that want to enable NRPE in NSClient++.

    Requirements

    A running Nagios XI server


    NSClient++ 0.4.x (or newer) installed on the Windows Client as per this documentation:
    https://assets.nagios.com/downloads/nagiosxi/docs/Installing-The-Windows-Agent-NSClient++-for-Nagios-XI.pdf

    Note: This document is for version 0.4.x of NSClient++. For version 0.3.x of NSClient++ see:
    https://assets.nagios.com/downloads/nagiosxi/docs/Enabling-The-NRPE-Listener-In-NSClient-0.3.x.pdf

    The following documentation explains how the configuration file works in NSClient++ and may also be helpful:
    https://assets.nagios.com/downloads/nagiosxi/docs/Configuring-The-Windows-Agent-NSClient++-for-Nagios-XI.pdf

    Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 1


    P.O. Box 8154 Int'l: +1 651-204-9102 Email:[email protected]
    Saint Paul, MN 55108 Fax: +1 651-204-9103
    USA
    Copyright 2010 - 2016 Nagios Enterprises, LLC
    Revision 1.1 February, 2017
    Nagios XI - Enabling the NRPE Listener In
    NSClient++ 0.4.x
    Update NSClient++ Configuration

    The configuration file in NSClient++ 0.4.x is called nsclient.ini and is located here:
    C:\Program Files\NSClient++\nsclient.ini

    The configuration file can be manually edited OR you can execute commands in a command prompt to make the required changes in
    the configuration file. This document instructs you to execute the commands to make the changes. Following this is a summary
    showing you the updated settings in the configuration file.

    Log onto your remote windows machine as an administrator.


    Open a command prompt with administrative rights and run the following commands:

    cd "C:\Program Files\NSClient++"
    nscp settings --activate-module NRPEServer --add-defaults
    nscp settings --path /settings/NRPE/server --key "allow arguments" --set true
    nscp settings --path /settings/NRPE/server --key "allow nasty characters" --set true
    nscp settings --path /settings/NRPE/server --key insecure --set true
    nscp settings --activate-module CheckExternalScripts --add-defaults
    nscp settings --path "/settings/external scripts" --key "allow arguments" --set true
    nscp settings --path "/settings/external scripts" --key "allow nasty characters" --set true

    This should not produce any output, however don't be alarmed if you see some Failed to register plugin errors.

    Open the configuration file nsclient.ini in a text editor for editing (like Notepad) to see the updated configurations.

    Under the [/modules] section you will see the following lines:

    NRPEServer = enabled
    CheckExternalScripts = enabled

    Under the [/settings/NRPE/server] section you will see the following lines:

    allow arguments = true


    allow nasty characters = true
    insecure = true

    Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 2


    P.O. Box 8154 Int'l: +1 651-204-9102 Email:[email protected]
    Saint Paul, MN 55108 Fax: +1 651-204-9103
    USA
    Copyright 2010 - 2016 Nagios Enterprises, LLC
    Revision 1.1 February, 2017
    Nagios XI - Enabling the NRPE Listener In
    NSClient++ 0.4.x
    Under the [/settings/external scripts] section you will see the following lines:

    allow arguments = true


    allow nasty characters = true

    What does allow arguments , allow nasty characters and insecure do?
    allow arguments
    This allows you send options in the check_nrpe command, it allows for flexible monitoring configurations.
    allow nasty characters
    This allows the `&><'"\[]{} characters to be used in the arguments.
    insecure
    Version 2.15 and earlier of check_nrpe on the Nagios XI server use an older SSL method that has been superseded
    by newer technology. check_npre v3 and newer provide more secure methods however to allow backward
    compatibility the insecure setting needs to be enabled in nsclient.ini.

    Restarting The NSClient++ Service

    NSClient must now be restarted. In the Windows open the Services console under Administrative Tools. If you cannot locate this, use
    services.msc to open the Services console.

    Locate the NSClient++ service.


    Right click the NSClient++ service and select Restart.
    You can close the Services console as it's no longer required.

    Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 3


    P.O. Box 8154 Int'l: +1 651-204-9102 Email:[email protected]
    Saint Paul, MN 55108 Fax: +1 651-204-9103
    USA
    Copyright 2010 - 2016 Nagios Enterprises, LLC
    Revision 1.1 February, 2017
    Nagios XI - Enabling the NRPE Listener In
    NSClient++ 0.4.x
    Testing On The Nagios XI Server

    Log in as root to the Nagios XI Server and enter the following:

    cd /usr/local/nagios/libexec/
    ./check_nrpe -H [IP of the windows system]

    You now should see the I seem to be doing fine... output, verifying the test is successful.

    Additional Resources

    The following documents demonstrate the different ways that NRPE can be utilized.

    Integrating AutoIt With Nagios XI


    https://assets.nagios.com/downloads/nagiosxi/docs/Integrating_autoIT_With_Nagios.pdf
    Checking For Windows Updates With Nagios XI
    https://assets.nagios.com/downloads/nagiosxi/docs/Checking-For-Windows-Updates-With-Nagios-XI.pdf
    Monitoring Performance Counters in Nagios Using NSClient++
    https://support.nagios.com/kb/article.php?id=127
    Windows Memory Usage Physical
    https://support.nagios.com/kb/article.php?id=169
    How to Restart A Windows Service With NRPE
    https://assets.nagios.com/downloads/nagiosxi/docs/Restarting-Windows-Services-With-NRPE-in-Nagios-XI.pdf
    Using Scripts / Plugins With NSClient++
    https://support.nagios.com/kb/article.php?id=528

    Finishing Up

    You should now have successfully configured the NRPE Listener on the target system running NSClient++. For any other support
    related questions, please visit the Nagios Support Forums at:

    https://support.nagios.com/forum/

    Nagios Enterprises, LLC US: 1-888-NAGIOS-1 Web: www.nagios.com Page 4


    P.O. Box 8154 Int'l: +1 651-204-9102 Email:[email protected]
    Saint Paul, MN 55108 Fax: +1 651-204-9103
    USA
    Copyright 2010 - 2016 Nagios Enterprises, LLC
    Revision 1.1 February, 2017

    You might also like