目  录

1 软件升级配置命令

1.1 软件升级配置命令

1.1.1 boot-loader

1.1.2 bootrom

1.1.3 display boot-loader

1.1.4 display patch

1.1.5 display patch information

1.1.6 patch active

1.1.7 patch deactive

1.1.8 patch delete

1.1.9 patch install

1.1.10 patch load

1.1.11 patch location

1.1.12 patch run

 

1 软件升级配置命令

1.1  软件升级配置命令

1.1.1  boot-loader

【命令】

分布式设备：

boot-loader file file-url slot slot-number { main | backup }

分布式IRF设备：

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

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

file file-url：文件名，为1～63个字符的字符串，如果用户输入的是相对路径，则执行命令时系统会自动将相对路径转换为绝对路径，同时要求绝对路径最多不能超过63个字符，否则，命令执行失败。格式为[drive:/]file-name，其中，

l              [ ]表示该参数可选。

l              drive用来指定文件在设备的哪个存储介质上，取值为存储介质的名称。如果设备上只有一个存储介质，可以不用输入该参数。

l              file-name表示文件的名称，一般以.app或.bin作为后缀名，不同型号的设备支持的后缀名可能不同，请以设备的实际情况为准。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：用来设置指定成员设备上指定单板的下次启动文件为指定文件。chassis-number表示设备在IRF中的成员编号，slot-number表示单板所在的槽位号。（分布式IRF设备）

main：指定该文件为主用启动文件。主用启动文件用于引导、启动设备。

backup：指定该文件为备用启动文件。备用启动文件只用于异常情况下，当主用启动文件不可用时，引导、启动设备。

【描述】

(1)        分布式设备

boot-loader命令用来指定主用主控板或者备用主控板的下次启动文件。

需要注意的是：

l              必须先将下次启动文件保存到相应主控板存储介质的根目录下，boot-loader命令才能执行成功。

l              主用主控板上的存储介质直接用存储介质的名称表示，比如flash；备用主控板的存储介质需要使用slotslot-number#存储介质的名称（slot-number表示备用主控板所在的槽位号），比如slot1#flash。

l              设置主用主控板的下次启动文件时，file-url参数不能携带槽位号，slot-number为主用主控板所在的槽位号；设置备用主控板的下次启动文件时，file-url参数需要携带备用主控板所在的槽位号（形如slot1#flash:/test.app），slot-number为备用主控板所在的槽位号。

l              主用主控板和备用主控板的下次启动文件名称可以不同，但是版本必须一致，否则，可能会导致设备不能正常启动。

相关配置可参考命令display boot-loader。

(2)        分布式IRF设备

boot-loader命令用来指定IRF中某个主控板的下次启动文件。

需要注意的是：

l              必须先将下次启动文件保存到相应成员设备某个主控板存储介质的根目录下，boot-loader命令才能执行成功。

l              全局主用主控板（Master设备的主用主控板）的存储介质直接用存储介质的名称表示，比如flash；全局备用主控板（IRF中全局主用主控板外的其它主控板）的存储介质需要使用chassischassis-number#slotslot-number#存储介质的名称，比如chassis2#slot1#flash。

l              设置全局主用主控板的下次启动文件时，file-url参数不能携带成员编号和单板编号，chassis-number参数指定为Master设备的成员编号，slot-number参数指定为全局主用主控板所在的槽位号；设置全局备用主控板的下次启动文件时，file-url参数必须携带该主控板所在设备的成员编号和单板的槽位号（形如chassis3#slot1#flash:/test.app），chassis-number和slot-number指定为设备的成员编号和单板所在的槽位号。

l              全局主用主控板和全局备用主控板的下次启动文件名称可以不同，但是版本最好一致，否则，可能会导致备用主控板不能加入IRF。

相关配置可参考命令display boot-loader。

【举例】

# 指定主用主控板（所在槽位为0）的主用下次启动文件为test.app（请先保证test.app已经存储在主用主控板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式设备）

