01-基础配置命令参考

07-软件升级命令

1 软件升级

1.1 软件升级配置命令

1.1.1 boot-loader file

1.1.2 boot-loader update

1.1.3 bootrom update

1.1.4 display boot-loader

1.1.5 firmware update

1.1.6 version auto-update enable

1.1.7 version check ignore

1 软件升级

MSR810/810-W/810-W-DB/810-LM/810-W-LM/810-LM-HK/810-W-LM-HK /2630/3610/3620/3620-DP/3640/3660/3600-28/3600-51/MSR2600-10-X1路由器使用集中式命令行，MSR 5620/5660/5680路由器使用分布式命令行。

1.1 软件升级配置命令

1.1.1 boot-loader file

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

【命令】

集中式设备：

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

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

分布式设备－独立运行模式/集中式IRF设备：

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 }

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：表示待升级的主控板所在的槽位号。（分布式设备－独立运行模式）

slot slot-number：表示待升级的成员设备的编号。（集中式IRF设备）

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

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

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

【使用指导】

(1) 集中式设备

请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则：

· 对于boot-loader file boot boot-package system system-package [ feature feature-package&<1-30> ] { backup | main }命令，只要指定某个的软件包当前没有有效的License，就会导致整条命令配置失败。

· 对于boot-loader file ipe-filename { backup | main }命令，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。

当配置该命令时，命令中指定的软件包/IPE文件必须放在设备存储介质主分区的根目录下，文件名中必须包含存储介质的名称，形如flash:/xx.bin（flash:/xx.ipe）。

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

(2) 分布式设备－独立运行模式/集中式IRF设备/分布式设备－IRF模式

· 请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，当使用软件包配置该命令时，只要指定的某个软件包当前没有有效的License，则会导致整条命令配置失败；当使用IPE文件配置该命令时，只有当前没有有效的License的软件包配置失败，其它软件包会配置成功。

· 当配置该命令时，命令中指定的软件包/IPE文件必须放在存储介质主分区的根目录下，文件名中必须包含存储介质的名称。

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

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

【举例】

# 指定设备下次启动时所用的主用启动文件为flash:/all.ipe。（集中式设备）

<Sysname> boot-loader file flash:/all.ipe main

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

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 the existing files? [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 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.

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

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

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

Images in IPE:

boot.bin

system.bin

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

Add images to target slot.

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

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

Overwrite the existing files? [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 main startup software images at the next reboot on slot 0.

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

<Sysname> boot-loader file flash:/all.ipe slot 1 main

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

Images in IPE:

boot.bin

system.bin

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

Add images to target slot.

File flash:/boot.bin already exists on slot 1.

File flash:/system.bin already exists on slot 1.

Overwrite the existing files? [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 main startup software images at the next reboot on slot 1.

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

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

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

Images in IPE:

boot.bin

system.bin

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

Add images to target slot.

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

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

Overwrite the existing files? [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 main startup software images at the next reboot on chassis 1 slot 0.

【相关命令】

· display boot-loader

1.1.2 boot-loader update

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

boot-loader update命令用来将从设备的软件版本与主设备的当前软件版本进行同步。（集中式IRF设备）

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

【命令】

分布式设备－独立运行模式/集中式IRF设备：

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

分布式设备－IRF模式：

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

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

all：表示同步升级所有备设备。（集中式IRF设备）

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

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

slot slot-number：表示待升级的成员设备的编号。（集中式IRF设备）

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

【使用指导】

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

(1) 分布式设备－独立运行模式

请先查看软件包版本发布说明书，如果软件包需要License才能运行，且设备当前没有对应的有效的License时，需安装对应的License，再执行该命令。否则，会导致命令执行失败。

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

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

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

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

(2) 集中式IRF设备

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

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

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

(3) 分布式设备－IRF模式

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

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

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

【举例】

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

<Sysname> boot-loader update slot 1

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

Updating. Please wait...

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

Done.

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

Done.

Successfully updated the startup software images of slot 1.

# 将成员设备2上的软件版本与主设备的软件版本同步。（集中式IRF设备）

<Sysname> boot-loader update slot 2

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

Updating. Please wait...

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

Done.

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

Done.

Successfully updated the startup software images of slot 2.

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

<Sysname> boot-loader update chassis 1 slot 1

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

Updating. Please wait...

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

Done.

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

Done.

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

【相关命令】

· display boot-loader

· install commit（基本配置命令参考/ISSU）

1.1.3 bootrom update

bootrom update命令用来加载Boot ROM程序。

【命令】

集中式设备：

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

分布式设备－独立运行模式/集中式IRF设备：

bootrom update file file-url slot slot-number-list [ subslot subslot-number-list ]

分布式设备－IRF模式：

bootrom update file file-url chassis chassis-number slot slot-number-list [ subslot subslot-number-list ]

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

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

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

slot slot-number-list：成员编号列表，表示同时升级多个成员设备的Boot ROM程序。表示方式为slot-number-list = { slot-number [ to slot-number ] }&<1-7>。其中，slot-number表示需要升级的设备在IRF中的成员编号。（集中式IRF设备）

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

subslot subslot-number-list：子槽位号列表，表示同时升级多个子卡的Boot ROM程序。表示方式为subslot-number-list = { subslot-number [ to subslot-number ] }&<1-7>。其中，subslot-number表示需要升级的子卡所在的子槽位号。&<1-7>表示前面的参数最多可以输入7次。不使用该参数时，表示不升级子卡。

【使用指导】

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

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

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

【举例】

# 使用a.bin文件升级设备的Boot ROM程序。

<Sysname> bootrom update file a.bin

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.4 display boot-loader

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

【命令】

集中式设备：

display boot-loader

分布式设备－独立运行模式/集中式IRF设备：

display boot-loader [ slot slot-number ]

分布式设备－IRF模式：

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

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

slot slot-number：表示成员设备的编号。不指定该参数时，表示IRF中的所有成员设备。（集中式IRF设备）

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

【举例】

# 显示本次启动和下次启动所采用的启动软件包的名称。（集中式设备）

<Sysname> display boot-loader

Software images on the device:

Current software images:

flash:/simware-cmw710-boot-a1701.bin