目  录

1 软件升级配置命令

1.1 软件升级配置命令

1.1.1 boot-loader

1.1.2 boot-loader update file

1.1.3 bootrom

1.1.4 bootrom-update security-check enable

1.1.5 display boot-loader

1.1.6 display patch information

1.1.7 patch active

1.1.8 patch deactive

1.1.9 patch delete

1.1.10 patch install

1.1.11 patch load

1.1.12 patch location

1.1.13 patch run

1 软件升级配置命令

1.1  软件升级配置命令

1.1.1  boot-loader

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

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

l              [ ]表示该参数可选，

l              drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。

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

slot：指定设备的成员编号。

l              all：用来设置整个IRF系统内所有成员设备的下次启动文件为指定文件。

l              slot-number：用来设置指定成员设备的下次启动文件为指定文件。slot-number表示设备在IRF中的成员编号。

main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。

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

【描述】

boot-loader命令用来指定成员设备的下次启动文件。

需要注意的是：

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

l              Master上的存储介质直接用存储介质的名称表示，比如flash；Slave上的存储介质需要使用slotslot-number#存储介质的名称（slot-number表示Slave的成员编号），比如slot2#flash。

l              设置Master的下次启动文件时，file-url参数不能携带成员编号，slot-number参数指定为Master的成员编号；设置Slave的下次启动文件时，file-url参数必须携带该Slave的成员编号（形如slot2#flash:/test.bin），slot-number指定为该Slave的成员编号。

l              使用all参数时，file-url参数不可以携带成员编号，否则命令会执行失败，并且要求先将该文件使用相同的名称保存在所有成员设备的存储介质中，否则没有该文件的成员设备会设置失败。

l              Master和Slave的下次启动文件名称可以不同，但是版本必须一致，否则，Slave会使用Master的启动文件重新启动加入IRF。

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

【举例】

# 指定Master（成员编号为1）的主用下次启动文件为test.bin（请先保证test.bin已经存储在Master的存储介质中，否则系统会提示错误，命令执行失败）。

<Sysname> boot-loader file test.bin 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!

# 指定Slave（成员编号为2）的主用下次启动文件为test.bin（请先保证test.bin已经存储在Slave的存储介质中，否则系统会提示错误，命令执行失败）。

<Sysname> boot-loader file slot2#flash:/test.bin slot 2 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 2!

# 指定IRF中所有成员设备的主用下次启动文件为test.bin（请先保证test.bin已经存储在所有成员设备的存储介质中，否则系统会提示错误）。

<Sysname> boot-loader file test.bin slot all 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!

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

1.1.2  boot-loader update file

【命令】

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

file-url：文件名，为1～63个字符的字符串。该参数的详细介绍请参见1.1.1  boot-loader。

slot：指定设备的成员编号。

l              slot-number：用来同步升级指定成员设备。slot-number表示设备在IRF中的成员编号。

l              all：用来同步升级所有成员设备。

main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。

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

【描述】

boot-loader update file命令用来同步升级指定成员设备或者所有成员设备的启动文件。

执行本命令相当于分步执行以下操作：

l              将指定启动文件拷贝到指定的成员设备。

l              将该文件指定为该成员设备的启动文件。

【举例】

# 同步升级所有成员设备的启动文件。

<Sysname> boot-loader update file main.bin slot all main

This command will update the specified boot file of all boards. Continue? [Y/N]:Y

Now is updating, please wait...

<Sysname> reboot

1.1.3  bootrom

【命令】

bootrom update file file-url slot slot-number-list

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

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表示设备在IRF中的成员编号。

【描述】

bootrom命令用来升级指定成员设备的Bootrom程序。

需要注意的是：

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

l              Master上的存储介质直接用存储介质的名称表示，比如flash；Slave上的存储介质需要使用slotslot-number#存储介质的名称（slot-number表示Slave的成员编号），比如slot2#flash。

l              升级Master的Bootrom程序时，file-url参数不能携带成员编号，slot-number参数指定为Master的成员编号；升级Slave的Bootrom程序时，file-url参数必须携带该Slave的成员编号（形如slot2#flash:/test.bin），slot-number指定为该Slave的成员编号。

【举例】

# 使用a.btm文件升级Master（成员编号为1）的Bootrom程序。

<Sysname> bootrom update file a.btm slot 1

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

  Now updating bootrom, please wait...

  Bootrom update succeeded in slot 1.

# 使用a.btm文件升级Slave（成员编号为2）的Bootrom程序。

<Sysname> bootrom update file slot2#flash:/a.btm slot 2

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

  Now updating bootrom, please wait...

  Bootrom update succeeded in slot 2.

1.1.4  bootrom-update security-check enable

【命令】

bootrom-update security-check enable

undo bootrom-update security-check enable

【视图】

系统视图

【缺省级别】

2：系统级

【参数】

无

【描述】

bootrom-update security-check enable命令用来启动Bootrom升级时的合法性检查功能。undo bootrom-update security-check enable命令用来关闭Bootrom升级时的合法性检查功能。

缺省情况下，Bootrom升级时的合法性检查功能是打开的。

如果使能了该功能，则在升级Bootrom时，会先检查Bootrom文件的合法性、是否有效以及是否和硬件匹配等。

【举例】

# 启动Bootrom升级时的合法性检查功能。

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.5  display boot-loader

【命令】

display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

