01-基础配置命令参考

07-软件升级命令

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> ] { all | slot slot-number } { backup | main }

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

IRF模式：

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

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

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

boot boot-package：指定用于启动的Boot包，boot-package表示Boot包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

system system-package：指定用于启动的System包，system-package表示System包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

feature feature-package：指定用于启动的Feature包，feature-package表示Feature包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。{ feature-package }&<1-30>表示前面的参数最多可以输入30次。

ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

all：用来升级整个系统。当用户获取的IPE包中包含IRF系统升级需要的所有软件包时，使用这样的IPE包，并指定all参数，执行一次boot-loader file命令，就能指定系统中所有硬件下次启动时使用的软件包/IPE文件。

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

chassis chassis-number slot slot-number：表示待升级的成员设备上的指定主控板的槽位号，或者待升级的PEX设备的虚拟槽位号。（IRF模式）

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

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

【使用指导】

· 在独立运行环境下：命令中指定的软件包（IPE文件）可以放在设备任意主控板存储介质的根目录下，文件名中必须包含存储介质的名称，可以包含slot的信息，形如slot1#flash:/xx.bin（flash:/xx.ipe）。

· 在IRF环境下：命令中指定的软件包（IPE文件）可以放在成员设备任意主控板存储介质的根目录下，文件名中必须包含存储介质的名称，可以包含slot的信息，形如chassis2#slot1#flash:/xx.bin（flash:/xx.ipe）。

· 在IRF3环境下：命令中指定的软件包（IPE文件）可以放在父设备任意主控板存储介质的根目录下，文件名中必须包含存储介质的名称，可以包含slot的信息，形如chassis2#slot1#flash:/xx.bin（flash:/xx.ipe）。

· 对于S6300系列以太网交换机做PEX设备时，才能使用该命令来配置下次启动软件包，如果同时配置了boot-loader file和boot-loader pex命令，则PEX设备启动时优先使用下次启动软件包。在启动过程中，如果发现下次启动软件包和父设备的版本不兼容，再使用加载软件包；对于S5120-58C-HI或S5120-34C-HI做PEX设备，则不能通过boot-loader file命令来升级PEX设备，请使用boot-loader pex file命令。

· 系统会自动检查指定单板或PEX上对应路径下是否存在同名文件，如果不存在，则直接从指定路径拷贝一份并设置为下次启动软件包；如果存在，则提示用户是否从指定路径拷贝一份并设置为下次启动软件包。

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

· 如果使用IPE文件指定父设备或PEX设备的下次启动软件，配置成功后系统会提示您是否需要删除所使用的IPE文件，您可以根据提示内容，选择Y或N来删除或保留该IPE文件。

【举例】

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

<Sysname> boot-loader file flash:/all.ipe slot 17 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 17.

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

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

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

Decompression completed.

Do you want to delete flash:/all.ipe now? [Y/N]:Y

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

<Sysname> boot-loader file flash:/all.ipe chassis 1 slot 17 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 17.

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

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

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

Decompression completed.

Do you want to delete flash:/all.ipe now? [Y/N]:Y

【相关命令】

· boot-loader pex file

· display boot-loader

1.1.2 boot-loader pex file

boot-loader pex file命令用来配置PEX设备的加载软件包/IPE文件。

【命令】

boot-loader pex pex-model file boot boot-package system system-package [ feature feature-package&<1-30> ]

boot-loader pex pex-model file ipe ipe-filename

pex pex-model：设备支持的PEX设备的型号，该参数必须完整输入，不区分大小写。可输入boot-loader pex ？，回车，来获取该参数的取值。

boot boot-package：指定用于加载的Boot包，boot-package表示Boot包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

system system-package：指定用于加载的System包，system-package表示System包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

feature feature-package：指定用于加载的Feature包，feature-package表示Feature包的完整路径，包括文件所在路径和文件名。feature-package&<1-30>表示前面的参数最多可以输入30次，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

ipe ipe-filename：表示IPE（Image Package Envelope，复合软件包套件）包的完整路径，包括文件所在路径和文件名，从存储介质名开始最大为63个字符的字符串（包括存储介质名在内），不区分大小写。

【使用指导】

· 如果配置该命令后，加入新的主控板，需要重新配置该命令，以免主备倒换后，影响PEX设备启动。

· 配置该命令后，系统会将指定软件包备份到所有主控板。PEX设备只使用当前全局主用主控板上的软件包作为加载软件包。

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

· PEX设备的加载软件包指定完成后，系统会提示您是否需要删除所使用的IPE包，您可以根据提示内容，选择Y或N来删除或保留该IPE包。

· 关于该命令请注意，当配置该命令时，命令中指定的软件包（IPE文件）可以放在设备任意主控板的存储介质的根目录下。

· 关于加载软件包的详细介绍以及下次启动软件包/IPE文件和加载软件包/IPE文件的关系，请参见“基础配置指导”中的“软件升级”。

【举例】

# 将型号为PEX-S5120HI的PEX设备的加载软件包配置为flash:/all.ipe。

<Sysname> boot-loader pex PEX-S5120HI file ipe flash:/all.ipe

Verifying the IPE file and the images............Done.

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.

Decompression completed.

Do you want to delete flash:/all.ipe now? [Y/N]:Y

【相关命令】

· boot-loader file

· display boot-loader pex

1.1.3 boot-loader update

boot-loader update命令用来将备用主控板的软件版本与主用主控板的当前软件版本进行同步。（独立运行模式）

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

【命令】

独立运行模式：

boot-loader update { all | slot slot-number }

IRF模式：

boot-loader update { all | chassis chassis-number slot slot-number }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

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

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

all：表示同步升级所有备用主控板。（独立运行模式）

all：表示同步升级所有全局备用主控板。（IRF模式）

【使用指导】

本命令用于备用主控板和主用主控板软件版本不一致时，刷新备用主控板的软件版本，使其和主用主控板的软件版本相同。

(1) 独立运行模式

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

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

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

(2) IRF模式

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

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

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

【举例】

# 将16号槽位的备用主控板上的软件版本与主用主控板的软件版本同步。（独立运行模式）

<Sysname> boot-loader update slot 16

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

Updating. Please wait...

Copying main startup software images to slot 16. Please wait...

Done.

Setting copied images as main startup software images for slot 16...

Done.

Successfully updated the startup software images of slot 16.

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

<Sysname> boot-loader update chassis 1 slot 16

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

Updating. Please wait...

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

Done.

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

Done.

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

【相关命令】

· display boot-loader

1.1.4 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中的成员编号或在IRF3中PEX设备的虚拟槽位号。（IRF模式）

slot slot-number-list：槽位号列表，表示同时备份多个单板的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要备份的单板所在的槽位号或PEX设备所在的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。（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 slot 17

Now backuping the Boot ROM, please wait...

......Done.

【相关命令】

· bootrom restore

1.1.5 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中的成员编号或在IRF3中PEX设备的虚拟槽位号。（IRF模式）

slot slot-number-list：槽位号列表，表示同时恢复多个单板的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要恢复的单板所在的槽位号或PEX设备所在的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。（IRF模式）

【举例】

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

<Sysname> bootrom restore slot 17

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 17

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

Now restoring the Boot ROM, please wait...

......Done.

【相关命令】

· bootrom backup

1.1.6 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：指定用于加载的BootWare程序， file-url表示BootWare程序的完整路径，包括文件所在路径和文件名，，从存储介质名开始最大为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中的成员编号或在IRF3中PEX设备的虚拟槽位号。（IRF模式）

slot slot-number-list：槽位号列表，表示同时升级多个单板的BootWare程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的单板所在的槽位号或PEX设备所在的虚拟槽位号。&<1-7>表示前面的参数最多可以输入7次。（IRF模式）

【使用指导】

· 当配置该命令时，命令中指定用于加载的BootWare程序可以放在设备任意主控板的存储介质的根目录下。

· 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:/a.bin slot 17

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:/a.bin chassis 1 slot 17

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.7 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.8 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：表示指定单板或PEX设备上的启动软件包。chassis chassis-number表示IRF中的成员编号或IRF3中PEX设备的虚拟框号，slot slot-number表示单板所在的槽位号。如果不指定本参数，则显示所有单板及PEX设备上的启动软件包。（IRF模式）

【举例】

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

<Sysname> display boot-loader

Software images on slot 17:

Current software images: