This is the slide deck from a session presented by Ray Bilyk and Tom Bilan at MWLUG 2014 in Grand Rapids, Michigan on August 29, 2014.
It's an introduction into using SNMP to capture metrics and monitor your IBM Domino servers using SNMP (Simple Network Management Protocol). This presentation includes links to FREE tools you can use.
Homebrew Your Own Metrics - An IBM Domino Administrator's Guide to SNMP (MWLUG 2014 Session SA103)
1. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
(SA103)
Ray Bilyk, Lotus Notes Administrator
Dr. Tom Bilan, Director of Technical Services - IHI, LCE and BLD
Ilitch Holdings, Inc.
2. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Ray Bilyk
• Notes Administrator at Ilitch Holdings, Inc.
•
• Member of the Month, SocialBizUG.org
• Silver Medal, National Homebrew Competition
• http://www.thepridelands.com
Dr. Tom Bilan
• Director of Technical Services at Ilitch Holdings, Inc.
• https://www.linkedin.com/in/bilan
3. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
4. Outline
• Overview of presentation
• Abstract
• Overview of Domino monitoring capabilities
• Backstory
• SNMP Basics
• SNMP Support in Domino
• SNMP command-line
• Other examples
5. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
ABSTRACT:
It's important as an IBM Domino administrator to get metrics on
your servers so that you know what's going on in your
"Brewhouse". There are also many ways to obtain this very
valuable information, like 3rd party tools and even the IBM
Domino Administrator client. What many don't know is that there
is also another way to capture this very valuable information.
SNMP (Simple Network Management Protocol) is an Internet-standard
protocol for managing devices on IP networks.
In this session, you will learn more about it, what it can give you,
how to set it up, and ways to 'drink in' or monitor the information.
With proper configuration, administrators not familiar with IBM
Domino can obtain and use key IBM Domino server metrics.
Homebrew your own metrics by attending this session!
6. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Existing Domino Monitoring Options
• Traditional Monitoring
– Monitoring Configuration database (EVENTS4.NSF)
– Statistics Reports database (STATREP.NSF)
• Domino Domain Monitoring (DDM)
• Domino Administrator client
• 3rd Party Tools
7. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
The Backstory
8. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
What is SNMP?
It’s not Simple (until you understand it)
It’s not just for Networks
It’s for Management
It’s a Protocol
It’s an industry standard communication protocol for talking
to devices that are connected to networks. If a device
says it’s manageable it likely has SNMP capabilities.
9. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
How can SNMP help you?
SNMP can be used to measure something immediately or
over time so that you can make better decisions.
SNMP traps can be sent to alert you of an event (i.e. drive
failure).
SNMP can be used to measure and then set thresholds that
trigger alerts.
10. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
How can SNMP help you? cont
SNMP is an enabler that allows visibility into real information so you’re not guessing.
SNMP can answer questions like:
– Do we need more phone lines?
– Do we need more Internet bandwidth?
– Why is my storage running slow?
• Is it CPU? Memory? Disk I/O? Network??????
– Am I going to run out of disk space 3 months from now?
– What was going on 20 minutes ago when everyone said the
network was running slow?
– Do I have a POS system that is getting hard drive errors and will
probably die 3 weeks from now?
– What temperature was it in the data center at 4 am 3 weeks
ago?
– How many mail messages are in the queue?
11. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Why use SNMP instead of a special
tool?
SNMP provides a common interface to get management
information for the thousands of different devices made
by thousands of vendors.
Each product may have it’s own management program but
what if you want a dashboard with many different
devices on one web page?
Once you master SNMP every device looks the same. (In
other words, all metric collection problems look like nails
so SNMP is the metaphorical hammer)
It’s a standard and there are MANY free tools
12. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
The Lingo
MIB – Management Information Base – A vendor provided
file that explains what SNMP functionality they support.
OID – Object Identifier – This is a specific variable that you
can get or set on a device.
MIB Namespace – A hierarchy that explains how an OID is
determined. (picture coming in a few slides)
Community – Password (RO = read-only, RW=read-write)
13. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
The Lingo Cont.
Get – Asking the device for a value
Set – Changing a value in a device
Trap – A device sending out an alert
Manager – Your PC
Agent – The device you’re monitoring
14. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
MIB
15. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
MIB Namespace
16. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Data Types
17. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
What you need to use SNMP
The bare minimum to get started:
– A SNMP querying program
– IP address of the device
– Community name
– The OID
Extras:
– Device MIBs (yes… you don’t need MIBs to
query a device)
– A cool GUI
– SNMP Trap receiver
18. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Examples
19. Domino MIB Example
lnWaitingMail OBJECT-TYPE --<< INT mail.waiting
SYNTAX INTEGER (0..2147483647)
ACCESS read-only
STATUS optional
DESCRIPTION
"Number of mail messages waiting to be routed."
::= { lnMail 6 }
lnDeadMail OBJECT-TYPE --<< INT mail.dead
SYNTAX INTEGER (0..2147483647)
ACCESS read-only
STATUS optional
DESCRIPTION
"Number of dead (undeliverable) mail messages."
::= { lnMail 1 }
20. SNMP MIB Example –Writeable
lnRemoteReboot OBJECT-TYPE
SYNTAX INTEGER {
no(1),
yes(2)
}
ACCESS read-write
STATUS mandatory
DESCRIPTION
"Set to 'yes' to reboot the entire system.
This value will be returned as 'yes' if the
system is in
the process of rebooting but hasn't come down
yet."
::= { lnControl 5 }
21. Domino SNMP Query Example
H:>snmpwalk -Of -v2c -c mwlug -m ALL 172.16.0.37 lnServerCPUCount
.iso.org.dod.internet.private.enterprises.lotus.notes.lnInfo.lnStats.lnServer
.lnServerInfo.lnServerCPUCount.0 = INTEGER: 4
H:>snmpwalk -On -v2c -c mwlug -m ALL 172.16.0.37 lnServerCPUCount
.1.3.6.1.4.1.334.72.1.1.6.2.12.0 = INTEGER: 4
H:>snmpwalk -v2c -c mwlug -m ALL 172.16.0.37 lnServerCPUCount
NOTES-MIB::lnServerCPUCount.0 = INTEGER: 4
H:>snmptranslate -Td -m NOTES-MIB .1.3.6.1.4.1.334.72.1.1.6.2.12.0
NOTES-MIB::lnServerCPUCount.0
lnServerCPUCount OBJECT-TYPE
-- FROM NOTES-MIB
SYNTAX INTEGER (0..2147483647)
MAX-ACCESS read-only
STATUS optional
DESCRIPTION "The number of processors installed on this server."
::= { iso(1) org(3) dod(6) internet(1) private(4) enterprises(1) lotus(334)
notes(72) lnInfo(1) lnStats(1) lnServer(6) lnServerInf
o(2) lnServerCPUCount(12) 0 }
26. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Setting up Domino for SNMP
http://www-01.ibm.com/support/docview.wss?uid=swg21169283
or IBM Domino Administrator 9.0.1 Social Edition Help
Look for “Configuring the Domino SNMP Agent” (OS specific steps)
Steps for setup on Windows OS
1. Configure SNMP at the Windows operating system level
– Go to Start --> Settings --> Control Panel --> Add/Remove Programs.
– Select "Add/Remove Windows Components" on the left.
– Choose "Management and Monitoring Tools" and click "Details".
– Select all under "Management..."
– Reboot the operating system
2. Start Domino
27. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Setting up Domino for SNMP (continued)
3. Configure the Domino LNSNMP agent to run as a service:
– Run the following commands in the Domino program directory.
First stop the service if it is already running - in a DOS prompt run commands :
c:Lotusdominonet stop lnsnmp
c:Lotusdominonet stop snmp
NOTE: If the service is not already running you may see the error:
System error 1060 has occurred.
The specified service does not exist as an installed service.
c:LotusdominoLNSNMP -Sc ( this command is case sensitive )
If it starts you will see :
Service creation complete
28. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Setting up Domino for SNMP (continued)
3. Continued
– More commands to run…
c:Lotusdominonet start snmp
c:Lotusdominonet start lnsnmp
If it starts you will see:
The Lotus Domino SNMP Agent service was started successfully.
(NOTE: SNMP console appears on server machine)
4. Run these commands on Domino server console
load quryset
load intrcpt (for SNMP traps)
load collect
5. Add quryset and/or intrcpt and collect to ServerTasks (NOTES.INI)
29. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Barracuda Web Filter MIB
Barracuda-SPYWARE DEFINITIONS ::=BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, INTEGER
FROM SNMPv2-SMI
barracuda
FROM Barracuda-REF;
bspyware MODULE-IDENTITY
LAST-UPDATED "201011040000Z"
ORGANIZATION "Barracuda Networks, Inc."
CONTACT-INFO
"
Barracuda Networks Inc.
3175 S. Winchester Blvd.
Campbell, CA 95008
"
DESCRIPTION
"
Barracuda Web Filter MIB.
Provides:
Objects:
* 1.3.6.1.4.1.20632.3.1.2 -- ActiveTCPConnections
* 1.3.6.1.4.1.20632.3.1.3 -- Throughput
* 1.3.6.1.4.1.20632.3.1.4 -- PolicyBlocks
* 1.3.6.1.4.1.20632.3.1.5 -- SpywareWebHitBlocks
* 1.3.6.1.4.1.20632.3.1.6 -- SpywareDownloadBlock
* 1.3.6.1.4.1.20632.3.1.7 -- VirusDownloadBlock
* 1.3.6.1.4.1.20632.3.1.8 -- SpywareProtocolBlocks
* 1.3.6.1.4.1.20632.3.1.9 -- HTTPTrafficAllowed
30. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Example – Barracuda Output
31. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Server Room Humidity
32. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
NetApp CPU Usage
33. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Voice Channel Usage – Multiple Sources
34. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Fox Internet Traffic
XO & AT&T – 24 hours
35. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Fox Internet Traffic - Monthly
36. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Port Errors
37. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Network Dashboard
38. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Thresholds and Alerting
39. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Troubleshooting
A few quick things to check if you have problems talking to devices:
– Double-check the community (case counts… it’s a
password)
– Double-check the IP address (ping it)
– Double-check that SNMP is Enabled on the device
(often it’s disabled by default)
– Double-check that there isn’t any restrictions from
where the device accepts SNMP packets from
– Double-check the SNMP version. Version 1 or 2c are
the most common and compatible. Version 3 uses
advanced authentication and may be overkill so stick
with 1 or 2c.
40. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Free Tools (almost better than free beer!)
Net-SNMP http://www.net-snmp.org/
Cacti http://www.cacti.net/
Manageengine MIBBrowser http://www.manageengine.com/
Domino MIB (domino.mib) is located in Domino program directory
41. Homebrew your own Metrics:
An IBM Domino Administrator's Guide to SNMP
Questions?