目  录

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader

1.1.2 boot-loader update

1.1.3 bootrom update

1.1.4 display boot-loader

1.1.5 display patch

1.1.6 display patch information

1.1.7 logic update

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 slot-number { main | backup }

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

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

·     [ ]表示该参数可选，

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

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

slot slot-number：表示单板所在的槽位号。

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

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

【描述】

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

需要注意的是：

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

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

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

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

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

 

【举例】

# 指定设备下次启动时所用的主用启动文件为test.bin。

<Sysname> boot-loader file cf0:/test.bin slot 0 main

  This command will set boot file, Continue? [Y/N]:y

 

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

1.1.2  boot-loader update

【命令】

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 update

【命令】

bootrom update file file-url slot slot-number [ to  slot-number ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

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

slot slot-number-list：单板的槽位号列表，表示多个单板。表示方式为slot-number-list = { slot-number [ to slot-number ] }。其中，slot-number为单板的槽位号。

【描述】

bootrom命令用来升级某（些）槽上单板的BootWare程序。

需要注意的是，升级主控板或者业务板的BootWare程序时，指定主用主控板上存储介质中的.bin文件即可完成升级。

 

【举例】

# 使用文件SR01LNLMCUA106.bin升级设备6号槽单板的BootWare。

<Sysname> bootrom update file SR01LNLMCUA106.bin slot 6

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

  Now updating bootrom, please wait...

 

#Aug 21 15:08:30:383 2007 H3C DEV/1/BOARD REQUEST LOADING:

 Trap 1.3.6.1.4.1.2011.2.23.1.12.1.18<hwRequestLoading>: frameIndex is 0, slotIndex 0.6

 

#Aug 21 15:08:30:553 2007 H3C DEV/1/LOAD FINISHED:

 Trap 1.3.6.1.4.1.2011.2.23.1.12.1.20<hwLoadFinished>: frameIndex is 0, slotIndex 0.6

 

%Aug 21 15:08:30:673 2007 H3C DEV/4/BOARD LOADING:

 Board is loading file on Frame 0 Slot 6.

 

%Aug 21 15:08:30:804 2007 H3C DEV/4/LOAD FINISHED:

 Board has finished loading file on Frame 0 Slot 6.

 

%Aug 21 15:08:30:943 2007 H3C SYSM/0/SYSM_LOG_TOP:Slot=6;

 Frame 0 NPU Board 6 this is loading bootrom file...

%Aug 21 15:08:38:883 2007 H3C SYSM/0/SYSM_LOG_TOP:Slot=6;

 Frame 0 NPU Board 6 upgrade BOOTROM succeeded!

1.1.4  display boot-loader

【命令】

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

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

slot slot-number：显示指定单板的启动文件的信息。slot-number表示单板所在的槽位号。

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

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

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

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

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

【描述】

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

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

【举例】

# 显示设备本次启动和下次启动所采用的启动文件。

<Sysname> display boot-loader

 The primary app to boot of board 0 at the next time is: cf0:/test.bin

 The backup  app to boot of board 0 at the next time is: cf0:/backup.bin

 The app to boot of board 0 at this time is: cf0::/test.bin

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

字段	描述
The primary app to boot of board slot-number at next time is	单板（slot-number表示单板所在的槽位号）下次启动时使用的主用启动文件
The backup  app to boot of board slot-number at next time is	单板（slot-number表示单板所在的槽位号）下次启动时使用的备用启动文件
The app to boot of board 0 at this time is	单板（slot-number表示单板所在的槽位号）本次启动时使用的启动文件

 

1.1.5  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:/SR8800-b90h01a.bin, B90H01a, loaded on slot(s):

1, 4, 5, 6, 7, 8, 9, 10

flash:/SR8800-b90h01b.bin, B90H01b, loaded on slot(s):

2

flash:/SR8800-b90h01c.bin, B90H01c, loaded on slot(s):

3

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

字段	描述
flash:/SR8800-b90h01a.bin	安装的补丁文件的路径
B90H01a	补丁包的版本
loaded on slot(s):0	加载补丁的单板编号

 

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命令用来显示设备上热补丁的信息。

【举例】

# 显示热补丁的信息。

<Sysname> display patch information

The location of patches: flash:

Slot Version   Temporaty Common Current Active Running  Start-Address

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

0    RPE004    0         1      1       0      1        0x310bd74

1    100001    0         1      1       0      1        0x1bb87ac

1.1  OAM001    0         1      1       0      1        0x1bb87ac

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

字段	描述
The location of patches	补丁文件的加载路径，可以通过patch location命令设置
Slot	该字段表示单板所在的槽号，如果单板上只有一个CPU，则直接显示slot-number，如果单板上有多个CPU，则主CPU显示为slot-number，辅助CPU显示为slot-number.cpu-id
Version	补丁版本号
Temporary	临时补丁数目
Common	正式补丁数目
Current	当前补丁总数目
Running	处于运行状态的补丁数目
Active	处于激活状态的补丁数目
Start-Address	内存补丁区在内存中的起始地址

 

1.1.7  logic update

【命令】

logic update file filename slot slot-number { board | subcard }

【视图】

用户视图

【缺省级别】

2：系统级

【参数】

file filename：升级逻辑，filename表示用于升级的文件名，不指定文件名时使用当前启动文件中包含的逻辑升级文件。

slot slot-number：需要升级逻辑的单板所在的槽位号，目前设备仅支持接口板。

board：升级单板逻辑。

subcard：升级子卡逻辑。

【描述】

logic update令用来升级指定槽位单板上的逻辑。

 

【举例】

# 升级2号槽位单板上的逻辑。

<Sysname> logic update file test slot 2 board

1.1.8  patch active

【命令】

patch active [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：表示单板所在的槽位号。

【描述】

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

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

需要注意的是：

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

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

【举例】

# 激活备用板（所在槽位号为1）上3号及3号之前已加载的补丁。

<Sysname> system-view

[Sysname] patch active 3 slot 1

# 激活备用板（所在槽位号为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：单板的槽位号。

【描述】

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

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

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

【举例】

# 停止运行备用板（所在槽位号为1）上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

# 停止运行备用板（所在槽位号为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：单板的槽位号。

【描述】

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

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

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

【举例】

# 删除备用板（所在槽位号为1）上3号及3号之后的补丁。

<Sysname> system-view

[Sysname] patch delete 3 slot 1

# 删除备用板（所在槽位号为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个字符的字符串。补丁文件必须放在存储介质的根目录下，如果该存储介质是支持分区的CF卡，则补丁文件必须放在CF卡第一个分区的根目录下。

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

【描述】

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

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

·     如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁继续生效，补丁状态从IDLE转换到RUNNING。相当于依次执行了patch location、patch load、patch active和patch run命令。对于不在槽位的单板，系统会记录该槽位上应该进行的补丁操作，当有单板插入时，系统会根据记录对该单板安装相应的补丁。

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

执行该命令前，需要将补丁文件保存到指定路径：如果通过补丁文件安装补丁，请将主用主控板和业务板的补丁文件保存到主用主控板Flash的根目录下，备用主控板的补丁文件保存到备用主控板Flash的根目录下；如果通过补丁包文件安装补丁，请将补丁包文件保存在主用主控板和备用主控板的存储介质的根目录下。如果存储介质是支持分区的CF卡，则补丁文件/补丁包文件必须放在CF卡第一个分区的根目录下。

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

 

【举例】

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

<Sysname> system-view

[Sysname] patch install flash:

Make sure the patch files saved on the AMB and SMB are the same.

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]

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

<Sysname> system-view

[Sysname] patch install file:/patch_packeg.bin

Make sure the patch files saved on the AMB and SMB are the same.

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.12  patch load

【命令】

patch load slot slot-number [ file filename ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

slot slot-number：表示单板所在的槽位号。

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

【描述】

patch load命令用来将补丁文件从存储介质（比如Flash、CF卡）加载到内存补丁区中。

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

执行该命令前，需要将补丁文件保存到指定路径：如果要从补丁包中加载补丁，则可以将补丁包文件保存在主用板的任意路径下，否则，请将主用板和接口板的补丁文件保存到主用板存储介质的根目录下，备用板的补丁文件保存到备用板存储介质的根目录下。

 

【举例】

# 从补丁文件中为备用板（所在槽位号为1）加载补丁。

<Sysname> system-view

[Sysname] patch load slot 1

# 从补丁包中为备用板（所在槽位号为1）加载补丁。

<Sysname> system-view

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

1.1.13  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串。

【描述】

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

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

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

当设备支持多个存储介质时，用户可以将补丁文件保存到Flash外的其它存储介质。此时，需要使用该命令告知系统补丁文件的位置。执行补丁加载操作时，系统会将该路径下指定后缀的补丁加载到对应的单板。

需要注意的是，执行patch install命令会修改补丁文件的加载路径。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。如果执行patch install命令的同时指定了具体的补丁包文件，则不会改变补丁文件的加载路径。

【举例】

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

<Sysname> system-view

[Sysname] patch location cf0:

1.1.14  patch run

【命令】

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

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。

slot slot-number：表示单板所在的槽位号。

【描述】

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

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

如果指定slot参数，则确认运行该单板上的所有补丁（包括辅助CPU的补丁）；如果不指定slot参数，表示确认运行所有单板上的所有补丁。

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

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

【举例】

# 确认运行备用板（所在槽位号为1）上3号及3号之前的补丁。

<Sysname> system-view

[Sysname] patch run 3 slot 1

# 确认运行备用板（所在槽位号为1）上所有已激活的补丁。

<Sysname> system-view

[Sysname] patch run slot 1