slot slot-number：显示指定成员设备的启动文件的信息。slot-number表示设备在IRF中的成员编号。

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display boot-loader命令用来显示启动文件信息。

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

【举例】

# 显示本次启动和下次启动所采用的启动文件（注意：本命令的显示信息与设备型号有关，请以设备的实际情况为准）。

<Sysname> display boot-loader

 Slot 1

The current boot app is:  flash:/test.bin

The main boot app is:     flash:/test.bin

The backup boot app is:   flash:/test.bin

表1-1 display boot-loader命令显示信息描述表

1.1.6  display patch information

【命令】

display patch information [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display patch information命令用来显示热补丁的信息。

【举例】

# 显示热补丁的信息。

The location of patches: flash:/

Slot Version   Temporary Common Current Active Running  Start-Address

----------------------------------------------------------------------

1    XXX        0           0        0        0       0         0x4d9a658

2    XXX        0           0        0        0       0         0x4d9a658

表1-2 display patch information命令显示信息描述表

1.1.7  patch active

【命令】

patch active patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示设备在IRF中的成员编号。

【描述】

patch active命令用来激活指定补丁，即运行该补丁。

执行该命令，补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活，进入激活状态。

需要注意的是：

l              激活补丁前，必须先加载该补丁，否则，激活操作失败。

l              系统重启后，原处于激活状态的补丁会变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活。

【举例】

# 激活成员设备（成员编号为1）上3号及3号之前的补丁。

<Sysname> system-view

[Sysname] patch active 3 slot 1

1.1.8  patch deactive

【命令】

patch deactive patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示设备在IRF中的成员编号。

【描述】

patch deactive命令用来停止运行指定补丁，恢复原版本软件的运行。

执行该命令，在此补丁序号之后（包括该序号）处于激活状态的补丁全部进入未激活状态。

对于处于运行状态的补丁，本命令无效。

【举例】

# 停止运行成员设备（成员编号为1）上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

1.1.9  patch delete

【命令】

patch delete patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示设备在IRF中的成员编号。

【描述】

patch delete命令用来将补丁从内存补丁区中删除，补丁序号之后（包括该序号）的所有补丁被删除。

执行该命令，只是将补丁从内存补丁区中删除，并不会将补丁从存储介质中删除，补丁回到初始状态（IDLE）。

【举例】

# 删除成员设备（成员编号为1）上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch delete 3 slot 1

1.1.10  patch install

【命令】

patch install patch-location

undo patch install

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式通常为存储介质的根目录，也可能是存储介质的根目录+补丁文件名称的形式，与设备的型号有关，请以设备的实际情况为准。

【描述】

patch install命令用来一步式完成补丁的安装。undo patch install命令用来卸载补丁。

在执行patch install命令时，系统会提示“Do you want to continue running patches after reboot? [Y/N]:”，

l              如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，设备重启后这些补丁继续生效，补丁状态从IDLE转换到RUNNING。相当于依次执行了patch location、patch load、patch active和patch run命令。

l              如果输入<N>或者<n>，则会安装指定路径下的所有补丁，设备重启后这些补丁不再继续生效，补丁状态从IDLE转换到ACTIVE。相当于依次执行了patch location、patch load和patch active命令。

需要注意的是：

l              执行该命令前，请将补丁文件保存到所有成员设备存储介质的根目录下。

l              执行补丁安装操作后，系统会将补丁文件的加载路径修改成“patch install patch-location”中patch-location参数所指向的位置。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。

【举例】

# 加载Flash上的补丁文件，并且要求设备重启后补丁继续生效。

<Sysname> system-view

[Sysname] patch install flash:

Patches will be installed. Continue? [Y/N]:y

Do you want to run patches after reboot? [Y/N]:y

Installing patches…

Installation completed, and patches will continue to run after reboot.

[Sysname]

1.1.11  patch load

【命令】

patch load slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

slot slot-number：表示设备在IRF中的成员编号。

【描述】

patch load命令用来将补丁文件从存储介质加载到内存补丁区中。

执行该命令前，请将补丁文件保存到所有成员设备存储介质的根目录下。

【举例】

# 为成员设备（成员编号为1）加载补丁。

<Sysname> system-view

[Sysname] patch load slot 1

1.1.12  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式通常为存储介质的根目录，也可能是存储介质的根目录+补丁文件名称的形式，与设备的型号有关，请以设备的实际情况为准。

【描述】

patch location命令用来设置补丁文件的加载路径。

缺省情况下，补丁文件的加载路径为flash:。

【举例】

# 设置补丁文件加载路径为flash卡的根目录。

<Sysname> system-view

[Sysname] patch location flash:

1.1.13  patch run

【命令】

patch run patch-number [ slot slot-number ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示设备在IRF中的成员编号。

【描述】

patch run命令用来确认运行指定补丁，补丁序号之前（包括该序号）的激活状态补丁全部进入运行状态。

如果指定slot参数，则确认运行某成员设备上的所有补丁（包括辅助CPU的补丁）；如果不指定slot参数，表示确认运行所有成员设备上的所有补丁。

该命令只对处于激活状态的补丁有效，对于处于其它状态的补丁，该命令无效。

确认运行的补丁，在系统重启后，会继续生效。

【举例】

# 确认运行成员设备（成员编号为1）上3号及3号之前的补丁。

<Sysname> system-view

[Sysname] patch run 3 slot 1