nagios 3.3.1 for ipbrick guidedownloads.ipbrick.com/ipbrick/documentation/en/nagios_en.pdf ·...

Nagios 3.3.1 For IPBRICK Guide

IPBRICK International

August 21, 2012

IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide

CONTENTS 2

Contents

1 Introduction 3

2 Requirements 3

3 Software 3

4 Installation 34.1 Scenarios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

4.1.1 Scenario 1 : Monitoring server (IPBRICK server) . . . . . . 44.1.2 scenario 2 : Monitored server . . . . . . . . . . . . . . . . . 44.1.3 Other machines or Windows Servers . . . . . . . . . . . . . 4

4.2 Installation Procedure . . . . . . . . . . . . . . . . . . . . . . . . . 4

5 Credentials 5

6 Interfaces 56.1 IPBRICK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

6.1.1 Nagios - Settings . . . . . . . . . . . . . . . . . . . . . . . . 56.1.2 Nagios - Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . 76.1.3 Nagios - Host Groups . . . . . . . . . . . . . . . . . . . . . . 126.1.4 Monitoring - Definition . . . . . . . . . . . . . . . . . . . . . 14

6.2 Nagios Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

7 Windows Machines 18


3

1 Introduction

Nagios is a robust monitoring solution that enables organizations to detect andrepair problems reducing therefore the number of IT infrastructure issues beforethey affect end-users, customers and critical business processes.

IPBRICK International offers you the possibility to integrate Nagios in IP-BRICK, presenting thus a perfect solution for system integrators and IT profes-sionals of all fields.

The nagios4ipbrick package allows you to access the Nagios interface and theIPBRICK Monitoring interface, the latter installs a set of agents (nrpes, snmp) inthe monitored servers, that will serve as probes detecting any malfunction.

2 Requirements

• IPBRICK v5.3 with all available updates installed (at least 1 to 7)

3 Software

In terms of software, and depending on the type of machines, the followingpackages are required:

• ipbrick_monitoring_v1.0-rc1.deb

• nagios4ipbrick_3.3.1-rc1.deb

They are available at our eShop:

http://eshop.ipbrick.com/eshop/

At: Downloads -> Software -> IPBRICK Related Software -> IPBRICK 5.3

Note: You have to be registered at our eShop for the Download section to beavailable.

4 Installation

4.1 Scenarios

On every IPBRICK server you wish to monitor you will need to install theipbrick_monitoring_v1.0-rc1.deb package, this package will serve as a clientapplication.

On the IPBRICK you choose to host the nagios package you will need to installfirst the ipbrick monitoring package and after the nagios4ipbrick.


http://eshop.ipbrick.com/eshop/

4.2 Installation Procedure 4

4.1.1 Scenario 1 : Monitoring server (IPBRICK server)

On the IPBRICK you wish to host Nagios, install the following packages inthis order:

1. Install ipbrick_monitoring_v1.0-rc1.deb

2. Install nagios4ipbrick_v3.3.1.deb

4.1.2 scenario 2 : Monitored server

On any other IPBRICK server you wish to monitor install only:

ipbrick_monitoring_v1.0-rc1.deb

4.1.3 Other machines or Windows Servers

• Windows machines: Install the NSClient++ software and configure it (moreinfo on the Windows Machines section);

• IPBrick machines and Others: No installation is required (just provide theright IP at the monitoring interface).

4.2 Installation Procedure

1. Access the IPBRICK’s web interface: Advanced Configurations > IPBRICK > Update

(Figure 1);

Figure 1: IPBRICK Update Page

2. Click on the Browse button, select the ipbrick_monitoring_v1.0-rc1.deband/or the nagios4ipbrick_3.3.1-rc1.deb depending on the server (pleaseconsult the Installation Scenarios section of this document) and install themby clicking on the Insert button;

3. Don’t forget to Apply Configurations.


5

5 Credentials

After the installation procedure, access to the several interfaces is as follows:

Nagios web interface:

nagios url: nagios.domain.com

admin: nagiosadmin

default password : 123456

NOTE: Don’t forget to replace ’domain.com’ with your own domain!

IPBRICK monitoring:

default passphrase (snmp community): public

NOTE: It is highly recommended, by security reasons, to alter the defaultcredentials!!!

IMPORTANT NOTE: Do not forget that the IPBRICK monitoring passphraseshould be identical in both the monitoring and monitored IPBRICKs!!!

6 Interfaces