<Sysname> boot-loader file test.app slot 0 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on slot 0!

# 指定备用主控板（所在槽位为1）的主用下次启动文件为test.app（请先保证test.app已经存储在备用主控板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式设备）

<Sysname> boot-loader file slot1#flash:/test.app slot 1 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on slot 1!

# 指定全局主用主控板（所在设备的成员编号为1，槽位号为0）的主用下次启动文件为test.app（请先保证test.app已经存储在该单板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式IRF设备）

<Sysname> boot-loader file test.app chassis 1 slot 0 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 1 slot 0!

# 指定全局备用主控板（所在设备的成员编号为1，槽位号为1）的主用下次启动文件为test.app（请先保证test.app已经存储在该单板的存储介质中，否则系统会提示错误，命令执行失败）。（分布式IRF设备）

<Sysname> boot-loader file chassis1#slot1#flash:/test.app chassis 1 slot 1 main

  This command will set the boot file of the specified board. Continue? [Y/N]:y

  The specified file will be used as the main boot file at the next reboot on chassis 1 slot 1!

1.1.2  bootrom

【命令】

分布式设备：

bootrom { backup | read | restore | update file file-url } slot slot-number-list  [ all | part ]

分布式IRF设备：

bootrom { backup | read | restore | update file file-url } chassis chassis-number slot slot-number-list [ all | part ]

【视图】

用户视图

【缺省级别】

3：管理级

【参数】

read：读取Bootrom，即将Bootrom程序从Bootrom存储器的Normal区读取到Flash中以作备份。当Bootrom存储器损坏，可以重新运行Flash上的Bootrom文件来恢复Bootrom。

restore：恢复Bootrom，即将Bootrom代码从Bootrom存储器的Backup区恢复到Normal区。如果当前的Bootrom被损坏，并且在损坏前备份了Bootrom，可以用restore操作来恢复Bootrom。backup：备份Bootrom，即将Bootrom代码从Bootrom存储器的Normal区备份到Backup区，以便Normal区损坏时，可以从Backup区恢复Bootrom程序。建议在升级Bootrom前备份Bootrom。

update file file-url：升级Bootrom，file-url表示用于升级的文件名，为1～63个字符的字符串。

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

chassis chassis-number：表示需要升级的设备在IRF中的成员编号。不指定该参数时，表示所有成员设备。（分布式IRF设备）

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

all：操作Bootrom的全部内容。不指定all和part参数时，默认使用all。

part：只操作Bootrom的扩展内容（Bootrom分两部分：常规部分和扩展部分，常规部分提供Bootrom的基本操作项，扩展部分提供更多的Bootrom操作项）。不指定all和part参数时，默认使用all。

【描述】

(1)        分布式设备

bootrom命令用来读取、恢复、备份或升级指定单板的Bootrom程序。

需要注意的是：

l              如果升级主控板，需要先将对应的Bootrom程序保存到该主控板存储介质的根目录下；如果升级业务板，需要先将对应的Bootrom程序保存到主用主控板存储介质的根目录下。

l              升级主用主控板、业务板的Bootrom程序时，file-url参数不能携带槽位号；升级备用主控板的Bootrom程序时，file-url参数需要携带该板的槽位号（形如slot1#flash:/test.btw）。

l              设备上各单板的Bootrom程序名称可以不同，但是版本必须兼容（是否兼容请查看Bootrom版本说明书），否则，可能会导致单板不能正常启动。

(2)        分布式IRF设备

bootrom命令用来读取、恢复、备份或升级指定成员设备上指定单板的Bootrom程序。

需要注意的是：

l              如果升级主控板，需要先将对应的Bootrom程序保存到该主控板存储介质的根目录下；如果升级业务板，需要先将对应的Bootrom程序保存到业务板所在成员设备的主用主控板存储介质的根目录下。

l              升级全局主用主控板以及Master上业务板的Bootrom程序时，file-url参数不能携带成员编号和单板的槽位号；升级IRF中其它主控板的Bootrom程序时， file-url参数必须携带该主控板所在设备的成员编号以及主控板所在的槽位号（形如chassis3#slot1#flash:/test.btw）；升级IRF中其它业务板的Bootrom程序时，file-url参数必须携带该单板所在设备的成员编号以及单板所在的槽位号（形如chassis3#slot5#flash:/test.btw）。

【举例】

# 使用a.btw文件升级主用主控板（所在槽位号为0）的Bootrom程序（本命令的显示信息请以设备的实际情况为准）。（分布式设备）

<Sysname> bootrom update file a.btw slot 0

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Attention:don't power down device, don't execute restart command such as slave

  switchover!!! 

  Bootrom update succeeded in slot 0.

# 使用a.btw文件升级备用主控板（所在槽位号为1）的Bootrom程序（本命令的显示信息请以设备的实际情况为准）。（分布式设备）

<Sysname> bootrom update file slot1#flash:/a.btw slot 1

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Attention:don't power down device, don't execute restart command such as slave

  switchover!!! 

  Bootrom update succeeded in slot 1.

# 使用a.btw文件升级全局主用主控板（所在设备的成员编号为1，槽位号为0）的Bootrom程序。（本命令的显示信息请以设备的实际情况为准）（分布式IRF设备）

<Sysname> bootrom update file a.btw chassis 1 slot 0

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Attention:don't power down device, don't execute restart command such as slave

  switchover!!! 

  Bootrom update succeeded in slot 0.

# 使用a.btw文件升级Master上业务板（所在设备的成员编号为1，槽位号为3）的Bootrom程序。（本命令的显示信息请以设备的实际情况为准）（分布式IRF设备）

<Sysname> bootrom update file a.btw chassis 1 slot 3

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Bootrom update succeed in chassis 1 slot 3.

# 使用a.btw文件升级全局备用主控板（所在设备的成员编号为1，槽位号为1）的Bootrom程序（本命令的显示信息请以设备的实际情况为准）。（分布式IRF设备）

<Sysname> bootrom update file chassis1#slot1#flash:/a.btw chassis 1 slot 1

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Bootrom update succeed in chassis 1 slot 1.

# 使用a.btw文件升级Slave设备业务板（所在设备的成员编号为2，槽位号为5）的Bootrom程序（本命令的显示信息请以设备的实际情况为准）。（分布式IRF设备）

<Sysname> bootrom update file chassis2#slot0#flash:/a.btw chassis 2 slot 5

  This command will update bootrom file on the specified board(s), Continue? [Y/N]:y

  Now updating bootrom, please wait...

  Start accessing bootflash chip...

  Bootrom update succeed in chassis 2 slot 5.

1.1.3  display boot-loader

【命令】

分布式设备：

display boot-loader [ slot slot-number ] [ | { begin | exclude | include } regular-expression ]

分布式IRF设备：

