net-snmp配置开发及注意事项

今天药忘吃喽~ 2022-09-20 15:01 424阅读 0赞

## 一．安装及配置SNMP（win32环境） ##

### 1.下载 ###

从[www.sourceforge.net][]下载到最新的net-snmp（目前最新版本5.4.1）net-snmp-5.4.1.zip

### 2.解压编译 ###

解压后，可以看到有一个win32目录，里面存放的是和win32环境相关的文件，有3个dsw：

libsdll.dsw             编译lib文件和dll文件的工程

win32.dsw            编译lib文件和工具文件如snmpget,snmpset的工程

win32sdk.dsw              类似于win32.dsw，区别在于：需要安装Platform SDK。如果需要agent能支持 interfaces等一些高级功能，必须用此工程编译。XPSP2 Platform SDK的下载地址

[http://www.microsoft.com/msdownload/platformsdk/sdkupdate/XPSP2FULLInstall.htm][http_www.microsoft.com_msdownload_platformsdk_sdkupdate_XPSP2FULLInstall.htm]

只需要安装Core SDK就可以了，安装完后需要从开始菜单中Register一下。

注意编译的顺序，最好先编译libsdll.dsw，把netsnmp.lib，netsnmpagent.lib，netsnmphelpers.lib，netsnmpmibs.lib，netsnmptrapd.lib文件先编译好，再编译win32sdk.dsw中的项目。

### 3.安装 ###

运行win32目录下的install-net-snmp.bat批处理文件，会把上一步编译生成的文件及相关的头文件等拷贝到c:/usr目录。

### 4.配置 ###

在c:/usr/etc/snmp目录添加配置文件snmpd.conf，添加如下内容：

rocommunity  public

rwcommunity  private

它表示的含义是，启动agent服务后，通过public共同体是只读的，private共同体可读也可写。

在命令行运行如下命令，将snmp注册为windows的服务：

cmd>”C:/usr/bin/snmpd.exe” –register -Lf "C:/usr/log/snmpd.log"

注册成功后可以在【控制面板】->【管理工具】->【服务】中看到刚注册的服务，服务名是：net-snmp agent

### 5.运行 ###

cmd>net start “net-snmp agent”

如果正常，会得到启动服务成功的提示

### 6.验证 ###

cmd>snmpget –v2c –c public localhost 1.3.6.1.2.1.1.5.0

cmd>snmpset -v2c -c private localhost sysContact.0 = piyeyong

如果正常，会的到取得和设置成功的提示，出错会给出错误提示。

## 二．MIB文件编写 ##

MIB文件会存放于C:/usr/share/snmp/mibs/目录下，是\*.txt，纯文本文件，可以直接打开查看和更改。RFC1213中定义的MIB节点信息的定义存放与RFC1213-MIB.txt，这些节点是比较重要的，会经常用到。

如果要扩展MIB，应该定义在1.3.6.1.4.1(.iso.org.dod.internet.private.enterprises)子树下。自定义MIB的节点，只需要描述该节点的SYNTAX，ACCESS，STATUS，DESCRIPTION等属性及它属于父节点的第几个子节点即可。如下所示，为扩展MIB的一个简单例子：

PROBA-MIB DEFINITIONS::=BEGIN

IMPORTS

enterprises,OBJECT-TYPE,Integer32,TimeTicks

FROM SNMPv2-SMI

TEXTUAL-CONVENTION,  DisplayString FROM SNMPv2-TC;

\-- proba node

proba OBJECT IDENTIFIER::=\{enterprises 8888\}

baseinfo     OBJECT IDENTIFIER ::= \{ proba 1 \}

\-- company name

probaCompName OBJECT-TYPE

SYNTAX DisplayString (SIZE (0..255))

ACCESS read-only

STATUS mandatory

DESCRIPTION "The Name of company"

::=\{baseinfo 1\}

\-- company location

probaLocation OBJECT-TYPE

SYNTAX DisplayString (SIZE (0..255))

ACCESS read-write

STATUS mandatory

DESCRIPTION "The Location of company"

::=\{baseinfo 2\}

\-- employee number

probaEmployeeNumber OBJECT-TYPE

SYNTAX INTEGER

ACCESS read-only

STATUS mandatory

DESCRIPTION "The number of employee"

::=\{baseinfo 3\}

END

## 三．Agent端开发 ##

在上一步中定义好MIB的结构后，现在就开始编码实现定义好的节点。net-snmp提供了一个MIB2C工具，利用它可以根据MIB的定义和配置文件自动生成\*.c和\*.h模板文件，然后只需要在相应位置添加对节点数据的处理就可以了。

### 1.配置net-snmp的perl模块 ###

用使用mib2c工具，需要perl模块的支持，可以从[http://www.ActiveState.com/ActivePerl][http_www.ActiveState.com_ActivePerl]下载，目前最新版是5.8.8

在net-snmp源文件的perl目录下，运行以下命令：

cmd>perl makefile.pl

如果成功，会生成makefile文件

cmd>nmake

cmd>nmake install

这时，会将net-snmp相关的perl模块编译好并安装到c:/perl/site/lib目录下。

注：有时候运行nmake会失败，把其它机器上安装好的c:/perl/site/lib目录下的文件拷贝过来，也可以运行。

### 2.用mib2c生成模板源代码 ###

运行以下命令：

cmd>mib2c -c mib2c.scalar.conf baseinfo

会按照模板配置文件mib2c.scalar.conf生成baseinfo.h和baseinfo.c文件。注意：baseinfo是上一步在MIB中定义的proba下的一个节点。在baseinfo.c中有很多/\* XXX 注释\*/的地方，这些地方是需要我们修改，填上我们对节点数据的处理代码。

### 3.对read-only节点的代码修改 ###

以probaCompName节点为例：

int

handle\_probaCompName(netsnmp\_mib\_handler \*handler,

netsnmp\_handler\_registration \*reginfo,

netsnmp\_agent\_request\_info   \*reqinfo,

netsnmp\_request\_info         \*requests)

/\* We are never called for a GETNEXT if it's registered as a

"instance", as it's "magically" handled for us.  \*/

/\* a instance handler also only hands us one request at a time, so

we don't need to loop over a list of requests; we'll only get one. \*/

switch(reqinfo->mode) \{

case MODE\_GET:

snmp\_set\_var\_typed\_value(requests->requestvb, ASN\_OCTET\_STR,

(u\_char \*)"proba"/\* XXX: a pointer to the scalar's data \*/,

strlen("proba")/\* XXX: the length of the data in bytes \*/);

break;

default:

/\* we should never get here, so this is a really bad error \*/

snmp\_log(LOG\_ERR, "unknown mode (%d) in handle\_probaCompName/n", reqinfo->mode );

return SNMP\_ERR\_GENERR;

return SNMP\_ERR\_NOERROR;

从上面的代码看出，只需在两处/\* XXX 注释 \*/的代码处填上这个节点的数据即可，管理站在执行get命令时这个值会返回给管理站。

### 4.对read-write节点的代码修改 ###

以probaLocation节点为例：

staticchar location\[256\];

void

init\_baseinfo(void)

memset(location, '/0', sizeof location);

memcpy(location, "beijing", sizeof"beijing");

。。。。。。

int

handle\_probaLocation(netsnmp\_mib\_handler \*handler,

netsnmp\_handler\_registration \*reginfo,

netsnmp\_agent\_request\_info   \*reqinfo,

netsnmp\_request\_info         \*requests)

int ret;

/\* We are never called for a GETNEXT if it's registered as a

"instance", as it's "magically" handled for us.  \*/

/\* a instance handler also only hands us one request at a time, so

we don't need to loop over a list of requests; we'll only get one. \*/

switch(reqinfo->mode) \{

case MODE\_GET:

snmp\_set\_var\_typed\_value(requests->requestvb, ASN\_OCTET\_STR,

(u\_char \*)location /\* XXX: a pointer to the scalar's data \*/,

strlen(location)/\* XXX: the length of the data in bytes \*/);

break;

/\*

\* SET REQUEST

\* multiple states in the transaction.  See:

\* http://www.net-snmp.org/tutorial-5/toolkit/mib\_module/set-actions.jpg

\*/

case MODE\_SET\_RESERVE1:

/\* or you could use netsnmp\_check\_vb\_type\_and\_size instead \*/

ret = netsnmp\_check\_vb\_type(requests->requestvb, ASN\_OCTET\_STR);

if ( ret != SNMP\_ERR\_NOERROR ) \{

netsnmp\_set\_request\_error(reqinfo, requests, ret );

break;

case MODE\_SET\_RESERVE2:

/\* XXX malloc "undo" storage buffer \*/

if (0/\* XXX if malloc, or whatever, failed: \*/) \{

netsnmp\_set\_request\_error(reqinfo, requests, SNMP\_ERR\_RESOURCEUNAVAILABLE);

break;

case MODE\_SET\_FREE:

/\* XXX: free resources allocated in RESERVE1 and/or

RESERVE2.  Something failed somewhere, and the states

below won't be called. \*/

break;

case MODE\_SET\_ACTION:

/\* XXX: perform the value change here \*/

if (0/\* XXX: error? \*/) \{

netsnmp\_set\_request\_error(reqinfo, requests, SNMP\_ERR\_COMMITFAILED/\* some error \*/);

break;

case MODE\_SET\_COMMIT:

/\* XXX: delete temporary storage \*/

memcpy(location, requests->requestvb->buf, requests->requestvb->val\_len);

location\[requests->requestvb->val\_len\] = '/0';

if (0/\* XXX: error? \*/) \{

/\* try \_really\_really\_ hard to never get to this point \*/

netsnmp\_set\_request\_error(reqinfo, requests, SNMP\_ERR\_COMMITFAILED);

break;

case MODE\_SET\_UNDO:

/\* XXX: UNDO and return to previous value for the object \*/

if (0/\* XXX: error? \*/) \{

/\* try \_really\_really\_ hard to never get to this point \*/

netsnmp\_set\_request\_error(reqinfo, requests, SNMP\_ERR\_UNDOFAILED);

break;

default:

/\* we should never get here, so this is a really bad error \*/

snmp\_log(LOG\_ERR, "unknown mode (%d) in handle\_probaLocation/n", reqinfo->mode );

return SNMP\_ERR\_GENERR;

return SNMP\_ERR\_NOERROR;

对于read-write节点的处理要复杂一点，对每一次管理站的set请求，代理站的处理会经过如下图所示的步骤：

从图中可以看出，通过这种机制，在处理出错的时候，可以根据需要实现回滚操作。

### 5.重新编译 ###

按照一下步骤重新编译工程：

1）把baseinfo.h和baseinfo.c文件拷贝到net-snmp源文件下agent/mibgroup目录下；

2）打开win32sdk，将其添加到netsnmpmibssdk工程；

3）打开net-snmp源文件下win32目录下的mib\_module\_includes.h，添加：

\#include "mibgroup/proba/baseinfo.h"

4）打开net-snmp源文件下win32目录下的mib\_module\_inits.h，添加：

if (should\_init("baseinfo")) init\_baseinfo();

5）重新编译netsnmpmibssdk工程和snmpdsdk工程，把生成的snmpd.exe拷贝到c:/usr/bin，netsnmpmibs.lib拷贝到c:/usr/lib

## 四．管理站开发 ##

以获取sysName节点为例：

struct snmp\_session session, \*ss;

struct snmp\_pdu \*pdu;

struct snmp\_pdu \*response;

oid anOID\[MAX\_OID\_LEN\];

size\_t anOID\_len = MAX\_OID\_LEN;

struct variable\_list \*vars;

int status;

/\*

\* Initialize the SNMP library

\*/

init\_snmp("snmpapp");

/\*

\* Initialize a "session" that defines who we're going to talk to

\*/

snmp\_sess\_init( &session );                   /\* set up defaults \*/

session.peername = "localhost";

/\* set up the authentication parameters for talking to the server \*/

\#ifdef DEMO\_USE\_SNMP\_VERSION\_3

/\* Use SNMPv3 to talk to the experimental server \*/

/\* set the SNMP version number \*/

session.version=SNMP\_VERSION\_3;

/\* set the SNMPv3 user name \*/

session.securityName = strdup("MD5User");

session.securityNameLen = strlen(session.securityName);

/\* set the security level to authenticated, but not encrypted \*/

session.securityLevel = SNMP\_SEC\_LEVEL\_AUTHNOPRIV;

/\* set the authentication method to MD5 \*/

session.securityAuthProto = usmHMACMD5AuthProtocol;

session.securityAuthProtoLen = sizeof(usmHMACMD5AuthProtocol)/sizeof(oid);

session.securityAuthKeyLen = USM\_AUTH\_KU\_LEN;

/\* set the authentication key to a MD5 hashed version of our

passphrase "The Net-SNMP Demo Password" (which must be at least 8

characters long) \*/

if (generate\_Ku(session.securityAuthProto,

session.securityAuthProtoLen,

(u\_char \*) our\_v3\_passphrase, strlen(our\_v3\_passphrase),

session.securityAuthKey,

&session.securityAuthKeyLen) != SNMPERR\_SUCCESS) \{

snmp\_perror(argv\[0\]);

snmp\_log(LOG\_ERR,

"Error generating Ku from authentication pass phrase. /n");

exit(1);

\#else/\* we'll use the insecure (but simplier) SNMPv1 \*/

/\* set the SNMP version number \*/

session.version = SNMP\_VERSION\_1;

/\* set the SNMPv1 community name used for authentication \*/

session.community = (u\_char\*)"public";

session.community\[6\] = '/0';

session.community\_len = 6;

\#endif/\* SNMPv1 \*/

/\* windows32 specific initialization (is a noop on unix) \*/

SOCK\_STARTUP;

/\*

\* Open the session

\*/

ss = snmp\_open(&session);                     /\* establish the session \*/

if (!ss) \{

snmp\_perror("ack");

snmp\_log(LOG\_ERR, "something horrible happened!!!/n");

exit(2);

/\*

\* Create the PDU for the data for our request.

\*   1) We're going to GET the system.sysDescr.0 node.

\*/

pdu = snmp\_pdu\_create(SNMP\_MSG\_GET);

read\_objid(".1.3.6.1.2.1.1.5.0", anOID, &anOID\_len);

//get\_node("sysDescr.0", anOID, &anOID\_len);

snmp\_add\_null\_var(pdu, anOID, anOID\_len);

/\*

\* Send the Request out.

\*/

status = snmp\_synch\_response(ss, pdu, &response);

/\*

\* Process the response.

\*/

if (status == STAT\_SUCCESS && response->errstat == SNMP\_ERR\_NOERROR) \{

/\*

\* SUCCESS: Print the result variables

\*/

for(vars = response->variables; vars; vars = vars->next\_variable)

print\_variable(vars->name, vars->name\_length, vars);

/\* manipuate the information ourselves \*/

for(vars = response->variables; vars; vars = vars->next\_variable) \{

int count=1;

if (vars->type == ASN\_OCTET\_STR) \{

char \*sp = (char \*)malloc(1 + vars->val\_len);

memcpy(sp, vars->val.string, vars->val\_len);

sp\[vars->val\_len\] = '/0';

printf("value \#%d is a string: %s/n", count++, sp);

free(sp);

else

printf("value \#%d is NOT a string! Ack!/n", count++);

\} else \{

/\*

\* FAILURE: print what went wrong!

\*/

if (status == STAT\_SUCCESS)

fprintf(stderr, "Error in packet/nReason: %s/n",

snmp\_errstring(response->errstat));

else

snmp\_sess\_perror("snmpget", ss);

/\*

\* Clean up:

\*  1) free the response.

\*  2) close the session.

\*/

if (response)

snmp\_free\_pdu(response);

snmp\_close(ss);

/\* windows32 specific cleanup (is a noop on unix) \*/

SOCK\_CLEANUP;

注意：需要引用以下头文件：

\#include<net-snmp/net-snmp-config.h>

\#include<net-snmp/utilities.h>

\#include<net-snmp/net-snmp-includes.h>

链接netsnmp.lib:

\#pragmacomment(lib, "netsnmp")

使用的编译环境为VC++2005.net

需要把netsnmp.lib所在的目录添加到【附加库目录】中，Release版的【代码生成】->【运行时库】选择【多线程 DLL (/MD)】，Debug版选择【多线程调试 DLL (/MDd)】；

Stdafx.h中添加：

\#include<windows.h>

【MFC的使用】选择【使用标准 Windows 库】

在编译的过程中发现，不仅要把net-snmp原文件夹下include目录添加到【附加包含目录】，还需要把win32目录也添加进去，因为win32/net-snmp/library下有一个snmpv3-security-includes.h文件。

## 五．其它注意事项 ##

1.        如果是采用下载可执行文件安装net-snmp时，Net-SNMP Agent Service项选择Standard agent，否则无法从管理器上读取到Agent的System等节点下的信息。

使用SNMP++提供的一个C\#组件。控制面板添加安装组件中添加SNMP组件后，system32目录下会增加许多\*.mib文件，如dhcp.mib，这些文件是mib库，存放的是OID与名字和描述的对应关系，相当于DNS。有了这些文件，在SNMP++.net开发包中，调用MIB类的loadDirectoryMib方法，就可以载入这些对应关系了。

[www.sourceforge.net]: http://www.sourceforge.net/
[http_www.microsoft.com_msdownload_platformsdk_sdkupdate_XPSP2FULLInstall.htm]: http://www.microsoft.com/msdownload/platformsdk/sdkupdate/XPSP2FULLInstall.htm
[http_www.ActiveState.com_ActivePerl]: http://www.activestate.com/ActivePerl