nagios 3.3.1 for ipbrick guidedownloads.ipbrick.com/ipbrick/documentation/en/nagios_en.pdf ·...
TRANSCRIPT
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
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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:
• 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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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)
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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!!!
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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:
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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.
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide
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)
IPBRICK International - 2012 Nagios 3.3.1 For IPBRICK Guide