6.1 IPBRICK

After the installation the IPBRICK will have a new menu on its interface(Figure 2);

Figure 2: IPBRICK.monitoring menu

6.1.1 Nagios - Settings

At this menu it’s possible to configure many settings pertaining to Nagios.


6.1 IPBRICK 6

Figure 3: Nagios - Settings

• State: By default the Nagios is set to Enabled you can also disable it;

• Admin password: The default password. For security reasons, please don’tforget to change it!

• Contact email: The email address that will receive the warning notifications,by default:

[email protected]

• Hosts notification options: By default all the available host status (Recovery,Down or Unreachable) are ticked, if you do not wish to receive warning fromone or any of them, please remove the tick from the desired status.

• Services notification options: As explained previously, by default all the avail-able Services notification options (Recovery, Warning, Unknown or Critical)are ticked, if you do not wish to receive warning from one or any of them,please remove the tick from the desired option.


6.1 IPBRICK 7

Figure 4: Nagios - Settings

6.1.2 Nagios - Hosts

At this page it’s possible to insert hosts. By default, the local host is alreadydefined.

Figure 5: Nagios - Hosts

If you click on localhost you can alter its Host definition settings and/or itsHost monitored services. Each of the options has a dedicated Modify link.


6.1 IPBRICK 8

Figure 6: Local Host Definition Page

Click on the Host Definition Modify link.

Figure 7: Local Host Definition Modify Page

You may change its Host name, Description, IP address, enable or disable thenotifications and change the passphrase.

IMPORTANT NOTE: At the Passphrase field do not forget that both themonitoring and monitored IPBRICKs passphrases should be identical!!!

Click on the Host monitored services Modify link.


6.1 IPBRICK 9

Figure 8: Local Host monitored services Modify Page

You may select which services are to be monitered and also to enable or disablethe notifications.

To insert a new host return to the IPBRICK.Monitoring > Nagios > Hosts page.If you click on Insert you can define 4 types of hosts:

1- IPBrick Servers (33 services can be monitored)


6.1 IPBRICK 10

Figure 9: Nagios - IPBRICK Server Insert

Fill the form with the necessary information.

IMPORTANT NOTE: At the Passphrase field do not forget that both themonitoring and monitored IPBRICKs passphrases should be identical!!!

2- Windows Servers (7 services can be monitored)

Figure 10: Nagios - Windows Server Selection

3- IPBrick Machines


6.1 IPBRICK 11

Figure 11: Nagios - Hosts - IPBRICK Machine Host types

The list of LDAP Machines from the server where Nagios is installed will bedisplayed according to typology.

Figure 12: Nagios - Hosts - IPBrick Machine Insert

Simply highlight the desired machine and click on >> to associate or << todissociate. Confirm your selection by clicking on the Insert button at the bottomof the page.

