net-snmp

1、安装
./configure
make
make install

2、配置文件
可以在./configure的时候指定配置文件所在的位置，也可以用--with-persistent-directory="path"的命令行指定配置文件所在的位置。

配置文件对于net-snmp的运行十分重要，net-snmp中提供了一个EXAMPLE.conf。
可以在EXAMPLE.conf的基础上进行修改，需要修改的地方主要包括：

1) com2sec 设置可访问的IP地址，访问的口令以及分组
#sec.name            source                  community
com2sec local        localhost               private
com2sec mynetwork    10.8.0.0/16              private

2）group   设置安全用户名的组
#sec.model          sec.name
group         MyRWGroup v1         local
group         MyRWGroup v2c        local
group         MyRWGroup usm        local
group         MyROGroup v1         mynetwork
group         MyROGroup v2c        mynetwork
group         MyROGroup usm        mynetwork

3）view 可以对哪些MIB子树进行访问
#incl/excl       subtree               mask
view all          included              .1

4）access   指定各个组对MIB子数的读写权限
#context sec.model sec.level match             read write notif
access MyROGroup ""      any       noauth    exact all    none    none
access MyRWGroup ""      any       noauth    exact all    all    none


3、命令行
在./configure ; make; make install之后在net-snmp/agent目录下会生成一系列的可执行文件。
可以用命令行调用这些执行文件，主要用于测试。主要的命令包括：
先在一个窗口中执行./snmpd

1、snmptable
再打开另一个窗口执行snmptable –v 1 –c demopublic -Os localhost sysORTable,会显示sysORTable的详细信息。（获得table的信息）

2、snmpget
可以执行 snmpget –v 1 –c public localhost SNMPv2-MIB::sysUpTime.0,会得到sysUpTime变量的值。（获得普通变量的信息）。

3、


4、创建私有MIB文件

想要扩展agent吗？先学写MIB文件。
MIB文件的格式比较简单，参照标准MIB文件写就OK了，之后可以用MG-soft编译。在archlinux上MIB文件库是放在/usr/share/snmp/mibs/下面。

几点注意的问题：
1、注意IMPORTS 私有mib的上级节点
2、注意IMPORTS 变量的类型名，如DisplayString，直接使用的话是不能识别的。
3、注意大小写。
4、注意编译的时候一定把error和warning全都消灭掉。
5、扩展 agent

到这里你已经应该正确的写出了一个私有的MIB文件，你需要把它放置到系统的MIB文件库中。我的系统的MIB库路径是/usr/share/snmp/mibs/。

然后开始学习使用MIB2C这个强大的工具，它的作用是把你写好的一个MIB文件，转化成一个或多个在net-snmp下可以使用的.c/.h文件。

一个简单的例子：当你写成了一个叫做ucdDemoPublic的私有MIB文件。

mib2c -c mib2c.scalar.conf ucdDemoPublic就可以生成ucdDemoPublic.c和ucdDemoPublic.h

MIB2C有很多版本，也有很多参数可供选择，可以在netsnmp的官网上查到：

重要的参数是 –c 后面的那个.conf值：

mib2c.mfd.conf
mib2c.scalar.conf
mib2c.int_watch.conf
mib2c.iterate.conf
mib2c.create-dataset.conf
mib2c.array-user.conf
mib2c.column_defines.conf
mib2c.column_enums.conf

一个重要的问题：

在使用mib2c时，需要配置一个mib2c的配置文件：snmp.conf
我的配置文件路径是：/var/net-snmp/snmp.conf
在配置文件中要加入类似下面的语句，表示我要把XXX-MIB.txt这个mib文件转化成c文件。
mibfile /usr/share/snmp/mibs/XXX-MIB.txt

简单变量的代码生成
用mib2c.scalar.conf生成简单MIB变量的XXX.c和XXX.h,如上例。生成MIB之后需要自己根据具体参数的含义，修改get或set时的动作。在XXX.c中包含两个重要的函数：init_XXX()和handle_XXX(),需要在init_XXX中修改oid，在handle_XXX中的case MODE_GET和case MODE_SET_ACTION中设置GTE和SET的函数。

Table变量的代码生成

用mib2c.mfd.conf生成table类型的MIB文件，生成的文件比较多，包括：XXX.c/.h;XXX_data_access.c/.h; XXX_data_get.c/.h; XXX_data_set.c/.h; XXX_enums.h; XXX_interface.c/.h; XXX_oids.h;

Snmpget的修改：需要修改的是XXX_data_access.c中的XXX__container_load函数，修改XXXTable中的变量值。

Snmpset的修改：需要修改的是：
XXX_data_set.c：XXXTable_commit中设置rowreq_ctx->column_set_flags的值，表示已经修改了XXXTable中的某一项。

XXX_data_set.c：中所有的XXX_set.c中指定自己想要的值。

代码集成      
生成了正确的.c/.h文件之后，需要把代码继承到snmpd中，有两种比较靠谱的方法:
1、 把所扩展的agent MIB，静态的集成到snmpd中。方法：把所生成的.c/.h文件拷贝到/net-snmp/agent/mibgroup下面，然后重新 ./configure --with-mib-modules="XXX"; make; make install, 好了你的私有MIB已经被静态集成到snmpd里面了，最后用命令行snmpget；snmpset试验一下。

2、 是动态加载的方式，自己写一个makefile，把所有生成的.c/.h编译成为一个.so,把这个.so放到一个特定的路径下面，并在snmpd.conf文件中指明.so的位置。

1)编译的时候除指定-fPIC -shared -O0参数之外，还需要指定= -I. `net-snmp-config --cflags`，在最后链接成.so的时候还需要指定`net-snmp-config --libs`参数

2)在需要在snmpd.conf文件中指定.so的位置：如
dlmod exampleTable /usr/lib/exampleTable.so

3）在运行./snmpd的时候需要指定所需的.so如：
./snmpd –f –L –Dexample,DLmod,

这样也可以实现对agent的动态扩展。

6、扩展trap
net-snmp的trap也是可以扩展的，我用的方法是把写好的trap代码（.c）放到snmp/snmplib下面，修改一下snmplib的Makefile，make；make install，即可

其代码的样例如下： 
#include    
#include    
config_require(util_funcs)           
int TrapSendTest()   
{   
    netsnmp_session session,*ss;   
    netsnmp_pdu *pdu;   
    long sysuptime;   
    char csysuptime[20];   
    int status = 0;   
    oid oid_sysuptime[] = { 1,3,6,1,2,1,1,3,0 };   
    char *cp1 = "10.8.72.1", *cp2 = "public";    

    snmp_sess_init(&session);   
    session.version = SNMP_VERSION_2c;   
    session.peername = cp1;   
    session.remote_port = 162;   
    session.community = (unsigned char*)cp2;   
    session.community_len = strlen((char *)session.community);   
    session.retries = 3;   
    session.timeout = 2000;   
    session.sessid = 0;   

    SOCK_STARTUP;   
    ss = snmp_add(&session,netsnmp_transport_open_client("snmptrap",    
        session.peername),   
        NULL,    
        NULL);   
    if (ss == NULL)    
    {   
        snmp_sess_perror("snmptable", &session);   
        SOCK_CLEANUP;   
    }   
    pdu = snmp_pdu_create(SNMP_MSG_TRAP2);     
    sysuptime = get_uptime();   
    sprintf(csysuptime, "%ld", sysuptime);    
    status = snmp_add_var(pdu, oid_sysuptime, OID_LENGTH(oid_sysuptime), 't', csysuptime);    
    if(status != 0)   
    {    
        snmp_sess_perror("snmptrap add sysuptime error!", &session);   
        return -1;   
    }   
    status = snmp_send(ss, pdu);   
    if (status == 0)   
    {    
        snmp_sess_perror("snmptrap send info error!", &session);   
        snmp_free_pdu(pdu);   
        return -2;   
    }    
    snmp_close(ss);   
    snmp_shutdown("snmptrap");   
    return 0;   
}
#include
#include
config_require(util_funcs)        
int TrapSendTest()
{
    netsnmp_session session,*ss;
    netsnmp_pdu *pdu;
    long sysuptime;
    char csysuptime[20];
    int status = 0;
    oid oid_sysuptime[] = { 1,3,6,1,2,1,1,3,0 };
    char *cp1 = "10.8.72.1", *cp2 = "public";

    snmp_sess_init(&session);
    session.version = SNMP_VERSION_2c;
    session.peername = cp1;
    session.remote_port = 162;
    session.community = (unsigned char*)cp2;
    session.community_len = strlen((char *)session.community);
    session.retries = 3;
    session.timeout = 2000;
    session.sessid = 0;

    SOCK_STARTUP;
    ss = snmp_add(&session,netsnmp_transport_open_client("snmptrap",
        session.peername),
        NULL,
        NULL);
    if (ss == NULL)
    {
        snmp_sess_perror("snmptable", &session);
        SOCK_CLEANUP;
    }
    pdu = snmp_pdu_create(SNMP_MSG_TRAP2);
    sysuptime = get_uptime();
    sprintf(csysuptime, "%ld", sysuptime);
    status = snmp_add_var(pdu, oid_sysuptime, OID_LENGTH(oid_sysuptime), 't', csysuptime);
    if(status != 0)
    {
        snmp_sess_perror("snmptrap add sysuptime error!", &session);
        return -1;
    }
    status = snmp_send(ss, pdu);
    if (status == 0)
    {
        snmp_sess_perror("snmptrap send info error!", &session);
        snmp_free_pdu(pdu);
        return -2;
    }
    snmp_close(ss);
    snmp_shutdown("snmptrap");
    return 0;
}

在实际用的时候，改一改参数就OK了。

Makefile的修改：
在.o和.lo编译目标列表尾部加入你所加入的文件名即可：XXX.o和XXX.lo, 这样你扩展的trap就静态加入snmpd中了

Snmpd的调用：snmpd的监听程序和你所扩展的trap程序是不能顺序运行的，否则会互相影响。所以要fork一下，父子进程分别运行。

7、调试方法
1、可以使用strace -f -L ./snmpd的方法跟踪snmpd调用的系统调用，来猜测snmpd的运行流程         
2、由于snmpd是后台运行的，可以用syslog.