07-软件升级命令
本章节下载: 07-软件升级命令 (288.32 KB)
如果将可插拔存储介质内的软件包指定为设备下次启动时使用的软件包,重启设备时不要将可插拔存储介质从设备上拔出,否则可能导致设备无法正常启动。建议将设备出厂时的缺省介质作为设备下次启动时使用软件包的存储位置。
boot-loader file命令用来配置设备下次启动时使用的软件包。
【命令】
(独立运行模式)
boot-loader file boot filename system filename [ feature filename&<1-30> ] { backup | main }
boot-loader file ipe-filename { backup | main [ undecompressed ] }
(IRF模式)
boot-loader file boot filename system filename [ feature filename&<1-30> ] { all | slot slot-number } { backup | main }
boot-loader file ipe-filename { all | slot slot-number } { backup | main [ undecompressed ] }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot:Boot包。
system:System包。
feature:Feature包。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
ipe-filename:IPE(Image Package Envelope,复合软件包套件)文件的名称,形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:指定系统中软件包适用的所有的硬件。
slot slot-number:表示待升级的成员设备的编号。(IRF模式)
backup:指定该软件包为备用启动软件包。备用启动软件包用于主用启动软件包不可用或异常情况时,引导设备启动。
main:指定该软件包为主用启动软件包。主用启动软件包用于引导设备启动。
undecompressed:表示不解压IPE包,直接将其设置为下次启动软件包。不指定该参数时,设备将立即解压IPE包并将解压出的BIN包设置为下次启动软件包。当设备存储介质上空间足够的时候,建议不要指定该参数。
本参数的支持情况与设备型号有关,请以设备的实际情况为准。
型号 |
说明 |
MSR810、MSR810-W、MSR810-W-DB、MSR810-LM、MSR810-W-LM、MSR810-10-PoE、MSR810-LM-HK、MSR810-W-LM-HK、MSR810-LM-CNDE-SJK、MSR810-CNDE-SJK |
支持 |
MSR810-LMS、MSR810-LUS |
支持 |
MSR810-LMS-EA、MSR810-LME |
支持 |
MSR2600-6-X1、MSR2600-10-X1 |
支持 |
MSR 2630 |
支持 |
MSR3600-28、MSR3600-51 |
支持 |
MSR3600-28-SI、MSR3600-51-SI |
不支持 |
MSR3600-28-X1、MSR3600-28-X1-DP、MSR3600-51-X1、MSR3600-51-X1-DP |
支持 |
MSR3610-I-DP、MSR3610-IE-DP、MSR3610-IE-ES、MSR3610-IE-EAD、MSR3610-I-IG、MSR3610-IE-IG |
不支持 |
MSR3610-X1、MSR3610-X1-DP、MSR3610-X1-DC、MSR3610-X1-DP-DC |
不支持 |
MSR 3610、MSR 3620、MSR 3620-DP、MSR 3640、MSR 3660 |
支持 |
MSR3610-G、MSR3620-G |
不支持 |
型号 |
说明 |
MSR810-W-WiNet、MSR810-LM-WiNet |
支持 |
MSR830-4LM-WiNet |
支持 |
MSR830-5BEI-WiNet、MSR830-6EI-WiNet、MSR830-10BEI-WiNet |
支持 |
MSR830-6BHI-WiNet、MSR830-10BHI-WiNet |
支持 |
MSR2600-6-WiNet、MSR2600-10-X1-WiNet |
支持 |
MSR2630-WiNet |
支持 |
MSR3600-28-WiNet |
支持 |
MSR3610-X1-WiNet |
不支持 |
MSR3610-WiNet、MSR3620-10-WiNet、MSR3620-DP-WiNet、MSR3620-WiNet、MSR3660-WiNet |
支持 |
型号 |
说明 |
MSR2630-XS |
支持 |
MSR3600-28-XS |
支持 |
MSR3610-XS |
不支持 |
MSR3620-XS |
支持 |
MSR3610-I-XS |
不支持 |
MSR3610-IE-XS |
不支持 |
型号 |
说明 |
MSR810-LM-GL |
支持 |
MSR810-W-LM-GL |
支持 |
MSR830-6EI-GL |
支持 |
MSR830-10EI-GL |
支持 |
MSR830-6HI-GL |
支持 |
MSR830-10HI-GL |
支持 |
MSR2600-6-X1-GL |
支持 |
MSR3600-28-SI-GL |
不支持 |
【使用指导】
成功执行该命令后,系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包,则更新后的软件包列表中不会有Feature包。
请先查看软件包版本发布说明书,如果软件包需要License才能运行,且设备当前没有对应的有效的License时,需安装对应的License,再执行该命令。否则:
· 当使用软件包配置该命令时,只要指定某个的软件包当前没有有效的License,就会导致整条命令配置失败。
· 当使用IPE文件配置该命令时,只有当前没有有效的License的软件包配置失败,其它软件包会配置成功。
需要重启系统来完成指定下次启动软件包的加载。
系统会自动检查指定slot上对应路径下是否存在同名文件,如果不存在,则直接从指定路径拷贝一份并设置为下次启动软件包;如果存在,则提示用户是否从指定路径拷贝一份并设置为下次启动软件包。
本命令不支持安装叠加补丁。
对于存储空间不足的设备指定下次主用启动软件包时,可以指定undecompressed参数,此时设备便不解压IPE包,直接将IPE包设置为主用下次启动软件包,并将当前的主用下次启动软件包设置为备用下次启动软件包。设备将在重启时解压IPE包,将解压出的BIN包设置为主用下次启动软件包来加载设备、完成启动,同时将IPE包删除。若解压IPE包、加载设备失败,则会使用备用下次启动软件包启动设备。
【举例】
# 配置设备下次启动时所用的主用启动文件为flash:/all.ipe。(独立运行模式)
<Sysname> boot-loader file flash:/all.ipe main
Verifying the file flash:/all.ipe on the device.............Done.
H3C MSR36-10 images in IPE:
boot.bin
system.bin
This command will set the main startup software images. Continue? [Y/N]:Y
Add images to the device.
File flash:/boot.bin already exists on the device.
File flash:/system.bin already exists on the device.
Overwrite or rename the new file? [Yes/No/Rename]: R
Please input the file name (*.bin)[boot_1.bin]
(To use the recommended file name, press the Enter key):
Decompressing file boot.bin to flash:/boot_1.bin........................Done.
Please input the file name (*.bin)[system_1.bin]
(To use the recommended file name, press the Enter key):system_backup.bin
Decompressing file system.bin to flash:/system_backup.bin...........................Done.
Verifying the file flash:/boot_1.bin on the device...Done.
Verifying the file flash:/system_backup.bin on the device.............Done.
The images that have passed all examinations will be used as the main startup software images at the next reboot on the device..
# 配置设备下次启动时所用的主用启动文件为flash:/boot.bin和flash:/system.bin。(独立运行模式)
<Sysname> boot-loader file boot flash:/boot.bin system flash:/system.bin main
This command will set the main startup software images. Continue? [Y/N]:Y
The images that have passed all examinations will be used as the main startup software images at the next reboot on the device.
# 配置指定slot下次启动时所用的主用启动文件为flash:/all.ipe。(IRF模式)
<Sysname> boot-loader file flash:/all.ipe slot 1 main
Verifying the file flash:/all.ipe on slot 1..............Done.
H3C MSR36-10 images in IPE:
boot.bin
system.bin
This command will set the main startup software images. Continue? [Y/N]:Y
Add images to slot 1.
File flash:/boot.bin already exists on slot 1.
File flash:/system.bin already exists on slot 1.
Overwrite or rename the new file? [Yes/No/Rename]: Y
Decompressing file boot.bin to flash:/boot.bin........................Done.
Decompressing file system.bin to flash:/system.bin...............................Done.
Verifying the file flash:/boot.bin on slot 1...Done.
Verifying the file flash:/system.bin on slot 1.............Done.
The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.
# 配置IRF的主用下次启动软件为flash:/all.ipe。(IRF模式)
<Sysname> boot-loader file slot1#flash:/all.ipe all main
Verifying the file flash:/all.ipe on slot 1......................................Done.
H3C MSR36-10 images in IPE:
Boot.bin
System.bin
This command will set the main startup software images. Continue? [Y/N]:Y
Add images to slot 1.
File flash:/Boot.bin already exists on slot 1.
File flash:/System.bin already exists on slot 1.
Overwrite or rename the new file? [Yes/No/Rename]:Y
Decompressing file Boot.bin to flash:/Boot.bin........................Done.
Decompressing file System.bin to flash:/System.bin........................Done.
The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 1.
File flash:/Boot.bin already exists on slot 2.
Do you want to overwrite the file?
Y: Overwrite the file.
N: Not overwrite the file.
A: From now on, overwrite or not overwrite without prompt.
Please make a choice. [Y/N/A]:A
What type of overwrite operation do you want to perform?
Y: Overwrite without prompt.
N: Not overwrite or display prompt.
Q: Return to the previous step.
Please make a choice. [Y/N/Q]:Y
An existing file will be overwritten without prompt if it has the same name as any upgrade file.
Loading......................Done.
Loading......................Done.
Loading......................Done.
Loading......................Done.
Loading......................Done.
Loading......................Done.
The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 2.
The images that have passed all examinations will be used as the main startup software images at the next reboot on slot 3.
Decompression completed.
Do you want to delete flash:/all.ipe now? [Y/N]:N
【相关命令】
· display boot-loader
display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。
【命令】
(独立运行模式)
display boot-loader
(IRF模式)
display boot-loader [ slot slot-number ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:表示成员设备的编号。不指定该参数时,表示IRF中的所有成员设备。
【举例】
# 显示本次启动和下次启动所采用的启动软件包的名称。(独立运行模式)
<Sysname> display boot-loader
Software images on the device:
Current software images:
flash:/boot.bin
flash:/system.bin
Main startup software images:
flash:/boot.bin
flash:/system.bin
Backup startup software images:
flash:/boot.bin
flash:/system.bin
# 显示本次启动和下次启动所采用的启动软件包的名称。(IRF模式)
<Sysname> display boot-loader
Software images on slot 1:
Current software images:
flash:/boot.bin
flash:/system.bin
Main startup software images:
flash:/boot.bin
flash:/system.bin
Backup startup software images:
flash:/boot.bin
flash:/system.bin
表1-1 display boot-loader命令显示信息描述表
字段 |
描述 |
Software images |
启动软件包的相关信息 |
Current software images |
最近一次启动使用的启动软件包列表 |
Main startup software images |
主用下次启动软件包列表 |
Backup startup software images |
备用下次启动软件包列表 显示为None时,表示未指定备用下次启动软件包 |
【相关命令】
· boot-loader file
display install active命令用来显示当前系统中处于激活状态的软件包的相关信息。
【命令】
(独立运行模式)
display install active [ verbose ]
(IRF模式)
display install active [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
verbose:显示处于激活状态的软件包的详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【举例】
# 显示设备上处于激活状态的软件包的简要信息。(独立运行模式)
<Sysname> display install active
Active packages on the device:
flash:/boot.bin
flash:/system.bin
flash:/feature1.bin
# 显示设备上处于激活状态的软件包的简要信息。(IRF模式)
<Sysname> display install active
Active packages on slot 1:
flash:/boot.bin
flash:/system.bin
flash:/feature1.bin
# 显示设备上处于激活状态的软件包的详细信息。(独立运行模式)
<Sysname> display install active verbose
Active packages on the device:
flash:/boot.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
Description: system package
flash:/feature1.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: test
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: test
Description: test package
表1-2 display install active命令显示信息描述表
字段 |
描述 |
Active packages on the device |
处于激活状态的软件包的相关信息 |
flash:/boot.bin |
软件包的名称 |
[Package] |
软件包的信息 |
Vendor |
生产厂商 |
Product |
产品名称 |
Service name |
软件包所包含的服务名称: · 如果显示为boot,表示该软件包为Boot包 · 如果显示为system,表示该软件包为System包 · 如果显示为boot patch,表示该软件包为Boot包的补丁包;如果显示为system patch,表示该软件包为System包的补丁包 · 如果显示为其它值,则表示该软件包为提供某项功能的Feature包 |
Platform version |
平台软件版本号 |
Product version |
产品软件版本号 |
Supported board |
软件包支持的硬件类型 |
[Component] |
组件信息,表示软件包的组成部分 |
Component |
组件的名称 |
Description |
组件的描述信息 |
【相关命令】
· install active
display install backup命令用来显示设备下次启动时使用的备用软件包的相关信息。
【命令】
(独立运行模式)
display install backup [ verbose ]
(IRF模式)
display install backup [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
verbose:显示详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【使用指导】
当主用启动软件包列表中的Boot包或System包不存在或者损坏时,使用备用启动软件包列表中的软件包。
执行boot-loader file命令可以修改设备下次启动时使用的备用软件包列表。
【举例】
# 显示设备下次启动时使用的备用软件包的相关信息。(独立运行模式)
<Sysname> display install backup
Backup startup software images on the device:
flash:/boot.bin
flash:/system.bin
# 显示设备下次启动时使用的备用软件包的相关信息。(IRF模式)
<Sysname> display install backup
Backup startup software images on slot 1:
flash:/boot.bin
flash:/system.bin
# 显示设备下次启动时使用的备用软件包的详细信息。(独立运行模式)
<Sysname> display install backup verbose
Backup startup software images on the device:
flash:/boot.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
Description: system package
# 显示设备下次启动时使用的备用软件包的详细信息。(IRF模式)
<Sysname> display install backup verbose
Backup startup software images on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
Description: system package
【相关命令】
· boot-loader file
· display install committed
display install committed命令用来显示设备下次启动时使用的主用软件包的相关信息。
【命令】
(独立运行模式)
display install committed [ verbose ]
(IRF模式)
display install committed [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
verbose:显示详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【使用指导】
某些install命令可以修改设备的软件包列表,但需要执行install commit命令来确认运行当前的软件包,这些软件包才会被列入主用下次启动软件包,使得设备重启后,这些软件包能够继续生效。可以使用本命令查看已被确认为下次启动的软件包。
执行install commit和boot-loader file命令都可以修改设备下次启动时使用的主用软件包列表。
【举例】
# 显示设备下次启动时使用的主用软件包的相关信息。(独立运行模式)
<Sysname> display install committed
Committed packages on the device:
flash:/boot.bin
flash:/system.bin
flash:/feature1.bin
# 显示设备下次启动时使用的主用软件包的相关信息。(IRF模式)
<Sysname> display install committed
Committed packages on slot 1:
flash:/boot.bin
flash:/system.bin
flash:/feature1.bin
# 显示设备下次启动时使用的主用软件包的详细信息。(独立运行模式)
<Sysname> display install committed verbose
Committed packages on the device:
flash:/boot.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
Description: system package
flash:/feature1.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: feature1
Description: feature1 package
# 显示设备下次启动时使用的主用软件包的详细信息。(IRF模式)
<Sysname> display install committed verbose
Committed packages on slot 1:
flash:/boot.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: boot
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: boot
Description: boot package
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
Description: system package
flash:/feature1.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: feature1
Description: feature1 package
【相关命令】
· boot-loader file
· display install backup
· install commit
display install inactive命令用来显示文件系统根目录下没有被激活的所有软件包的相关信息。
【命令】
(独立运行模式)
display install inactive [ verbose ]
(IRF模式)
display install inactive [ slot slot-number ] [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
verbose:显示详细信息,包括软件包的名称、基本信息和所包含的组件。不指定该参数时,仅显示软件包的名称。
【举例】
# 显示文件系统根目录下、没有被激活的所有软件包的简要信息。(独立运行模式)
<Sysname> display install inactive
Inactive packages on the device:
flash:/feature1.bin
# 显示文件系统根目录下没有被激活的所有软件包的简要信息。(IRF模式)
<Sysname> display install inactive
Inactive packages on slot 1:
flash:/feature1.bin
# 显示文件系统根目录下没有被激活的所有软件包的详细信息。(独立运行模式)
<Sysname> display install inactive verbose
Inactive packages on the device:
flash:/feature1.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: feature1
Description: feature1 package
# 显示文件系统根目录下没有被激活的所有软件包的详细信息。(IRF模式)
<Sysname> display install inactive verbose
Inactive packages on slot 1:
flash:/feature1.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: feature1
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: feature1
Description: feature1 package
【相关命令】
· install deactivate
display install ipe-info命令用来显示IPE文件包含的软件包列表。
【命令】
display install ipe-info ipe-filename
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
ipe-filename:表示IPE文件的名称,形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
【使用指导】
IPE文件是一个或多个软件包的集合。用户获得IPE文件后,可以选择其中的软件包进行升级。
【举例】
# 显示flash:/test.ipe的IPE信息。(独立运行模式)
<Sysname> display install ipe-info flash:/test.ipe
Verifying the file flash:/test.ipe on the device................Done.
H3C MSR36-10 images in IPE:
boot.bin
system.bin
# 显示flash:/test.ipe的IPE信息。(IRF模式)
<Sysname> display install ipe-info flash:/test.ipe
Verifying the file flash:/test.ipe on slot 1................Done.
H3C MSR36-10 images in IPE:
boot.bin
system.bin
【相关命令】
· display install package
display install job命令用来显示系统中正在执行的激活、卸载操作。
【命令】
display install job
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【举例】
# 显示系统中正在执行的激活、卸载操作。(独立运行模式)
<Sysname> display install job
JobID:5
Action:install activate flash:/feature1.bin on the device
以上显示信息表明:设备正在执行install activate flash:/feature1.bin操作。
# 显示系统中正在执行的激活、卸载操作。(IRF模式)
<Sysname> display install job
JobID:5
Action:install activate flash:/feature1.bin on slot 1
以上显示信息表明:设备正在执行install activate flash:/feature1.bin slot 1操作。
display install package命令用来显示软件包的相关信息。
【命令】
display install package { filename | all } [ verbose ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
filename:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:表示设备上各文件系统根目录下的所有软件包。(独立运行模式)
all:表示主设备上各文件系统根目录下的所有软件包。(IRF模式)
verbose:显示软件包的基本信息和软件包所包含的组件。不指定该参数时,仅显示软件包的基本信息。
【举例】
# 显示软件包system.bin的相关信息。
<Sysname> display install package flash:/system.bin
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
# 显示软件包system.bin的详细信息。
<Sysname> display install package flash:/system.bin verbose
flash:/system.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
[Component]
Component: system
display install which命令用来显示一个组件或文件的所属软件包,以及该软件包的相关信息。
【命令】
(独立运行模式)
display install which { component name | file filename }
(IRF模式)
display install which { component name | file filename } [ slot slot-number ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
component name:软件包所包含的组件的名称。
file filename:软件包所包含的文件的名称,为1~63个字符的字符串,不区分大小写。必须为纯文件名的形式。
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
【使用指导】
组件是特性的集合,组件中的特性是同时安装/卸载的。
当软件包运行错误,系统提示xx组件或者xx文件运行错误的时候,可以根据组件名/文件名使用该命令查找它属于哪个软件包,从而帮助进一步定位是否是软件包本身有缺陷。通过检验该软件包,定位是否为软件包的问题。使用install verify命令可以对软件包进行检验。
执行该命令后,系统会扫描指定位置的所有文件系统根目录下的所有软件包,将包含该组件/文件的软件包都依次显示。
【举例】
# 显示文件pkg_ctr属于哪个软件包以及该软件包的相关信息。(IRF模式)
<Sysname> display install which file pkg_ctr
Verifying the file flash:/system-t0001015.bin on slot 1..........................Done.
Found pkg_ctr in flash:/system-t0001015.bin on slot 1.
flash:/system-t0001015.bin
[Package]
Vendor: H3C
Product: MSR36
Service name: system
Platform version: 7.1.070
Product version: Test 0001015
Supported board: MSR36-10
Verifying the file flash:/boot-d2601007.bin on slot 1.....Done.
表1-3 display install which命令显示信息描述表
字段 |
描述 |
Verifying the file |
验证文件是否合法 |
Found pkg_ctr |
找到文件 |
[Package] |
软件包的信息 |
Vendor |
生产厂商 |
Product |
产品名称 |
Service name |
软件包所包含的服务名称: · 如果显示为boot,表示该软件包为Boot包 · 如果显示为system,表示该软件包为System包 · 如果显示为patch,表示该软件包为补丁包 · 如果显示为其它值,则表示该软件包为提供某项功能的Feature包 |
Platform version |
平台软件版本号 |
Product version |
产品软件版本号 |
Supported board |
软件包支持的硬件类型 |
File xxx was not found in the image packages under the root directory of the storage medium |
在存储介质根目录下的所有包中都没有找到指定文件 |
firmware update命令用来升级CPLD、FPGA等固件。
【命令】
(独立运行模式)
firmware update [ subslot subslot-number ]{ cpld cpld-number | fpga fpga-number | module module-number } file filename
(IRF模式)
firmware update slot slot-number [ subslot subslot-number ] { cpld cpld-number | fpga fpga-number | module module-number } file filename
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
slot slot-number:指定IRF成员设备,slot-number表示设备在IRF中的成员编号。(IRF模式)
subslot subslot-number:子卡所在的子槽位号。不指定该参数时,表示单板上的所有子卡。
cpld cpld-number:表示需要升级CPLD(Complex Programmable Logical Device 复杂可编程逻辑器件),cpld-number表示固件的编号。
本参数的支持情况与设备型号有关,请以设备的实际情况为准。
型号 |
说明 |
MSR810、MSR810-W、MSR810-W-DB、MSR810-LM、MSR810-W-LM、MSR810-10-PoE、MSR810-LM-HK、MSR810-W-LM-HK、MSR810-LM-CNDE-SJK、MSR810-CNDE-SJK |
不支持 |
MSR810-LMS、MSR810-LUS |
不支持 |
MSR810-LMS-EA、MSR810-LME |
不支持 |
MSR2600-6-X1、MSR2600-10-X1 |
支持 |
MSR 2630 |
支持 |
MSR3600-28、MSR3600-51 |
支持 |
MSR3600-28-SI、MSR3600-51-SI |
支持 |
MSR3600-28-X1、MSR3600-28-X1-DP、MSR3600-51-X1、MSR3600-51-X1-DP |
支持 |
MSR3610-I-DP、MSR3610-IE-DP、MSR3610-IE-ES、MSR3610-IE-EAD、MSR3610-I-IG、MSR3610-IE-IG |
支持 |
MSR3610-X1、MSR3610-X1-DP、MSR3610-X1-DC、MSR3610-X1-DP-DC |
支持 |
MSR 3610、MSR 3620、MSR 3620-DP、MSR 3640、MSR 3660 |
支持 |
MSR3610-G、MSR3620-G |
支持 |
型号 |
说明 |
MSR810-W-WiNet、MSR810-LM-WiNet |
不支持 |
MSR830-4LM-WiNet |
不支持 |
MSR830-5BEI-WiNet、MSR830-6EI-WiNet、MSR830-10BEI-WiNet |
不支持 |
MSR830-6BHI-WiNet、MSR830-10BHI-WiNet |
不支持 |
MSR2600-6-WiNet、MSR2600-10-X1-WiNet |
支持 |
MSR2630-WiNet |
支持 |
MSR3600-28-WiNet |
支持 |
MSR3610-X1-WiNet |
支持 |
MSR3610-WiNet、MSR3620-10-WiNet、MSR3620-DP-WiNet、MSR3620-WiNet、MSR3660-WiNet |
支持 |
型号 |
说明 |
MSR2630-XS |
支持 |
MSR3600-28-XS |
支持 |
MSR3610-XS |
支持 |
MSR3620-XS |
支持 |
MSR3610-I-XS |
支持 |
MSR3610-IE-XS |
支持 |
型号 |
说明 |
MSR810-LM-GL |
不支持 |
MSR810-W-LM-GL |
不支持 |
MSR830-6EI-GL |
不支持 |
MSR830-10EI-GL |
不支持 |
MSR830-6HI-GL |
不支持 |
MSR830-10HI-GL |
不支持 |
MSR2600-6-X1-GL |
支持 |
MSR3600-28-SI-GL |
支持 |
fpga fpga-number:表示需要升级FPGA(Field Programmable Gate Array 现场可编程门阵列),fpga-number表示固件的编号。
本参数的支持情况与设备型号有关,请以设备的实际情况为准。
型号 |
说明 |
MSR810、MSR810-W、MSR810-W-DB、MSR810-LM、MSR810-W-LM、MSR810-10-PoE、MSR810-LM-HK、MSR810-W-LM-HK、MSR810-LM-CNDE-SJK、MSR810-CNDE-SJK |
不支持 |
MSR810-LMS、MSR810-LUS |
不支持 |
MSR810-LMS-EA、MSR810-LME |
不支持 |
MSR2600-6-X1、MSR2600-10-X1 |
支持 |
MSR 2630 |
支持 |
MSR3600-28、MSR3600-51 |
支持 |
MSR3600-28-SI、MSR3600-51-SI |
支持 |
MSR3600-28-X1、MSR3600-28-X1-DP、MSR3600-51-X1、MSR3600-51-X1-DP |
支持 |
MSR3610-I-DP、MSR3610-IE-DP、MSR3610-IE-ES、MSR3610-IE-EAD、MSR3610-I-IG、MSR3610-IE-IG |
支持 |
MSR3610-X1、MSR3610-X1-DP、MSR3610-X1-DC、MSR3610-X1-DP-DC |
支持 |
MSR 3610、MSR 3620、MSR 3620-DP、MSR 3640、MSR 3660 |
支持 |
MSR3610-G、MSR3620-G |
支持 |
型号 |
说明 |
MSR810-W-WiNet、MSR810-LM-WiNet |
不支持 |
MSR830-4LM-WiNet |
不支持 |
MSR830-5BEI-WiNet、MSR830-6EI-WiNet、MSR830-10BEI-WiNet |
不支持 |
MSR830-6BHI-WiNet、MSR830-10BHI-WiNet |
不支持 |
MSR2600-6-WiNet、MSR2600-10-X1-WiNet |
支持 |
MSR2630-WiNet |
支持 |
MSR3600-28-WiNet |
支持 |
MSR3610-X1-WiNet |
支持 |
MSR3610-WiNet、MSR3620-10-WiNet、MSR3620-DP-WiNet、MSR3620-WiNet、MSR3660-WiNet |
支持 |
型号 |
说明 |
MSR2630-XS |
支持 |
MSR3600-28-XS |
支持 |
MSR3610-XS |
支持 |
MSR3620-XS |
支持 |
MSR3610-I-XS |
支持 |
MSR3610-IE-XS |
支持 |
型号 |
说明 |
MSR810-LM-GL |
不支持 |
MSR810-W-LM-GL |
不支持 |
MSR830-6EI-GL |
不支持 |
MSR830-10EI-GL |
不支持 |
MSR830-6HI-GL |
不支持 |
MSR830-10HI-GL |
不支持 |
MSR2600-6-X1-GL |
支持 |
MSR3600-28-SI-GL |
支持 |
module module-number:表示需要升级指定模块,module-number表示模块的编号。
file filename:升级文件的名称,形如filesystemname/filename.bin。不同固件升级文件的后缀可能不同,该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
【使用指导】
固件升级后需要对其所在的板卡/设备进行下电后重新上电才能生效。请根据实际支持情况,选择下电方式:
· 切断外部电源
· 插拔板卡
【举例】
# 升级1号CPLD。(独立运行模式)
<Sysname> firmware update cpld 1 file package.bin
Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y
Updating the firmware…
Please power cycle the card or subcard to activate the firmware.
# 升级指定slot的1号CPLD。(IRF模式)
<Sysname> firmware update slot 1 cpld 1 file package.bin
Updating firmware for CPLD on the specified card or subcard. Continue?[Y/N]:y
Updating the firmware…
Please power cycle the card or subcard to activate the firmware.
install activate命令用来激活软件包。
【命令】
(独立运行模式)
install activate { boot filename | system filename | feature filename&<1-30> } *
install activate patch filename
(IRF模式)
install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number
install activate patch filename { all | slot slot-number }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
boot:Boot包。
system:System包。
feature:Feature包。
patch:补丁包。该参数一次只能指定一个补丁包,但是可以通过多次执行此命令为设备激活多个补丁包。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:升级补丁包对应的所有成员设备。(IRF模式)
slot slot-number:表示设备在IRF中的成员编号。(IRF模式)
【使用指导】
请先查看软件包版本发布说明书,如果某软件包需要License才能运行,且设备当前没有对应的有效的License时,需安装对应的License,再执行该命令。否则,会导致命令执行失败。
(1) (独立运行模式)
使用本命令激活设备上的软件包后,被激活的软件包只在本次运行的系统中生效。要使被激活的软件包在设备重启后继续生效,还需要执行install commit命令。
(2) (IRF模式)
使用本命令激活指定硬件上的软件包后,被激活的软件包只在本次运行的系统中生效。要使被激活的软件包在设备重启后继续生效,还需要执行install commit命令。激活补丁包时,若使用install activate patch filename all命令同时激活所有硬件上的补丁包,则无需执行install commit命令,所有补丁包在设备重启后继续生效。
执行该命令时,如果filename不是存放在待升级成员设备上的文件,则系统会先将该文件拷贝到待升级成员设备上,再执行升级动作。
从设备重启后,会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态,才能执行该命令。否则,命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。
【举例】
# 激活System包system.bin和Feature包feature1.bin。(独立运行模式)
<Sysname> install activate system flash:/system.bin feature flash:/feature1.bin
Verifying the file flash:/feature1.bin on the device.....Done.
Verifying the file flash:/system.bin on the device.....Done.
Upgrade summary according to following table:
flash:/system.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1.bin
Running Version New Version
NONE Test 0001016
Upgrade Way: Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
# 激活从设备2上的System包system.bin和Feature包feature1.bin。(IRF模式)
<Sysname> install activate system flash:/system.bin feature flash:/feature1.bin slot 2
Copying file flash:/system.bin to slot2#flash:/system.bin......Done.
Verifying the file flash:/system.bin on slot 2.....Done.
Copying file flash:/feature1.bin to slot2#flash:/feature1.bin......Done.
Verifying the file flash:/feature1.bin on slot 2.....Done.
Upgrade summary according to following table:
flash:/system.bin
Running Version New Version
Test 0001015 Test 0001016
flash:/feature1.bin
Running Version New Version
None Test 0001016
Slot Upgrade Way
2 Service Upgrade
Upgrading software images to compatible versions. Continue? [Y/N]:y
This operation might take several minutes, please wait...Done.
表1-4 install activate命令显示信息描述表
字段 |
描述 |
Copying file A to B......Done. |
将文件从位置A拷贝到位置B。 |
Verifying the file flash:/xx.bin.....Done. |
验证文件是否合法 |
Upgrade summary according to following table |
升级摘要信息 |
Running Version |
设备当前运行的相同类型软件包的产品版本号 |
New Version |
目标软件包的产品版本号 |
Upgrade Way |
(暂不支持)兼容升级策略,取值可能为: · Service Upgrade:表示服务级增量升级 · File Upgrade:表示文件级增量升级 · Reboot:表示通过重启方式升级 |
Influenced service according to following table |
将受影响的功能模块 |
Upgrading software images to compatible versions. Continue? [Y/N] |
询问用户是否执行兼容升级操作 |
This operation might take several minutes, please wait |
升级操作需要花费一定时间,请等待 |
Done. |
表示激活成功 |
Operation failed. |
表示激活失败 |
Install command does not support incompatible upgrade. |
不能使用install命令来升级不兼容版本 |
【相关命令】
· display install active
· install commit
· install deactivate
install add命令用来解压缩IPE文件。
【命令】
install add ipe-filename filesystem
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
ipe-filename:IPE文件的名称,形如filesystemname/filename.ipe。该文件必须保存在设备任一文件系统的根目录下,该参数中必须包含文件系统的名称,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
filesystem:解压缩IPE文件保存的目的文件系统的名称。
【使用指导】
由于使用install命令激活的软件包只能是.bin软件包,所以在使用install命令激活软件包之前需要使用install add命令将IPE文件进行解压缩。
用户获取IPE文件后,可以使用display install ipe-info命令查看该IPE文件中包含了哪些软件包,可以通过install add命令将IPE文件解压生成软件包,再利用生成的软件包更新设备软件。
【举例】
# 解压缩all.ipe文件到存储介质flash上。
<Sysname> install add flash:/all.ipe flash:
Verifying the file flash:/all.ipe on slot 1...Done.
Decompressing file boot.bin to flash:/boot.bin.......................Done.
Decompressing file system.bin to flash:/system.bin.................................Done.
install commit命令用来确认软件包更改。
【命令】
install commit
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
请先查看软件包版本发布说明书,如果某软件包需要License才能运行,且设备当前没有对应的有效的License时,需安装对应的License,再执行该命令。否则,会导致命令执行失败。
该命令会将补丁包文件添加到系统当前使用的软件包列表:
· 如果系统使用了主用软件包启动,该命令会将补丁包文件添加到主用软件包列表中。
· 如果系统使用了备用软件包启动,该命令会将补丁包文件添加到备用软件包列表中。
boot-loader file命令和install commit命令都可以变更主用下次启动软件包列表,最新的配置生效。两条命令的不同之处在于,install commit命令自动使用当前激活的软件包列表作为主用下次启动软件包列表。而boot-loader file命令还可以指定其它当前未激活的软件包,可以配置为主用或者备用下次启动软件包列表。
【举例】
# 确认软件包更改。
<Sysname> install commit
This operation will take several minutes, please wait...........................Done.
【相关命令】
· install activate
· install deactivate
· install rollback
install deactivate命令用来卸载Feature包或补丁包。
【命令】
(独立运行模式)
install deactivate feature filename&<1-30>
install deactivate patch filename
(IRF模式)
install deactivate feature filename&<1-30> slot slot-number
install deactivate patch filename { all | slot slot-number }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
feature:Feature包。
patch:补丁包。该参数一次只能指定一个补丁包,若要卸载多个补丁包,则需要多次执行此命令。
filename&<1-30>:软件包的名称,形如filesystemname/filename.bin。该参数中必须且只能包含文件系统的名称,不能包含文件系统位置信息,从存储介质名称开始最多可输入63个字符。&<1-30>表示前面的参数最多可以输入30次。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
all:表示安装了该补丁包的所有成员设备。(IRF模式)
slot slot-number:表示设备在IRF中的成员编号。(IRF模式)
【使用指导】
从设备重启后,会自动批量备份主设备的配置和状态数据。请使用display system stable state命令查看设备是否处于稳定状态。只有System State处于Stable状态,才能执行该命令。否则,命令执行失败。关于display system stable state命令的详细介绍请参见“基础配置命令参考”中的“设备管理”。
该命令只能对已经激活的Feature包或补丁包进行卸载操作。使用本命令卸载设备上的Feature包或补丁包后,卸载的Feature包或补丁包的特性功能在本次系统运行中失效。如果要使卸载的Feature包或补丁包在设备重启后继续失效,请执行install commit命令对卸载操作进行确认。(独立运行模式)
该命令只能对已经激活的Feature包或补丁包进行卸载操作。使用本命令卸载指定slot上的Feature包或补丁包后,卸载的Feature包或补丁包的特性功能在本次系统运行中失效。如果要使卸载的Feature包或补丁包在设备重启后继续失效,请执行install commit命令对卸载操作进行确认。卸载补丁包时,若使用install deactivate patch filename all命令同时卸载所有slot上的补丁包,则无需执行install commit命令,所有补丁包在设备重启后继续失效。(IRF模式)
【举例】
# 卸载设备上的patch包route-patch.bin。(独立运行模式)
<Sysname> install deactivate patch flash:/route-patch.bin
This operation might take several minutes, please wait...Done.
# 卸载指定slot上的patch包route-patch.bin。(IRF模式)
<Sysname> install deactivate patch flash:/route-patch.bin slot 1
This operation might take several minutes, please wait...Done.
【相关命令】
· display install active
· display install inactive
install remove命令用来删除没有激活的软件包。
【命令】
(独立运行模式)
install remove { filename | inactive }
(IRF模式)
install remove [ slot slot-number ] { filename | inactive }
【视图】
用户视图
【缺省用户角色】
network-admin
【参数】
filename:软件包的名称,形如filesystemname/filename.bin。该文件必须保存在设备任一文件系统的根目录下,该参数中必须且只能包含文件系统的名称,不能包含文件系统位置信息,从存储介质名称开始最多可输入63个字符。有关指定文件夹和文件详细介绍请参见“基础配置指导”中的“文件系统管理”。
slot slot-number:表示设备在IRF中的成员编号。不指定该参数时,表示IRF中的所有成员设备。(IRF模式)
inactive:表示将删除指定文件系统根目录下、没有被激活的所有软件包。
【使用指导】
执行该命令后,指定的软件包将从设备上被彻底删除,用户将不能使用该软件包进行回滚或回退操作。
【举例】
# 删除软件包flash:/feature1.bin。
<Sysname> install remove flash:/feature1.bin
install verify命令用来执行对软件包状态、完整性和一致性的检验。
【命令】
install verify
【视图】
用户视图
【缺省用户角色】
network-admin
【使用指导】
为了保证设备进行install命令升级之后能够正常运行,需要执行本命令对软件包进行如下检验:
完整性:检验Boot包、System包和Feature包的完整性。
一致性:检验系统内各激活的软件包列表的差异,以方便用户知道系统内各软件包版本是否一致。
软件包状态:检查各设备上激活的软件包列表和确认的软件包列表之间的差异,以方便用户知道是否有未确认的软件包。
使用该命令,能帮助用户进行软件包检查:
· 当系统提示软件包不完整时,请重新下载并安装软件包。
· 当系统提示软件包不一致时,请使用install activate、install deactivate以及install commit命令来确保它们的一致。
【举例】
# 检验设备上软件包状态、完整性和一致性信息。(独立运行模式)
<Sysname> install verify
Active packages on the device are the reference packages.
Packages will be compared with the reference packages.
This operation will take several minutes, please wait...
Verifying packages on the device:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on the device...........Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on the device............Done.
flash:/system-t0001015.bin verification successful.
Start to check active package consistency.
Active packages are consistent with committed packages on their own board.
Active packages are consistent with the reference packages.
Verification is done.
# 检验设备上软件包状态、完整性和一致性信息。
<Sysname> install verify
Active packages on slot 1 are the reference packages.
Packages will be compared with the reference packages.
This operation will take several minutes, please wait...
Verifying packages on slot 0:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on slot 0.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on slot 0.....................Done.
flash:/system-t0001015.bin verification successful.
Start to check active package consistency.
Active packages are consistent with committed packages on their own board.
Active packages are consistent with the reference packages.
Verifying packages on slot 1:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on slot 1.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on slot 1.....................Done.
flash:/system-t0001015.bin verification successful.
Start to check active package consistency.
Active packages are consistent with committed packages on their own board.
Active packages are consistent with the reference packages.
Verification is done.
# 检验设备上软件包状态、完整性和一致性信息。(IRF模式)
<Sysname> install verify
Active packages on slot 1 are the reference packages.
Packages will be compared with the reference packages.
This operation will take several minutes, please wait...
Verifying packages on slot 1:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on slot 1.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on slot 1.....................Done.
flash:/system-t0001015.bin verification successful.
Start to check active package consistency.
Active packages are consistent with committed packages on their own board.
Active packages are consistent with the reference packages.
Verifying packages on slot 2:
Start to check active package completeness.
Verifying the file flash:/boot-t0001015.bin on slot 2.....................Done.
flash:/boot-t0001015.bin verification successful.
Verifying the file flash:/system-t0001015.bin on slot 2.....................Done.
flash:/system-t0001015.bin verification successful.
Start to check active package consistency.
Active packages are consistent with committed packages on their own board.
Active packages are consistent with the reference packages.
Verification is done.
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!