2022自动配置技术白皮书

自动配置技术白皮书 Copyright©2022新华三技术有限公司版权所有，保留一切权利。 非经本公司书面许可，任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部，并不得以任何形式传播。除新华三技术有限公司的商标外，本手册中出现的其它公司的商标、产品标识及商品名称，由各自权利人拥有。本文中的内容为通用性技术信息，某些信息可能不适用于您所购买的产品。 目录 1概述1 1.1产生背景1 1.2技术优点1 2自动配置技术实现1 2.1文本类型的配置文件1 2.2Python脚本文件2 2.3Tcl脚本文件2 2.4自动配置的实现方式3 3U盘自动配置技术实现3 3.1使用ini格式的索引文件和对设备进行配置的文件进行自动配置3 3.2仅使用.cfg格式的配置文件进行自动配置6 4服务器自动配置技术实现7 4.1典型组网7 4.2运行机制8 4.2.1基本原理8 4.2.2服务器自动配置（IPv4环境）9 4.2.3服务器自动配置（IPv6环境）15 5典型组网应用19 5.1TFTP方式的服务器自动配置（交换应用）19 5.2HTTPPython方式的服务器自动配置举例（交换应用）20 5.3TFTP方式的同网段服务器自动配置（路由应用）20 5.4TFTP方式的跨网段服务器自动配置（路由应用）21 1概述 1.1产生背景 在部署网络设备时，设备硬件安装完成后，需要管理员到安装现场对设备进行软件调试。此种模式适合小规模安装，并容忍一定的人为出错几率。而对于较大型的项目，需要实施的网点多、设备数量多，手工配置的方式较为费时费力，安装和实施成本较高。因此，需要支持对完成硬件安装的设备进行自动配置的方案。 1.2技术优点 自动配置是指空配置设备上电启动时采用的一种自动获取并执行配置文件的功能。设备运行自动配置功能后，可以从U盘或文件服务器获取配置文件并自动加载配置文件，实现远程部署接入网络的设备，从而减少人力成本，并提高设备部署的效率。 2自动配置技术实现 空配置设备可以通过执行文件服务器上“.cfg”的文本类型配置文件、Python脚本文件或Tcl脚本文件实现自动配置。 2.1文本类型的配置文件 后缀名为“.cfg”的文本类型配置文件是用来保存配置的文件。 文本类型的配置文件包括特定配置文件、部分或全部公用配置文件以及缺省配置文件（device.cfg）三种类型。具体如表1所示。 表1不同的文本类型的配置文件 配置文件 适用的设备 文件名要求 支持的文件服务器 特定配置文件 具有特定配置需求的设备 配置文件名.cfg为了方便辨识文件名，尽量不要使用包含空格的配置文件名 HTTP服务器TFTP服务器 部分或全部共用配置文件 配置需求全部或者部分相同的设备 配置文件名.cfg“配置文件名”可以是任意文件名 HTTP服务器TFTP服务器 缺省配置文件，包含一般设备启动的公用配置信息 无特殊配置需求的设备 固定配置文件名device.cfg TFTP服务器 2.2Python脚本文件 ComwareV7系统提供扩展PythonAPI，设备通过执行PythonAPI脚本实现自动配置。Python脚本文件由管理员创建，并存放在文件服务器（HTTP服务器或TFTP服务器）上供设备获取，其后缀名为“.py”。 扩展PythonAPI支持如下两种方式下发Comware配置命令： 1.channel channel方式用来执行Comware系统的命令并创建channel对象。脚本格式为channel(command=‘’)。command表示要下发的命令，缺省为空。channel下发命令是从用户视图开始，如果command中不指定视图，直接输入命令，表示该命令在用户视图下执行；当需要执行其它视图的命令时，需要先输入进视图的命令，再输入具体的配置命令。多条命令之间以空格加分号分隔，如’system-view;displayinterfacebrief|includeUP’。 2.CLI CLI方式用来执行Comware系统的命令并创建CLI对象。脚本格式为CLI(command=‘’, do_print=True)。 command：表示要下发的命令，缺省为空。CLI下发命令是从用户视图开始，如果command中不指定视图，直接输入命令，表示该命令在用户视图下执行；当需要执行其它视图的命令时，需要先输入进视图的命令，再输入具体的配置命令。多条命令之间以空格加分号分隔， 如’system-view;local-usertestclassmanage’。 do_print：表示是否输出执行结果，True表示输出执行结果，False表示不输出执行结果。缺省值为True。 管理员通过Python脚本可以实现丰富的功能，例如通过识别设备型号下载对应的配置文件、自动保存配置文件到文件服务器等等。本白皮书仅介绍自动配置的工作流程，不包含如何编辑Python脚本的内容。 2.3Tcl脚本文件 ComwareV7系统内嵌了Tcl（ToolCommandLanguage，工具命令语言）解析器，支持执行Tcl脚本命令，以实现通过Tcl脚本配置设备。Tcl脚本文件由管理员创建，并存放在文件服务器（HTTP服务器或TFTP服务器）上供设备获取，其后缀名为“.tcl”。Tcl脚本文件中包括设备可执行的Comware命令。例如： system-view telnetserverenablelocal-useruserpasswordsimpleabcabcservice-typetelnetquit user-interfacevty063authentication-modeschemeuser-rolenetwork-adminquit interfacegigabitethernet1/0/1 portlink-moderouteipaddressdhcp-allocreturn 2.4自动配置的实现方式 空配置的设备在上电后自动进入自动配置流程。设备首先尝试通过插入的U盘完成自动配置，如果 U盘配置失败，再尝试通过服务器方式完成自动配置。 U盘自动配置：管理员将配置文件保存在U盘上，设备在启动时可以自动从USB接口插入的 U盘上获取并执行配置文件，实现自动配置功能。 服务器自动配置：网络中存在文件服务器、DHCP服务器和DNS服务器的情况下，空设备上电启动时，设备会自动运行DHCPClient服务，通过DHCPServer获取配置文件所在的URL地址或TFTPServerIP、TFTPServername以及配置文件的文件名，然后从文件服务器下载配置文件进行配置加载并启动的过程。 不同实现方式下，配置文件的保存位置以及应用场景如表2所示。 表2自动配置的实现方式 实现方式 配置文件保存位置 应用场景 服务器自动配置 文件服务器 网络规模较大，设备位置相对分散 U盘自动配置 U盘 小规模网络：设备位置相对集中且缺少多余设备作为文件服务器大规模网络：仅有少量设备的配置需要更新仅支持USB口的设备支持U盘自动配置 3U盘自动配置技术实现 设备空配置启动进入自动配置流程后，首先尝试通过从U盘进行自动配置。U盘自动配置支持如下两种方式： 使用ini格式的索引文件和索引文件指定的配置文件进行自动配置 仅使用.cfg格式的配置文件进行自动配置 3.1使用ini格式的索引文件和对设备进行配置的文件进行自动配置 1.ini索引文件的格式 使用ini格式的索引文件进行自动配置时，索引文件的名称必须为“smart_config.ini”。管理员需要将名称为“smart_config.ini”的索引文件、对设备进行配置的文件（如.cfg格式的配置文件）保存到U盘中。索引文件中各字段的含义如表3所示。 表3ini索引文件字段含义 字段 描述 BEGINLSW 必选字段。起始标志，此字段不能修改 字段 描述 GLOBALCONFIG 必选字段。全局配置起始标志，此字段不能修改 TIMESN 必选字段。数据变更时间标志，字符串格式，长度范围为1～16，不能包含空格。建议格式：年月日.时分秒。例如，2011年06月28日08时09分10秒，可设置为TIMESN=20110628.080910。 每个TIMESN对应某台升级的设备。在U盘自动配置过程中，设备会在重启前记录此TIMESN（升级后不需要重启的则在升级完成后记录），下次升级不可使用此TIMESN。如果由于某些原因造成在设备重启后升级失败，则需要将TIMESN重新修改后再进行U盘自动配置 AUTODELFILE 可选字段。表示是否允许升级后自动删除原有系统软件AUTODELFILE=YES：删除AUTODELFILE=NO：不删除 缺省情况下，AUTODELFILE为NO。如果该字段不存在、为空或是不合法值，均表示为缺省情况 有两种AUTODELFILE字段：全局字段和单台设备字段。 位于[GLOBALCONFIG]字段内的是全局字段，位于[DEVICEDESCRIPTION]内的是单台设备字段。 如果单台设备设置了此字段的值为YES或NO，则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空，则以全局设置的生效 AUTOOVERWRITEFILE 可选字段。表示从U盘拷贝配置文件到设备上时，如果设备上有同名配置文件，是否允许覆盖设备上的同名配置文件 AUTOOVERWRITEFILE=YES：覆盖AUTOOVERWRITEFILE=NO：不覆盖 缺省情况下，AUTOOVERWRITEFILE为YES。如果该字段不存在、为空或是不合法值，均表示为缺省情况 ACTIVEMODE 可选字段。表示文件拷贝完成后的文件激活方式。 DEFAULT：按照各个文件的默认方式激活。其中，系统软件默认激活方式是重启设备；配置文件、补丁文件默认激活方式是不重启设备，在线激活REBOOT：采用重启设备的方式激活。缺省情况下，ACTIVEMODE为DEFAULT。如果该字段不存在、为空或是不合法值，均表示为缺省情况。有两种ACTIVEMODE字段：全局字段和单台设备字段。位于[GLOBALCONFIG]字段内的是全局字段，位于[DEVICEDESCRIPTION]内的是单台设备字段如果单台设备设置了此字段的值为DEFAULT或REBOOT，则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空，则以全局设置的生效 DEVICEDESCRIPTION 必选字段。单台设备文件信息描述起始标志DEVICEDESCRIPTION字段下表示单台设备信息的每个字段不可以重复出现，否则将不匹配这个DEVICE。DEVICE按照文件中定义的顺序从上到下进行匹配，匹配到一组之后不会再匹配其它DEVICE OPTION 可选字段。单台设备文件信息有效标志，表示该设备文件信息是否有效。OPTION=OK：有效 字段 描述 OPTION=NOK：无效，此单台设备的文件信息都无需判断 缺省情况下，OPTION为OK。如果该字段不存在、为空或是不合法值，均表示为缺省情况 SN 可选字段。设备序列号。如果SN=DEFAULT，表示不匹配ESN序列号，否则需要和设备匹配SN。缺省情况下，ESN为DEFAULT。如果该字段不存在或为空，则表示为缺省情况 待升级的设备将在索引文件中按DEVICE从上往下进行匹配，匹配的优先级为：MAC>SN>DEVICETYPE>DEFAULT。一旦匹配上，则按匹配上的DEVICE信息加载文件，如果此过程出错，将不会再次进行匹配，只会输出错误报告 MAC 可选字段。设备MAC地址，格式为：XXXX-XXXX-XXXX，X为十六进制数。如果MAC=DEFAULT，表示不匹配MAC地址，否则需要和设备匹配MAC地址 缺省情况下，MAC为DEFAULT。如果该字段不存在或为空，则表示为缺省情况 DEVI