目  录

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

1.1.7 display patch information

1.1.8 patch active

1.1.9 patch deactive

1.1.10 patch delete

1.1.11 patch install

1.1.12 patch load

1.1.13 patch location

1.1.14 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，其中，

·     [ ]表示该参数可选。

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

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

slot { all | slot-number }：指定设备编号。slot-number取值只能为1。使用slot all和slot 1配置效果相同。

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

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

【描述】

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

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

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

【举例】

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

<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!

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 { all | slot-number }：指定设备编号。slot-number取值只能为1。使用slot all和slot 1配置效果相同。

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

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

【描述】

boot-loader update file命令用来同步升级设备的启动文件。

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

·     将指定文件拷贝到设备。

·     将该文件指定为该设备的下次启动文件。

【举例】

# 同步升级设备。

<Sysname> tftp 192.168.1.26 get main.bin

  File will be transferred in binary mode

  Downloading file from remote TFTP server, please wait...|

  TFTP: 10105088 bytes received in 36 second(s)

  File downloaded successfully.

<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个字符的字符串。

slot slot-number-list：指定设备编号。slot-number-list取值只能为1。

【描述】

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

升级设备前，请将Bootrom程序保存到该设备存储介质的根目录下。

【举例】

# 使用a.btm文件升级设备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.

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 取值只能为1。

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

【命令】

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

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

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

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

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

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

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

【描述】

display patch命令用来显示当前安装的补丁文件和对应的补丁包的版本。如果不是从补丁包中加载补丁，则不显示补丁包版本。

【举例】

# 显示当前安装的补丁文件和补丁包版本。

<Sysname> display patch

The following patch packages are loaded:

flash:/patch-package.bin, Package-Version-001, loaded on slot(s):

1

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

1.1.7  display patch information

【命令】

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

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

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

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

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

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

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

【描述】

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

【举例】

# 显示热补丁的信息。

<Sysname> display patch information

The location of patches: flash:/

Slot Version   Temporary Common Current Active Running  Start-Address

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

1    XXX        0           0       0        0        0         0x53f8364 

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

1.1.8  patch active

【命令】

patch active [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：指定设备编号。slot-number 取值只能为1。

【描述】

patch active命令用来激活补丁，即临时运行已加载的补丁。

执行该命令时，如果指定补丁序号，则表示补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活；如果不指定补丁序号，则表示当前所有处于未激活状态的补丁将全部被激活。

需要注意的是：

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

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

【举例】

# 激活设备上3号及3号之前已加载的补丁。

<Sysname> system-view

[Sysname] patch active 3 slot 1

# 激活设备上所有已加载的补丁。

<Sysname> system-view

[Sysname] patch active slot 1

1.1.9  patch deactive

【命令】

patch deactive [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：指定设备编号。slot-number 取值只能为1。

【描述】

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

执行该命令时，如果指定补丁序号，则表示在此补丁序号之后（包括该序号）处于激活状态的补丁将全部进入未激活状态；如果不指定补丁序号，则表示当前所有处于激活状态的补丁将全部进入未激活状态。

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

【举例】

# 停止运行设备上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

# 停止运行设备上所有已激活的补丁。

<Sysname> system-view

[Sysname] patch deactive slot 1

1.1.10  patch delete

【命令】

patch delete [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：指定设备编号。slot-number 取值只能为1。

【描述】

patch delete命令用来将补丁从内存补丁区中删除。

执行该命令时，如果指定补丁序号，则表示补丁序号之后（包括该序号）的所有补丁将被删除；如果不指定补丁序号，则表示内存补丁区中的所有补丁将被删除。

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

【举例】

# 删除设备上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch delete 3 slot 1

# 删除设备上所有补丁。

<Sysname> system-view

[Sysname] patch delete slot 1

1.1.11  patch install

【命令】

patch install { patch-location | file filename }

undo patch install

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式为存储介质的根目录。该参数用于安装没有经过打包的补丁文件，补丁文件的名称必须符合要求，否则系统会因无法识别文件名而造成补丁操作失败。

file filename：表示补丁包文件的名称。该参数用于安装补丁包文件，补丁包是指打包的补丁文件，该文件中存放了相同版本不同类型的补丁文件。

【描述】

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

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

·     如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，补丁状态从IDLE转换到RUNNING，设备重启后这些补丁继续生效。

·     如果输入<N>或者<n>，则会安装指定路径下的所有补丁，补丁状态从IDLE转换到ACTIVE，设备重启后这些补丁不再继续生效。

执行该命令前，需要将补丁文件保存到指定路径：

安装补丁时，请将补丁包文件或者补丁文件保存在设备存储介质的根目录下。

【举例】

# 加载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…

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

<Sysname> system-view

[Sysname] patch install file patch_package.bin

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

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

Installing patches…

1.1.12  patch load

【命令】

patch load slot slot-number [ file filename ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

slot slot-number：指定设备编号。slot-number 取值只能为1。

file filename：表示补丁包文件的名称。

【描述】

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

如果指定了补丁包文件，则表示系统从补丁包中加载补丁；如果未指定补丁包文件，则表示从补丁文件中加载补丁，系统默认会从Flash中读取补并加载补丁文件。

执行该命令前，需要将补丁文件保存到指定路径：

加载补丁时，请将补丁包文件或者补丁文件保存在设备存储介质的根目录下。

【举例】

# 从补丁文件中为设备加载补丁。

<Sysname> system-view

[Sysname] patch load slot 1

# 从补丁包中为设备加载补丁。

<Sysname> system-view

[Sysname] patch load slot 1 file flash:/patchpackage.bin

1.1.13  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式通常为存储介质的根目录。

【描述】

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

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

如果是要安装补丁包，则也无需配置该命令。

【举例】

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

<Sysname> system-view

[Sysname] patch location flash:

1.1.14  patch run

【命令】

patch run [ patch-number ] [ slot slot-number ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：指定设备编号。slot-number 取值只能为1。

【描述】

patch run命令用来确认运行补丁，即确认激活状态的补丁进入运行状态。

执行该命令时，如果指定补丁序号，则表示确认运行补丁序号之前（包括该序号）的所有已激活的补丁；如果不指定补丁序号，则表示确认运行当前系统中所有已激活的补丁。

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

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

【举例】

# 确认运行设备上3号及3号之前的补丁。

<Sysname> system-view

[Sysname] patch run 3 slot 1

# 确认运行设备上所有已激活的补丁。

<Sysname> system-view

[Sysname] patch run slot 1