net-snmp的readme文件（win32平台）

欢迎转载，但请尊重我的劳动，注明出处。勿用于商业用途。
原文在Net-SNMP 5.5.0 win安装后的usr目录中。注意可能会因为版本变化，而有所区别。

--2010.5.4

Net-SNMP的README文件（win32平台）

免责声明
-----------
作者对于使用本软件造成的直接或者间接损失、系统性能下降不负责任。本软件不包含任何“明确的”或者“隐含的”担保。


内容列表
-----------
   免责声明
   内容列表
   介绍
*  安装
*  与microsoft SNMP 服务共存
   安装perl模块
*  配置
   编译信息

   （*代表需要仔细阅读）


介绍
-----------
这个安装包包含了一个编译好的在windowsNT/2000/XP环境中运行的Net-SNMP的二进制版本。这个二进制版本不能在windows98中运行。"snmpd"和"snmptrapd"不能在windows98中作为“服务”运行，因为windows98没有提供服务控制管理（SCM）。

关于这个软件的帮助文档Net-SNMP.chm可以在安装目录中找到。也可以在中找到相关的帮助文档。

安装
-------------
Net-SNMP 的windows安装包执行了以下任务：

- 安装Net-SNMP的二进制文件，MIB文件还有ActiveState 5.8.x版本的perl PPM包（位置默认在c:\usr.）
- 把安装文件夹中的bin目录添加到PATH系统变量中
- 添加了以下注册表键值：
    - HKEY_LOCAL_MACHINE\Software\Net-SNMP\SNMPCONFPATH=(install folder)/etc/snmp;
      (install folder)/snmp/persist
    - HKEY_LOCAL_MACHINE\Software\Net-SNMP\SNMPSHAREPATH=(install folder)/share/snmp
- 在SNMPCONFPATH指定的位置创建一个snmp.conf文件，其中做了如下定义：

    - mibdirs (安装路径)/share/snmp/mibs
    - persistentDir (install folder)/snmp/persist
    - tempFilePattern (install folder)/temp/snmpdXXXXXX

使用安装向导完成安装后，执行一个快速测试来验证安装是否正确。在提示符下运行如下命令：
    snmptranslate -IR -Td IF-MIB::linkDown

上面的命令会有如下输出：
    IF-MIB::linkDown
    linkDown NOTIFICATION-TYPE
      -- FROM       IF-MIB
      OBJECTS       { ifIndex, ifAdminStatus, ifOperStatus }
      DESCRIPTION   "A linkDown trap signifies that the SNMP entity, acting in
                an agent role, has detected that the ifOperStatus object for
                one of its communication links is about to enter the down
                state from some other state (but not from the notPresent
                state).  This other state is indicated by the included value
                of ifOperStatus."
    ::= { iso(1) org(3) dod(6) internet(1) snmpV2(6) snmpModules(3) snmpMIB(1)
          snmpMIBObjects(1) snmpTraps(5) 3 }

如果提示snmptranslate命令没有找到，检查Net-SNMP安装路径是否添加到PATH中了。
如果有“模块未找到”之类的提示，比如：IP-MIB：module not found，那么这是由于Net-SNMP没有找到mibs文件夹。检查SNMPCONFPATH系统变量被设置为正确的位置（例如:c:/usr/etc/snmp;c:/usr/snmp/persist ）。还要检查在snmp.conf中是否包含了所需的配置变量“mibdirs,persistentDir,tempFilePattern”。例如：

    mibdirs c:/usr/share/snmp/mibs
    persistentDir c:/usr/snmp/persist
    tempFilePattern C:/usr/temp/snmpdXXXXXX

关于Net-SNMP配置中可以使用的环境变量和注册表键值的详细信息，参见帮助文件中“配置”一节的“概览”部分。

关于怎样在windows中运行snmpd和snmptrapd的详细信息，参见‘怎样把Net-SNMP代理和trap守护进程注册为windows服务’一节，在README.win32中，此文件在安装好Net-SNMP后，可以在开始菜单中找到。


与microsoft的snmp服务共存
---------------------------
请参见README.win32中的“与microsoft SNMP 服务共存”一节，安装好后可以在开始菜单中找到。


安装--perl模块
----------------
在安装路径的\perl文件中，有一个ActiveState perl5.8.x PPM包。注意：在Net-SNMP的前一个版本中，这个PPM包名字是Net-SNMP.ppd。这个包现在被命名为NETSNMP.ppd，来防止与ActiveState的Net::SNMP包冲突。

这个perl模块需要Win32版的REGEX包（正则表达式），可以在这里获得：

   

下载gnu_regex.exe，复制并展开它。

复制gnu_regex.dll到 %windir%\system32 文件夹。

删除已经存在的Net-SNMP 模块：

    ppm remove NetSNMP

安装perl 模块：

    cd (install folder)\Perl
    ppm install NetSNMP.ppd

执行一个基本的测试脚本：

    net-snmp-perl-test.pl



配置
-------------
所有的配置文件都应该放在%SNMPCONFPATH%文件夹中。

注意：所有在配置文件中的路径都应该使用‘/’（unix中的样式）

包括一个perl脚本snmpconf，用来创建配置文件。

使用snmpconf的帮助可以在Net-SNMP.chm文档中找到，位置在Net-SNMP的安装目录中。帮助也可以在Net-SNMP的官方网站 找到。

使用下面的命令来运行snmpconf：

   snmpconf -i



编译相关信息：
-----------------
BUILD INFORMATION

  Name:            net-snmp-5.5-1.x86.exe
  URL:           
  Build date:        Sept 27th, 2009
  Built by:        Alex Burger
  Installer Package by: Andy Smith
  NSIS Compiler:    Version 2.45
 
  OS:            Windows 7 32-bit
  Compiler:        MSVC++ 2008 SP1
  Platform SDK:        MSVC++ 2008 SP1
  Perl:            ActivePerl 5.10.0
  REGEX:        n/a

  Source:         net-snmp-5.5.zip
  Patches        n/a
  Destination:      c:\usr
  Project:        SDK
  Library:        netsnmp.dll
  OpenSSL:        0.9.8k



下面是一些Net-SNMP使用的默认路径：
-----------------

  ----------------------------------------------------------------------------
  net-snmp-config.h define   | value                    | optional environment
                             |                          | variable
  ----------------------------------------------------------------------------
  DEFAULT_MIBDIRS            | c:/usr/share/snmp/mibs   | MIBDIRS
  SNMPDLMODPATH              | c:/usr/lib/dlmod         | SNMPDLMODPATH
  SNMPLIBPATH                | c:/usr/lib               | SNMPLIBPATH
  SNMPSHAREPATH              | c:/usr/share/snmp        | SNMPSHAREPATH
  SNMPCONFPATH               | c:/usr/etc/snmp          | SNMPCONFPATH
  PERSISTENT_DIRECTORY       | c:/usr/snmp/persist      | SNMP_PERSISTENT_DIR
  NETSNMP_TEMP_FILE_PATTERN  | c:/usr/temp/snmpdXXXXXX  |