How to use SNMP in Icewarp

SNMP belongs to the communication protocols family and has become widely accepted somewhere around 1993 as a powerful method for TCP/IP networks management. The original SNMP concept designer is the IETF (Internet Engineering Task Force). SNMP protocol is adaptable and it is suitable for any TCP/IP based networks, as well as other types of networks.

SNMP itself is a front-end for gathering statistics and gaining data about a network device in terms of client-server relationship. The network manager (client program) connects virtually to the SNMP agent (server program) which tests the network device, and returns back information about the device's status to the manager. The list of possible tests, collection of objects and the list of control values is called Management Information Base (MIB).

The main advance against traditional network management tools such as "ping", and "netstat" is in SNMP interoperability and universality. With SNMP you can monitor almost any network device regardless the fact it is hardware or software. SNMP gives you control to the information on the manageable device. The SNMP support in Icewarp Server is mainly purposed for integrators and developers. Majority of "normal" administrators would satisfy with ordinary statistics inside Icewarp Server Administration Console.

Usage with Icewarp Server

• First you have to enable SNMP support in your Icewarp Server. Set the SNMP port to 1161. You can do it in the Main Menu > System > Services > General tab section:

• Icewarp Server has a it's own private MIB. You can find the list of the possibilities of SNMP protocol usage within Icewarp Server in the following file - snmp-mib.txt. The current version of this file is available in <install_dir>\doc\snmp-mib.txt. The file also defines the structure of the queries and so called OIDs (object ID). The OIDs can be combined in many ways to fetch info about various aspect of your server.
• To be able to interpret these you need also an SNMP network manager utility for querying and connecting to your server. You can use e.g. snmpget or snmpwalk utilities to display the information http://net-snmp.sourceforge.net/.

EXAMPLES

Here are some examples of usage snmpwalk with Icewarp SNMP server:

The syntax for diplaying the top node:

snmpwalk -v 1 -c private <host_name> 1.3.6.1.4.1.23736.1.2.1.1.1

How to display  status of all services:

snmpwalk -v 1 -c private <host_name> 1.3.6.1.4.1.23736.1.2.1.1.2.2

IceWarp Server - SNMP OIDs

Root OID

1.3.6.1.4.1.23736.1.2.1.<PROD>.1.<SysID>

PROD

1 - IceWarp Server (1.3.6.1.4.1.23736.1.2.1.1.1.<SysID>)

SysID

1 - sysDesc
2 - sysObjectId
3 - sysUpTime
4 - sysContact
5 - sysName
6 - sysLocation
7 - sysServices
8 - sysVersion

Service OID

1.3.6.1.4.1.23736.1.2.1.1.2.<SvcID>.<SVC>

SvcID

1 - svcName
2 - svcRunning
3 - svcUpTime
4 - svcServerOutData
5 - svcServerInData
6 - svcClientOutData
7 - svcClientInData
8 - svcServer
9 - svcServerPeak
10 - svcClient
11 - svcClientPeak
12 - svcServerConns
13 - svcPeakWorkingSetSize
14 - svcPageFileUsage
15 - svcWorkingSetSize

16 - svcSMTPMessageOut
17 - svcSMTPMessageIn 
18 - svcSMTPMessageFailed
19 - svcSMTPFailedTooData
20 - svcSMTPFailedVirus
21 - svcSMTPFailedCF
22 - svcSMTPFailedStaticFilter
23 - svcSMTPFailedBWFilter 
24 - svcSMTPFailedDNSBL
25 - svcSMTPFailedTarpit
26 - svcSMTPFailedSpam

SVC

1 - SMTP
2 - POP3 
3 - IMAP 
4 - IM
5 - GW
6 - FTP
7 - Control