选择区域语言: EN CN HK

01-基础配置命令参考

06-软件升级命令

本章节下载  (139 KB)

docurl=/cn/Service/Document_Software/Document_Center/Routers/Catalog/SR_Router/SR6600/Command/Command_Manual/H3C_SR6600_CR-R2420(V1.12)/01/201212/765492_30005_0.htm

06-软件升级命令


1 软件升级配置命令

1.1  软件升级配置命令

1.1.1  boot-loader

【命令】

集中式设备:

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

分布式设备:

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

【视图】

用户视图

【缺省级别】

3:管理级

【参数】

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

l              [ ]表示该参数可选,

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

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

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

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

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

【描述】

(1)        集中式设备

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

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

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

(2)        分布式设备

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

需要注意的是:

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

l              主用主控板上的存储介质直接用存储介质的名称表示,比如cfa0;备用主控板的存储介质需要使用slotslot-number#存储介质的名称slot-number表示备用主控板所在的槽位号),比如slot1#cfa0。

l              设置主用主控板的下次启动文件时,file-url参数不能携带槽位号,slot-number为主用主控板所在的槽位号;设置备用主控板的下次启动文件时,file-url参数需要携带备用主控板所在的槽位号(形如slot1#cfa0:/test.bin),slot-number为备用主控板所在的槽位号。

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

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

【举例】

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

<Sysname> boot-loader file test.bin main

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

 

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

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

<Sysname> boot-loader file test.bin 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.bin(请先保证test.bin已经存储在备用主控板的存储介质中,否则系统会提示错误,命令执行失败)。(分布式设备)

<Sysname> boot-loader file slot1#cfa0:/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 slot

【命令】

boot-loader update slot slot-number

【视图】

用户视图

【缺省级别】

3:管理级

【参数】

slot slot-number:表示备用主控板所在的槽位号。

【描述】

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

如果设备支持主用/备用(main/backup)两个下次启动文件,则同步升级的是备用主控板的主用下次启动文件。

本命令仅分布式设备支持。

 

【举例】

# 同步升级备用主控板(编号为1)的启动文件。

<Sysname> boot-loader update slot 1

1.1.3  bootrom

【命令】

集中式设备:

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

分布式设备:

bootrom update file file-url slot slot-number-list [ subslot subslot-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表示单板所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。

subslot subslot-number-list:子卡的槽位号列表,表示多个子卡。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中,subslot-number表示子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时,表示配置的是所有子卡。

【描述】

(1)        集中式设备

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

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

(2)        分布式设备

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

需要注意的是:

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

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

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

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

【举例】

# 使用a.btm文件升级设备的Bootrom程序。(集中式设备)

<Sysname> bootrom update file a.btm

  This command will update bootrom file, Continue? [Y/N]:y

  Now updating bootrom, please wait...

 

 Updating basic bootrom!

 ................................

 Update basic bootrom success!

 Updating extended bootrom!

 ........................

 Update extended bootrom success!

 Update bootrom success!

# 使用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

  Now updating bootrom, please wait...

  Start accessing bootcfa0 chip...

  Bootrom update succeeded in slot 0.

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

<Sysname> bootrom update file slot1#cfa0:/a.btm slot 1

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

  Now updating bootrom, please wait...

  Start accessing bootcfa0 chip...

  Bootrom update succeeded in slot 1.

1.1.4  display boot-loader

【命令】

集中式设备:

display boot-loader

分布式设备:

display boot-loader [ slot slot-number ]

【视图】

任意视图

【缺省级别】

2:系统级

【参数】

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

【描述】

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

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

【举例】

# 显示本次启动和下次启动所采用的启动文件信息。(集中式设备)

<Sysname> display boot-loader

 The boot file used this time:cfa0:/sr6602.bin attribute: main

 The boot file used next time:cfa0:/sr6602.bin attribute: main

 The boot file used next time:cfa0:/sr6602.bin attribute: backup

 Failed to get the secure boot file used next time!

表1-1 display boot-loader命令显示信息描述表(集中式设备)

字段

描述

The boot file used this time

系统本次启动时使用的启动文件

attribute

启动文件的属性:main表示主用;backup表示备用

The boot file used next time

系统下次启动时使用的启动文件

Failed to get the secure boot file used next time!

获取下次启动时使用的安全启动文件失败(主用、备用下次启动文件均不存在或者损坏时,如果启动设备,将使用安全启动文件启动)

 

# 显示本次启动和下次启动所采用的启动文件。(分布式设备)

<Sysname> display boot-loader

Master Board(slot0):

 The boot file used this time:cfa0:/sr6608.bin attribute: main

 The boot file used next time:cfa0:/sr6608.bin attribute: main

 The boot file used next time:cfa0:/sr6608_bak.bin attribute: backup

 Failed to get the secure boot file used next time!

Slave Board(slot1):

 Slave Board is Absent.

表1-2 display boot-loader命令显示信息描述表(分布式设备)

字段

描述

Master Board

主用主控板

The boot file used this time

系统本次启动时使用的启动文件

attribute

启动文件的属性:main表示主用;backup表示备用

The boot file used next time

系统下次启动时使用的启动文件

Failed to get the secure boot file used next time!

获取下次启动时使用的安全启动文件失败(主用、备用下次启动文件均不存在或者损坏时,如果启动设备,将使用安全启动文件启动)

Slave Board

备用主控板

Slave Board is Absent

备用主控板目前不在位

 

1.1.5  display patch information

【命令】

display patch information

【视图】

任意视图

【缺省级别】

3:管理级

【参数】

【描述】

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

【举例】

# 显示热补丁的信息。(集中式设备)

<Sysname> display patch information

The location of patches: cfa0:/

Slot Version   Temporary Common Current Active Running  Start-Address

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

0     RPE004     0          1        1         0       1         0x310bd74

# 显示热补丁的信息。(分布式设备)

<Sysname> display patch information

The location of patches: cfa0:/

Slot Version     Temporary Common Current Active Running  Start-Address

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

0    MPU           0           0       0        0       0         0x83b75bc8

1    MPU           0           0       0        0       0         0x837c2d30

2    LPM           0           0       0        0       0         0x828d7558

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

字段

描述

The location of patches

补丁文件的加载路径,可以通过patch location命令设置

Slot

无意义(集中式设备)

Slot

单板所在的槽号,如果单板上只有一个CPU,则直接显示slot-number,如果单板上有多个CPU,则主CPU显示为slot-number,辅助CPU显示为slot-number.cpu-id(分布式设备)

Version

补丁版本号。该字段的前3个字符表示PATCH-FLAG的后缀,比如某单板的PATCH-FLAG为PATCH-RPE,则该字段会显示为RPE,后面的数字00x表示补丁的编号(只有补丁加载后,系统才能读取到补丁的编号信息)

Temporary

临时补丁数目

Common

正式补丁数目

Current

当前补丁总数目

Running

处于运行状态的补丁数目

Active

处于激活状态的补丁数目

Start-Address

内存补丁区在内存中的起始地址

 

1.1.6  patch active

【命令】

集中式设备:

patch active patch-number

分布式设备:

patch active patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号,该参数的取值范围为1~200。

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

【描述】

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

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

需要注意的是:

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

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

【举例】

# 激活3号及3号之前的补丁。(集中式设备)

<Sysname> system-view

[Sysname] patch active 3

# 激活备用板(所在槽位号为1)上3号及3号之前的补丁。(分布式设备)

<Sysname> system-view

[Sysname] patch active 3 slot 1

1.1.7  patch deactive

【命令】

集中式设备:

patch deactive patch-number

分布式设备:

patch deactive patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,取值范围为1~200。

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

【描述】

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

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

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

【举例】

# 停止运行3号及3号之后的补丁。(集中式设备)

<Sysname> system-view

[Sysname] patch deactive 3

# 停止运行备用板(所在槽位号为1)上3号及3号之后的补丁。(分布式设备)

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

1.1.8  patch delete

【命令】

集中式设备:

patch delete patch-number

分布式设备:

patch delete patch-number slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,取值范围为1~200。

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

【描述】

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

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

【举例】

# 删除3号及3号之后的补丁。(集中式设备)

<Sysname> system-view

[Sysname] patch delete 3

# 删除备用板(所在槽位号为1)上3号及3号之后的补丁。(分布式设备)

<Sysname> system-view

[Sysname] patch delete 3 slot 1

1.1.9  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 locationpatch loadpatch activepatch run命令。

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

需要注意的是:

l              执行该命令前,请将补丁文件保存到设备存储介质的根目录下。(集中式设备)

l              执行该命令前,请将主用板和接口板的补丁文件保存到主用板存储介质的根目录下,备用板的补丁文件保存到备用板存储介质的根目录下。(分布式设备)

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

【举例】

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

<Sysname> system-view

[Sysname] patch install cfa0:/

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

【命令】

集中式设备:

patch load

分布式设备:

patch load slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

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

【描述】

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

系统默认从CF卡加载补丁文件。

l              执行该命令前,请将补丁文件保存到设备存储介质的根目录下。(集中式设备)

l              执行该命令前,请将主用板和接口板的补丁文件保存到主用板存储介质的根目录下,备用板的补丁文件保存到备用板存储介质的根目录下。(分布式设备)

【举例】

# 加载补丁。(集中式设备)

<Sysname> system-view

[Sysname] patch load

# 为备用板(所在槽位号为1)加载补丁。(分布式设备)

<Sysname> system-view

[Sysname] patch load slot 1

1.1.11  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-location:表示补丁文件所在的路径,为1~64个字符的字符串,格式通常为存储介质的根目录+补丁文件名称的形式。

【描述】

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

缺省情况下,补丁文件的加载路径为cfa0:/。

当设备支持多个存储介质时,用户可以将补丁文件保存到CF卡以外的其它存储介质。此时,需要使用该命令告知系统补丁文件的位置,执行补丁加载操作时,系统会将该路径下指定后缀的补丁加载到对应的单板。如果设备只有一个存储介质,而且补丁文件只能放在固定路径,则不需要配置该命令。

需要注意的是,执行patch install命令会修改补丁文件的加载路径。比如,先配置了patch location xxx,再执行patch install yyy,此时系统会自动将补丁文件的加载路径从xxx改为yyy。

【举例】

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

<Sysname> system-view

[Sysname] patch location cfa0:/

1.1.12  patch run

【命令】

集中式设备:

patch run patch-number

分布式设备:

patch run patch-number [ slot slot-number ]

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。该参数的有效值与使用的补丁文件有关,取值范围为1~200。

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

【描述】

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

如果指定slot参数,则确认运行该单板上的所有补丁(包括辅助CPU的补丁);如果不指定slot参数,表示确认运行所有单板上的所有补丁。(分布式设备)

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

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

【举例】

# 确认运行3号及3号之前的补丁。(集中式设备)

<Sysname> system-view

[Sysname] patch run

# 确认运行备用板(所在槽位号为1)上3号及3号之前的补丁。(分布式设备)

<Sysname> system-view

[Sysname] patch run 3 slot 1

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!