display boot-loader [ chassis chassis-number [ slot slot-number ] ] [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

2：系统级

【参数】

slot slot-number：显示指定单板的启动文件的信息。slot-number表示单板所在的槽位号。（分布式设备）

chassis chassis-number：显示指定成员设备的启动文件的信息。chassis-number表示设备在IRF中的成员编号。不使用该参数时，表示所有成员设备。（分布式IRF设备）

slot slot-number：显示指定单板的启动文件的信息。slot-number表示单板所在的槽位号。不使用该参数时，表示该成员设备的所有主控板。（分布式IRF设备）

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display boot-loader命令用来显示启动文件信息。

相关配置可参考命令boot-loader。

【举例】

# 显示本次启动和下次启动所采用的启动文件（本命令的显示信息请以设备的实际情况为准）。（分布式设备）

<Sysname> display boot-loader

  The primary app to boot of board 0 at this time is: flash:/test.app

  The primary app to boot of board 0 at next time is: flash:/test.app

  The slave app to boot of board 0 at next time is: flash:/test.app

  The primary app to boot of board 1 at this time is: flash:/test.app

  The primary app to boot of board 1 at next time is: flash:/test.app

  The slave app to boot of board 1 at next time is: flash:/test.app

表1-1 display boot-loader命令显示信息描述表（分布式设备）

字段	描述
The primary app to boot of board slot-number at this time is	单板（slot-number表示单板所在的槽位号）本次启动时使用的启动文件
The primary app to boot of board slot-number at next time is	单板（slot-number表示单板所在的槽位号）下次启动时使用的主用启动文件
The slave app to boot of board slot-number at next time is	单板（slot-number表示单板所在的槽位号）下次启动时使用的备用启动文件

 

# 显示本次启动和下次启动所采用的启动文件（本命令的显示信息请以设备的实际情况为准）。（分布式IRF设备）

<Sysname> display boot-loader

  The primary app to boot of chassis 1 board 0 at this time is: flash:/test.app

  The primary app to boot of chassis 1 board 0 at next time is: flash:/test.app

  The slave app to boot of chassis 1 board 0 at next time is: flash:/test.app

  The primary app to boot of chassis 2 board 0 at this time is: flash:/test.app

  The primary app to boot of chassis 2 board 0 at next time is: flash:/test.app

  The slave app to boot of chassis 2 board 0 at next time is: flash:/test.app

表1-2 display boot-loader命令显示信息描述表（分布式IRF设备）

字段	描述
The primary app to boot of chassis 1 board 0 at this time is	成员设备1上的0号单板本次启动时使用的启动文件
The primary app to boot of chassis 1 board 0 at next time is	成员设备1上的0号单板下次启动时使用的主用启动文件
The slave app to boot of chassis 1 board 0 at next time is	成员设备1上的0号单板下次启动时使用的备用启动文件

 

1.1.4  display patch

【命令】

display patch [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display patch命令用来显示当前安装的补丁文件和对应的补丁包的版本。如果不是从补丁包中加载补丁，则不显示补丁包版本。

【举例】

# 显示当前安装的补丁文件和补丁包版本（本命令的显示信息请以设备的实际情况为准）。（分布式设备）

<Sysname> display patch

The following patch packages are loaded:

flash:/ patch-package.app, Package-Version-001, loaded on slot(s):

0, 1, 2, 3, 4, 5,

# 显示当前安装的补丁文件和补丁包版本（本命令的显示信息请以设备的实际情况为准）。（分布式IRF设备）

<Sysname> display patch

The following patch packages are loaded:

flash:/ patch-package.app, Package-Version-001, loaded on slot(s):

Chassis 1, slot(s): 0

表1-3 display patch命令显示信息描述表

字段	描述
flash:/ patch-package.app	安装的补丁文件的路径
Package-Version-001	补丁包的版本
loaded on slot(s):	加载补丁的设备单板编号，如果单板上只有一个CPU，则直接显示slot-number，如果单板上有多个CPU，则主CPU显示为slot-number，辅助CPU显示为slot-number.cpu-id

 

1.1.5  display patch information

【命令】

display patch information [ | { begin | exclude | include } regular-expression ]

【视图】

任意视图

【缺省级别】

3：管理级

【参数】

|：使用正则表达式对显示信息进行过滤。有关正则表达式的详细介绍，请参见“基础配置指导”中的“CLI”。

begin：从包含指定正则表达式的行开始显示。

exclude：只显示不包含指定正则表达式的行。

include：只显示包含指定正则表达式的行。

regular-expression：表示正则表达式，为1～256个字符的字符串，区分大小写。

【描述】

display patch information命令用来显示热补丁的信息。

【举例】

# 显示热补丁的信息（本命令的显示信息请以设备的实际情况为准）。（分布式设备）

<Sysname> display patch information

The location of patches: flash:

Slot Version   Temporary Common Current Active Running  Start-Address

----------------------------------------------------------------------

0    MPU          0         0       0        0       0         0x84c94e60

3    LPU          0         0       0        0       0         0x8568c8f8

3.1  LPO          0         0       0        0       0         0x80a68e1c

4    LPU          0         0       0        0       0         0x8568c8f8

5    LPU          0         0       0        0       0         0x8568c8f8 

# 显示热补丁的信息（本命令的显示信息请以设备的实际情况为准）。（分布式IRF设备）

<Sysname> display patch information

The location of patches: flash:

Chassis Slot Version   Temporary Common Current Active Running  Start-Address

----------------------------------------------------------------------

1         0    MPU          0         0       0        0       0         0x84c94e60

1         3    LPU          0         0       0        0       0         0x8568c8f8

1         3.1  LPO          0         0       0        0       0         0x80a68e1c

1         4    LPU          0         0       0        0       0         0x8568c8f8

1         5    LPU          0         0       0        0       0         0x8568c8f8 

表1-4 display patch information命令显示信息描述表

字段	描述
The location of patches	补丁文件的加载路径，可以通过patch location命令设置
Chassis	设备的成员编号（分布式IRF设备）
Slot	单板所在的槽号，如果单板上只有一个CPU，则直接显示slot-number，如果单板上有多个CPU，则主CPU显示为slot-number，辅助CPU显示为slot-number.cpu-id（分布式设备）
Slot	单板所在的槽号，如果单板上只有一个CPU，则直接显示slot-number，如果单板上有多个CPU，则主CPU显示为slot-number，辅助CPU显示为slot-number.cpu-id（分布式IRF设备）
Version	补丁版本号
Temporary	临时补丁数目
Common	正式补丁数目
Current	当前补丁总数目
Running	处于运行状态的补丁数目
Active	处于激活状态的补丁数目
Start-Address	内存补丁区在内存中的起始地址

 

1.1.6  patch active

【命令】

分布式设备：

patch active [ patch-number ] slot slot-number

分布式IRF设备：

patch active [ patch-number ] chassis chassis-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：表示指定成员设备上的指定单板。（分布式IRF设备）

【描述】

patch active命令用来激活补丁，即临时运行已加载的补丁。

执行该命令时，如果指定补丁序号，则表示补丁序号之前（包括该序号）的所有处于未激活状态的补丁将被激活；如果不指定补丁序号，则表示当前所有处于未激活状态的补丁将全部被激活。

需要注意的是：

l              激活补丁前，必须先加载该补丁，否则，激活操作失败。

l              系统重启后，原处于激活状态的补丁会变成未激活状态，不再生效。如果想再次使用该补丁，需要再次激活。

【举例】

# 激活备用主控板（所在槽位号为1）上3号及3号之前已加载的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch active 3 slot 1

# 激活备用主控板（所在槽位号为1）上所有已加载的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch active slot 1

# 激活成员设备1的2号单板上的3号及3号之前已加载的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch active 3 chassis 1 slot 2

# 激活成员设备1的2号单板上所有已加载的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch active chassis 1 slot 2

1.1.7  patch deactive

【命令】

分布式设备：

patch deactive [ patch-number ] slot slot-number

分布式IRF设备：

patch deactive [ patch-number ] chassis chassis-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：表示指定成员设备上的指定单板。（分布式IRF设备）

【描述】

patch deactive命令用来停止运行补丁，恢复原版本软件的运行。

执行该命令时，如果指定补丁序号，则表示在此补丁序号之后（包括该序号）处于激活状态的补丁将全部进入未激活状态；如果不指定补丁序号，则表示当前所有处于激活状态的补丁将全部进入未激活状态。

对于处于运行状态的补丁，本命令无效。

【举例】

# 停止运行备用主控板（所在槽位号为1）上3号及3号之后的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch deactive 3 slot 1

# 停止运行备用主控板（所在槽位号为1）上所有已激活的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch deactive slot 1

# 停止运行成员设备1的5号单板上的3号及3号之后的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch deactive 3 chassis 1 slot 5

# 停止运行成员设备1的5号单板上的所有已激活的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch deactive chassis 1 slot 5

1.1.8  patch delete

【命令】

分布式设备：

patch delete [ patch-number ] slot slot-number

分布式IRF设备：

patch delete [ patch-number ] chassis chassis-number slot slot-number

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：表示指定成员设备上的指定单板。（分布式IRF设备）

【描述】

patch delete命令用来将补丁从内存补丁区中删除。

执行该命令时，如果指定补丁序号，则表示补丁序号之后（包括该序号）的所有补丁将被删除；如果不指定补丁序号，则表示内存补丁区中的所有补丁将被删除。

执行该命令，只是将补丁从内存补丁区中删除，并不会将补丁从存储介质中删除，补丁回到初始状态（IDLE）。

【举例】

# 删除备用主控板（所在槽位号为1）上3号及3号之后的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch delete 3 slot 1

# 删除备用主控板（所在槽位号为1）上所有补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch delete slot 1

# 删除成员设备1的5号单板上的3号及3号之后的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch delete 3 chassis 1 slot 5

# 删除成员设备1的5号单板上的所有补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch delete chassis 1 slot 5

1.1.9  patch install

【命令】

patch install { patch-location | file filename }

undo patch install

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式为存储介质的根目录。该参数用于安装没有经过打包的补丁文件，补丁文件的名称必须符合要求，否则系统会因无法识别文件名而造成补丁操作失败。

file filename：表示补丁包文件的名称。该参数用于安装补丁包文件，补丁包是指打包的补丁文件，该文件中存放了相同版本不同类型的补丁文件。

【描述】

patch install命令用来一步式完成补丁的安装。undo patch install命令用来卸载补丁。

在执行patch install命令时，系统会提示“Do you want to continue running patches after reboot? [Y/N]:”，

l              如果输入<Y>或者<y>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁继续生效，补丁状态从IDLE转换到RUNNING。相当于依次执行了patch location、patch load、patch active和patch run命令。

l              如果输入<N>或者<n>，则会安装指定路径下的所有补丁，设备或单板重启后这些补丁不再继续生效，补丁状态从IDLE转换到ACTIVE。相当于依次执行了patch location、patch load和patch active命令。

执行该命令前，需要将补丁文件保存到指定路径：

如果要从补丁包中安装补丁，则可以将补丁包保存在主用主控板的任意路径下，否则请将主用主控板和业务板的补丁文件保存到主用主控板Flash的根目录下，备用主控板的补丁文件保存到备用主控板Flash的根目录下。（分布式设备）

执行补丁安装操作后，系统会将补丁文件的加载路径修改成“patch install patch-location”中patch-location参数所指向的位置。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。如果执行patch install file filename命令，则系统不会改变加载路径。

【举例】

# 加载Flash上的补丁文件，并且要求设备重启后补丁继续生效（本命令的显示信息请以实际情况为准）。

<Sysname> system-view

[Sysname] patch install flash:

Patches will be installed. Continue? [Y/N]:y

Do you want to run patches after reboot? [Y/N]:y

Installing patches…

# 加载补丁文件包，并且要求设备重启后补丁继续生效（本命令的显示信息请以实际情况为准）。

<Sysname> system-view

[Sysname] patch install file:/patch_packeg.app

Patches will be installed. Continue? [Y/N]:y

Do you want to run patches after reboot? [Y/N]:y

Installing patches…

1.1.10  patch load

【命令】

分布式设备：

patch load slot slot-number [ file filename ]

分布式IRF设备：

patch load chassis chassis-number slot slot-number [ file filename ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：表示指定成员设备上的指定单板。（分布式IRF设备）

file filename：表示补丁包文件的名称。

【描述】

patch load命令用来将补丁文件从Flash加载到内存补丁区中。

如果指定了补丁包文件，则表示系统从补丁包中加载补丁；如果未指定补丁包文件，则表示从补丁文件中加载补丁，系统默认会从Flash中读取补并加载补丁文件。

执行该命令前，需要将补丁文件保存到指定路径：

l              如果要从补丁包中加载补丁，则可以将补丁包文件保存在主用主控板的任意路径下，否则，请将主用主控板和业务板的补丁文件保存到主用主控板Flash的根目录下，备用主控板的补丁文件保存到备用主控板Flash的根目录下。（分布式设备）

l              如果要从补丁包中加载补丁，则可以将补丁包文件保存在全局主用主控板的任意路径下，否则请将补丁文件保存到所有成员设备存储介质的根目录下。各成员设备主用主控板和业务板的补丁文件保存到本设备主用主控板Flash的根目录下，备用主控板的补丁文件保存到本设备备用主控板Flash的根目录下。（分布式IRF设备）

【举例】

# 从补丁文件中为备用主控板（所在槽位号为1）加载补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch load slot 1

# 从补丁包中为备用主控板（所在槽位号为1）加载补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch load slot 1 file flash:/patchpackege.app

# 从补丁文件中为成员设备1的3号单板加载补丁文件。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch load chassis 1 slot 3

# 从补丁包中为成员设备1的3号单板加载补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch load chassis 1 slot 3 file flash:/patchpackege.app

1.1.11  patch location

【命令】

patch location patch-location

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-location：表示补丁文件所在的路径，为1～64个字符的字符串，格式通常为存储介质的根目录。

【描述】

patch location命令用来设置补丁文件的加载路径。

缺省情况下，补丁文件的加载路径为flash:。

如果是要安装补丁包，则也无需配置该命令。

需要注意的是，执行patch install命令会修改补丁文件的加载路径。比如，先配置了patch location xxx，再执行patch install yyy，此时系统会自动将补丁文件的加载路径从xxx改为yyy。如果执行patch install命令的同时指定了具体的补丁包文件，则不会改变补丁文件的加载路径。

【举例】

# 设置补丁文件加载路径为Flash的根目录。

<Sysname> system-view

[Sysname] patch location flash:

1.1.12  patch run

【命令】

分布式设备：

patch run [ patch-number ] [ slot slot-number ]

分布式IRF设备：

patch run [ patch-number ] [ chassis chassis-number slot slot-number ]

【视图】

系统视图

【缺省级别】

3：管理级

【参数】

patch-number：补丁序号。该参数的有效值与使用的补丁文件有关，请以实际情况为准。

slot slot-number：表示单板所在的槽位号。（分布式设备）

chassis chassis-number slot slot-number：表示指定成员设备上的指定单板。（分布式IRF设备）

【描述】

patch run命令用来确认运行补丁，即确认激活状态的补丁进入运行状态。

执行该命令时，如果指定补丁序号，则表示确认运行补丁序号之前（包括该序号）的所有已激活的补丁；如果不指定补丁序号，则表示确认运行当前系统中所有已激活的补丁。

l              如果指定slot参数，则确认运行该单板上的所有补丁（包括辅助CPU的补丁）；如果不指定slot参数，表示确认运行所有单板上的所有补丁。（分布式设备）

l              如果指定chassis和slot参数，则确认运行某成员设备指定单板上的所有补丁（包括辅助CPU的补丁）；如果不指定chassis和slot参数，表示确认运行IRF中所有单板上的所有补丁。（分布式IRF设备）

该命令只对处于激活状态的补丁有效，对于处于其它状态的补丁，该命令无效。

确认运行的补丁，在系统重启后，会继续生效。

【举例】

# 确认运行备用主控板（所在槽位号为1）上3号及3号之前的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch run 3 slot 1

# 确认运行备用主控板（所在槽位号为1）上所有已激活的补丁。（分布式设备）

<Sysname> system-view

[Sysname] patch run slot 1

# 确认运行成员设备1的5号单板上的3号及3号之前的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch run 3 chassis 1 slot 5

# 确认运行成员设备1的5号单板上的所有已激活的补丁。（分布式IRF设备）

<Sysname> system-view

[Sysname] patch run chassis 1 slot 5