- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 新华三人才研学中心
- 关于我们
07-软件升级命令
本章节下载： 07-软件升级命令 (136.37 KB)
如果将USB外接设备内的软件包指定为设备下次启动时使用的软件包，重启设备时不要将USB外接设备从设备上拔出，否则可能导致设备无法正常启动。建议将Flash中的软件包指定为设备下次启动时使用的软件包。
boot-loader file命令用来指定设备下次启动时使用的软件包/IPE文件（以下简称下次启动软件包/IPE文件）。
boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { all | slot slot-number } { backup | main }
boot-loader file ipe-filename { all | slot slot-number } { backup | main }
boot boot-package：Boot包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
system system-package：System包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
feature feature-package：Feature包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。feature-package&<1-30>表示前面的参数最多可以输入30次。
ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）文件的名称，以.ipe作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
all：用来升级整个系统。当用户获取的IPE包中包含IRF系统升级需要的所有软件包时，使用这样的IPE包，并指定all参数，执行一次boot-loader file命令，就能指定系统中所有硬件下次启动时使用的软件包/IPE文件。
slot slot-number：表示待升级的成员设备的编号，或者待升级的本地有存储介质的PEX设备的虚拟槽位号。
backup：指定该软件包为备用启动软件包，并将该软件包的名称添加到备用启动软件包列表。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。
main：指定该软件包为主用启动软件包，并将该软件包的名称添加到主用启动软件包列表。主用启动软件包用于引导设备启动。
· 请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，当使用软件包配置该命令时，只要指定的某个软件包当前没有有效的License，则会导致整条命令配置失败；当使用IPE文件配置该命令时，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。
· 当配置该命令时，命令中指定的软件包/IPE文件必须放在主设备的Flash或USB外接设备的根目录下，文件名中必须包含存储介质的名称。
· 在IRF3环境下：命令中指定的软件包（IPE文件）必须放在父设备中主设备Flash或USB外接设备的根目录下，文件名中必须包含存储介质的名称。
· 如果配置的是从设备，则系统会自动检查从设备上对应路径下是否存在同名文件，如果不存在，则直接从主设备上拷贝一份并设置为下次启动软件包；如果存在，则提示用户是否从主设备上拷贝一份并设置为下次启动软件包。
· 成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。
· 对于PEX设备，只有本地有存储介质的PEX设备才能使用该命令来配置下次启动软件包。对于本地无存储介质的PEX设备，则不能通过该命令来升级PEX设备，请使用boot-loader pex file命令。对于本地有存储介质的PEX设备，如果同时配置了boot-loader file和boot-loader pex命令，则PEX设备启动时优先使用下次启动软件包。在启动过程中，如果发现下次启动软件包和父设备的版本不兼容，再使用加载软件包。
# 指定成员设备1下次启动时所用的备用启动文件为boot.bin和system.bin。
<sysname> boot-loader file boot flash:/boot.bin system flash:/system.bin slot 1 backup
This command will set the backup startup software images. Continue? [Y/N]:y
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 backup startup
software images at the next reboot on slot 1.
· boot-loader pex file
boot-loader pex file命令用来配置PEX设备的加载软件包/IPE文件。
boot-loader pex pex-model file ipe ipe-filename
pex pex-model：设备支持的PEX设备的型号，该参数必须完整输入，不区分大小写。可输入boot-loader pex ？，来获取该参数的取值。
boot boot-package：PEX设备将加载的Boot包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
system system-package：PEX设备将加载的System包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
feature feature-package：PEX设备将加载的feature包的名称，以.bin作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。feature-package&<1-30>表示前面的参数最多可以输入30次。
ipe ipe-filename：表示PEX设备将加载的IPE（Image Package Envelope，复合软件包套件）文件的名称，以.ipe作为后缀名，从存储介质名开始为1～63个字符的字符串（包括存储介质名在内），不区分大小写。
当PEX设备首次加入IRF3系统时，必须从父设备加载启动软件包。对于要加入的新型号PEX设备，需要在父设备上配置本命令，为PEX设备加载软件包。
对于已存在于IRF3系统中的PEX设备，可以使用本命令对PEX设备进行软件升级。
· 对于本地有存储介质的PEX设备，可以使用本命令或boot-loader file命令加载本地保存的启动软件包。本地有存储介质的PEX设备优先查找并加载本地的启动软件包，若本地不存在启动软件包，则从父设备加载启动软件包。
· 对于本地无存储介质的PEX设备，可以使用父设备的加载软件包。
如果配置该命令后，加入新的成员设备，需要重新配置该命令，以免主备倒换后，影响PEX设备启动。
配置该命令后，系统会将指定软件包备份到所有成员设备。PEX设备使用当前主设备上的Flash或USB外接设备上的软件包作为加载软件包。
成功执行该命令后，系统会用命令中指定的软件包替换命令行中指定型号的PEX设备现有的加载软件包列表。如果命令行中没有指定Feature包，则更新后的加载软件包列表中不会有Feature包。
关于该命令请注意，当配置该命令时，命令中指定的软件包（IPE文件）必须放在父设备中主设备Flash或USB外接设备的根目录下，文件名中必须包含存储介质的名称。
关于加载软件包的详细介绍以及下次启动软件包/IPE文件和加载软件包/IPE文件的关系，请参见“基础配置指导”中的“软件升级”。
# 将型号为PEX-S5120HI的PEX设备的主用加载软件包配置为flash:/all.ipe。
<Sysname> boot-loader pex PEX-S5120HI file ipe flash:/all.ipe
Decompressing file rpu-s5120hi-boot.bin to flash:/rpu-s5120hi-boot.bin.....................Done.
Decompressing file rpu-s5120hi-system.bin to flash:/rpu-s5120hi-system.bin............................................ Done.
File flash:/rpu-s5120hi-boot.bin already exists on slot 1.
File flash:/rpu-s5120hi-system.bin already exists on slot 1.
Overwrite the existing files? [Y/N]:Y
Copying file flash:/rpu-s5120hi-boot.bin to slot2#flash:/rpu-s5120hi-boot.bin.........................Done.
Copying file flash:/rpu-s5120hi-system.bin to slot2#flash:/rpu-s5120hi-system.bin...............................................Done.
# 将型号为PEX-S5120HI的PEX设备的主用加载软件包配置为flash:/boot.bin和flash:/system.bin。
<Sysname> boot-loader pex PEX-S5120HI file boot flash:/boot.bin system flash:/system.bin
Copying file flash:/boot.bin to slot1#flash:/boot.bin.........................Done.
Copying file flash:/system.bin to slot1#flash:/system.bin......................................................Done.
· boot-loader file
boot-loader update命令用来将从设备的软件版本与主设备的当前软件版本进行同步。
boot-loader update { all | slot slot-number }
all：表示同步升级所有从设备。
slot slot-number：表示待升级的从设备的编号。
请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，会导致命令执行失败。
本命令用于从设备和主设备软件版本不一致时，刷新从设备的软件版本，使其和主设备的软件版本相同。
通过该命令指定从设备的下次启动软件包时，系统会进行如下处理：
· 如果主设备当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。
· 如果主设备当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到从设备的对应目录下，并设置为从设备的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。
如果主设备刚安装了补丁或者进行了ISSU升级，在执行本命令前，请执行install commit命令刷新主设备的下次启动软件包列表。否则，可能导致从设备升级后与主设备的版本不一致。
# 将成员设备2上的软件版本与主设备的软件版本同步。
<Sysname> boot-loader update slot 2
This command will update the specified standby MPU. Continue? [Y/N]:y
Updating. Please wait...
Verifying the file flash:/BOOT.bin on slot 2.....Done.
Verifying the file flash:/SYSTEM.bin on slot 2..................................Done.
Successfully updated the startup software images of slot 2.
· install commit（基本配置命令参考/ISSU）
bootrom update命令用来加载BootWare程序。
bootrom update file file-url slot slot-number-list [ subslot subslot-number-list ]
file file-url：Flash中包含BootWare程序的文件，file-url表示用于BootWare程序升级的文件的名称，为1～63个字符的字符串。
slot slot-number-list：成员编号/PEX虚拟槽位号列表，表示同时备份多个成员设备/PEX的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要备份的设备在IRF中的成员编号或者PEX的虚拟槽位号。
subslot subslot-number-list：子槽位号列表，表示同时升级多个接口模块扩展卡的BootWare程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要升级的接口模块扩展卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示不升级接口模块扩展卡。
BootWare程序通过Boot包（*.bin）发布，产品会将需要升级的设备的BootWare程序集成到Boot包中。此时，可是使用bootrom update命令，将升级文件指定为Boot包，系统会根据设备的型号自动将相应的BootWare程序加载到BootWare中；也可以在升级Boot包的同时完成BootWare程序的加载。
执行该命令后，设备会将缺省存储介质中的BootWare程序加载到BootWare的Normal区。设备启动时，会直接使用Normal区的BootWare程序。因此，如果缺省存储介质空间不足，BootWare程序加载完成之后，BootWare文件可以删除。
加载后，要使新的BootWare程序生效，需要重启设备。
# 使用Flash根目录下的a.bin文件升级设备的BootWare程序。
<Sysname> bootrom update file flash:/a.bin slot 1
This command will update the Boot ROM file on the specified board(s), Continue? [Y/N]:y
Now updating the Boot ROM, please wait...
.............Done.
bootrom-update security-check enable命令用来开启BootWare程序合法性检查功能。
undo bootrom-update security-check enable命令用来关闭BootWare程序合法性检查功能。
bootrom-update security-check enable
undo bootrom-update security-check enable
BootWare程序合法性检查功能处于开启状态。
如果使能了该功能，则在升级BootWare程序时，设备会先检查BootWare文件的合法性：包括BootWare文件是否有效以及是否和硬件匹配等。检查通过后，才会升级。
# 启动BootWare升级时的合法性检查功能。
[Sysname] bootrom-update security-check enable
display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。
display boot-loader [ slot slot-number ]
slot slot-number：表示成员设备的编号。不指定该参数时，表示IRF中的所有成员设备。
使用该命令可显示父设备、PEX设备本次启动和下次启动所采用的启动软件包的名称。
· 对于本地有存储介质的PEX设备，会显示本次启动和下次启动所采用的启动软件包的名称。
· 对于本地无存储介质的PEX设备，只显示本次启动软件包的名称。
# 显示本次启动和下次启动所采用的启动软件包的名称。
Software images on slot 1:
Current software images:
flash:/CMW710-BOOT-TEST.bin
flash:/CMW710-SYSTEM-TEST.bin
Main startup software images:
flash:/CMW710-BOOT-TEST.bin
flash:/CMW710-SYSTEM-TEST.bin
Backup startup software images:
None
表1-1 display boot-loader命令显示信息描述表
|
成员编号为n的某成员设备的启动软件包的相关信息 |
|
display boot-loader pex命令用来显示PEX设备的加载软件包列表。
display boot-loader pex [ pex-model ]
pex-model：设备支持的PEX设备的型号，该参数必须完整输入，不区分大小写。可输入boot-loader pex ？，来获取该参数的取值。不指定该参数时，表示所有型号的PEX设备。
当PEX设备需要使用加载软件包启动时，就会根据加载软件包列表去当前主设备加载这些软件包。
# 查看PEX设备的加载软件包列表。
<Sysname> display boot-loader pex
Main load software image files for PEXs to load from the parent device:
PEX model: PEX-S5120HI
flash:/rpu-s5120hi-boot.bin
flash:/rpu-s5120hi-system.bin
PEX model: PEX-S6300
flash:/boot.bin
flash:/system.bin
Backup load software image files for PEXs to load from the parent device:
PEX model: PEX-S5120HI
flash:/rpu-s5120hi-boot.bin
flash:/rpu-s5120hi-system.bin
PEX model: PEX-S6300
flash:/boot-backup.bin
flash:/system-backup.bin
reset boot-loader pex命令用来清除PEX设备的加载软件包配置。
reset boot-loader pex pex-model
pex-model：设备支持的PEX设备的型号，该参数必须完整输入，不区分大小写。可输入boot-loader pex ？，来获取该参数的取值。
执行本命令后，设备会清空对应的加载软件包列表，不会将加载软件包从设备上删除。
# 清除指定型号为PEX-S6300的PEX的主用加载软件包配置。
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
售前咨询
售后咨询
人工在线咨询
