01 基础配置命令参考

06-软件升级命令

1 软件升级配置命令

1.1 软件升级配置命令

1.1.1 boot-loader

1.1.2 boot-loader update slot

1.1.3 bootrom

1.1.4 display boot-loader

1.1.5 display patch information

1.1.11 patch location

1.1.12 patch run

1 软件升级配置命令

1.1 软件升级配置命令

1.1.1 boot-loader

【命令】

分布式设备：

boot-loader file file-url slot slot-number { main | backup }

分布式IRF设备：

boot-loader file file-url chassis chassis-number slot slot-number { main | backup }

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

file file-url：文件名，为1～63个字符的字符串，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败。格式为[drive:/]file-name，其中，

l [ ]表示该参数可选，

l drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。如果设备上只有一个存储介质，可以不用输入该参数。

l file-name表示文件的名称，一般以.app作为后缀名。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：用来设置指定成员设备上指定单板的下次启动文件为指定文件。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（分布式IRF设备）

main：指定该文件为主用启动文件。

backup：指定该文件为备用启动文件。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。

【描述】

(1) 分布式设备

boot-loader命令用来指定主用主控板或者备用主控板的下次启动文件。

需要注意的是：

l 必须先将下次启动文件保存到相应主控板存储介质的根目录下，boot-loader命令才能执行成功。

l 主用主控板上的存储介质直接用存储介质的名称表示，比如flash；备用主控板的存储介质需要使用slotslot-number#存储介质的名称（slot-number表示备用主控板所在的槽位号），比如slot1#flash。

l 设置主用主控板的下次启动文件时，file-url参数不能携带槽位号，slot-number为主用主控板所在的槽位号；设置备用主控板的下次启动文件时，file-url参数需要携带备用主控板所在的槽位号（形如slot1#flash:/test.app），slot-number为备用主控板所在的槽位号。

l 主用主控板和备用主控板的下次启动文件名称可以不同，但是版本必须一致，否则，可能会导致设备不能正常启动。

相关配置可参考命令display boot-loader。

(2) 分布式IRF设备

boot-loader命令用来指定IRF中某个主控板的下次启动文件。

需要注意的是：

l 必须先将下次启动文件保存到相应成员设备某个主控板存储介质的根目录下，boot-loader命令才能执行成功。

l 全局主用主控板（Master设备的主用主控板）的存储介质直接用存储介质的名称表示，比如flash；全局备用主控板（IRF中全局主用主控板外的其它主控板）的存储介质需要使用chassischassis-number#slotslot-number#存储介质的名称，比如chassis2#slot1#flash。

l 设置全局主用主控板的下次启动文件时，file-url参数不能携带成员编号和单板编号，chassis-number参数指定为Master设备的成员编号，slot-number参数指定为全局主用主控板所在的槽位号；设置全局备用主控板的下次启动文件时，file-url参数必须携带该主控板所在设备的成员编号和单板的槽位号（形如chassis3#slot1#flash:/test.app），chassis-number和slot-number指定为设备的成员编号和单板所在的槽位号。

l 全局主用主控板和全局备用主控板的下次启动文件名称可以不同，但是版本最好一致，否则，可能会导致备用主控板不能加入IRF。

相关配置可参考命令display boot-loader。

【举例】

# 指定主用主控板（所在槽位为0）的主用下次启动文件为test.app（请先保证test.app已经存储在主用主控板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式设备）

<Sysname> boot-loader file test.app slot 0 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on slot 0!

# 指定备用主控板（所在槽位为1）的主用下次启动文件为test.app（请先保证test.app已经存储在备用主控板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式设备）

<Sysname> boot-loader file slot1#flash:/test.app slot 1 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on slot 1!

# 指定全局主用主控板（所在设备的成员编号为1，槽位号为0）的主用下次启动文件为test.app（请先保证test.app已经存储在该单板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式IRF设备）

<Sysname> boot-loader file test.app chassis 1 slot 0 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on chassis 1 slot 0!

# 指定全局备用主控板（所在设备的成员编号为1，槽位号为1）的主用下次启动文件为test.app（请先保证test.app已经存储在该单板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式IRF设备）

<Sysname> boot-loader file chassis1#slot1#flash:/test.app chassis 1 slot 1 main

This command will set the boot file of the specified board. Continue? [Y/N]:y

The specified file will be used as the main boot file at the next reboot on chassis 1 slot 1!

1.1.2 boot-loader update slot

【命令】

boot-loader update slot slot-number

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

slot slot-number：表示备用主控板所在的槽位号。（分布式设备）

