01-基础配置命令参考

07-软件升级命令

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom backup

1.1.4 bootrom restore

1.1.5 bootrom update

1.1.6 bootrom-update security-check enable

1.1.7 display boot-loader

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

boot-loader file命令用来指定设备下次启动时使用的软件包/IPE文件。

【命令】

独立运行模式：

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] slot slot-number { backup | main }

boot-loader file ipe-filename slot slot-number { backup | main }

IRF模式：

boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] chassis chassis-number slot slot-number { backup | main }

boot-loader file ipe-filename chassis chassis-number slot slot-number { backup | main }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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个字符的字符串，不区分大小写。

slot slot-number：表示待升级的主控单元所在的槽位号。（独立运行模式）

chassis chassis-number slot slot-number：表示待升级的成员设备上的指定主控单元。（IRF模式）

backup：指定该软件包为备用启动软件包，并将该软件包的名称添加到备用启动软件包列表。备用启动软件包用于主用启动软件包不可用或异常情况时，引导设备启动。

main：指定该软件包为主用启动软件包，并将该软件包的名称添加到主用启动软件包列表。主用启动软件包用于引导设备启动。

【使用指导】

(1) 独立运行模式

· 当配置该命令时，命令中指定的软件包（IPE文件）必须放在主控单元Flash的根目录下，文件名中必须且只能包含存储介质的名称，不能包含slot的信息，形如flash:/xx.bin（flash:/xx.ipe）。

· 成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。

(2) IRF模式

· 当配置该命令时，命令中指定的软件包（IPE文件）必须放在全局主用主控单元Flash的根目录下，文件名中必须且只能包含存储介质的名称，不能包含chassis和slot的信息，形如flash:/xx.bin（flash:/xx.ipe）。

· 如果配置的是全局备用主控单元，则系统会自动检查全局备用主控单元上对应路径下是否存在同名文件，如果不存在，则从全局主用主控单元上拷贝一份并设置为下次启动软件包；如果存在，则提示用户是否从全局主用主控单元上拷贝一份并设置为下次启动软件包。

· 成功执行该命令后，系统会用命令中指定的软件包替换现有的软件包列表。如果命令行中没有指定Feature包，则更新后的软件包列表中不会有Feature包。

【举例】

# 指定0号板下次启动时所用的备用启动文件为flash:/all.ipe。（独立运行模式）

<Sysname> boot-loader file flash:/all.ipe slot 0 backup

Verifying image file......Done.

Images in IPE:

boot.bin

system.bin

ssh.bin

This command will set the backup startup software images. Continue? [Y/N]:Y

Add images to target slot.

flash:/boot.bin already exists on slot 0.

flash:/system.bin already exists on slot 0.

flash:/ssh.bin already exists on slot 0.

Overwrite it? [Y/N]: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 backup startup software images at the next reboot on slot 0.

# 指定成员设备1的0号板下次启动时所用的备用启动文件为flash:/all.ipe。（IRF模式）

<Sysname> boot-loader file flash:/all.ipe chassis 1 slot 0 backup

Verifying image file......Done.

Images in IPE:

boot.bin

system.bin

ssh.bin

This command will set the backup startup software images. Continue? [Y/N]:Y

Add images to target slot.

flash:/boot.bin already exists on chassis 1 slot 0.

flash:/system.bin already exists on chassis 1 slot 0.

flash:/ssh.bin already exists on chassis 1 slot 0.

Overwrite it? [Y/N]: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 backup startup software images at the next reboot on chassis 1 slot 0.

【相关命令】

· display boot-loader

1.1.2 boot-loader update

boot-loader update命令用来将全局主用主控单元的软件版本与全局备用主控单元的当前软件版本进行同步。（IRF模式）

【命令】

IRF模式：

boot-loader update chassis chassis-number slot slot-number

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

chassis chassis-number slot slot-number：表示待升级的全局备用主控单元所在位置。chassis-number表示设备的成员编号，slot-number表示全局备用主控单元所在的槽位号。（IRF模式）

【使用指导】

本命令仅用于设备堆叠IRF后使用（堆叠的设备台数不少于2台）

通过该命令指定全局备用主控单元的下次启动软件包时，系统会进行如下处理：

· 如果全局主用主控单元当前是使用主用启动软件包列表启动的，则将其主用下次启动软件包列表中的软件包拷贝到全局备用主控单元的对应目录下，并设置为全局备用主控单元的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

· 如果全局主用主控单元当前是使用备用启动软件包列表启动的，则将其备用下次启动软件包列表中的软件包拷贝到全局备用主控单元的对应目录下，并设置为全局备用主控单元的主用下次启动软件包。如果这些软件包中有任一软件包不存在或者不可用，则命令执行失败。

· 如果主用主控单元刚安装了补丁，在执行boot-loader update命令前，请执行install commit命令刷新主用主控单元的下次启动软件包列表。否则，可能导致备用主控单元升级后与主用主控单元的版本不一致。

【举例】

# 将成员设备1的0号主控单元上的软件版本与全局主用主控单元同步。（IRF模式）

<Sysname> boot-loader update chassis 1 slot 0

This command will update the specified standby MPU. Continue? [Y/N]:y

Updating. Please wait...

Copying main startup software images to chassis 1 slot 0. Please wait...

Done.

