Agent技术文档
－写在1998年耶诞前夕
吃进去的是协议，挤出来的是文档。
——崔健
此文档详细描述了本人作为网络管理小组成员，自1997年年底以来所一直进行着的Agent软件开发工作。
背景知识
在开发Agent软件之前，需熟悉以下内容：
SNMP协议，MIB，ASN.1 SNMP子集，BER编码规则；
UDP协议，无连接Socket编程；
ATM UNI，AAL5；
VxWorks的多任务机制和消息队列机制，及两者的编程；
WRS WindNet软件包的使用和扩展；
Tornado系列开发和调试工具。
以上内容可参阅下述资料：
SNMP，MIB：RFC1155，RFC1157，RFC1122，RFC1213；
ASN.1，BER：X.680，X.690；
有关ATM的书籍，ATM Forum ILMI 4.0；
VxWorks Programmer’s Guide：
Chapter 2：Basic OS
Chapter 5：Network
WindNet SNMPv1/v2c全本
Tornado User’s Guide全本
GNU ToolKit：
The GNU Binary Utilities：ar，ld，nm
GNU Make
编程中若遇到函数调用之类的问题，可参阅
VxWorks 5.3.1 Reference Manual
有关消息队列的介绍另可参考崔健同学的技术文挡。
Agent简述
根据该接入设备的总体设计，网络管理分为用户侧和网络侧两级来进行。每一级的网络管理模块都基于 Client/Server 结构，Manager作为 Client ，以请求的形式向被管对象的Agent（以下简称Agent）发送命令； Agent作为 Server，根据接收到的请求完成相应的操作，并将结果以响应的形式发回给Manager。这两者之间的通信遵循简单网络管理协议（SNMP）。
另外，根据 ATM Forum 制订的规范，用户侧和网络侧的Agent作为 ATM 接口管理实体（IME），两者之间也必须建立起实时对等的通信，每一方都必须实现Manager和Agent的双重功能，既可以以Manager的身份向对方发送请求，也可以以Agent的身份接收和处理对方的请求。两个对等IME之间的通信遵循 ATM Forum 的ILMI 规范（Integrated Local Management Interface Specification）。而 ILMI 也是基于 SNMP 协议之上的。
综上所述，网络管理信息系统 SNMP Agent主要将实现以下功能：
接收和处理来自对应Manager的请求（通过UDP端口）；
两级Agent之间的ILMI 消息传递（通过一个特定的VPI/VCI和AAL5层）；
为实现上述功能而必需的与交换、信令和业务模块之间的消息传递。
图一、二显示了响应实体之间的关系及其协议栈。
上述（3）的功能通过操作系统（采用了实时操作系统 VxWorks）提供的内部通信机制（如消息队列）来实现。而 SNMP Agent的实现则采用了 Wind River System 公司所提供的 WindNet 软件包。
由于 WindNet 只实现了Agent的功能，为了建立起 ILMI 通信，还必须自己实现Manager的功能。
（三）程序及其编译过程的描述
本人编写的程序分成两部分，分放在两个目录下（之所以这样做只是为了尽可能保留WindNet的目录结构）：
$(ATMNET_BASE)/
$(WIND_BASE)/target/src/snmpv1/
程序结构
下图列出了各主要程序之间的依赖关系。上层依赖下层，或者说，位于下层的程序被上层的程序所调用。
下图是Agent各任务间的数据流图： '无图片
（2）$(ATMNET_BASE)/下的程序描述
除了MIB Method Routines（见“$(WIND_BASE)/target/src/snmpv1/下的程序描述”）以外，所有自己编写的C源程序均存放在本目录下，而头文件则放在一级子目录h/下。另外在一级子目录apps/下则存放了在SUN主机上可执行的Manager程序。下面逐一介绍。
Makefile
用来编译和更新网管Agent的程序。
anmadLib.c
Agent的ILMI数据包处理程序，它可能调用snmpMgrLib.c中的SNMP解码程序。
anmaGlobals.c
Agent范围内的全局变量的定义。
anmaIoLib.c
Agent与其他软件模块的消息接口处理程序。
anmaMain.c
在嵌入VxWorks时，Agent软件的唯一入口函数在本文件中定义。
anmInfoLib.c
作为ATM Private MIB的信息源，为后者的Method Routines所调用。
ilmiFsm.c
ILMI 有限状态机的实现。
ilmiInfoLib.c
作为ILMI MIBs的信息源，为后者的Method Routines所调用。
snmpMgrLib.c
为实现Manager功能所编写的例程，主要提供SNMP BER编码和解码函数。其中在解码过程中，如果识别出是Get，Get-next或Set的PDU，说明是对端Manager发过来的数据包，则递交给WindNet的snmpdPktProcess()处理；对于Get-response和Trap的PDU，说明是本地Manager发出请求后得到的响应，则继续全权处理。请同时参阅anmadLib.c。
一级子目录h/：
anmaAll.h
Agent范围内类型和常量的定义，如与其他软件模块通信时所用消息队列的属性和消息的结构，等。
anmaConfig.h
设备配置文件，如设备是node还是user等等。
anmadLib.h
对anmadLib.c中定义的非局部函数的声明。
anmaIoLib.h
对anmaIoLib.c中定义的非局部函数的声明。
anmInfoLib.h
对anmInfoLib.c中定义的非局部函数的声明。
anmPrivMib.h
ATM Private MIB结构类型的定义，类似于$(WIND_BASE)/target/h/snmp/m2Lib.h。
atms_api.h
由交换模块实现的API的声明。这些API主要由网管Agent调用，以完成Manager请求的涉及到交换的操作。
ilmiFsm.h
有关ILMI FSM的类型和常量定义。
ilmiInfoLib.h
对ilmiInfoLib.c中定义的非局部函数的声明。
ilmiMib.h
ILMI MIBs的结构类型的定义，类似于$(WIND_BASE)/target/h/snmp/m2Lib.h。
snmpMgr.h
实现SNMP Manager功能所需要的一些定义，以及snmpMgrLib.c中实现的函数的声明。
一级子目录apps/：
snmpGet.c和可执行的snmpGet
snmpNext.c和可执行的snmpNext
snmpSet.c和可执行的snmpSet
供测试用的能独立运行于UNIX主机上的SNMP Manager程序及其源代码。注意，由于px主机上没有CC和Socket库，编译上述三个程序需在tmn2主机上进行：
tmn2% cc -l socket -I ../h -DUNIX -o snmpGet snmpMgrLib.c snmpGet.c
命令行中，snmpMgrLib.c可根据不同操作系统进行条件编译，所以务请选择-DUNIX或-DVXWORKS。
（3）$(WIND_BASE)/target/src/snmpv1/下的程序描述
凡注明“WindNet”的文件均是WindNet软件包提供的，否则就是本人创建和编写的。在本小节内提到的“Agent”指狭义的SNMP Agent，除此之外，“Agent”均指广义的网管Agent，即本人所做的工作在整个系统中所扮演的角色。
一级子目录agent/：
Makefile
用来编译和更新WindNet。
snmpIoLib.c（WindNet）
SNMP Agent I/O， 包含了 snmpIoInit()，，snmpIoClose()，snmpIoMain()，snmpIoBody()，snmpIoCommunityValidate()等函数，可根据实际情况修改，特别是snmpIoWrite()和snmpIoCommunityValidate()，一定要做相应的配置。这些函数的具体描述请参阅WindNet SNMPv1/v2c，P47）。
snmpMib2.mib（WindNet）
MIB2的控制文件，决定MIB Method Routines的函数名等。控制MIB主要用到三个关键字：FORCE-INCLUDE，DEFAULT，EXCLUDE，具体用法请参阅WindNet SNMPv1/v2c，P80：mibcomp Extensions。
ilmiMib.mib
ILMI MIBs的控制文件。
anmPrivMib.mib
ATM网管自定义MIB的控制文件。
snmpMib2.c，mibhand.h，mibleaf.h
mibcomp的生成文件，snmpMib2.c定义了MIB的内部存储格式，mibhand.h是对Method Routines的声明，mibleaf.h是对MIB常量的定义。
二级子目录agent/anm_rtns：
二级子目录agent/ilmi_rtns：
二级子目录agent/snmp_rtns（WindNet）：
各个MIB的Method Routines，每个文件对应于一个Group。在写这些函数时，可先用mibcomp -stub生成.c文件，再在此文件上做修改，这样可省却许多录入工作。
一级子目录rfc_mibs/（WindNet）：
标准的RFC MIBs，如rfc1213.mib等。
一级子目录anm_mibs/：
ILMI MIBs，ATM Private MIB等与ATM相关的非RFC MIBs。
（4）在开发阶段编译Agent的一般步骤
环境： 主机为tmn2，WindNet源程序也在tmn2上；
当前用户为wrs，这是专为调试而建立的用户；
目标机为mv162，其CPU为MC68LC040。
设置环境变量：
% source ~wrs/.cshrcsnmp
.cshrcsnmp是本人建立的一个配置文件，定义了有关SNMP的环境变量和mibcomp、cc68k的一些常用选项。它不是系统的缺省文件，所以需要手动执行。.cshrc才是系统的缺省配置文件，在用户登录时自动执行。
编译WindNet：
% cd ~wrs/wind/target/src/snmpv1/agent
% make CPU=MC68LC040 TOOL=gnu
此举将编译本目录下Makefile中所列出的相关文件，make的结果是得到最新版本的~wrs/wind/target/lib/libMC68LC040gnuvx.a
配置和编译vxWorks：
% launch&
（如果是开机后第一次运行Tornado的调试工具，则执行 source ~wrs/startit&）
选择target server：mv162@tmn2；
（如果该target server不存在，请先创建它，target server的配置如下：
tgtsvr <target_IP> -A -V -n mv162 -B wdbrpc -f a.out
具体的用法请参阅Tornado User’s Guide：The Tornado Launcher，P105）
在launch面板上选择WindCFG，在随后打开的配置窗口依次选择mv162lc，windNet，注意必须有以下两项内容：
#INCLUDE_MIB2_ALL
#INCLUDE_SNMPD
在上面打开的配置窗口中依次点击Config按钮和Build按钮，开始编译vxWorks内核。
重新启动目标机。
编译其它Agent程序：
在$(ATMNET_BASE)/目录下运行make，将最终的目标文件下载到目标机调试。
（5）在开发阶段扩展MIB的一般步骤
用ASN.1编写MIB。如果要实现已有MIB中被控制MIB EXCLUDE掉的Group，则将相应的EXCLUDE语句注释掉。
写Method Routines。这可能会涉及到修改或创建以下三个文件：xxxMib.h，xxxInfoLib.h，xxxInfoLib.c，其中xxxMib.h是该MIB的类型和常量定义，xxxInfoLib.c为method routines提供支持，是后者的信息来源。
在~wrs/wind/target/src/snmpv1/agent/目录下的Makefile中OBJS一项增补相应的.o文件。
make。见前述“在开发阶段编译Agent的一般步骤”（a）~（d）。
