| 命令 | 作用 |
| check version | 查看各设备版本匹配情况 |
| clear install storage | 清除所有非当前运行的补丁包及对应数据库信息 |
| install activate | 临时激活补丁，使补丁生效 |
| install add | 下载补丁包，并将补丁信息加入数据库 |
| install auto-sync | 配置设备是否开启补丁自动同步功能，仅对配置成功后新接入的设备有效 |
| install commit | 永久激活补丁，使补丁在设备重启后依然生效 |
| install deactivate | 使补丁回退到未激活状态 |
| install remove | 清除未激活的补丁包，并将补丁信息从数据库删除 |
| patch active | 激活功能组件安装包 |
| patch auto-running | 激活补丁并使其自动永久生效，即使补丁在设备上生效，且重启后依然生效 |
| patch autoload | 一键下载补丁包，将补丁信息加入数据库并永久激活补丁，使补丁在设备重启后依然生效 |
| patch deactive | 使补丁回退到未激活状态 |
| patch delete | 清除未激活的补丁包，并将补丁信息从数据库删除 |
| patch running | 永久激活补丁，使补丁在设备重启后依然生效 |
| show hotpatch all patch | 查看当前设备函数补丁信息 |
| show hotpatch all process | 查看当前设备所有函数补丁注册进程信息 |
| show install | 查看多补丁方案中，设备中已安装的补丁包的相关信息 |
| show install auto-sync | 查看当前设备所有需要自动同步的补丁包 |
| show patch | 查看单补丁方案中，设备中已安装的补丁包的相关信息 |
| show patch auto-sync | 查看设备所有需要自动同步的补丁包信息 |
| show upgrade auto-sync | 查看设备中自动同步升级的相关配置 |
| show upgrade file | 查看存放在设备文件系统中的安装包文件信息 |
| show upgrade history | 查看升级历史信息 |
| show upgrade status | 查看设备各板卡的升级状态以及补丁包的安装状态 |
| upgrade | 安装，升级本地文件系统内安装包 |
| upgrade auto-sync package | 配置设备系统的自动同步升级的检查范围 |
| upgrade auto-sync policy | 配置系统的自动同步策略 |
| upgrade auto-sync range | 配置系统的自动同步升级的范围 |
| upgrade boot | 升级设备上所有的Uboot与Rboot |
| upgrade download patch-active | 下载补丁包，将补丁信息加入数据库并临时激活补丁，使补丁生效 |
| upgrade download patch-running | 下载补丁包，将补丁信息加入数据库并永久激活补丁，使补丁生效 |
| upgrade hot | 热升级设备上的CPLD |
| upgrade mcu | 升级mcu器件 |
| upgrade server | 配置系统的版本自动同步服务功能 |
| upgrade sync-server | 配置系统的版本自动同步服务功能 |
| upgrade fiber-firmware | 光模块固件升级命令 |
| show upgrade fiber-module-status | 查看光模块固件升级状态 |
1.1 check version
【命令功能】
check version命令用来查看各设备版本匹配情况。
【命令格式】
check version
【参数说明】
无
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
无
【配置举例】
# 查看系统各设备版本匹配情况。
Hostname> enable
Hostname# check version
Dev Slot State
--- ---- ------------
1 2 Compatible
1 4 Compatible
1 FE6 Compatible
1 M1 Compatible
表1-1 check version命令输出信息描述表
| 字段 | 描述 |
| Dev | 设备 |
| Slot | 单板 |
| State | 状态，Compatible表示设备与版本匹配 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.2 clear install storage
注意
本命令请慎用，因为执行后所有补丁将无法回退。
【命令功能】
clear install storage命令用来清除所有非当前运行的补丁包及对应数据库信息。
【命令格式】
clear install storage [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令可以清除所有非当前运行的补丁包，并将补丁信息从数据库删除，且要注意执行完该条命令后，所有已安装的补丁无法再进行解激活操作。
【配置举例】
# 清除设备所有的版本或者模块上的补丁包。
Hostname> enable
Hostname# clear install storage
Running this command will cause system fail to deactivate. continue?[Y/N]y
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 清除设备上指定的slot 1/0槽位上的补丁包。
Hostname> enable
Hostname# clear install storage slot 1/0
Running this command will cause system fail to deactivate. continue?[Y/N]y
< The terminal is lock >
Operating, please wait for a moment..
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-2 clear install storage命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 清除操作执行中 |
| Patch operation finish! | 补丁清除操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：清除成功 ● Fail：清除失败 ● Skip：忽略清除 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.3 install activate
【命令功能】
install activate命令用来临时激活补丁，使补丁生效。
【命令格式】
install activate package-name [ slot slot-id | slot all ]
【参数说明】
package-name：待激活补丁包文件名。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令支持功能组件安装包的激活。
只有处于安装状态的补丁才允许执行激活操作。
如果激活成功后，但是补丁包却没有生效，一般是当前补丁包中的各个组件版本低于或等于当前设备正在运行的组件版本，属于正常情况。
如果设备上的补丁激活成功后，但未确认过，那么设备重启后，该补丁包会被回退，所以激活某一个补丁包后如果确认问题已经解决，请及时执行install commit命令操作。
【配置举例】
# 临时激活补丁，使补丁生效。
Hostname> enable
Hostname# install activate smu_rf_hot1002_0118.bin
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 临时激活指定槽位slot 1/0上的补丁，使补丁生效。
Hostname# install activate smu_rf_hot1002_0118.bin slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-3 install activate命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 激活操作执行中 |
| Patch operation finish! | 补丁激活操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：激活成功 ● Fail：激活失败 ● Skip：忽略激活 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 组件包文件不存在或输入的补丁文件名设备不支持，则提示以下错误信息：
Package maybe not exist, please check!
# 当补丁包文件损坏，校验失败时，则提示以下错误信息：
Package verify fail, please check!
# 当被依赖的组件未安装时，则提示以下错误信息：
Package depends not satisfy!
# 当设备空间不足时，则提示以下错误信息：
No space left on device!
# 当补丁包已经被激活过时，则提示以下错误信息：
Package has been activated, no need activate again!
# 当补丁包错误时，则提示以下错误信息：
Install package error!
# 补丁包版本相同或者过低，无法生效，则提示以下错误信息：
Version is lower or same, it doesn't take effect
# 补丁在设备上已经激活，不会再激活，且会删除该补丁包，并提示以下信息：
All components have been activated on device, no activate again!
【常见错误】
无
【平台说明】
无
【相关命令】
1.4 install add
【命令功能】
install add命令用来下载补丁包，并将补丁信息加入数据库。
【命令格式】
install add url [ slot slot-id | slot all ]
【参数说明】
url：url为下载补丁包的方法，可以是Flash、TFTP、FTP和HTTP等下载方式。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令用于将补丁包拷贝到目标位置并将其添加到数据库中。
【配置举例】
# 下载设备上所有的版本或者模块的补丁包，并将补丁信息加入数据库。
Hostname> enable
Hostname# install add tftp//192.1.1.1/smu_rf_hot1002_0118.bin
< The terminal is lock >
Press Ctrl+C to quit
!
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 下载补丁包到设备上指定的slot 1/0槽位上，并将补丁信息加入数据库。
Hostname# install add tftp//192.1.1.1/smu_rf_hot1002_0118.bin slot 1/0
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-4 install add命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 下载操作执行中 |
| Patch operation finish! | 补丁下载操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：下载成功 ● Fail：下载失败 ● Skip：忽略下载 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
l 执行完该条命令可以使用show install命令查看到相应的补丁信息，且状态为installed，则为add成功。
l 命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 对于已经安装成功的补丁包，如果再次安装，则提示以下错误信息：
This package already add, don't need to add again!
# 当安装补丁包，空间不足时，则提示以下错误信息：
No space left on device!
# 当补丁包与设备不匹配时，则提示以下错误信息：
Package architecture not match!
# 当设备不满足补丁包安装条件时，则提示以下错误信息：
Package depends not satisfy!
# 设备查询补丁包信息失败时
Get database error!
# 补丁包之前被clear过，则不允许再次安装
This package is already cleared, don't allow add again!
# 补丁包已经被active，则不允许再次安装
This package is already activated, don't need to add again!
# 补丁包已经被commit，则不允许再次安装
This package is already running, don't need to add again!
# 机箱式设备，线卡下载补丁包失败时，升级失败，提示以下信息
Download error!
# 命令执行过程中，检验补丁信息，过滤重复补丁时出错，则提示以下信息
Filter package error!
# 机箱式设备，线卡下载补丁包失败时，升级失败，提示以下信息
Download error!
# 命令执行过程数据库添加失败，提示以下信息
Insert database error!
# 命令执行过程数据库更新失败，提示以下信息
Update database error!
或
Update state error!
# 命令执行过程补丁包的组件版本号检验失败，提示以下信息
Package version is inconsistent!
# 命令执行过程补丁包的组件基线检验失败，提示以下信息
It may not need to be running on this device!
# 命令执行过程补丁包的cpu基线检验失败，提示以下信息
Cpu baseline is different!
# 命令执行过程补丁包的目标设备（一般由Serial+Card_type指定）检验失败，提示以下信息
It is not target device of the packages!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
# 命令执行过程检查补丁包的版本号，发现版本号为空，升级会有下面的提示
Patch version is null, please check!
# 命令执行过程获取数据库中已经升级的补丁信息，获取失败，升级会有下面的提示
Get database error, please check!
# 命令执行过程发现设备还有未running的补丁，升级会有下面的提示
There is a patch on device that has not been running!
# 命令执行过程发现补丁版本低于设备运行版本，或与设备运行版本一致，升级会有下面的提示
Patch version is lower or same, not allow add!
# 叠加补丁升级时，程序自动清理旧的补丁包，清理旧补丁包失败时，会有下面的提示
Error deleting older patches, please check!
【常见错误】
无
【平台说明】
无
【相关命令】
1.5 install auto-sync
【命令功能】
install auto-sync命令用来配置设备是否开启补丁自动同步功能，仅对配置成功后新接入的设备有效。
缺省情况下，开启补丁自动同步功能处于开启状态。
【命令格式】
install auto-sync [ enable | disable ]
【参数说明】
enable：开启补丁自动同步。
disable：关闭补丁自动同步。
【命令模式】
全局配置模式
【缺省级别】
15
【使用指导】
建议使用系统缺省配置。
【配置举例】
# 关闭补丁自动同步。
Hostname> enable
Hostname# configure terminal
Hostname(config)# install auto-sync disable
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
1.6 install commit
【命令功能】
install commit命令用来永久激活补丁，使补丁在设备重启后依然生效。
【命令格式】
install commit [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
只有处于激活状态的补丁可以执行永久激活操作。
在补丁永久激活前，如果设备发生异常复位，补丁将自动回退。
只有执行过install commit命令的补丁包才会永久生效，否则设备重启后，已激活的补丁包会被自动回退。
【配置举例】
# 永久激活补丁，使补丁在设备重启后依然生效。
Hostname> enable
Hostname# install commit
< The terminal is lock >
Operating, please wait for a momen
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 永久激活指定slot1/0槽位上的补丁，使补丁在设备重启后依然生效。
Hostname# install commit slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-5 install commit命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 激活操作执行中 |
| Patch operation finish! | 补丁激活操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：激活成功 ● Fail：激活失败 ● Skip：忽略激活 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当前不存在“Active”状态的补丁，执行install commit时会有以下提示：
There are no active state on the device, no need running!
# 当前设备未安装过任何补丁时，执行本命令会有以下提示：
No package in device, not need commit!
【常见错误】
无
【平台说明】
无
【相关命令】
1.7 install deactivate
【命令功能】
install deactivate命令用来使补丁回退到未激活状态。
【命令格式】
install deactivate package-name [ slot slot-id | slot all ]
【参数说明】
package-name：补丁包文件名。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
无
【配置举例】
# 使补丁回退到未激活状态。
Hostname> enable
Hostname# install deactivate smu_rf_hot1002_0118.bin slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 使指定槽位slot1/0上的补丁回退到未激活状态。
Hostname# install deactivate smu_rf_hot1002_0118.bin slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
Slot Result Comment
1/0 Success None
表1-6 < The terminal is unlock > install deactivate命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 补丁退回未激活状态操作执行中 |
| Patch operation finish! | 补丁退回未激活状态操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：退回成功 ● Fail：退回失败 ● Skip：忽略退回 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当组件包文件不存在、输入的补丁文件名设备不支持、补丁包未安装时，均有如下提示信息：
Package maybe not exist, please check!
# 解激活一个未激活过的补丁包，会有下面的提示，需要先激活后才允许解激活。
Package is not activate or running, not allow deactivate!
# 当设备空间不足时有如下提示信息：
No space left on device!
【常见错误】
无
【平台说明】
无
【相关命令】
1.8 install remove
【命令功能】
install remove命令用来清除未激活的补丁包，并将补丁信息从数据库删除。
【命令格式】
install remove package-name [ slot slot-id | slot all ]
【参数说明】
package-name：待删除补丁包文件名。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
无
【配置举例】
# 清除设备上未激活的补丁包，并将补丁包信息从数据库中删除。
Hostname> enable
Hostname# install remove smu_rf_hot1002_0118.bin
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 清除设备上指定槽位slot 1/0上未激活的补丁包，并将补丁包信息从数据库中删除。
Hostname# install remove smu_rf_hot1002_0118.bin slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-7 install remove命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 清除操作执行中 |
| Patch operation finish! | 补丁清除操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：清除成功 ● Fail：清除失败 ● Skip：忽略清除 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 处于激活或确认状态的补丁不允许执行Remove，否则会有下面提示：
Active or running state not allow remove!
# 补丁未安装过，执行Remove时会有提示：
Package is not exist, please check!
【常见错误】
无
【平台说明】
无
【相关命令】
1.9 patch active
【命令功能】
patch active命令用来激活功能组件安装包。
【命令格式】
patch active [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令支持功能组件安装包的激活。只有处于安装状态的补丁，才允许执行激活操作。
如果激活成功后，补丁包却没有生效，一般是当前补丁包中的各个组件版本低于或等于当前设备正在运行的组件版本，属于正常情况。
如果设备上的补丁激活成功后，但未确认过，那么设备重启后，该补丁包会被回退，所以激活某一个补丁包后如果确认问题已经解决，请及时执行patch running命令。
【配置举例】
# 激活设备上的功能组件安装包。
Hostname> enable
Hostname# patch active
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
表1-8 patch active命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 激活操作执行中 |
| Patch operation finish! | 补丁激活操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：激活成功 ● Fail：激活失败 ● Skip：忽略激活 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
# 当组件包文件不存在或输入的补丁文件名设备不支持时，则提示以下错误信息。
Package maybe not exist, please check!
# 当补丁包文件损坏，校验失败时，则提示以下错误信息。
Package verify fail, please check!
# 当被依赖的组件未安装时，则提示以下错误信息。
Package depends not satisfy!
# 当设备空间不足时，则提示以下错误信息。
No space left on device!
# 当补丁包已经被激活过时，则提示以下错误信息。
Package has been activated, no need activate again!
# 当补丁包错误时，则提示以下错误信息。
Install package error!
# 补丁包版本相同或者过低，无法生效，提示以下信息。
Version is lower or same, it doesn't take effect
# 该补丁在设备上已经激活，不会再激活，且会删除该补丁包，并提示以下信息。
All components have been activated on device, no activate again!
# 补丁包架构与设备不匹配
Package architecture not match!
# 设备查询补丁包信息失败时
Get database error!
# 补丁包之前被clear过，则不允许再次安装
This package is already cleared, don't allow add again!
# 补丁包已经被active，则不允许再次安装
This package is already activated, don't need to add again!
# 补丁包已经被commit，则不允许再次安装
This package is already running, don't need to add again!
# 补丁包install所需的空间计算失败，提示以下信息
Get package size error!
# 补丁包active前备份旧版本失败，提示以下信息
Backup package error!
# 判断补丁包Active是否需要reboot重启设备，判断过程出错，提示以下信息
Judge reboot error!
# 补丁包Active过程解注册ham等操作失败，提示以下信息
Install package error!
# 补丁包Active过程更新组件的flag数据库状态失败，提示以下信息
Update current flag error!
# 补丁包Active过程更新补丁包的数据库状态失败，提示以下信息
Update active state error!
# 补丁包Active过程中检查是否强制升级，检查过程出错，提示以下信息
Version check error!
# 补丁包active过程失败，回退到旧版本时出错，提示以下信息
Return to previous version error!
# 命令执行过程补丁包的组件基线检验失败，提示以下信息
It may not need to be running on this device!
# patch active命令执行过程发现补丁包状态还是INIT，提示以下信息
Package has not been added yet!
# 补丁包中的补丁目标组件不在设备基线版本中，提示以下信息
It may not need to be running on this device!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
# 命令执行过程中发现补丁包的补丁名称为空，升级会有下面的提示
There are no patches to activate!
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.10 patch auto-running
【命令功能】
patch auto-running命令用来激活补丁并使其自动永久生效，即使补丁在设备上生效，且重启后依然生效。
【命令格式】
patch auto-running [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
只有处于待激活状态的补丁可以执行本命令。
执行本命令并确认生效后，即使设备重启补丁也不会回退。
【配置举例】
# 激活补丁并使其永久生效。
Hostname> enable
Hostname# patch auto-running
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 激活指定槽位slot1/0上的补丁并使其永久生效。
Hostname> enable
Hostname# patch auto-running slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-9 patch auto-running命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 激活补丁并永久生效操作执行中 |
| Patch operation finish! | 激活补丁并永久生效完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：成功激活补丁并永久生效 ● Fail：激活补丁并永久生效失败 ● Skip：忽略激活补丁并永久生效操作 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当前不存在“Active”状态的补丁，执行install commit时会有下面的提示。
There are no active state on the device, no need running!
# 当前设备未安装过任何补丁时，执行本命令会有下面的提示。
No
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.11 patch autoload
【命令功能】
patch autoload命令用来一键下载补丁包，将补丁信息加入数据库并永久激活补丁，使补丁在设备重启后依然生效。
【命令格式】
patch autoload url
【参数说明】
url：下载补丁包的路径，可以是flash:、TFTP、FTP、HTTP等下载方式
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
该命令用于将补丁包一键永久激活，使补丁生效，补丁在设备重启后依然生效。
注意
本命令不支持冷补丁包。
【配置举例】
# 配置一键下载在TFTP服务器上的补丁并永久激活。
Hostname> enable
Hostname#patch autoload tftp://10.20.189.189/SP1.bin
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Operate finish!
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
< The terminal is unlock >
【提示信息】
无
【常见错误】
命令执行错误时，Result为Fail或Skip，Comment注释信息如下所述：
# 对于已经安装成功的补丁包，不允许再次安装
This package is already added, don't need to add again!
# 补丁包与设备不匹配
Package architecture not match!
# 设备不满足补丁包安装条件
Package depends not satisfy!
# 补丁包错误
Install package error!
# 补丁包文件损坏，校验失败
Package verify fail, please check!
# 组件补丁的目标组件，如果已经升级过函数补丁，则会有下面的提示
Unable to patch the component as the function has been patched!
# 当前补丁包没有叠加包含上一个补丁包的所有补丁信息时，会有下面的提示
The patch package does not contain the activated patch!
# 补丁包有函数补丁，但是函数补丁的目标组件有组件补丁，升级会有下面的提示
Target process has been patched, please deactive the previous patch
# 补丁包有函数补丁，但是函数补丁的基线与设备运行版本不一致，升级会有下面的提示
Target process baseline error!
# 补丁包中的函数补丁格式不对，升级会有下面的提示
Hotpatch config error
# 准备升级补丁时，设备的CPU、内存水线过高，则不允许补丁操作，会有下面的提示
Memory and cpu exceeds the water mark!
或者
Cpu exceeds the water mark!
或者
Memory exceeds the water mark!
# 补丁包中的补丁个数过多，升级会有下面的提示
There are too many deb files in the patch!
# 补丁包是冷补丁时，则不支持patch autoload，升级会有下面的提示
It doesn't support to autoload cold patch!
# 补丁包升级过程，业务出现异常，升级会有下面的提示
Operation interrupt, please check!
# 补丁安装前检查设备空间，判断空间不足，升级会有下面的提示
No space left on data!
或者
Maybe no enough space!
# 补丁包中补丁版本低于设备运行版本，或者与设备运行版本一致，升级会有下面的提示
Patch version is lower or same, not allow add!
# 补丁升级过程中内存申请失败，升级会有下面的提示
Maybe out of memory!
# 叠加补丁升级时，程序自动清理旧的补丁包，清理旧补丁包失败时，会有下面的提示
Error deleting older patches, please check!
# 补丁升级过程中补丁版本低于设备运行版本，或与设备运行版本一致，升级会有下面的提示
Version is lower or same, it doesn't take effect!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
# 命令执行过程检查补丁包的版本号，发现版本号为空，升级会有下面的提示
Patch version is null, please check!
# 命令执行过程获取数据库中已经升级的补丁信息，获取失败，升级会有下面的提示
Get database error, please check!
# 命令执行过程发现设备还有未running的补丁，升级会有下面的提示
There is a patch on device that has not been running!
# 命令执行过程获取补丁的设备路径信息失败，升级会有下面的提示
Unknown error, please check!
【平台说明】
无
【相关命令】
无
1.12 patch deactive
【命令功能】
patch deactive命令用来使补丁回退到未激活状态。
【命令格式】
patch deactive [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令未带参数时，表示删除设备上所有设备成员的未激活的补丁包及数据库信息。
【配置举例】
# 使补丁回退到未激活状态。
Hostname> enable
Hostname# patch deactive
< The terminal is lock >
Hostname> enable
Hostname# patch auto-running
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
Patch operation finish!
Operate result information:
-------------------------------------
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 将指定槽位slot1/0上的补丁回退到未激活状态。
Hostname> enable
Hostname# patch deactive slot 1/0
< The terminal is lock >
Hostname> enable
Hostname# patch auto-running
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
Patch operation finish!
Operate result information:
-------------------------------------
1/0 Success None
< The terminal is unlock >
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当组件包文件不存在、输入的补丁文件名设备不支持、补丁包未安装，均会提示下面信息。
Package maybe not exist, please check!
# 当解激活一个未激活过的补丁包，会有下面的提示，需要先激活后才允许解激活。
Package is not activate or running, not allow deactivate!
# 当设备空间不足当时有如下信息。
No space left on device!
补丁包的补丁个数太多，提示以下信息
The package is too big, please check!
# 数据库中查询补丁包信息失败，提示以下信息
Get database error!
# 数据库中不存在补丁包相关信息，提示以下信息
No package on the device, no need deactivate!
# 补丁包之前被clear过，提示以下信息
Package has been cleared, not allow deactivate!
# 补丁包Deactive前检查设备中补丁相关信息及组件状态，检查失败，提示以下信息
Package check error!
# 补丁包Deactive前获取备份的旧版本组件包信息失败，提示以下信息
Get backup package error!
# 补丁包Deactive过程判断是否需要重启，判断过程出现异常，提示以下信息
Judge reboot error!
# 补丁包Deactive过程，对每个补丁组件处理deactive，处理失败，提示以下信息
Deactivate package error!
# 补丁包Deactive过程，更新数据库补丁包状态失败，提示以下信息
Update package state error!
# 补丁包Deactive过程，更新数据库补丁包状态失败，提示以下信息
Update package state error!
# 补丁包Deactive过程，获取设备可用空间信息失败，提示以下信息
Get space error!
# 补丁包Deactive过程，如果是非基线组件，则会卸载，如果卸载失败，提示以下信息
Remove package error!
或者
Other packages depend it!
# 补丁包Deactive过程，更新数据库标志失败，提示以下信息
Update current flag error!
# 补丁包Deactive过程，获取当前设备组件版本信息失败，提示以下信息
Get current version error!
# patch deactive命令执行过程补丁包的组件基线检验失败，提示以下信息
It may not need to be running on this device!
# 补丁包中的补丁目标组件不在设备基线版本中，提示以下信息
It may not need to be running on this device!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
# 命令执行过程中发现补丁包的补丁名称为空，升级会有下面的提示
There are no patches that need to be deactivated!
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.13 patch delete
【命令功能】
patch delete命令用来清除未激活的补丁包，并将补丁信息从数据库删除。
【命令格式】
patch delete [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令未带参数时，删除设备上所有设备成员的未激活的补丁包及数据库信息。
【配置举例】
# 清除未激活的补丁包，并将补丁信息从数据库删除。
Hostname> enable
Hostname# patch delete
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 清除指定槽位slot1/0上未激活的补丁包，并将补丁信息从数据库删除。
Hostname> enable
Hostname# patch delete slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-10patch delete命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 清除操作执行中 |
| Patch operation finish! | 补丁清除操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：清除成功 ● Fail：清除失败 ● Skip：忽略清除 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当处于激活或确认状态的补丁不允许Remove，否则会有下面提示。
Active or running state not allow remove!
# 补丁未安装过，执行Remove时会有提示。
Package is not exist, please check!
# 补丁包的补丁个数太多，提示以下信息
Receive data maybe error!
# 数据库中获取补丁包信息失败，提示以下信息
Get database error!
# 当前设备不存在install状态的补丁包，提示以下信息
No package on the device, no need remove!
# 补丁包delete过程，更新数据库状态失败，提示以下信息
Update state error!
# 补丁包delete过程，删除数据库记录失败，提示以下信息
Delete record from the database error!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.14 patch running
【命令功能】
patch running命令用来永久激活补丁，使补丁在设备重启后依然生效。
【命令格式】
patch running [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
只有处于激活状态的补丁可以执行永久激活操作。
当补丁处于未永久激活状态时，如果设备发生异常复位，补丁将自动回退。
执行过patch running命令的补丁包才会永久生效，否则设备重启后，已激活的补丁包会被自动回退。
【配置举例】
# 永久激活补丁，使补丁在设备重启后依然生效。
Hostname> enable
Hostname# patch running
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
2/0 Success None
< The terminal is unlock >
# 永久激活指定槽位slot1/0上的补丁，使补丁在设备重启后依然生效。
Hostname> enable
Hostname# patch running slot 1/0
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
1/0 Success None
< The terminal is unlock >
表1-11patch running命令输出信息描述表
| 字段 | 描述 |
| Operating, please wait for a moment | 永久激活补丁操作执行中 |
| Patch operation finish! | 补丁永久激活操作完成 |
| Operate result information | 运行结果信息 |
| Slot | 槽位号 |
| Result | 运行结果，该字段可能的取值如下
● Success：永久激活成功 ● Fail：永久激活失败 ● Skip：忽略永久激活 |
| Comment | Comment注释信息
● Result为Success时，该字段取值为None，表示无注释信息 ● Result为Skip或Fail时，该字段显示对应的失败原因 |
【提示信息】
命令执行错误时，格式跟上面命令指导一样，就是Result会是Fail或Skip，Comment注释信息如下所述：
# 当前不存在“Active”状态的补丁，执行patch running时会有下面的提示：
There are no active state on the device, no need running!
# 当前设备未安装过任何补丁时，执行本命令会有以下的提示：
No package in device, not need running!
# 补丁包running过程中，从数据库中查询不到补丁信息，会有下面的提示
Get package state error!
# 补丁包running过程中，更新数据库补丁包状态失败，会有下面的提示
Update package state error!
# 补丁包running过程中，更新数据库补丁包所有补丁状态失败，会有下面的提示
Package running error!
# 命令执行过程中业务进程出现异常，升级会有下面的提示
Operation interrupt, please check!
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.15 show hotpatch all patch
【命令功能】
show hotpatch all patch命令用来查看当前设备函数补丁信息。
【命令格式】
show hotpatch all patch [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
本命令用来查看当前设备函数补丁信息。
【配置举例】
# 查看当前设备所有补丁信息。
Hostname# show hotpatch all patch
< The terminal is lock >
Operating, please wait for a moment
! 100%
Receive success
[Slot 0]
Patch: HP000066(/hotpatch/HP000066.pat.private,/sbin/msdp.elf,66) target: actived
Process 7740,msdp.elf: actived(flags:0x0)
req(2) ack(2,0)
< The terminal is unlock >
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.16 show hotpatch all process
【命令功能】
show hotpatch all process命令用来查看当前设备所有函数补丁注册进程信息。
【命令格式】
show hotpatch all process [ slot slot-id | slot all ]
【参数说明】
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
本命令用来查看补丁操作是否成功。
【配置举例】
# 查看当前设备所有补丁信息。
Hostname# show hotpatch all process
< The terminal is lock >
Operating, please wait for a moment
! 100%
Receive success
[Slot M1]
Process: 6998,ce.fp.sw(debug:0,init:done)
Process: 6963,proxy.span.sw(debug:0,init:done)
Process: 6950,proxy.bfd.sw(debug:0,init:done)
Process: 6937,ce.mtp.sw(debug:0,init:done)
Process: 6926,ftp_server.elf(debug:0,init:done)
Process: 6905,fe.ddm.sw(debug:0,init:done)
Process: 6880,ce.sflow.sw(debug:0,init:done)
Process: 6893,cli.ptm.sw(debug:0,init:done)
Process: 6868,ce.rspan.sw(debug:0,init:done)
…
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.17 show install
【命令功能】
show install命令用来查看多补丁方案中，设备中已安装的补丁包的相关信息。
【命令格式】
show install [ detail ] [ slot slot-id | slot all ]
【参数说明】
detail：查看补丁的详细信息。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
本命令用来查看补丁操作是否成功。
【配置举例】
# 查看多补丁方案中，设备中已安装的补丁包的相关信息。
Hostname> enable
Hostname# show install
Install information:
[Slot 1/0]
Name State Flag Effective time Package
smu_rf_hot1002_0118.bin active Hot 2019-09-17 19:00:02
smu_rf_hot1004_0118.bin installed Hot 2019-09-17 19:05:01
[Slot 2/0]
Name State Flag Effective time Package
smu_rf_hot1002_0118.bin Active Hot 2019-09-17 19:00:02
smu_rf_hot1004_0118.bin install Hot 2019-09-17 19:05:01
表1-12show install命令输出信息描述表
| 字段 | 描述 |
| Name | 补丁包名 |
| State | 补丁包状态：
● active：表示已激活 ● installed：表示已安装 ● running：表示正在运行 |
| Flag | 补丁包标志：
● Hot：热补丁 ● Cold：冷补丁 |
| Effective time | 补丁包生效时间 |
| Package | 补丁包内部唯一标识 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.18 show install auto-sync
【命令功能】
show install auto-sync命令用来查看当前设备所有需要自动同步的补丁包。
【命令格式】
show install auto-sync
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
本命令用来查看补丁操作是否成功。
【配置举例】
# 查看当前设备所有需要自动同步的补丁包。
Hostname> enable
Hostname# show install
Install information:
[Slot 1/0]
Name State Flag Effective time Package
smu_rf_hot1002_0118.bin active Hot 2019-09-17 19:00:02
smu_rf_hot1004_0118.bin installed Hot 2019-09-17 19:05:01
[Slot 2/0]
Name State Flag Effective time Package
smu_rf_hot1002_0118.bin Active Hot 2019-09-17 19:00:02
smu_rf_hot1004_0118.bin install Hot 2019-09-17 19:05:01
表1-13show install命令输出信息描述表
| 字段 | 描述 |
| Name | 补丁包名 |
| State | 补丁包状态：
● active：表示已激活 ● installed：表示已安装 ● running：表示正在运行 |
| Flag | 补丁包标志：
● Hot：热补丁 ● Cold：冷补丁 |
| Effective time | 补丁包生效时间 |
| Package | 补丁包内部唯一标识 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.19 show patch
【命令功能】
show patch命令用来查看单补丁方案中，设备中已安装的补丁包的相关信息。
【命令格式】
show patch [ detail ] [ slot slot-id | slot all ]
【参数说明】
detail：查看补丁的详细信息。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
无
【配置举例】
# 查看单补丁方案中，设备中已安装的补丁包的相关信息。
Hostname# show patch
[Slot 1/0]:
Patch package SP1 installed in the system, version:5.0.0.0
----------------------------------------
Patch : SP1.bin
Status : active
Version : 5.0.0.0
Size : 1770
Install time: 2020-07-06 06:59:28
Description : test SP1
[Slot 2/0]:
Patch package SP1 installed in the system, version:5.0.0.0
----------------------------------------
Patch : SP1.bin
Status : active
Version : 5.0.0.0
Size : 1770
Install time: 2020-07-06 06:59:28
Description : test SP1
表1-14show patch命令输出信息描述表
| 字段 | 描述 |
| Patch | 补丁包名字 |
| Status | 补丁包状态 |
| Version | 补丁包版本 |
| Size | 补丁包大小 |
| Install time | 补丁包生效时间 |
| Description | 补丁包描述 |
# 查看查看单补丁方案中，设备中已安装的补丁包的详细信息。
Hostname# show patch detail
[Slot 1/0]:
Patch package SP4 installed in the system, version:5.0.0.4
----------------------------------------
Patch : SP4.bin
Status : active
Version : 5.0.0.4
Size : 5248
Install time: 1970-05-29 15:43:27
Description : test SP4
Flag : Hot
Last patch : SP1
Include : rf_test6; rf_test7; rf_test8; rf_test5;
表1-15show patch detail命令输出信息描述表
| 字段 | 描述 |
| Patch | 补丁包名称 |
| Status | 补丁包状态：
● active：表示已激活 ● installed：表示已安装 ● running：表示正在运行 |
| Version | 补丁包的版本 |
| Size | 补丁包大小，单位为千字节 |
| Install time | 补丁包激活时间 |
| Description | 补丁包描述 |
| Flag | 表示该补丁是热补丁还是冷补丁
● Hot：热补丁 ● Cold：冷补丁 |
| Last patch | 上个版本补丁包名称 |
| Include | 该补丁包包含的文件 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.20 show patch auto-sync
【命令功能】
show patch auto-sync命令用来查看设备所有需要自动同步的补丁包信息。
【命令格式】
show patch auto-sync
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
15
【使用指导】
无
【配置举例】
# 查看当前设备所有需要自动同步的补丁包信息。
Hostname> enable
Hostname# show patch auto-sync
Auto-sync switch: enable
Auto-sync lists :
Name State Flag Effective time Package
SP1.bin running Hot 1970-10-08 15:39:42 SP1
SP2.bin installed Hot SP2
表1-16show install auto-sync命令输出信息描述表
| 字段 | 描述 |
| Auto-sync switch | 组件自动同步开关：
● enable：开启 ● disable：关闭 |
| Auto-sync lists | 组件自动同步补丁包列表 |
| Name | 补丁包名称 |
| State | 补丁包状态：
● active：表示已激活 ● installed：表示已安装 ● running：表示正在运行 |
| Flag | 表示该补丁是热补丁还是冷补丁：
● Hot：热补丁 ● Cold：冷补丁 |
| Effective time | 补丁包生效时间 |
| Package | 补丁包内部唯一标识 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.21 show upgrade auto-sync
【命令功能】
show upgrade auto-sync命令用来查看设备中自动同步升级的相关配置。
【命令格式】
show upgrade auto-sync
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
14
【使用指导】
无
【配置举例】
# 查看系统自动同步的相关信息。
Hostname> enable
Hostname# show upgrade auto-sync
auto-sync policy: coordinate
auto-sync range: vsu
auto-sync package: flash:/eg1000m_main_1.0.0.0f328e91.bin
表1-17show upgrade auto-sync命令输出信息描述表
| 字段 | 描述 |
| auto-sync policy | 配置自动同步升级的策略：
● coordinate：以管理板存储的系统升级包为依据，将所有其它成员的软件同步至此版本 ● none：不进行自动同步升级 |
| auto-sync range | 自动同步升级的范围 |
| auto-sync package | 自动同步升级的升级包路径 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.22 show upgrade file
【命令功能】
show upgrade file命令用来查看存放在设备文件系统中的安装包文件信息。
【命令格式】
show upgrade file url
【参数说明】
url：安装包文件存放的本地路径。
【命令模式】
除用户模式以外的所有模式
【缺省级别】
14
【使用指导】
下载安装包文件到本地文件系统后可使用本命令预先查看安装包的主要信息。
注意
本命令不支持机架包。
【配置举例】
# 查看安装包文件信息。
Hostname> enable
Hostname# show upgrade file flash:S6120_RGOS12.1(1)B0101-FULL_install.bin
Name : main
Version : 1.0.0.2f1c4dd8
Package type : unknown
Size : 166440370
Build time : Fri 23 Nov 2018 09:01:43 UTC
Description : main upgrade package
Package files :
/fdt.img
/initrd.img
/kernel.img
/rboot-s6120.bin
/rootfs.sqsh
/u-boot-s6120_spi.bin
表1-18show upgrade file命令输出信息描述表
| 字段 | 描述 |
| Name | 安装包名称：
● main：主程序安装包 ● bios：BIOS安装包 ● cpld：CPLD和FPGA固件安装包 |
| Version | 安装包版本 |
| Package type | 安装包类型：
● distribute component：机架式安装包 ● main component：Main安装包 ● bios component：BIOS安装包 ● cpld component：CPLD和FPGA固件安装包 |
| Size | 安装包大小，以Byte为单位 |
| Build time | 编译时间 |
| Description | 安装包描述信息 |
| Package files | 安装包内文件列表 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.23 show upgrade history
【命令功能】
show upgrade history命令用来查看升级历史信息。
【命令格式】
show upgrade history
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
14
【使用指导】
无
【配置举例】
# 查看升级历史信息。
Hostname> enable
Hostname# show upgrade history
Upgrade History Information:
Time : 2018-11-05 06:13:17
Method : OOBTFTP
Package Name : S6500_RGOS12.5(1)B0506_10202704_install .bin
Package Type : MAIN
Time : 2018-11-06 03:11:16
Method : OOBTFTP
Package Name : S6500_RGOS12.5(1)B0506_10202704_install .bin
Package Type : MAIN
表1-19show upgrade history命令输出信息描述表
| 字段 | 描述 |
| Upgrade History Information | 升级历史信息 |
| Time | 升级时间 |
| Method | 升级方式：
● AUTO-SYNC：自动同步升级 ● LOCAL：使用本地安装包升级 ● TFTP：使用tftp下载升级 ● FTP：使用ftp下载升级 ● OOBTFTP：使用oob_tftp下载升级 ● OOBFTP：使用oob_ftp下载升级 |
| PackageName | 安装包名称 |
| PackageType | 安装包类型：
● Main：MAIN安装包 ● RBOOT：RBOOT安装包 ● UBOOT：UBOOT安装包 ● CPLD：CPLD和FPGA固件安装包 ● BIOS：BIOS安装包 ● DISTRIBUTE：机架式安装包 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.24 show upgrade status
【命令功能】
show upgrade status命令用来查看设备各板卡的升级状态以及补丁包的安装状态。
【命令格式】
show upgrade status
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
14
【使用指导】
无
【配置举例】
# 查看设备各板卡升级状态。
Hostname> enable
Hostname# show upgrade status
upgrade global status: INIT
[Slot 2/0]
Device type : s6120
Status : success
[Slot 1/0]
Device type : s6120
Status : success
# 查看补丁包安装的状态。
Hostname# show upgrade status
[Slot 2/0]
Device type : s6120
Status : success
[Slot 1/0]
Device type : s6120
Status : success
表1-20show upgrade status命令输出信息描述表
| 字段 | 描述 |
| upgrade global status | 升级全局状态：
● INIT：未升级或者升级完成 ● DOWNLOAD：安装包下载过程 ● PRE-UPGRADE：升级预处理过程 ● UPGRADING：升级处理过程 ● POST-UPGRADE：升级后处理过程 |
| Device type | 设备类型 |
| Status | 板卡升级状态：
● ready：未升级 ● parse：安装包解析过程 ● transmission：安装包传输中 ● upgrading：安装包升级中 ● success：升级成功 ● skipped：忽略升级，设备不支持或者版本一致 ● fail：升级失败 |
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.25 upgrade
【命令功能】
upgrade命令用来安装，升级本地文件系统内安装包。
【命令格式】
upgrade { url | download { oob_ftp://path [ via mgmt interface-number ] | oob_tftp://path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | ftp://path [ vrf vrf-name ] | tftp://path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ] } } [ slot slot-id | slot all ] [ force ]
【参数说明】
url：表示安装包在设备上存放的本地路径，一般为flash:、tmp:和usb0:。
path：path为FTP或者TFTP服务器上安装包的路径，该参数表示从服务器上下载安装包，下载成功之后设备自动升级，sftp命令用户名和密码不能带@字符。
via mgmt interface-number：如果是oob_tftp、oob_sftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
vrf vrf-name：VRF名称。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
force：表示要升级的版本与系统的版本相同时强制升级。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
本命令支持各子系统安装包，机架设备安装包以及补丁安装包。使用upgrade url命令前，先使用copy命令将功能包拷入设备文件系统内。
vrf参数与oob_tftp、oob_sftp、oob_ftp参数互斥。
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade download sftp://username@192.168.1.1/test.bin flash:test.bin
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
# 配置设备上升级本地文件系统的路径为U盘上的安装包。
Hostname> enable
Hostname# upgrade usb0: S6120_RGOS12.1(1)B0101-FULL_install.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!20%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!30%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!100%
Upgrade success
< The terminal is unlocked by upgrade module >
[Slot 0]
Device type : s6120
Status : success
# 升级设备中存在在flash路径下的补丁包。
Hostname# upgrade flash:cmpnt_upgrade_server_99.0.0.0_mips64.deb
< The terminal is locked by patch module >
Upgrade start
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Upgrade finish
< The terminal is unlocked by patch module >
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
【提示信息】
# 升级成功提示。
Upgrade success
# 安装包无效或被损坏重新获取安装包并执行升级命令。
Invalid package file
# 设备不支持该安装包，重新获取安装包并执行升级命令。
Device don't support
# 设备无需升级。
The version in device is newer or the same
# 当升级空间不足时，则会提示如下信息：
No enough space for decompress
【常见错误】
无
【平台说明】
无
【相关命令】
l show version（基础配置/基础管理命令）
1.26 upgrade auto-sync package
【命令功能】
upgrade auto-sync package命令用来配置设备系统的自动同步升级的检查范围。
缺省情况下，系统的自动同步升级的检查范围为上一次系统升级所使用升级包的路径。
【命令格式】
upgrade auto-sync package url
【参数说明】
url：系统自动升级时，所使用的升级包在设备本地的路径。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
在系统中有新成员加入时，升级功能将使用该路径来确定安装包的位置。通常，在每次进行系统升级时，升级功能会自动记录本次升级所使用安装包路径，用于自动同步升级。用户也可以使用upgrade auto-sync package命令手工进行设定。
【配置举例】
# 配置设备系统的自动同步升级的路径设置为U盘上的升级包。
Hostname> enable
Hostname# upgrade auto-sync package usb0:/eg1000m_main_1.0.0.0f328e91.bin
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
1.27 upgrade auto-sync policy
【命令功能】
upgrade auto-sync policy命令用来配置系统的自动同步策略。
缺省情况下，系统的自动同步策略为coordinate。
【命令格式】
upgrade auto-sync policy [ compatible | coordinate | none ]
【参数说明】
compatible：以版本前后为依据来判断是否需要自动同步并开启补丁包自动同步功能。
coordinate：以管理板存储的系统升级包为依据，同步至此版本并开启补丁包自动同步功能。
none：不进行自动同步升级并关闭补丁包自动同步。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
使用本命令前需要先确认升级包是否已经就绪。
【配置举例】
# 配置设备自动同步策略为以管理板的版本为准。
Hostname> enable
Hostname# upgrade auto-sync policy coordinate
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
1.28 upgrade auto-sync range
【命令功能】
upgrade auto-sync range命令用来配置系统的自动同步升级的范围。
缺省情况下，系统的自动同步升级的范围为VSU系统范围。
【命令格式】
upgrade auto-sync range [ vsu ]
【参数说明】
vsu：vsu系统范围内进行版本自动同步升级。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
无
【配置举例】
# 配置自动同步升级的范围为VSU系统。
Hostname> enable
Hostname# upgrade auto-sync range vsu
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
1.29 upgrade boot
警告
Boot升级有风险，若升级过程下电，设备有概率会损坏，导致无法使用；若升级失败，请勿对设备执行下电操作，请再尝试升级一次。
【命令功能】
upgrade boot命令用来升级设备上所有的Uboot与Rboot。
【命令格式】
upgrade boot { url | download { oob_ftp://path [ via mgmt interface-number ] | oob_tftp://path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | ftp://path [ vrf vrf-name ] | tftp://path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ] } } [ slot slot-id | slot all ] [ force ]
【参数说明】
url：表示安装包在设备上存放的本地路径，一般为flash:、tmp:和usb0:。
path：path为FTP或者TFTP服务器上安装包的路径，该参数表示从服务器上下载安装包，下载成功之后设备自动升级，sftp命令用户名和密码不能带@字符。
via mgmt interface-number：如果是oob_tftp、oob_sftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
vrf vrf-name：VRF名称。
force：表示要升级的版本与系统的版本相同时强制升级。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade boot download sftp://username@192.168.1.1/test.bin flash:test.bin
Boot upgrade is risky, Are you sure? Continue [Y/N]y
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
# 升级存放在设备本地USB中的Boot文件。
Hostname> enable
Hostname# upgrade boot usb0: S6120_RGOS12.1(1)B0101-FULL_install.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!20%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!30%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!100%
Upgrade success
< The terminal is unlocked by upgrade module >
[Slot 0]
Device type : s6120
Status : success
【提示信息】
# 升级成功则提示以下信息。
Upgrade success
# 安装包无效或被损坏，则提示以下信息，建议重新获取安装包并执行升级命令。
Invalid package file
# 设备不支持该安装包，则提示以下信息，建议重新获取安装包并执行升级命令。
Device don't support
# 升级空间不足，则提示以下信息，建议检查设备附带的U盘是否完好。
No enough space for decompress
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.30 upgrade download patch-active
【命令功能】
upgrade download patch-active命令用来下载补丁包，将补丁信息加入数据库并临时激活补丁，使补丁生效。
【命令格式】
upgrade { url | download { oob_ftp: //path [ via mgmt interface-number ] | oob_tftp: //path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | ftp: //path [ vrf vrf-name ] | tftp: //path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ] } } patch-active [ slot slot-id | slot all ] [ force ]
【参数说明】
url：下载补丁包的路径，可以是flash:、TFTP、FTP、HTTP等下载方式。
path：path为FTP或者TFTP服务器上安装包的路径，该参数表示从服务器上下载安装包，下载成功之后设备自动升级，sftp命令用户名和密码不能带@字符。
via mgmt interface-number：如果是oob_tftp、oob_sftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
vrf vrf-name：从指定vrf下载安装包。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
force：表示要升级的版本与系统的版本相同时强制升级。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令用于将补丁包一键临时激活，使补丁生效，设备重启后会自动回退。多补丁和单补丁通用。
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade download sftp://username@192.168.1.1/test.bin flash:test.bin patch-active
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
#一键临时激活多补丁。
Hostname> enable
Hostname# upgrade download tftp://10.20.189.189/cmpnt_upgrade_begin_99.0.0.0_mips64.deb patch-active
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a momen
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
< The terminal is unlock >
# 一键临时激活单补丁。
Hostname> enable
Hostname# upgrade download tftp://10.20.189.189/SP1.bin patch-active
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
< The terminal is unlock >
【提示信息】
命令执行错误时，Result为Fail或Skip，Comment注释信息如下：
# 对于已经安装成功的补丁包，不允许再次安装。
This package already add, don't need to add again!
# 安装补丁包，空间不足。
No space left on device!
# 补丁包与设备不匹配。
Package architecture not match!
# 设备不满足补丁包安装条件。
Package depends not satisfy!
# 补丁包已经被激活过。
Package has been activated, no need activate again!
# 补丁包错误。
Install package error!
# 补丁包文件损坏，校验失败。
Package verify fail, please check!
常见错误】
无
【平台说明】
无
【相关命令】
无
1.31 upgrade download patch-running
【命令功能】
upgrade download patch-running命令用来下载补丁包，将补丁信息加入数据库并永久激活补丁，使补丁生效。
【命令格式】
upgrade { url | download { oob_ftp: //path [ via mgmt interface-number ] | oob_tftp: //path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | | ftp: //path [ vrf vrf-name ] | tftp: //path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ]} } patch-running [ slot slot-id | slot all ] [ force ]
【参数说明】
url：下载补丁包的路径，可以是flash:、TFTP、FTP、HTTP等下载方式。
path：path为FTP或者TFTP服务器上安装包的路径，该参数表示从服务器上下载安装包，下载成功之后设备自动升级，sftp命令用户名和密码不能带@字符。
via mgmt interface-number：如果是oob_tftp、oob_sftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
vrf vrf-name：从指定vrf下载安装包。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
force：表示要升级的版本与系统的版本相同时强制升级。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
本命令用于将补丁包一键永久激活，使补丁生效，补丁在设备重启后依然生效。多补丁和单补丁通用。
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade download sftp://username@192.168.1.1/test.bin flash:test.bin patch-running
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
# 一键永久激活多补丁。
Hostname> enable
Hostname# upgrade download tftp://10.20.189.189/cmpnt_upgrade_begin_99.0.0.0_mips64.deb patch-running
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a momen
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
< The terminal is unlock >
# 一键永久激活单补丁。
Hostname> enable
Hostname# upgrade download tftp://10.20.189.189/SP1.bin patch-running
Press Ctrl+C to quit
!
< The terminal is lock >
Operating, please wait for a moment
!!!!!!!!!! 20%
!!!!!!!!!! 40%
!!!!!!!!!! 60%
!!!!!!!!!! 80%
!!!!!!!!!! 90%
!! 100%
Patch operation finish!
Operate result information:
-------------------------------------
Slot Result Comment
M1 Success None
3 Success None
< The terminal is unlock >
【提示信息】
无
【常见错误】
命令执行错误时， Result为Fail或Skip，Comment注释信息如下：
# 对于已经安装成功的补丁包，不允许再次安装。
This package already add, don't need to add again!
# 安装补丁包，空间不足。
No space left on device!
# 补丁包与设备不匹配。
Package architecture not match!
# 设备不满足补丁包安装条件。
Package depends not satisfy!
# 补丁包已经被激活过。
Package has been activated, no need activate again!
# 补丁包错误。
Install package error!
# 补丁包文件损坏，校验失败。
Package verify fail, please check!
【平台说明】
无
【相关命令】
无
1.32 upgrade hot
【命令功能】
upgrade hot命令用来热升级设备上的CPLD。
【命令格式】
upgrade hot { url | download { oob_ftp://path [ via mgmt interface-number ] | oob_tftp://path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | ftp://path [ vrf vrf-name ] | tftp://path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ] } } [ slot slot-id | slot all ] [ force ] [ ignore-cpu-mem ]
【参数说明】
url：表示安装包在设备上存放的本地路径，一般为flash:、tmp:和usb0:。
path：path为FTP或者TFTP服务器上安装包的路径，该参数表示从服务器上下载安装包，下载成功之后设备自动升级。
via mgmt interface-number：如果是oob_tftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
vrf vrf-name：VRF名称。
slot slot-id：指定单板。m*表示管理引擎；fe*表示交换网板；1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
force：表示要升级的版本与系统的版本相同时强制升级。
ignore-cpu-mem：忽略升级前CPU和内存检查。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
该命令仅支持安装包为CPLD安装包。
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade hot download sftp://username@192.168.1.1/test.bin flash:test.bin patch-active
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
Hostname#upgrade hot usb0: cpld_1.0.0.046251cb_211015134649.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!20%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!30%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!100%
Upgrade success
< The terminal is unlocked by upgrade module >
[Slot 0]
Device type : s6120
Status : success
【提示信息】
# 升级成功提示：
Upgrade success
# 安装包无效或被损坏重新获取安装包并执行升级命令：
Invalid package file
# 设备不支持该安装包，重新获取安装包并执行升级命令
Device don't support
# 升级空间不足，检查设备附带的U盘是否完好：
No enough space for decompress
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.33 upgrade mcu
说明
仅S6510-48VS8CQ、S6250-48XS8CQ设备支持本命令。
【命令功能】
upgrade mcu命令用来升级mcu器件。
【命令格式】
upgrade mcu { url | download { oob_ftp://path [ via mgmt interface-number ] | oob_tftp://path [ via mgmt interface-number ] | oob_sftp://path [ via mgmt interface-number ] | ftp://path [ vrf vrf-name ] | tftp://path [ vrf vrf-name ] | sftp://path [ vrf vrf-name ]} } [ slot slot-id | slot all ]
【参数说明】
url：表示mcu固件在设备上存放的本地路径，一般为flash:、tmp:和usb0:。
path：path为FTP或者TFTP服务器上mcu固件的路径，该参数表示从服务器上下载mcu固件，下载成功之后设备自动升级mcu器件。
via mgmt interface-number：如果是oob_tftp或者oob_ftp的方式传输并且存在多个MGMT口时可以自行选择对应的口。其中interface-number表示指定的MGMT接口编号。
vrf vrf-name：VRF名称。
slot slot-id：指定单板。1~*表示业务接口板。其中*为正整数。
slot all：所有单板。
【命令模式】
特权模式
【缺省级别】
14
【使用指导】
本命令支持mcu固件包。
vrf参数与oob_tftp、oob_ftp参数互斥。
通过sftp协议进行文件传输时：
（1）不支持用户名包含/、@、:这些特殊字符；
（2）若密码包含/、@、:这些特殊字符，可以使用以下交互式命令方式输入密码，避免解析异常。
Hostname# upgrade mcu download sftp://username@192.168.1.1/test.bin flash:test.bin patch-active
username @192.168.1.1's password:
通过ftp协议进行文件传输时：
（1）登录FTP Server的账号名，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
（2）登录FTP Server的账户密码，长度限制32字节，不可包含“:”、“/”、@和空格等字符，不可省略
【配置举例】
# 配置设备上升级本地文件系统的路径为U盘上的mcu固件。
Hostname> enable
Hostname# upgrade usb0: S6510_MCU.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!20%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!30%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!100%
Upgrade success
< The terminal is unlocked by upgrade module >
[Slot 0]
Device type : s6510
Status : success
【提示信息】
# 升级成功提示。
Upgrade success
# 设备无需升级。
Skipped(version same)
# 当升级空间不足时，则会提示如下信息：
No enough space for decompress
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.34 upgrade server
【命令功能】
upgrade server命令用来配置系统的版本自动同步服务功能。
【命令格式】
upgrade server { open | close }
【参数说明】
open：打开自动同步服务。
close：关闭自动同步服务。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
当系统版本自动同步服务功能开启时，无主程序的线卡热插入机箱后，线卡自动升级为和主控板一致的版本。
【配置举例】
# 打开自动同步服务。
Hostname> enable
Hostname# upgrade server open
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.35 upgrade sync-server
说明
仅N18000-XH（CE类线卡）、S6910-3C、S6920-4C、S6510-4C、S6580-48CQ8QC、S6580-24DC8QC设备支持本命令。
【命令功能】
upgrade sync-server命令用来配置系统的版本自动同步服务功能。
【命令格式】
upgrade sync-server { open | close }
【参数说明】
open：打开自动同步服务。
close：关闭自动同步服务。
【命令模式】
特权模式
【缺省级别】
15
【使用指导】
当系统版本自动同步服务功能开启时，无主程序的线卡热插入机箱后，线卡自动升级为和主控板一致的版本。
【配置举例】
# 打开自动同步服务。
Hostname> enable
Hostname# upgrade sync-server open
【提示信息】
无
【常见错误】
无
【平台说明】
无
【相关命令】
无
1.36 upgrade fiber-firmware
【命令功能】
upgrade fiber-firmware命令用来光模块固件升级命令。
【命令格式】
upgrade fiber-firmware {url} [password：key]
【参数说明】
url：表示mcu固件在设备上存放的本地路径，光模块升级只支持flash:。
key：表示光模块升级包的密码
【命令模式】
全局配置模式
【缺省级别】
15
【使用指导】
该命令仅支持安装包为光模块固件安装包，光模块升级只支持本地flash的安装包升级。
【配置举例】
# 接口模式，光模块单端口固件升级
Hostname> enable
Hostname#
Hostname#config
Enter configuration commands, one per line. End with CNTL/Z.
Hostname#interface fhGigabitEthernet 0/25
Hostname (config-if-FHGigabitEthernet0/25)# upgrade fiber-firmware flash：qdd-fw1.9.12.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!100%
[Name:FHGigabitEthernet0/26 , Index:76]
Version : 1.13
Status : success
< The terminal is unlocked by upgrade module >
# 批量模式，光模块端口固件升级
Hostname#config
Enter configuration commands, one per line. End with CNTL/Z.
Hostname# interface range fhGigabitEthernet 0/25,0/26,0/27,0/28
Hostname (config-if-range)# upgrade fiber-firmware flash：qdd-fw1.9.12.bin
< The terminal is locked by upgrade module >
Upgrade start
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!10%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!20%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!30%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!40%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!50%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!60%
< you can press Ctrl+C to unlock terminal >
!!!!!!!!!!!!!100%
[Name:FHGigabitEthernet0/25 , Index:73]
Version :
Status : fail
Reason : The optical module is not detected.
[Name:FHGigabitEthernet0/26 , Index:76]
Version : 1.13
Status : success
[Name:FHGigabitEthernet0/27 , Index:79]
Version :
Status : fail
Reason : The optical module is not detected.
< The terminal is unlocked by upgrade module >
【提示信息】
# 升级成功提示：
Version：1.13
Status ：success
# 升级失败提示：
Version :
Status : fail
Reason :升级失败原因描述
【常见错误】
无
【平台说明】
无
【相关命令】
l show upgrade fiber-module-status
1.37 show upgrade fiber-module-status
【命令功能】
show upgrade fiber-module-status命令用来查看光模块固件升级状态
【命令格式】
show upgrade fiber-module-status
【参数说明】
无
【命令模式】
除用户模式以外的所有模式
【缺省级别】
14
【使用指导】
该命令仅支持安装包为光模块固件安装包。
【配置举例】
Hostname> enable
Hostname#
Hostname# show upgrade fiber_module_status
[Name:FHGigabitEthernet0/25 , Index:73]
Version :
Status : fail
Reason : The optical module is not detected.
[Name:FHGigabitEthernet0/26 , Index:76]
Version : 1.13
Status : success
【提示信息】
# 升级成功提示：
Version：1.13
Status ：success
# 升级失败提示：
Version :
Status : fail
Reason :升级失败原因描述
【常见错误】
无
【平台说明】
无
【相关命令】