Setting copied images as main startup software images for chassis 1 slot 0...

Done.

Successfully updated the startup software images of chassis 1 slot 0.

【相关命令】

· display boot-loader

1.1.3 bootrom backup

bootrom backup命令用来将BootWare程序从BootWare的Normal区备份到Backup区。

【命令】

独立运行模式：

bootrom backup slot slot-number-list

IRF模式：

bootrom backup chassis chassis-number slot slot-number-list

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：槽位号列表，表示同时备份多个单板/主控单元的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要备份的单板/主控单元所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（独立运行模式）

chassis chassis-number：表示需要备份BootWare程序的设备在IRF中的成员编号。（IRF模式）

【使用指导】

BootWare分为Normal区和Backup区。

· Normal区用于存放BootWare程序。设备启动时，会自动读取Normal区的BootWare程序。如果Normal区的BootWare程序不可用，再自动读取Backup区的BootWare程序。

· Backup区用于存放BootWare程序的副本。如果在设备运行过程中，Normal区的BootWare程序被损坏或者需要版本回退，可以使用bootrom restore命令将BootWare程序从Backup区恢复到Normal区。

【举例】

# 将BootWare程序从BootWare的Normal区备份到Backup区。

<Sysname> bootrom backup all

Now backuping the Boot ROM, please wait...

......Done.

【相关命令】

· bootrom restore

1.1.4 bootrom restore

bootrom restore命令用来将BootWare程序从BootWare的Backup区恢复到Normal区。

【命令】

独立运行模式：

bootrom restore slot slot-number-list

IRF模式：

bootrom restore chassis chassis-number slot slot-number-list

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

slot slot-number-list：槽位号列表，表示同时恢复多个单板/主控单元的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢复的单板/主控单元所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（独立运行模式）

chassis chassis-number：表示需要恢复BootWare程序的设备在IRF中的成员编号。（IRF模式）

【举例】

# 恢复BootWare程序（独立运行模式）。

<Sysname> bootrom restore slot 0

This command will restore the Boot ROM file, Continue? [Y/N]:y

Now restoring the Boot ROM, please wait...

......Done.

# 恢复BootWare程序（IRF模式）。

<Sysname> bootrom restore chassis 1 slot 0

This command will restore the Boot ROM file, Continue? [Y/N]:y

Now restoring the Boot ROM, please wait...

......Done.

【相关命令】

· bootrom backup

1.1.5 bootrom update

bootrom update命令用来加载BootWare程序。

【命令】

独立运行模式：

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

IRF模式：

bootrom update file file-url chassis chassis-number slot slot-number-list

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

file file-url：Flash中包含BootWare程序的文件，file-url表示用于BootWare程序升级的文件的名称，为1～63个字符的字符串。

slot slot-number-list：槽位号列表，表示同时升级多个单板/主控单元的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的单板/主控单元所在的槽位号。&<1-7>表示前面的参数最多可以输入7次。（独立运行模式）

chassis chassis-number：表示需要升级BootWare程序的设备在IRF中的成员编号。（IRF模式）

【使用指导】

BootWare程序通过Boot包（*.bin）发布，产品会将需要升级的单板/主控单元的BootWare程序集成到Boot包中。此时，可是使用bootrom update命令，将升级文件指定为Boot包，系统会根据单板/主控单元的型号自动将相应的BootWare程序加载到BootWare中；也可以在升级Boot包的同时完成BootWare程序的加载。

执行该命令后，设备会将Flash中的BootWare程序加载到BootWare的Normal区。设备启动时，会直接使用Normal区的BootWare程序。因此，如果Flash空间不足，BootWare程序加载完成之后，BootWare文件可以删除。

加载后，要使新的BootWare程序生效，需要重启设备。

【举例】

# 使用a.bin文件升级设备的BootWare程序（独立运行模式）。

<Sysname> bootrom update file flash:/boot.bin slot 0

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.

# 使用a.bin文件升级设备的BootWare程序（IRF模式）。

<Sysname> bootrom update file flash:/boot.bin chassis 1 slot 0

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.

【相关命令】

· boot-loader file

1.1.6 bootrom-update security-check enable

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程序合法性检查功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

如果使能了该功能，则在升级BootWare程序时，设备会先检查BootWare文件的合法性：包括BootWare文件是否有效以及是否和硬件匹配等。检查通过后，才会升级。

【举例】

# 启动BootWare升级时的合法性检查功能。

<Sysname> system-view

[Sysname] bootrom-update security-check enable

1.1.7 display boot-loader

display boot-loader命令用来显示本次启动和下次启动所采用的启动软件包的名称。

【命令】

独立运行模式：

display boot-loader [ slot slot-number ]

IRF模式：

display boot-loader [ chassis chassis-number [ slot slot-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示主控单元所在的槽位号。不指定该参数时，表示设备上的所有主控单元。（独立运行模式）

chassis chassis-number slot slot-number：表示指定成员设备上的指定主控单元。chassis chassis-number表示设备在IRF中的成员编号，slot slot-number表示主控单元所在的槽位号。不指定该参数时，表示IRF中的所有主控单元。（IRF模式）

【举例】

# 显示本次启动和下次启动所采用的启动软件包的名称。（独立运行模式）

<Sysname> display boot-loader

Software images on slot 0:

Current software images: