• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 新华三人才研学中心
  • 关于我们

01 基础配置命令参考

目录

06-软件升级命令

本章节下载 06-软件升级命令  (151.88 KB)

06-软件升级命令


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命令才能执行成功。

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

【举例】

# 指定下次启动时所用的主用启动文件为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:指定设备的成员编号。

·     slot-number:用来同步升级指定成员设备。

·     all:用来同步升级所有成员设备。

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

Slot 1

  Current boot app is: flash:/test.bin

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

  Next backup boot app is: flash:/

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

字段

描述

Current boot app is

设备本次启动时使用的启动文件

Next main boot app is

设备下次启动时使用的主用启动文件

Next backup boot app is

设备下次启动时使用的备用启动文件

 

1.1.4  display patch

【命令】

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

【视图】

任意视图

【缺省级别】

3:管理级

【参数】

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

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

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

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

regular-expression:表示正则表达式,为1~256个字符的字符串,区分大小写。

【描述】

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

【举例】

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

<Sysname> display patch

flash:/ patch-package.bin, B90H01a, loaded on slot(s):1

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

字段

描述

flash:/patch-package.bin

安装的补丁文件的路径

Package-Version-001

补丁包的版本

loaded on slot(s):

加载补丁的设备成员编号,如果设备上只有一个CPU,则直接显示slot-number

 

1.1.5  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

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

0     RPE004     0          1        1         0       1         0x310bd74

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

字段

描述

The location of patches

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

Slot

设备的槽号,如果设备上只有一个CPU,则直接显示slot-number

Version

补丁版本号

Temporary

临时补丁数目

Common

正式补丁数目

Current

当前补丁总数目

Running

处于运行状态的补丁数目

Active

处于激活状态的补丁数目

Start-Address

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

 

1.1.6  patch active

【命令】

patch active [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。

slot slot-number:表示设备的槽位号。

【描述】

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

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

需要注意的是:

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

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

【举例】

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

<Sysname> system-view

[Sysname] patch active 3 slot 1

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

<Sysname> system-view

[Sysname] patch active slot 1

1.1.7  patch deactive

【命令】

patch deactive [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。

slot slot-number:表示设备所在的槽位号。

【描述】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

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

<Sysname> system-view

[Sysname] patch deactive slot 1

1.1.8  patch delete

【命令】

patch delete [ patch-number ] slot slot-number

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。

slot slot-number:表示设备的槽位号。

【描述】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] patch delete 3 slot 1

# 删除设备上所有补丁。

<Sysname> system-view

[Sysname] patch delete slot 1

1.1.9  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,设备重启后这些补丁不再继续生效。

执行该命令前,需要将补丁文件保存到指定路径:如果要从补丁包中安装补丁,则可以将补丁包保存在任意路径下,否则请将补丁文件保存到设备存储介质的根目录下。

说明

如果设备以前安装过补丁,必须先将历史补丁卸载,才能安装新补丁。用户可以使用display patch information显示设备的补丁信息。

 

【举例】

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

【命令】

patch load slot slot-number [ file filename ]

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

slot slot-number:表示设备的槽位号。

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.11  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

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

【描述】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] patch location flash:

1.1.12  patch run

【命令】

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

【视图】

系统视图

【缺省级别】

3:管理级

【参数】

patch-number:补丁序号。

slot slot-number:表示设备的槽位号。

【描述】

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

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

如果指定slot参数,则确认运行该设备上的所有补丁。

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

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

【举例】

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

<Sysname> system-view

[Sysname] patch run 3 slot 1

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

<Sysname> system-view

[Sysname] patch run slot 1

 

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

新华三官网
联系我们