更新时间:2026-03-17 GMT+08:00
分享

交换机通过U盘方式上云

U盘开局方式上云基本流程

U盘开局之前,需要先制作U盘开局索引文件并将索引文件保存至U盘根目录下。把需要加载的开局文件保存至U盘开局索引文件指定的目录下。将U盘插入设备中,设备会根据开局文件自动完成文件的加载。U盘开局流程如图 U盘开局流程所示:

图1 U盘开局流程图

U盘开局上云操作方法

  1. 编辑U盘开局索引文件smart_config.ini。

    新建一个索引文件,命名为“smart_config.ini”。索引文件的内容与格式如下:

    BEGIN LSW 
    [GLOBAL CONFIG] 
    TIMESN=20130728.020900 
    [DEVICE0 DESCRIPTION] 
    MAC=xxxx-xxxx-xxxx 
    AUTODELFILE=YES 
    DEVICETYPE=S12700 
    SYSTEM-SOFTWARE=S12700-new.CC 
    SYSTEM-USERDEF1=userfile.txt 
    [DEVICE1 DESCRIPTION] 
    ESN=020TEA10xxxxxxxx 
    DEVICETYPE=S12700 
    SYSTEM-SOFTWARE=S12700-new.CC 
    SYSTEM-CONFIG=vrpcfgnew.zip 
    SYSTEM-PAT=patch.pat 
    END LSW
    表1 smart_config.ini索引文件字段含义

    字段

    描述

    BEGIN LSW

    必选字段。起始标志,此字段不能修改。

    GLOBAL CONFIG

    必选字段。全局配置起始标志,此字段不能修改。

    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字段:全局字段和单台设备字段。

    • 位于[GLOBAL CONFIG]字段内的是全局字段,位于[DEVICEn DESCRIPTION]内的是单台设备字段。
    • 如果单台设备设置了此字段的值为YES或NO,则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空,则以全局设置的生效。

    ACTIVEMODE

    可选字段。表示文件复制完成后的文件激活方式。

    • DEFAULT:按照各个文件的默认方式激活。

      其中,系统软件、配置文件默认激活方式是重启设备;补丁文件默认激活方式是不重启设备,在线激活;License文件、Web网页文件、用户自定义文件不做激活处理,下载成功后U盘开局即结束。

    • RELOAD:采用重启设备的方式激活。

    缺省情况下,ACTIVEMODE为DEFAULT。如果该字段不存在、为空或是不合法值,均表示为缺省情况。

    有两种ACTIVEMODE字段:全局字段和单台设备字段。

    • 位于[GLOBAL CONFIG]字段内的是全局字段,位于[DEVICEn DESCRIPTION]内的是单台设备字段。
    • 如果单台设备设置了此字段的值为DEFAULT或RELOAD,则以单台设备设置的生效。如果单台设备没有设置此字段或者此字段为空,则以全局设置的生效。

    USB-DEPLOYMENT PASSWORD

    可选字段。U盘开局的认证密码。如果待开局设备的配置中包含开局认证密码,则此字段中必须填入相应的密码,如果待开局设备中未配置密码,该字段为空或不存在即可。同一个索引文件只能使用同一个密码。如果一个索引文件需要对多个设备开局,则设备上配置的开局认证的密码必须相同。
    说明:

    如果是非空配置设备进行U盘开局,必须通过命令set device usb-deployment config-file password配置加密和解密的密码。

    DEVICEn DESCRIPTION

    必选字段。单台设备文件信息描述起始标志,n表示设备的编号,从0开始,最大为65535。

    说明:
    • DEVICEn DESCRIPTION字段下表示单台设备信息的每个字段不可以重复出现,否则将不匹配这个DEVICEn
    • DEVICE按照文件中定义的顺序从上到下进行匹配,匹配到一组之后不会再匹配其它DEVICEn

    OPTION

    可选字段。单台设备文件信息有效标志,表示该设备文件信息是否有效。
    • OPTION=OK:有效
    • OPTION=NOK:无效,此单台设备的文件信息都无需判断

    缺省情况下,OPTION为OK。如果该字段不存在、为空或是不合法值,均表示为缺省情况。

    ESN

    可选字段。设备序列号。如果ESN=DEFAULT,表示不匹配ESN序列号,否则需要和设备匹配ESN。

    缺省情况下,ESN为DEFAULT。如果该字段不存在或为空,则表示为缺省情况。

    待升级的设备将在索引文件中按DEVICE从上往下进行匹配,匹配的优先级为:MAC > ESN > DEVICETYPE > DEFAULT。一旦匹配上,则按匹配上的DEVICE信息进行加载文件,如果此过程出错,将不会再次进行匹配,只会输出错误报告。

    MAC

    可选字段。设备MAC地址,格式为:XXXX-XXXX-XXXX,X为十六进制数。如果MAC=DEFAULT,表示不匹配MAC地址,否则需要和设备匹配MAC地址。

    缺省情况下,MAC为DEFAULT。如果该字段不存在或为空,则表示为缺省情况。

    DEVICETYPE

    可选字段。表示与设备的类型匹配,例如S12700。如果DEVICETYPE=DEFAULT,表示不匹配设备类型。否则需要和设备的类型匹配。

    缺省情况下,DEVICETYPE为DEFAULT。如果该字段不存在或为空,则表示为缺省情况。

    HMAC

    可选字段。配置文件的HMAC校验值,用于对加载的配置文件进行校验。该值为64位的字符串,是通过计算工具对U盘中的配置文件以HMAC-SHA256算法计算出的值。其中用作计算的密钥必须与在设备上通过set device usb-deployment hmac-key命令设置的HMAC密钥保持一致。缺省情况下,不对配置文件进行校验。

    说明:

    可通过HMAC-SHA256计算工具(如OpenSSL或者HashCalc)生成配置文件的HMAC值。

    当U盘开局的升级文件中包含配置文件时,为提高安全性,建议通过命令set device usb-deployment config-file password配置加密和解密的密码,对配置文件按照标准zip格式压缩,压缩时指定密码,再保存至U盘,通过命令set device usb-deployment hmac-key命令配置U盘开局时HMAC校验功能的HMAC密钥,同时通过命令set device usb-deployment hmac使能HMAC校验功能。

    DIRECTORY

    可选字段。文件在U盘中存放的目录。
    • 此字段为空或不存在时,表示文件位于U盘根目录下。
    • DIRECTORY=/abc,表示文件位于U盘的abc文件夹下。

    缺省情况下,DIRECTORY字段为空。

    索引文件中文件目录的格式必须与设备的文件系统一致:
    • 目录深度小于等于4级。目录必须以“/”开头,每一级目录以“/”隔开,但不能以“/”结束,例如/abc/test是合法目录,/abc/test/则是非法目录。
    • 每一级目录的字符串长度范围是1~15。
    • 目录名使用的字符不可以是空格、“~” 、“*” 、“/” 、“\” 、“:” 、“'” 、“"” 、“<” 、“>” 、“|” 、“?” 、“[” 、“]”、“%” 等字符,目录名称不区分大小写。

    SYSTEM-SOFTWARE

    可选字段。系统软件名称,后缀名为“.cc”。

    如果指定了此字段,则设备在复制系统软件前,会将此系统软件的版本号与设备正在运行的系统软件版本号比较,如果相同则不进行复制以及系统软件的升级。

    SYSTEM-CONFIG

    可选字段。配置文件名称,后缀名为“.cfg”或“.zip”。

    SYSTEM-LICENSE

    可选字段。License文件名称,后缀名为“.dat”。

    SYSTEM-PAT

    可选字段。补丁文件名称,后缀名为“.pat”。

    SYSTEM-WEB

    可选字段。Web网页文件名称,后缀名为“.web.7z”。

    SYSTEM-USERDEF1

    SYSTEM-USERDEF2

    SYSTEM-USERDEF3

    可选字段。用户自定义文件。

    END LSW

    必选字段。文件结束标志。

  2. 将索引文件smart_config.ini及其他所有开局文件保存至U盘根目录下.
  3. 将U盘插入S12700主用主控板中启动开局流程,观察指示灯,监控U盘开局的状态。

    设备重启后,系统检测开局状态:USB指示灯绿色常亮,表示U盘开局成功;USB指示灯红色快闪(每秒闪两次),表示U盘开局失败,可查看U盘根目录下usbload_error.txt文件定位出错原因。

    确认U盘开局成功后,拔出U盘,U盘开局结束。

相关文档