基于SIS标准CM和CMTS的电缆设备 MIB库定义.doc

Network Working Group M. St. Johns, Ed.Request for Comments: 2669 Home NetworkCategory: Proposed Standard August 1999 基于DOCSIS标准CM和CMTS的电缆设备 MIB库定义（RFC2669 DOCSIS Cable Device MIB Cable Device Management Information Base for DOCSIS compliant Cable Modems and Cable Modem Termination Systems） 本备忘录的状态本文档讲述了一种Internet社区的Internet标准跟踪协议，它需要进一步进行讨论和建议以得到改进。请参考最新版的“Internet正式协议标准” (STD1)来获得本协议的标准化程度和状态。本备忘录的发布不受任何限制。版权声明Copyright (C) The Internet Society (1999).摘要本文档为在Internet设区中所使用的网络管理协议定义了部分管理信息库（MIB），具体为基于DOCSIS1.0标准的兼容CM和CMTS定义了基本管理对象集，该管理方法基于SNMP协议。本文档所定义的MIB模块符合SNMP SMIv2 567标准描述方法，所使用的SNMP框架结构和现有SNMP标准保持一致。目录1. SNMP管理架构22. 术语22.1. 有线电视（CATV）32.2. 电缆调制解调器（CM）32.3 电缆调制解调器前端系统（CMTS）.2.4 DOCSIS.2.5 下行传输.2.6 前端.2.7 MAC包2.8 电缆多媒体网络系统2.9 射频.2.10上行传输3. 概览43.1 管理信息库结构.3.2 管理要求.3.2.1 软件升级.3.2.2 事件和陷阱.3.2.3 Trap限制.3.2.3 .1 Trap速率级别 限制Trap速率3.3 协议过滤3.3.1入内的链路层包过滤（LLC filter）.3.3.2 专有过滤 IP盗用过滤. SNMP访问过滤.3.3.3 IP包过滤.3.3.4 出外的链路层过滤(LLC filter).4 定义5 鸣谢6 参考7 安全事项.8 知识产权9 作者地址.10 版权声明.1. SNMP管理架构SNMP当前的管理架构可从五个方面来描述。0总体结构描述，可参照 RFC25711。0网络管理目标和MIB对象的命名和描述。0传输管理信息所需消息协议描述。0访问管理信息的协议操作0 基本应用集描述和网络管理访问控制机制2. 术语本节既讨论了 IETF 协议指定的一般性术语，也讨论了本文档要用到的一些术语。 2.1. 有线电视（CATV）最初称为公用天线电视系统，现在不管是普通的电缆系统或是HFC系统都可以统称为CATV系统2.2. 电缆调制解调器（Cable Modem）在DOCSIS兼容电缆数据传输系中被称为slave的调制解调器。2.3 电缆调制解调器终端系统（CMTS）工作在头端的覆盖电缆桥接或电缆路由的一般性术语，CMTS在DOCSIS电容电缆数据传输系统中一般作为主设备（master），而且它是唯一的传输下行和控制上行传输的设备。2.4 DOCSIS基于Cable的数据传输接口规范，可参考 ITU-T J.112 Annex B。2.5 下行（Downstream）从头端（CMTS）传向用户端的方向称为下行。2.6 头端用户端数据的发源地，一般指CMTS设备的所在位置。2.7 MAC包符合DOCSIS标准的数据单元。2.8 MCNS多媒体电缆网络系统，一般被DOCSIS来代替表示。2.9 射频表示射频信号。2.10 上行从用户端传输到头端的方向称为上行。3概览本MIB库提供了满足DOCSIS兼容CableModem和CMTS的管理需求的管理子集，该管理需求来源于DOCSIS射频接口规范标准（DOCSIS Radio Frequency Interface specification）。需要留意的是DOCSIS1.0标准仅仅要求CableModem实现SnmpV1和处理IPv4的通信数据，未来的DOCSIS版本将会支持SnmpV3和Ipv6。 3.1 MIB结构本MIB结构被划分为七个组（groups）：0Cable设备系统管理组docsDevBase0网络访问控制组docsDevNmAccessGroup0软件升级所需信息处理组docsDevSoftware0事件报告控制和记录组docsDevEvent0链路层和IP层过滤器配置组docsDevFilter0客户端设备IP控制组docsDevCpe3.2管理要求3.2.1 软件升级处理CableModem的软件升级处理可以通过DOCSIS射频接口规范标准中描述的方法进行操作，作为网络管理者可以通过下列步骤升级CableModem：0设置docsDevSwServer为软件升级TFTP服务器的IP地址0设置docsDevSwFilename为软件升级映像文件的文件名0设置docsDevSwAdminiStatus为upgrade-from-mgt注意软件升级在下列情况下应禁止：0软件升级文件未完全下载0软件升级文件内容不完整或已被破坏0软件升级文件并不是针对本设备的硬件标识3.2.2 事件和Traps本MIB库为系统事件的报告提供了灵活的控制机制，包括在日志服务器（syslog）、Traps、非易失性本地记录等。如果事件通过Traps报告应符合相应的规范。其他非Traps事件报告的机制本文不加论述。Trap事件报告的定义和编码规则可以有厂商自定义。不过为了多厂家设备的通用性考虑，各厂家CableModem应当提供TOD（Time of day）时钟以便于网络故障的检修。每一个通过Trap报告的厂商自定义事件必须定义企业指定的定义，Trap定义必须包括事件发生的原因而且为DisplayString编码。如下所示：trapName NOTIFICATION-TYPEOBJECTS ifIndex,EventReason,Other useful objectsSTATUS currentDESCRIPTION trap description：= Object Id注意ifIndex 仅在接口相关时有具体含义。3.2.3 Trap限制CM和CMTS必须按如下所述方法提供对Trap消息的扼制或限制机制，网络操作员可以方便的通过调整部分MIB来实现缩减Trap消息速率和限制Trap消息。 Trap速率级别Trap速率限制可以通过两种方法实现，第一种方法是设置Trap消息的最大速率，当Trap消息的发送超过该极限速率时，CM或CMTS主动停止发送Trap消息直到网络管理站点有信的请求。在第二种方法中当Trap消息的产生低于最大速率时CM或CMTS恢复Trap消息的发送。限制Trap速率通过限制在一定的时间间隔（秒）发送Trap消息的个数和设置超标的动作状态设置（Trap消息发送使能）。 限制Trap速率网络管理希望限制在一定时间内发送的Trap个数，当CM或CMTS发送的Trap个数超过指定的限制时CM或CMTS停止发送Trap。3.3协议过滤 Cable设备MIB库提供了链路层和IP层的协议过滤控制。链路层协议过滤机制可以限制一系列网络层协议包的转发（例如IP,IPX,NetBios,AppleTalk等）。IP层协议过滤机制可以限制CM和CMTS上下行基于源目标IP和目标IP的包过滤、传输层协议包（例如TCP,UDP,和ICMP等）、基于TCP/UDP协议的源和目的端口号等。通常，Cable设备按照下列顺序使用过滤器：* INBOUND LLC FILTER *| |V| V * | * * IP Spoof * | * SNMP Access * * | * | | | V V V * * IP Filter In* *| V * * IP FilterOut *|V* * LLC FILTER OUTBOUND * *3.3.1 入内的链路层过滤-docsDevFilterLLCTable入内的链路层（MAC层或第二层）过滤在docsDevFilterLLCTable中实现，该表的内容应用于RF口和任何一个CPE接口。该过滤器用于限制处理或转发第二层可能对网络造成负担的协议包族。就目前而言，该过滤器可以被设置为这两种情况：当符合Filter表中的至少一个filter时丢弃该帧（在第二层上我们称之为帧）或者是匹配表中的至少一个filter时处理该帧。在链路层上的过滤器可能的应用例子：限制IP通信（包括arp包）或者丢弃NetBeuI协议的通信帧。3.3.2 特殊过滤器特殊的过滤器被应用在MAC帧经过处理后已经被IP层所接受但其他的任何处理过程都未进行时。特殊过滤器一般被应用在特殊的通信网络系统当中。 IP spoofing filters-docsDevCpeTableIP盗用过滤器应用在当IP包从任何一个CPE接口进入CM时，为了防止用户盗用他人IP地址或者是误用了非服务运营商所提供的IP地址。若该filter被激活，从任何一个CPE接口进入的IP包的源地址（src addr）必须符合该Filter表中的至少一个IP地址，否则该IP包将被不加任何的进一步处理而丢弃。该表的内容可以根据最先使用CM的N个CPE的IP地址自动创建，也可以根据实际情况采用一定的策略来进行进一步的网络控制。例如使用docsDevCpeEnroll和docsDevCpeMax等。 SNMP Access filters-docsDevNmAccessTableSNMP 访问控制过滤器被用作过滤从任何接口进入的snmp 包（不管是以太网口或是RF口）。如果该报是从CPE接口进入的则该过滤器应用在IP spoof filter之后，而且仅考虑过滤SNMPv1和v2的包，至于SNMPv3的包则不在考虑之内。有关SNMPv3的访问控制可以参考USM MIB12。3.3.3 IP Filters-docsDevIpFilterTableIP层的过滤器实际上是一个分类器表，表中的每一行描述了过滤IP包的模板。模板中包括IP包的源地址、目的地址（以及相关联的掩码）、上层协议（例如TCP、UDP）、源端口和目的端口、服务类型（TOS）及服务类型掩码。并且每一行还包括接口索引和通信方向的结合来比较。在进行包比较时只有匹配该表中其中一行的所有列项时才认为匹配该行，当然接口索引值和传输方向也必须在比较考虑之内。当分拣一个包时，首先扫描索引值较小的过滤行，若发现有匹配的行，对应该行的处理动作就会被指定。若所匹配过滤器的继续扫描位（continue bit set）被置位，IP过滤器会继续扫描其他可能的匹配和相应的处理动作。这样就可以在匹配条件较宽松的情况下帧对某些特殊包进行过滤（例如在条件24.0.16/下可以对0进行不同的控制）。一旦某个IP包在表中找到对应的匹配行，通过docsDevFilterIpControl的设置可以有三种可能性来处理该IP包：丢弃（该包不再被处理）、接受进而继续被处理、根据docsDevFilterIpContinue的设置进行处理（若被设为true，继续扫描IP过滤器表和其他的可能匹配的结果）。若IP包匹配表中的某一行，并且docsDevFilterIpControl被设为policy， docsDevFilterIpPolicyId就被作为docsDevFilterPolicyTable表的索引或选择，在该 docsDevFilterPolicyTable表中可能有对匹配IP包的多种处理动作，通过docsDevFilterIpPolicyId选择对应的处理行进行处理。3.3.4 Outbound LLC Filters最后Outbound LLC Filters被应用于在前面处理中所释放出来的包，当然也对应于相应的接口。本MIB库不指定任何的Outbound LLC Filters，因为在前面描述的各种过滤器应已经考虑到未来的DOCSIS标准会包括服务质量保证（Qos）并且应该处理本应在Outbound LLC Filters过滤器中所做的处理。4. 定义DOCS-CABLE-DEVICE-MIB DEFINITIONS := BEGINIMPORTS MODULE-IDENTITY, OBJECT-TYPE,- do not import BITS, IpAddress, Unsigned32, Counter32, Integer32, zeroDotZero, mib-2 FROM SNMPv2-SMI RowStatus, RowPointer, DateAndTime, TruthValue FROM SNMPv2-TC OBJECT-GROUP, MODULE-COMPLIANCE FROM SNMPv2-CONF SnmpAdminString FROM SNMP-FRAMEWORK-MIB InterfaceIndexOrZero FROM IF-MIB; - RFC2233docsDev MODULE-IDENTITY LAST-UPDATED 9908190000Z - August 19, 1999 ORGANIZATION IETF IPCDN Working Group CONTACT-INFO Michael StJohns Postal: Home Network 425 Broadway Redwood City, CA 94063 U.S.A. Phone: +1 650 569 5368 E-mail: DESCRIPTION MCNS兼容cable modems和cable-modem termination systems MIB库模块 REVISION 9908190000Z DESCRIPTION Initial Version, published as RFC 2669. Modified by Mike StJohns to add/revise filtering, TOS support, software version information objects. := mib-2 69 docsDevMIBObjects OBJECT IDENTIFIER := docsDev 1 docsDevBase OBJECT IDENTIFIER := docsDevMIBObjects 1 - 下面所列举的某些MIB对象在目前的DOCSIS射频标准中并没有定义 - 但在这里定义出来，防止有人能够定义它或使用- （目前并没有这样的支持，仅作为保留的MIB对象）-.-docsDevRole OBJECT-TYPE SYNTAX INTEGER cm(1), cmtsActive(2), cmtsBackup(3) MAX-ACCESS read-only STATUS current DESCRIPTION描述当前设备在网路中的扮演角色，cm(1)表示这是一个CableModem，cmtsActiv(2)表示这是一个正在管理网路中Cablemodems的CMTS(正被激活的)， cmtsBackup(3) 表示这是一个网路中但并不管理Cablemodem的CMTS(当前并未使用)。 一般来说，如果该设备是一个CM，在网路操作或重启后它的角色并不改变。如果该设备是一个CMTS，则在网路操作中它可能在工作CMTS和备份CMTS的角色中转换。 注意：目前DOCSIS并不支持备份CMTS，此处有backup CMTS 完全是为了完整性考虑。 := docsDevBase 1 docsDevDateTime OBJECT-TYPE SYNTAX DateAndTime MAX-ACCESS read-write STATUS current DESCRIPTION 日期和时间，加上可选的时区信息 := docsDevBase 2 docsDevResetNow OBJECT-TYPE SYNTAX TruthValue MAX-ACCESS read-write STATUS current DESCRIPTION 设为真true(1)使本设备重新启动 读取本对象的值将一致返回假false(2). := docsDevBase 3 docsDevSerialNumber OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION 生产厂商为该设备所指定的串号 := docsDevBase 4 docsDevSTPControl OBJECT-TYPE SYNTAX INTEGER stEnabled(1), noStFilterBpdu(2), noStPassBpdu(3) MAX-ACCESS read-write STATUS current DESCRIPTION 本对象控制对STP（802.1d生成树协议）协议包的处理。若被设为stEnabled(1)，该设备支持STP并处理STP包。若被设为noStFilterBpdu(2), 该设备不支持STP协议并且将接收到的BPDU包丢弃。若被设为noStPassBpdu(3) ，该设备不支持STP协议但会将接收到的BPDU包透明传输。注意：该设备不必支持所有的选项，但必须支持noStFilte-rBpdu(2)项 := docsDevBase 5 - 下面的表提供了对网络管理站点进行网络管理访问- 提供了一种控制方法。注意这种访问受到community- 字符串和任何的厂家指定安全层所控制- -docsDevNmAccessTable OBJECT-TYPE SYNTAX SEQUENCE OF DocsDevNmAccessEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION本表控制网管站点访问SNMP对象的访问权限。若本表为空表则没有任何限制并且本表只有SNMP版本v1和v2c存在，在SNMP版本v3中不存在。 在SNMP版本v3中对应的MIB对象和安全模块已经覆盖了本表的内容。 := docsDevMIBObjects 2 docsDevNmAccessEntry OBJECT-TYPE SYNTAX DocsDevNmAccessEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION 网管站点访问SNMP代理的入口索引值. 若网管站点有该SMMP代理的读写访问权限该入口索引值可被网管站点所更改(或缺省的读写权限或者在本表中有指定的读写权限)每个入口索引按docsDevNmAccessIndex排序。第一个匹配（例如匹配IP地址和community字符串）入口的访问权限被应用于访问的网管站点。 INDEX docsDevNmAccessIndex := docsDevNmAccessTable 1 DocsDevNmAccessEntry := SEQUENCE docsDevNmAccessIndex Integer32, docsDevNmAccessIp IpAddress, docsDevNmAccessIpMask IpAddress, docsDevNmAccessCommunity OCTET STRING, docsDevNmAccessControl INTEGER, docsDevNmAccessInterfaces OCTET STRING, docsDevNmAccessStatus RowStatus docsDevNmAccessIndex OBJECT-TYPE SYNTAX Integer32 (1.2147483647) MAX-ACCESS not-accessible STATUS current DESCRIPTION对访问权限控制排序的索引值 := docsDevNmAccessEntry 1 docsDevNmAccessIp OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-create STATUS current DESCRIPTION网络管理站点的IP地址。地址55被定义为任何网络管理站点。若支持陷阱(Traps)则该值必须被指定为该设备的IP地址 DEFVAL ffffffffh := docsDevNmAccessEntry 2 docsDevNmAccessIpMask OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-create STATUS current DESCRIPTION 网络管理站点的子网掩码。若支持陷阱（Traps）. 该值必须被设为55. DEFVAL ffffffffh := docsDevNmAccessEntry 3 docsDevNmAccessCommunity OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION本访问入口所必需匹配的community 字符串。若被设为0，则任何的community字符串都匹配。当被读访问时本对象应该返回0长度的字符串 DEFVAL public := docsDevNmAccessEntry 4 docsDevNmAccessControl OBJECT-TYPE SYNTAX INTEGER none(1), read(2), readWrite(3), roWithTraps(4), rwWithTraps(5), trapsOnly(6) MAX-ACCESS read-create STATUS current DESCRIPTION指定网络管理站点的访问权限。设为none(1)表示本入口已经被废弃， Read(2) 允许get 和 get-next访问ReadWrite(3)允许再加上set访问RoWithtraps(4), rwWithTraps(5), 和trapsOnly(6)用来控制由本设备发送的Traps的发送控制。 DEFVAL read := docsDevNmAccessEntry 5 - 下面对象的语法是从RFC1493复制过来的- dot1dStaticAllowedToGoTo.docsDevNmAccessInterfaces OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-create STATUS current DESCRIPTION指定接受网络访问站点访问包的接口。该对象值的每一个字节表示8个接口并且第1个字节表示1-8接口第2个字节表示9-16接口以此类推。 在每个字节中的最高有效位表示索引较低的接口值，最地有效位表示索引较高的接口值，因此每个接口都可以被本对象值的单独一个bit位所表示。该bit位设为1，则该接口就被包括其中。注意：该接口索引值仅对链路层有效（例如Ethernet和RF MAC层）上行Upstream和下行downstream通道接口索引值不能够在该表中被指定。- DEFVAL is the bitmask corresponding to all interfaces := docsDevNmAccessEntry 6 docsDevNmAccessStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION控制当前行的当前状态。表中的每一行可以由reate-and-go或者create-and-wait 创建。当某一行在激活状态时本对象的值可以更改。 := docsDevNmAccessEntry 7 - 下列组的使用过程在DOCSIS射频标准 DOCSIS Radio Frequence Interface Specification- 的3.2.1有描述docsDevSoftware OBJECT IDENTIFIER := docsDevMIBObjects 3 docsDevSwServer OBJECT-TYPE SYNTAX IpAddress MAX-ACCESS read-write STATUS current DESCRIPTION 软件升级TFTP服务器IP地址，若未知，返回. := docsDevSoftware 1 docsDevSwFilename OBJECT-TYPE SYNTAX SnmpAdminString (SIZE (0.64) MAX-ACCESS read-write STATUS current DESCRIPTION被下载道被设备的软件影像文件的文件名。该项应返回CM配置文件服务器提供的新版本软件的升级文件名除非通过网络管理进行更改。若未知，返回unknown := docsDevSoftware 2 docsDevSwAdminStatus OBJECT-TYPE SYNTAX INTEGER upgradeFromMgt(1), allowProvisioningUpgrade(2), ignoreProvisioningUpgrade(3) MAX-ACCESS read-write STATUS current DESCRIPTION若被设为upgradeFromMgt(1), 该设备将从软件升级TFTP服务器下载在docsDevSwFilename.中指定的升级文件。在成功的接收到升级文件进行升级后该设备将本对象值设为ignoreProvisioningUpgrade(3)然后重新启动。若下载过程由于重启或电源工作失败所中止，设备将加载上一个软件影像经过重新初始化会继续尝试下载在docsDevSwFilename指定的软件升级文件影像。若被设为allowProvisioningUpgrade(2), 该设备将会根据配置服务器所提供的升级文件信息在设备下一次启动时进行升级 (这并不会导致设备重启)。 若被设为ignoreProvisioningUpgrade(3), 设备将会忽略来自配置服务器所提供的软件升级信息。 注意读本对象的值时可能返回upgradeFromMgt(1)，这意味着此时正在进行软件升级而且在成功的下载完升级文件后设备会重新启动。一般情况下设备在初始化启动结束后本对象会返回缺省值allowProvisioningUpgrade(2). := docsDevSoftware 3 docsDevSwOperStatus OBJECT-TYPE SYNTAX INTEGER inProgress(1), completeFromProvisioning(2), completeFromMgt(3), failed(4), other(5) MAX-ACCESS read-only STATUS current DESCRIPTIONInProgress(1) I表明TFTP下载正在进行当中，这可能由于配置文件中的版本信息或软件升级请求消息所导致（upgradeFromMgt request.）。CompleteFromProvisioning(2)表明上一次软件升级时在配置信息中所指定的版本信息。CompleteFromMgt(3)表明上一次软件升级是设置docsDevSWAdminStatus的状态为upgradeFromMgt所进行的升级。Failed(4) 表明上一次的升级尝试失败，一般是由于TFTP等待时间超出所导致。 REFERENCEDOCSIS射频接口规范DOCSIS Radio Frequency Interface Specification，8.2部分Cable Modem软件升级下载操作 := docsDevSoftware 4 docsDevSwCurrentVers OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION指示本设备当前运行的软件版本，本对象的值的语法控制由生产厂商控制如何标识软件版本。访问它时对于任何CM来讲必须返回当前所使用的软件版本描述信息字符串，对于CMTS来讲本对象应该包含厂家指定信息的人性化描述信息或者操作处理器的软件信息，若这些都不是则返回值必须是空字符串。 := docsDevSoftware 5 - 下面的组描述了在设备初始化启动时所使用的和各种服务器相关的信息-docsDevServer OBJECT IDENTIFIER := docsDevMIBObjects 4 docsDevServerBootState OBJECT-TYPE SYNTAX INTEGER operational(1), disabled(2), waitingForDhcpOffer(3), waitingForDhcpResponse(4), waitingForTimeServer(5), waitingForTftp(6), refusedByCmts(7), forwardingDenied(8), other(9), unknown(10) MAX-ACCESS read-only STATUS current DESCRIPTION若为operational(1),设备已经完成的配置参数的加载和处理并且CMTS也已经完成了登记信息交换。若为disabled(2) ，设备的启动时加载和处理配置参数被禁止或者载配置文件中被指定网络访问被禁止。若为waitingForDhcpOffer(3) 则DHCP广播请求信息Discover已经被发送但还没有受到第一次响应信息offer若为waitingForDhcpResponse(4) 则DHCP确认请求信息 Request 已经被发送但还没有收到任何确认相应信息。若为waitingForTimeServer(5) 则时间请求信息Time Request已经被发送但还没有受到任何响应信息。若为waitingForTftp(6) 则参数请求已经向TFTP服务器发送但还没有受到任何响应信息若为refusedByCmts(7) 则登记请求/响应信息交换失败。若为forwardingDen