【描述】

boot-loader update slot命令用来同步升级备用主控板的主用下次启动文件。

同步升级备用主控板的启动文件之前，请确保备用主控板的存储介质有足够的空间存放待升级的启动文件。

【举例】

# 同步升级备用主控板（编号为1）的下次启动文件。

<Sysname> boot-loader update slot 1

1.1.3 bootrom

【命令】

分布式设备：

bootrom { backup | read | restore | update file file-url } slot slot-number-list [ all | part ]

分布式IRF设备：

bootrom { backup | read | restore | update file file-url } chassis chassis-number slot slot-number-list [ all | part ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

read：读取Bootrom，即将Bootrom程序从Bootrom存储器的Normal区读取到Flash中以作备份。当Bootrom存储器损坏，可以重新运行Flash上的Bootrom文件来恢复Bootrom。

restore：恢复Bootrom，即将Bootrom代码从Bootrom存储器的Backup区恢复到Normal区。如果当前的Bootrom被损坏，并且在损坏前备份了Bootrom，可以用restore操作来恢复Bootrom。

backup：备份Bootrom，即将Bootrom代码从Bootrom存储器的Normal区备份到Backup区，以便Normal区损坏时，可以从Backup区恢复Bootrom程序。建议在升级Bootrom前备份Bootrom。

update file file-url：升级Bootrom，file-url表示用于升级的文件名，为1～63个字符的字符串。file-url参数的详细介绍请参见1.1.1 boot-loader。

slot slot-number-list：单板的槽位号列表，表示多个单板。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示单板所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（分布式设备）

slot slot-number-list：设备的成员编号列表，表示多个成员设备。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示设备在IRF中的成员编号。（集中式IRF设备）

chassis chassis-number：表示设备在IRF中的成员编号。不指定该参数时，表示所有成员设备。（分布式IRF设备）

all：操作Bootrom的全部内容。不指定all和part参数时，默认使用all。

part：只操作Bootrom的扩展内容（Bootrom分两部分：常规部分和扩展部分，常规部分提供Bootrom的基本操作项，扩展部分提供更多的Bootrom操作项）。不指定all和part参数时，默认使用all。

【描述】

(1) 分布式设备

bootrom命令用来读取、恢复、备份或升级指定单板或子卡的Bootrom程序。

需要注意的是：

l 必须先将Bootrom程序保存到相应单板存储介质的根目录下，bootrom命令用来才能执行成功。

l 主用主控板上的存储介质直接用存储介质的名称表示，比如flash；备用主控板和接口板的存储介质需要使用slotslot-number#存储介质的名称（slot-number表示备用主控板或接口板所在的槽位号），比如slot1#flash。

l 升级主用主控板的Bootrom程序时，file-url参数不能携带槽位号，slot-number参数指定为主用主控板所在的槽位号，subslot-number-list参数指定为主用主控板上子卡所在的槽位号；升级备用主控板或接口板的Bootrom程序时，file-url参数需要携带该板的槽位号（形如slot1#flash:/test.app），slot-number参数指定为该板所在的槽位号。

l 设备上各单板的Bootrom程序名称可以不同，但是版本必须兼容，否则，可能会导致单板不能正常启动。

(2) 分布式IRF设备

bootrom命令用来读取、恢复、备份或升级指定成员设备上指定单板或子卡的Bootrom程序。

需要注意的是：

l 必须先将Bootrom程序保存到相应成员设备指定单板存储介质的根目录下，bootrom命令才能执行成功。

l 全局主用主控板的存储介质直接用存储介质的名称表示，比如flash；全局备用主控板的存储介质需要使用chassischassis-number#slotslot-number#存储介质的名称，比如chassis3#slot1#flash。

l 升级全局主用主控板以及Master上接口板的Bootrom程序时，file-url参数不能携带成员编号和单板的槽位号，chassis-number参数指定为Master的成员编号，slot-number参数指定为单板所在的槽位号；升级IRF中其它单板的Bootrom程序时，file-url参数必须携带该单板所在设备的成员编号以及单板所在的槽位号（形如chassis3#slot1#flash:/test.app），chassis-number参数指定为该单板所在设备的成员编号，slot-number参数指定为该单板所在的槽位号。chassis-number和slot-number指定为该单板所在设备的成员编号以及单板的槽位号。

【举例】

# 使用a.btm文件升级主用主控板（所在槽位号为0）的Bootrom程序。（分布式设备）

<Sysname> bootrom update file a.btm slot 0

This command will update bootrom file on the specified board(s), Continue? [Y/N]:y