4- Others (any other unknown machine - monitoring is done based on the IP -Only Ping is monitored


6.1 IPBRICK 12

Figure 13: Nagios - Other Machines Insert

NOTE: Any change done at the inserted machines is replicated at the nagios.domain.comweb interface.

When you insert new hosts they will be visible at the Hosts page.

Figure 14: Nagios - Inserted Machines

As in the localhost you may click on their name and access the correspondingmodify page.

6.1.3 Nagios - Host Groups

Creating groups of hosts can be very important in terms of organizing the mon-itoring process.

Here you may form groups of hosts, organizing them anyway you see fit.

By default the IPBRICK servers group is already created and includes thelocalhost.

Figure 15: Nagios - Host Groups


6.1 IPBRICK 13

Click on Insert to create a new host group.

Figure 16: Nagios - Host Groups Insert page

Click on the Insert button to create the new group.

At the host groups page you will visualize the newly created group.

Figure 17: Nagios - Host Groups page with a new group inserted

Click on the new group name and then on the Modify link.

Figure 18: Nagios - New Host Group Modify page


6.1 IPBRICK 14

Simply highlight the desired non member machine and click on << to associateor >> to dissociate from the group. Confirm your selection by clicking on theModify button at the bottom of the page.

6.1.4 Monitoring - Definition

But there’s also another important menu at the IPBRICK interface:

Advanced configurations > System > Monitoring > Definition

Figure 19: Monitoring - Definitions menu

If you click on the Modify link, it’s possible to set a new passphrase, modifythe IP address, etc.

IMPORTANT NOTE: Again we remind you that the IPBRICK monitoringpassphrase should be identical in both the monitoring and monitored IPBRICKs!!!


6.1 IPBRICK 15

Figure 20: Monitoring - Modify Definitions

At the Services monitoring preferences type the desired values for Warn-ing and Critical and click on the Modify button to confirm the preferences.

• Connected users: The number of connected users. if it exceeds the limitsyou have imposed as warning level, you will receive a warning;

• Load Average: CPU’s load average,

• Disk Space: The free disk space percentage. Again, if the percentages youhave set are exceed the warning level you will receive a notification;

• Zombie procs: A zombie process is one who has completed execution butstill has an entry in the process table;

• Total procs: The total number of running processes;

• Swap (%): Swap is basically the disk’s virtual memory. Usually, it shouldremain at zero percent, if it is being used that means it is being cached atthe disk;

• Mail Queue: The total number of queued emails, i.e: all mails that have notbe sent or received yet

• TCP/UDP connections: The number of simultaneous connections.


6.2 Nagios Interface 16

6.2 Nagios Interface

As stated in the Credentials section of this document, the Nagios web interfaceis available at:

nagios url: nagios.domain.com

admin: nagiosadmin

default password : 123456

NOTE: Don’t forget to replace ’domain.com’ with your own domain!

Figure 21: Nagios web interface - Authentication

When you have logged in, you will access the index page.

Figure 22: Nagios web interface - Index

On the left side of the page you will access the various options.


6.2 Nagios Interface 17

Figure 23: Nagios web interface - Left Menu Frame

When you click on Hostsyou will access all the available information on eachmonitored host (Name, Status, Last Check, Duration and Status Information).

The color code follows the usual:

• Green = Up. There is connectivity

• Yellow = Problems detected

• Red = Down. The Host is Unreachable

Figure 24: Nagios web interface - Hosts

Click on Services to access the details concerning service status.


18

Figure 25: Nagios web interface - Services

Since we disabled the POP notifications at the IPBRICK warning the followingicon is displayed.

Figure 26: Disabled Notifications Icon

Click on Host Groups. As you can see both groups we have created are dis-played along with information on their Status and Services.

Figure 27: Nagios web interface - Services

7 Windows Machines

For the Windows Servers, you are required to install NSClient++ and configureit so the machine would be monitored.

Please follow these steps:


19

1. Download the latest stable version of the NSClient++ addon from:

http://sourceforge.net/projects/nscplus

2. Unzip the NSClient++ files into a new C:\NSClient++ directory

3. Open a command prompt and change to the C:\NSClient++ directory

4. Register the NSClient++ system service with the following command:

nsclient++ /install

5. Install the NSClient++ SysTray with the following command (’SysTray’ iscase-sensitive):

nsclient++ SysTray

6. Open the services manager and make sure the NSClient++ service is allowedto interact with the desktop (see the ’Log On’ tab of the services manager).If it isn’t already allowed to interact with the desktop, check the box to allowit to.

7. Edit the NSC.INI file (located in the C:\NSClient++ directory) and makethe following changes:

- Uncomment all the modules listed in the [modules] section, except forCheckWMI.dll and RemoteConfiguration.dll

- Optionally, request a password for clients by changing the ’password’ op-tion in the [Settings] section.

- Uncomment the allowed_hosts option in the [Settings] section. Add theIP address of the Nagios server to this line, or leave it blank to allow allhosts to connect.

- Make sure the ’port’ option in the [NSClient] section is uncommented andset to ’12489’ (the default port).

8. Start the NSClient++ service with the following command:

nsclient++ /start

9. If installed properly, a new icon should appear in your system tray. It willbe a yellow circle with a black ’M’ inside.


http://sourceforge.net/projects/nscplus

20

10. Success! The Windows server can now be added to the Nagios monitoringconfiguration...

IMPORTANT NOTES:

When testing, disable the windows firewall or enable port 12489 used by theNSClient

Occasionally, you will need to modify the main config file. Be sure to havethe next lines enabled and not commented:

FileLogger.dll

CheckSystem.dll

CheckDisk.dll

NSClientListener.dll

NRPEListener.dll

SysTray.dll

CheckEventLog.dll

CheckHelpers.dll

port=12489

allowed_hosts= XXX.XXX.XXX.XXX (IP of the Nagios server)


nagios 3.3.1 for ipbrick guidedownloads.ipbrick.com/ipbrick/documentation/en/nagios_en.pdf ·...

Documents