01-基礎配置命令參考

09-ISSU命令

1 ISSU

1.1 ISSU配置命令

1.1.1 display install active

1.1.2 display install backup

1.1.3 display install committed

1.1.4 display install inactive

1.1.5 display install ipe-info

1.1.6 display install job

1.1.7 display install log

1.1.8 display install package

1.1.9 display install rollback

1.1.10 display install which

1.1.11 display issu rollback-timer

1.1.12 display issu state

1.1.13 display version comp-matrix file

1.1.14 install abort

1.1.15 install activate

1.1.16 install add

1.1.17 install commit

1.1.18 install deactivate

1.1.19 install remove

1.1.20 install rollback to

1.1.21 install verify

1.1.27 issu rollback-timer

1.1.28 issu run switchover

1.1.29 reset install log-history oldest

1.1.30 reset install rollback oldest

1 ISSU

1.1 ISSU配置命令

字段	描述
Active packages on the device	處於激活狀態的軟件包的相關信息
flash:/boot.bin	軟件包的名稱
[Package]	軟件包的信息
Vendor	生產廠商
Product	產品名稱
Service name	軟件包所包含的服務名稱： · 如果顯示為boot，表示該軟件包為Boot包 · 如果顯示為system，表示該軟件包為System包 · 如果顯示為boot patch，表示該軟件包為Boot包的補丁包；如果顯示為system patch，表示該軟件包為System包的補丁包 · 如果顯示為其它值，則表示該軟件包為提供某項功能的Feature包
Platform version	平台軟件版本號
Product version	產品軟件版本號
Supported board	軟件包支持的硬件類型： · mpu表示成員設備
[Component]	組件信息，表示軟件包的組成部分
Component	組件的名稱
Description	組件的描述信息

1.1.2 display install backup

display install backup命令用來顯示設備下次啟動時使用的備用軟件包的相關信息。

【命令】

display install backup [ slot slot-number ] [ verbose ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

slot slot-number：表示設備在IRF中的成員編號。不指定該參數時，表示IRF中的所有成員設備。

verbose：顯示詳細信息，包括軟件包的名稱、基本信息和所包含的組件。不指定該參數時，僅顯示軟件包的名稱。

【使用指導】

應用場景

當主用啟動軟件包列表中的Boot包或System包不存在或者損壞時，設備會使用備用啟動軟件包列表中的軟件包來啟動設備。可以通過本命令查看下次啟動時使用的備用軟件包的相關信息。有關設備下次啟動時使用的軟件包的詳細介紹請參見“基礎配置指導”中的“軟件升級”。

注意事項

執行boot-loader file命令可以修改設備下次啟動時使用的備用軟件包列表。

【舉例】

# 顯示設備下次啟動時使用的備用軟件包的相關信息。

<Sysname> display install backup

Backup startup software images on slot 1:

flash:/boot.bin

flash:/system.bin

# 顯示設備下次啟動時使用的備用軟件包的詳細信息。

<Sysname> display install backup verbose

Backup startup software images on slot 1:

flash:/boot.bin

[Package]

Vendor: H3C

Product: S6813

Service name: boot

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: boot

Description: boot package

flash:/system.bin

[Package]

Vendor: H3C

Product: S6813

Service name: system

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: system

Description: system package

本命令顯示信息的描述請參見表1-1。

【相關命令】

· boot-loader file（基礎配置命令參考/軟件升級）

· display install committed

1.1.3 display install committed

display install committed命令用來顯示設備下次啟動時使用的主用軟件包的相關信息。

【命令】

display install committed [ slot slot-number ] [ verbose ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

slot slot-number：表示設備在IRF中的成員編號。不指定該參數時，表示IRF中的所有成員設備。

verbose：顯示詳細信息，包括軟件包的名稱、基本信息和所包含的組件。不指定該參數時，僅顯示軟件包的名稱。

【使用指導】

應用場景

某些install命令可以修改設備的軟件包列表，但需要執行install commit命令來確認運行當前的軟件包，這些軟件包才會被列入主用下次啟動軟件包，使得設備重啟後，這些軟件包能夠繼續生效。可以使用本命令查看已被確認為下次啟動的軟件包。

注意事項

執行install commit和boot-loader file命令都可以修改設備下次啟動時使用的主用軟件包列表。

【舉例】

# 顯示設備下次啟動時使用的主用軟件包的相關信息。

<Sysname> display install committed

Committed packages on slot 1:

flash:/boot.bin

flash:/system.bin

flash:/feature1.bin

# 顯示設備下次啟動時使用的主用軟件包的詳細信息。

<Sysname> display install committed verbose

Committed packages on slot 1:

flash:/boot.bin

[Package]

Vendor: H3C

Product: S6813

Service name: boot

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: boot

Description: boot package

flash:/system.bin

[Package]

Vendor: H3C

Product: S6813

Service name: system

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: system

Description: system package

flash:/feature1.bin

[Package]

Vendor: H3C

Product: S6813

Service name: feature1

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: feature1

Description: feature1 package

本命令顯示信息的描述請參見表1-1。

【相關命令】

· boot-loader file（基礎配置命令參考/軟件升級）

· display install backup

· install commit

1.1.4 display install inactive

display install inactive命令用來顯示文件係統根目錄下沒有被激活的所有軟件包的相關信息。

【命令】

display install inactive [ slot slot-number ] [ verbose ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

slot slot-number：表示設備在IRF中的成員編號。不指定該參數時，表示IRF中的所有成員設備。

verbose：顯示詳細信息，包括軟件包的名稱、基本信息和所包含的組件。不指定該參數時，僅顯示軟件包的名稱。

【舉例】

# 顯示文件係統根目錄下沒有被激活的所有軟件包的簡要信息。

<Sysname> display install inactive

Inactive packages on slot 1:

flash:/feature1.bin

# 顯示文件係統根目錄下沒有被激活的所有軟件包的詳細信息。

<Sysname> display install inactive verbose

Inactive packages on slot 1:

flash:/feature1.bin

[Package]

Vendor: H3C

Product: S6813

Service name: feature1

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: feature1

Description: feature1 package

本命令顯示信息的描述請參見表1-1。

【相關命令】

· install deactivate

1.1.5 display install ipe-info

display install ipe-info命令用來顯示IPE文件包含的軟件包列表。

【命令】

display install ipe-info ipe-filename

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

ipe-filename：表示IPE文件的名稱，形如filesystemname/filename.ipe。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

【使用指導】

IPE文件是一個或多個軟件包的集合。用戶獲得IPE文件後，可以選擇其中的軟件包進行升級。

【舉例】

# 顯示flash:/test.ipe的IPE信息。

<Sysname> display install ipe-info flash:/test.ipe

Verifying the file flash:/test.ipe on slot 1................Done.

H3C S6813-48X6C images in IPE:

boot.bin

system.bin

【相關命令】

· display install package

1.1.6 display install job

display install job命令用來顯示係統中正在執行的激活、卸載或回滾操作。

【命令】

display install job

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【舉例】

# 顯示係統中正在執行的激活、卸載、回滾操作。

<Sysname> display install job

JobID:5

Action:install activate flash:/feature1.bin on slot 1

以上顯示信息表明：設備正在執行install activate flash:/feature1.bin slot 1操作。

字段	描述
Install job 1 started by user root at 04/28/2001 08:39:29.	ISSU動作的執行者和執行時間
Job 1 completed successfully at 04/28/2001 08:39:30.	ISSU動作的完成時間
Install activate flash:/feature1.bin	執行的ISSU動作
Detail of activating packages	激活包動作的詳細信息
Get upgrade policy successfully	表示升級決策處理成功
Uncompress package to system successfully	解壓軟件包文件到係統成功
Remove files from system successfully	從係統中刪除文件成功

1.1.8 display install package

display install package命令用來顯示軟件包的相關信息。

【命令】

display install package { filename | all } [ verbose ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

filename：軟件包的名稱，形如filesystemname/filename.bin。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

all：表示主設備上各文件係統根目錄下的所有軟件包。

verbose：顯示軟件包的基本信息和軟件包所包含的組件。不指定該參數時，僅顯示軟件包的基本信息。

【舉例】

# 顯示軟件包system.bin的相關信息。

<Sysname> display install package flash:/system.bin

flash:/system.bin

[Package]

Vendor: H3C

Product: S6813

Service name: system

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

# 顯示軟件包system.bin的詳細信息。

<Sysname> display install package flash:/system.bin verbose

flash:/system.bin

[Package]

Vendor: H3C

Product: S6813

Service name: system

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

[Component]

Component: system

Description: system package

本命令顯示信息的描述請參見表1-1。

1.1.9 display install rollback

display install rollback命令用來顯示回滾點的相關信息。

【命令】

display install rollback [ point-id ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

point-id：回滾點的編號。如果未指定point-id，則顯示所有回滾點的相關信息。

【使用指導】

應用場景

可以通過本命令查看回滾點信息，以便進行相應的回滾操作。

注意事項

issu命令升級過程中不會記錄回滾點，因此，在issu命令升級過程中執行該命令，沒有信息可顯示。

【舉例】

# 顯示所有回滾點的相關信息。

<Sysname> display install rollback

Install rollback information 1 on slot 1:

Updating from flash:/route-1.bin

to flash:/route-2.bin.

Install rollback information 2 on slot 1:

Deactivating flash:/route-2.bin

以上顯示信息表明：設備上共有兩個回滾點，回滾點1是將flash:/route-1.bin升級至flash:/route-2.bin，回滾點2是卸載flash:/route-2.bin。

表1-3 display install rollback命令顯示信息描述表

字段	描述
Install rollback information n	回滾點信息，n為回滾點編號
Updating from A to B	從軟件包A升級到軟件包B，A和B為軟件包的名稱
Deactivating A	卸載軟件包A，A為軟件包的名稱

【相關命令】

· install rollback

· reset install rollback oldest

1.1.10 display install which

display install which命令用來顯示一個組件或文件的所屬軟件包，以及該軟件包的相關信息。

【命令】

display install which { component name | file filename } [ slot slot-number ]

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

component name：軟件包所包含的組件的名稱。

file filename：軟件包所包含的文件的名稱，為1～63個字符的字符串，不區分大小寫。必須為純文件名的形式。

slot slot-number：表示設備在IRF中的成員編號。不指定該參數時，表示IRF中的所有成員設備。

【使用指導】

概念介紹

組件是特性的集合，組件中的特性是同時安裝/卸載的。

應用場景

當軟件包運行錯誤，係統提示xx組件或者xx文件運行錯誤的時候，可以根據組件名/文件名使用該命令查找它屬於哪個軟件包，從而幫助進一步定位是否是軟件包本身有缺陷。通過檢驗該軟件包，定位是否為軟件包的問題。使用install verify命令可以對軟件包進行檢驗。

工作機製

執行該命令後，係統會掃描指定位置的所有文件係統根目錄下的所有軟件包，將包含該組件/文件的軟件包都依次顯示。

【舉例】

# 顯示文件pkg_ctr屬於哪個軟件包以及該軟件包的相關信息。

<Sysname> display install which file pkg_ctr

Verifying the file flash:/system-t0001015.bin on slot 1..........................Done.

Found pkg_ctr in flash:/system-t0001015.bin on slot 1.

flash:/system-t0001015.bin

[Package]

Vendor: H3C

Product: S6813

Service name: system

Platform version: 7.1.070

Product version: Test 0001015

Supported board: mpu

Verifying the file flash:/boot-d2601007.bin on slot 1.....Done.

表1-4 display install which命令顯示信息描述表

字段	描述
Verifying the file	驗證文件是否合法
Found pkg_ctr	找到文件
[Package]	軟件包的信息
Vendor	生產廠商
Product	產品名稱
Service name	軟件包所包含的服務名稱： · 如果顯示為boot，表示該軟件包為Boot包 · 如果顯示為system，表示該軟件包為System包 · 如果顯示為patch，表示該軟件包為補丁包 · 如果顯示為其它值，則表示該軟件包為提供某項功能的Feature包
Platform version	平台軟件版本號
Product version	產品軟件版本號
Supported board	軟件包支持的硬件類型： · mpu表示成員設備
File xxx was not found in the image packages under the root directory of the storage medium	在存儲介質根目錄下的所有包中都沒有找到指定文件

1.1.11 display issu rollback-timer

display issu rollback-timer命令用來顯示回滾定時器的相關信息。

【命令】

display issu rollback-timer

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【使用指導】

因為新設置的回滾定時器時長會在下次ISSU升級中生效，因此，可能出現剩餘時間大於定時器時長的情況。

【舉例】

# 執行issu run switchover命令後，顯示回滾定時器的相關信息。

<Sysname> display issu rollback-timer

Rollback timer: Working

Rollback interval：45 minutes

Rollback time remaining : 40 minutes

# 執行issu accept命令後，顯示回滾定時器的相關信息。

<Sysname> display issu rollback-timer

Rollback timer: Not working

Rollback interval：30 minutes

# 當前沒有進行ISSU升級，顯示回滾定時器的相關信息。

<Sysname> display issu rollback-timer

Rollback timer: Not working

Rollback interval：45 minutes

表1-5 display issu rollback-timer命令顯示信息描述表

字段	描述
Rollback timer	回滾定時器是否處於工作狀態： · Working：回滾定時器已經啟動 · Not working：回滾定時器沒有啟動或者已經超時
Rollback interval	用戶配置的回滾定時器的時間，單位為分鍾
Rollback time remaining	距離回滾定時器超時的時間，單位為分鍾

【相關命令】

· issu rollback-timer

1.1.12 display issu state

display issu state命令用來顯示當前ISSU升級所處的狀態，以及ISSU升級的相關信息。

【命令】

display issu state

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【使用指導】

應用場景

issu命令升級需要經過一係列的操作步驟，升級過程中有嚴格的步驟要求，執行升級步驟會導致ISSU狀態的變化，通過該命令的顯示信息可以幫助管理員確定下一步需執行的操作。

注意事項

該命令不能顯示install命令升級過程中設備所處的狀態，因為install命令升級過程沒有用到狀態機。

【舉例】

# 當前設備沒有ISSU升級，顯示ISSU狀態。

<Sysname> display issu state

ISSU state: Init

Compatibility: Unknown

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot: None

Current version list:

boot: 7.1.070, Test 0001015

system: 7.1.070, Test 0001015

feature1: 7.1.070, Test 0001015

Current software images:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature1-t0001015.bin

# issu load命令執行過程中，顯示ISSU狀態。

<Sysname> display issu state

ISSU state: Loading

Compatibility: Incompatible

Work state: Normal

Upgrade method: Card by card

Upgraded slot: None

Current upgrading slot:

slot 1

Previous version list:

boot: 7.1.070, Test 0001015

system: 7.1.070, Test 0001015

feature1: 7.1.070, Test 0001015

Previous software images:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature1-t0001015.bin

Upgrade version list:

boot: 7.1.070, Test 0001016

system: 7.1.070, Test 0001016

feature1: 7.1.070, Test 0001016

Upgrade software images：

flash:/boot-t0001016.bin

flash:/system-t0001016.bin

flash:/feature1-t0001016.bin

表1-6 display issu state命令顯示信息描述表

字段	描述
ISSU state	ISSU升級狀態，取值可能為： Init：表示還沒有開始ISSU升級或者ISSU升級已經完成 Loading：表示正在執行issu load操作 Loaded：表示issu load操作完成 Switching：表示正在執行issu run switchover操作 Switchover：表示issu run switchover操作完成 Accepted：表示issu accept操作完成 Committing：表示正在執行issu commit操作 Rollbacking：表示係統正在回滾中 Unknown：在非原主成員設備上查看，表示設備正在升級過程中
Compatibility	版本兼容性檢查結果，取值可能為： Compatible：表示兼容升級 Incompatible：表示不兼容升級 Unknown：沒有升級
Work state	設備的工作模式，取值可能為： Normal：表示正常模式 Independent active：表示獨立成員模式。當升級到不兼容版本時，先升級的從設備就會進入獨立成員模式。該模式使得同一設備上的不同成員設備可以運行不同的軟件版本
Upgrade method	升級方式，取值為： · Card by card：表示以堆疊成員設備為單位進行升級，升級完一個成員設備再升級另一個成員設備
Upgraded slot	完成升級的成員設備。取值為Unknown時，表示設備處於回滾過程中
Current upgrading slot	正在升級的成員設備。取值為Unknown時，表示設備處於回滾過程中
Current version list	設備沒有升級，表示當前係統軟件版本
Current software images	設備沒有升級，表示當前運行軟件包的名稱
Previous version list	進行ISSU升級前的係統軟件版本 Unknown：不兼容升級的時候，在非原主成員設備上查看，表示設備正在升級過程中
Previous software images	進行ISSU升級前版本文件 Unknown：不兼容升級的時候，在非原主成員設備上查看，表示設備正在升級過程中
Upgrade version list	正在ISSU升級的目標版本 Unknown：不兼容升級的時候，在非原主成員設備上查看，表示設備正在升級過程中
Upgrade software images	正在ISSU升級中用到的目標文件 Unknown：不兼容升級的時候，在非原主成員設備上查看，表示設備正在升級過程中

‌

【相關命令】

· issu accept

· issu commit

· issu load

· issu rollback

· issu run switchover

1.1.13 display version comp-matrix file

display version comp-matrix file顯示設備將采用的ISSU升級策略。

【命令】

display version comp-matrix file { boot filename | system filename | feature filename&<1-30> } *

display version comp-matrix file ipe ipe-filename

【視圖】

任意視圖

【缺省用戶角色】

network-admin

network-operator

【參數】

boot：Boot包。

system：System包。

feature：Feature包。

filename&<1-30>：軟件包的名稱，形如filesystemname/filename.bin。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。&<1-30>表示前麵的參數最多可以輸入30次。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

ipe ipe-filename：IPE文件名，ipe-filename表示IPE文件的名稱，形如filesystemname/filename.ipe。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

【使用指導】

隻要設備上有一個軟件包不兼容，均判定為不兼容升級方式，需要重啟整個係統。

【舉例】

# 顯示設備將采用的ISSU升級策略。（兼容版本顯示信息舉例）

<Sysname> display version comp-matrix file boot flash:/boot-t0001015.bin system flash:/system-t0001015.bin feature flash:/feature1-t0001015.bin

Verifying the file flash:/feature1-t0001015.bin on slot 1.....Done.

Verifying the file flash:/boot-t0001015.bin on slot 1.....Done.

Verifying the file flash:/system-t0001015.bin on slot 1.....Done.

Slot Upgrade Way

1 File Upgrade

表1-7 display version comp-matrix命令顯示信息描述表

字段	描述
Verifying the file flash:/xx.bin.....Done.	驗證文件是否合法
Influenced service according to following table	如果升級，受影響的功能模塊。隻有版本兼容時，才會顯示該信息
Incompatible upgrade	如果升級指定的軟件包，則升級的方式為不兼容升級
Upgrade Way	兼容升級策略。隻有版本兼容時，才會顯示該信息。取值可能為： · Service Upgrade：表示服務級增量升級 · File Upgrade：表示文件級增量升級 · Reboot：表示通過重啟方式升級有關兼容升級的具體介紹請參見“基礎配置指導”中的“ISSU配置”

【相關命令】

· issu load

1.1.14 install abort

install abort命令用來取消正在執行中的激活或卸載操作。

【命令】

install abort [ job-id ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

job-id：任務ID。不指定該參數時，則取消正在執行中的所有激活和卸載操作。

【使用指導】

工作機製

使用本命令取消正在進行的激活或卸載操作後，係統回退到操作前的狀態。

注意事項

當用戶執行install activate、install add、install commit、install deactivate、install remove或install rollback to命令時，係統會創建相應的任務。為了管理和監控這些任務，係統會給每個任務分配一個任務ID。一個任務ID代表一條命令。可以使用display install job命令來查看任務ID。

【舉例】

# 取消正在執行中的所有激活和卸載操作。

<Sysname> install abort

【相關命令】

· display install job

1.1.15 install activate

install activate命令用來激活或查看軟件包。

【命令】

install activate { boot filename | system filename | feature filename&<1-30> } * slot slot-number [ test ]

install activate patch filename { all | slot slot-number }

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

boot：Boot包。

system：System包。

feature：Feature包。

patch：補丁包。該參數一次隻能指定一個補丁包，但是可以通過多次執行此命令為設備激活多個補丁包。該參數既可以指定疊加補丁也可以指定非疊加補丁。疊加補丁最多可以安裝30個；由於每個Boot、System和Feature包隻能安裝一個非疊加補丁，所以非疊加補丁最多隻能同時安裝16個。有關疊加補丁和非疊加補丁的詳細解釋請參見，“基礎配置指導”的“軟件升級”。

all：升級補丁包對應的所有成員設備。

slot slot-number：表示設備在IRF中的成員編號。

test：查看指定軟件包的升級策略。不帶該參數時，表示直接執行升級操作。

【使用指導】

配置前提

從設備重啟後，會自動批量備份主設備的配置和狀態數據。請使用display system stable state命令查看設備是否處於穩定狀態。隻有System State處於Stable狀態，才能執行該命令。否則，命令執行失敗。關於display system stable state命令的詳細介紹請參見“基礎配置命令參考”中的“設備管理”。

注意事項

激活軟件包前，係統會對軟件包進行數字簽名校驗，如果軟件包通過校驗則激活軟件包；如果軟件包未通過校驗則不激活軟件包，並返回錯誤提示信息。

本命令可以指定一個或多個BIN包升級，但要求升級完成後的啟動列表上的所有軟件包版本一致。否則將出現如下情況：

· 當前啟動列表無Patch包時，僅升級部分bin包，且升級包的版本號與另一部分bin包版本號不一致，升級失敗。

· 當前啟動列表有Patch包時，升級除patch包以外的bin包，且所有升級包版本號一致，升級成功但Patch包被卸載。

此時存在如下兩種解決方法：

· 升級啟動列表裏的所有bin包。

¡ 如果是IPE包內的BIN包未包含設備上運行的部分Feature包，那麼需要先獲取到這些部分Feature包與IPE包版本相同的升級包，通過install add命令將IPE包解壓縮成BIN包後再指定啟動列表裏的所有BIN包一起升級。

¡ 如果升級包已解決了上一版本的補丁問題，那麼不需要升級Patch包。

· 確保Feature包上的功能在設備上處於關閉狀態，再使用install deactivate命令卸載這些Feature包之後再升級啟動列表上剩下的BIN包。

使用本命令激活指定硬件上的軟件包後，被激活的軟件包隻在本次運行的係統中生效。要使被激活的軟件包在設備重啟後繼續生效，還需要執行install commit命令。激活補丁包時，若使用install activate patch filename all命令同時激活所有硬件上的補丁包，則無需執行install commit命令，所有補丁包在設備重啟後繼續生效。

執行該命令時，如果filename不是存放在待升級成員設備上的文件，則係統會先將該文件拷貝到待升級成員設備上，再執行升級動作。

【舉例】

# 顯示從設備2上的Feature包feature1.bin的升級策略

<Sysname> install activate feature flash:/feature1.bin slot 2 test

Copying file flash:/feature1.bin to slot2#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 2.....Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

2 Reboot

Influenced service according to following table:

flash:/feature1.bin

Feature1

以上顯示信息表明，該軟件將采用重啟方式升級。

# 激活從設備2上的System包system.bin和Feature包feature1.bin。

<Sysname> install activate system flash:/system.bin feature flash:/feature1.bin slot 2

Copying file flash:/system.bin to slot2#flash:/system.bin......Done.

Verifying the file flash:/system.bin on slot 2.....Done.

Copying file flash:/feature1.bin to slot2#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 2.....Done.

Upgrade summary according to following table:

flash:/system.bin

Running Version New Version

Test 0001015 Test 0001016

flash:/feature1.bin

Running Version New Version

None Test 0001016

Slot Upgrade Way

2 Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

表1-8 install activate命令顯示信息描述表

字段	描述
Copying file A to B......Done.	將文件從位置A拷貝到位置B。
Verifying the file flash:/xx.bin.....Done.	驗證文件是否合法
Upgrade summary according to following table	升級摘要信息
Running Version	設備當前運行的相同類型軟件包的產品版本號
New Version	目標軟件包的產品版本號
Upgrade Way	兼容升級策略，取值可能為： · Service Upgrade：表示服務級增量升級 · File Upgrade：表示文件級增量升級 · Reboot：表示通過重啟方式升級有關兼容升級的具體介紹請參見“基礎配置指導”中的“ISSU配置”
Influenced service according to following table	將受影響的功能模塊
Upgrading software images to compatible versions. Continue? [Y/N]	詢問用戶是否執行兼容升級操作
This operation might take several minutes, please wait	升級操作需要花費一定時間，請等待
Done.	表示激活成功
Operation failed.	表示激活失敗
Install command does not support incompatible upgrade.	不能使用install命令來升級不兼容版本

【相關命令】

· display install active

· install commit

· install deactivate

1.1.16 install add

install add命令用來解壓縮IPE文件。

【命令】

install add ipe-filename filesystem

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

ipe-filename：IPE文件的名稱，形如filesystemname/filename.ipe。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

filesystem：解壓縮IPE文件保存的目的文件係統的名稱。

【使用指導】

由於使用install命令激活的軟件包隻能是.bin軟件包，所以在使用install命令激活軟件包之前需要使用install add命令將IPE文件進行解壓縮。

用戶獲取IPE文件後，可以使用display install ipe-info命令查看該IPE文件中包含了哪些軟件包，可以通過install add命令將IPE文件解壓生成軟件包，再利用生成的軟件包更新設備軟件。

【舉例】

# 解壓縮all.ipe文件到存儲介質flash上。

<Sysname> install add flash:/all.ipe flash:

Verifying the file flash:/all.ipe on slot 1...Done.

Decompressing file boot.bin to flash:/boot.bin.......................Done.

Decompressing file system.bin to flash:/system.bin.................................Done.

1.1.17 install commit

install commit命令用來確認軟件包更改。

【命令】

install commit

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【使用指導】

配置前提

應用場景

隻有在進行如下情況的配置修改設備當前的軟件包列表時才需要執行本命令用來確認軟件包更改：

· 執行install activate命令，且為增量升級方式時

· 執行install deactivate命令時

· 執行install rollback命令時

工作機製

該命令會將補丁包文件添加到係統當前使用的軟件包列表：

· 如果係統使用了主用軟件包啟動，該命令會將補丁包文件添加到主用軟件包列表中。

· 如果係統使用了備用軟件包啟動，該命令會將補丁包文件添加到備用軟件包列表中。

boot-loader file命令和install commit命令都可以變更主用下次啟動軟件包列表，最新的配置生效。兩條命令的不同之處在於，install commit命令自動使用當前激活的軟件包列表作為主用下次啟動軟件包列表。而boot-loader file命令還可以指定其它當前未激活的軟件包，可以配置為主用或者備用下次啟動軟件包列表。

有關主用/備用軟件包的詳細介紹請參見“基礎配置指導”中的“軟件升級”。

注意事項

當執行install activate命令，且為重啟升級方式時，因為用戶在執行install activate命令時，係統已經修改了下次啟動軟件列表，所以，即便不再執行install commit命令，升級軟件包也會在係統重啟後繼續生效。

【舉例】

# 確認軟件包更改。

<Sysname> install commit

This operation will take several minutes, please wait...........................Done.

The current software images have been saved as the startup software images.

Current software images on slot 1:

flash:/boot.bin

flash:/system.bin

Current software images on slot 2:

flash:/boot.bin

flash:/system.bin

【相關命令】

· install activate

· install deactivate

· install rollback

1.1.18 install deactivate

install deactivate命令用來卸載Feature包或補丁包。

【命令】

install deactivate feature filename&<1-30> slot slot-number

install deactivate patch filename { all | slot slot-number }

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

feature：Feature包。

patch：補丁包。該參數一次隻能指定一個補丁包，若要卸載多個補丁包，則需要多次執行此命令。

filename&<1-30>：軟件包的名稱，形如filesystemname/filename.bin。該參數中必須且隻能包含文件係統的名稱，不能包含文件係統位置信息，從存儲介質名稱開始最多可輸入63個字符。&<1-30>表示前麵的參數最多可以輸入30次。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

all：表示安裝了該補丁包的所有成員設備。

slot slot-number：表示設備在IRF中的成員編號。

【使用指導】

配置前提

注意事項

該命令隻能對已經激活的軟件包進行卸載操作。使用本命令卸載指定slot上的軟件包後，卸載的軟件包的特性功能在本次係統運行中失效。如果要使卸載的軟件包在設備重啟後繼續失效，請執行install commit命令對卸載操作進行確認。卸載補丁包時，若使用install deactivate patch filename all命令同時卸載所有slot上的補丁包，則無需執行install commit命令，所有補丁包在設備重啟後繼續失效。

【舉例】

# 卸載指定slot上的patch包route-patch.bin。

<Sysname> install deactivate patch flash:/route-patch.bin slot 1

This operation might take several minutes, please wait...Done.

【相關命令】

· display install active

· display install inactive

1.1.19 install remove

install remove命令用來刪除沒有激活的軟件包。

【命令】

install remove [ slot slot-number ] { filename | inactive }

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

filename：軟件包的名稱，形如filesystemname/filename.bin。該文件必須保存在設備任一文件係統的根目錄下，該參數中必須且隻能包含文件係統的名稱，不能包含文件係統位置信息，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

slot slot-number：表示設備在IRF中的成員編號。不指定該參數時，表示IRF中的所有成員設備。

inactive：表示將刪除指定文件係統根目錄下、沒有被激活的所有軟件包。

【使用指導】

執行該命令後，指定的軟件包將從設備上被徹底刪除，用戶將不能使用該軟件包進行回滾或回退操作。

【舉例】

# 刪除軟件包flash:/feature1.bin。

<Sysname> install remove flash:/feature1.bin

1.1.20 install rollback to

install rollback to命令用來回滾到指定的回滾點，即按回滾點上記錄的信息，進行回滾操作。

【命令】

install rollback to { point-id | original }

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

point-id：回滾點的編號，當係統中至少存在兩個回滾點的時候，才能輸入該參數。可以用display install rollback命令查看係統中存在的回滾點。

original：回滾到ISSU升級初始狀態。

【使用指導】

應用場景

每次激活或者卸載軟件包之後，係統將這些變化記錄為回滾點。通過回滾功能，可將係統回滾到某個曆史狀態，或者恢複到ISSU升級初始狀態。

注意事項

當升級方式為增量升級時，軟件包回滾隻在設備本次運行過程中生效，用戶隻有通過install commit命令確認軟件包的更改後，才能使此次的回滾操作在係統重啟後生效。係統最多支持50個回滾點，當回滾點超過最大值時，舊的回滾點會被刪除，新的回滾點會被保存。

當升級方式為軟重啟或重啟升級時，係統不會保留任何回滾點，隻支持回滾到係統升級初始狀態。

補丁包不支持回滾操作。

【舉例】

# 回滾到回滾點1。

<Sysname> install rollback to 1

This operation might take several minutes, please wait...Done.

# 回滾到ISSU升級的初始狀態。可通過觀察active列表和回滾點的變化看出執行的結果。

<Sysname> display install active

Active packages on slot 1:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

flash:/feature1-t0001015.bin

<Sysname> display install rollback

Install rollback information 1 on slot 1:

Updating from no package

to flash:/feature1-t0001015.bin.

以上顯示信息表明，當前激活的包有三個，但是確認的隻有兩個，回滾點1是激活了flash:/feature1-t0001015.bin。

<Sysname> install rollback to original

This operation might take several minutes, please wait...Done.

<Sysname> display install active

Active packages on slot 1:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

<Sysname> display install committed

Committed packages on slot 1:

flash:/boot-t0001015.bin

flash:/system-t0001015.bin

執行install rollback to original命令後，設備運行的軟件集恢複到ISSU升級初始狀態，flash:/feature1-t0001015.bin被卸載。

【相關命令】

· display install rollback

1.1.21 install verify

install verify命令用來執行對軟件包狀態、完整性和一致性的檢驗。

【命令】

install verify

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【使用指導】

應用場景

使用該命令，能幫助用戶進行軟件包檢查：

· 當係統提示軟件包不完整時，請重新下載並安裝軟件包。

· 當係統提示軟件包不一致時，請使用install activate、install deactivate以及install commit命令來確保它們的一致。

工作機製

為了保證設備進行ISSU升級之後能夠正常運行，需要執行本命令對軟件包進行如下檢驗：

· 完整性：檢驗Boot包、System包和Feature包的完整性。

· 一致性：檢驗係統內各激活的軟件包列表的差異，以方便用戶知道係統內各軟件包版本是否一致。

· 軟件包狀態：檢查各設備上激活的軟件包列表和確認的軟件包列表之間的差異，以方便用戶知道是否有未確認的軟件包。

【舉例】

# 檢驗設備上軟件包狀態、完整性和一致性信息。

<Sysname> install verify

Active packages on slot 1 are the reference packages.

Packages will be compared with the reference packages.

This operation will take several minutes, please wait...

Verifying packages on slot 1:

Start to check active package completeness.

Verifying the file flash:/boot-t0001015.bin on slot 1.....................Done.

flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on slot 1.....................Done.

flash:/system-t0001015.bin verification successful.

Start to check active package consistency.

Active packages are consistent with committed packages on their own board.

Active packages are consistent with the reference packages.

Verifying packages on slot 2:

Start to check active package completeness.

Verifying the file flash:/boot-t0001015.bin on slot 2.....................Done.

flash:/boot-t0001015.bin verification successful.

Verifying the file flash:/system-t0001015.bin on slot 2.....................Done.

flash:/system-t0001015.bin verification successful.

Start to check active package consistency.

Active packages are consistent with committed packages on their own board.

Active packages are consistent with the reference packages.

Verification is done.

1.1.22 issu accept

issu accept命令用來確認ISSU兼容升級，接受已升級的軟件版本，並刪除回滾定時器。

【命令】

issu accept

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【使用指導】

工作機製

執行本命令後，係統會刪除回滾定時器，本次ISSU升級過程中不會再進行自動回滾，用戶可以執行issu rollback命令進行手動回滾。

注意事項

ISSU不兼容升級時，不需要執行該命令。

【舉例】

# 版本兼容情況下，確認升級步驟。

<Sysname> issu accept

【相關命令】

· issu load

· issu run switchover

1.1.23 issu commit

issu commit命令用來對原主設備及未升級的從設備進行兼容版本升級。

【命令】

issu commit slot slot-number

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

slot slot-number：待升級的原主設備以及其它從設備的成員編號。

【使用指導】

配置前提

注意事項

所有成員設備完成升級後，本次升級結束，ISSU回到初始狀態。執行此命令後，不能再通過ISSU回滾命令或者回滾定時器進行回滾操作。多個從設備的情況下應該在一個從設備啟動完成並重新加入IRF後再對下一個從設備執行該命令，否則可能引起升級錯誤。

對於單成員設備雙主控或分布式設備獨立運行模式的情況，升級完成後ISSU回到初始狀態。執行此命令後，不能再通過ISSU回滾命令或者回滾定時器進行回滾操作。

對於多成員設備的情況，所有成員設備完成升級後，本次升級結束，ISSU回到初始狀態。執行此命令後，不能再通過ISSU回滾命令或者回滾定時器進行回滾操作。如果有多個成員設備需要通過issu commit命令進行升級，需要等到一個成員設備重啟、重新加入IRF後再進行下一個成員設備的升級，否則可能造成升級錯誤。

【舉例】

# 版本兼容情況下，成員2已經升級完成成為新的主設備，升級原主設備（假設成員編號為3）和其他成員（假設成員編號為4和1）。

<Sysname> issu commit slot 3

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

3 Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

<Sysname> issu commit slot 4

Copying file flash:/feature1.bin to slot4#flash:/feature1.bin...Done.

Verifying the file flash:/feature1.bin on slot 4..............Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

4 Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

<Sysname> issu commit slot 1

Copying file flash:/feature1.bin to slot1#flash:/feature1.bin...Done.

Verifying the file flash:/feature1.bin on slot 1..............Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

1 Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

本命令顯示信息的描述請參見表1-9。

【相關命令】

· issu accept

· issu load

· issu run switchover

1.1.24 issu load

issu load命令用來升級從設備的啟動軟件包並將從設備的主用下次啟動軟件包設置為指定的軟件包。

【命令】

issu load file { boot filename | system filename | feature filename&<1-30> } * slot slot-number&<1-9> [ reboot ]

issu load file ipe ipe-filename slot slot-number&<1-9> [ reboot ]

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

boot：Boot包。

system：System包。

feature：Feature包。最多可指定30個。

filename&<1-30>：表軟件包的名稱，形如filesystemname/filename.bin。該文件必須保存在主設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。&<1-30>表示前麵的參數最多可以輸入30次。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

ipe ipe-filename：IPE文件，ipe-filename表示IPE文件的名稱，形如filesystemname/filename.ipe。該文件必須保存在主設備任一文件係統的根目錄下，該參數中必須包含文件係統的名稱，從存儲介質名稱開始最多可輸入63個字符。有關指定文件夾和文件詳細介紹請參見“基礎配置指導”中的“文件係統管理”。

slot slot-number：表示從設備在IRF中的成員編號。&<1-9>表示前麵的參數最多可以輸入9次。

· 如果IRF中隻有一個成員設備，則輸入該成員設備的編號，用來完成整個IRF的升級。

· 如果IRF中有多個成員設備：

¡ 當要升級的軟件包的版本和設備當前運行的軟件包的版本兼容時，隻允許輸入一個slot-number。

¡ 當要升級的軟件包的版本和設備當前運行的軟件包的版本不兼容時，可以輸入多個slot-number，一次升級多個從設備。

¡ 如果IRF為環形連接，建議一次升級一半數量的物理上鄰接的成員設備（也稱為對半升級）

reboot：表示在版本兼容的情況下，如果決策出來的結果是文件級增量升級、服務級增量升級、ISSU軟重啟升級則強製使用兼容重啟升級重啟成員設備以完成升級。不指定該參數時，係統會按照決策結果進行升級。

【使用指導】

配置前提

工作機製

輸入該命令後，係統將自動執行以下操作：

· 進行版本兼容性檢查。

· 確定升級策略。

· 按照升級策略進行升級，並將指定成員設備的主用下次啟動軟件包設置為issu load命令中指定的包。

注意事項

本命令可以指定一個或多個BIN包升級，但要求升級完成後的啟動列表上的所有軟件包版本一致。若僅升級部分bin包，且升級包的版本號與另一部分bin包版本號不一致，升級失敗。

此時存在如下兩種解決方法：

· 升級啟動列表裏的所有bin包。如果是IPE包內的BIN包未包含設備上運行的部分Feature包，那麼需要先獲取到這些部分Feature包與IPE包版本相同的升級包，通過install add命令將IPE包解壓縮成BIN包後再指定啟動列表裏的所有BIN包一起升級。

· 確保Feature包上的功能在設備上處於關閉狀態，再使用install deactivate命令卸載這些Feature包之後再升級啟動列表上剩下的BIN包。

【舉例】

# 版本兼容情況下，使用flash:/feature1.bin升級從設備2上的Feature包。

<Sysname> issu load file feature flash:/feature1.bin slot 2

This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y

Verifying the file flash:/feature1.bin on slot 1...Done.

Copying file flash:/feature1.bin to slot2#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

2 Service Upgrade

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

# 增量升級情況下，使用flash:/feature1.bin升級從設備2上的Feature包，帶reboot參數。

<Sysname> issu load file feature flash:/feature1.bin slot 2 reboot

This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y

Verifying the file flash:/feature1.bin on slot 1...Done.

Copying file flash:/feature1.bin to slot2#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 2...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

2 Reboot

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

# 版本不兼容情況下，使用flash:/feature1.bin升級從設備3和4上的Feature包。

<Sysname> issu load file feature flash:/feature1.bin slot 3 4

This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]:Y

Verifying the file flash:/feature1.bin on slot 1...Done.

Copying file flash:/feature1.bin to slot3#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 3...Done.

Copying file flash:/feature1.bin to slot4#flash:/feature1.bin......Done.

Verifying the file flash:/feature1.bin on slot 4...Done.

Identifying the upgrade methods….Done.

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

3 Reboot

4 Reboot

Upgrading software images to incompatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

表1-9 issu load命令顯示信息描述表

字段	描述
This operation will delete the rollback point information for the previous upgrade and maybe get unsaved configuration lost. Continue? [Y/N]	當前操作會刪除上一次ISSU升級的日誌信息和回滾點，並且未保存的配置可能會丟失，詢問用戶是否繼續執行升級操作
Verifying the file flash:/xx.bin................................Done.	驗證文件是否合法
Decompressing file A to B...........................Done.	將文件從位置A解壓縮到位置B。隻有使用IPE文件升級時，才顯示該信息
Copying file B to C......Done.	將文件從位置B拷貝到位置C。當配置從設備時才有該提示信息
Identifying the upgrade methods….Done.	獲取升級策略
Upgrade summary according to following table	升級信息摘要
Running Version	設備當前運行的相同類型軟件包的產品版本號
New Version	將要升級的軟件包的產品版本號
Upgrade Way	升級策略，取值可能為： · Service Upgrade：表示服務級增量升級 · File Upgrade：表示文件級增量升級。 · Reboot：表示通過重啟方式升級有關兼容升級的具體介紹請參見“基礎配置指導”中的“ISSU配置”
Upgrading software images to compatible versions. Continue? [Y/N]	詢問用戶是否執行兼容升級操作
Upgrading software images to incompatible versions. Continue? [Y/N]	詢問用戶是否執行不兼容升級操作
This operation might take several minutes, please wait	升級操作需要花費一定時間，請等待
Done.	表示激活成功
Operation failed.	表示激活失敗

1.1.25 issu quit

issu quit命令用來強製結束ISSU升級流程。

【命令】

issu quit

【視圖】

係統視圖

【缺省用戶角色】

network-admin

【使用指導】

應用場景

執行此命令將結束整個ISSU流程，係統恢複到Init狀態。當ISSU升級異常且不能再次進行升級或回滾操作時，可以使用本命令強製結束ISSU升級流程。

ISSU升級異常是指設備的ISSU狀態不是Init狀態，而升級已經停止；或者設備進入Init狀態，但升級並未完成。執行install activate、issu load命令的ISSU升級流程中可能出現ISSU升級異常。

注意事項

強製結束ISSU升級流程之後，係統的升級可能並未完成。請檢查係統狀態是否符合ISSU升級要求。若係統狀態符合ISSU升級要求，可以使用boot-loader或者install命令恢複版本為初始狀態之後嚐試重新升級。若重新升級再次失敗，請聯係技術支持。

【舉例】

# 強製結束ISSU升級流程。

<Sysname> system-view

[Sysname] issu quit

This command stops the ongoing ISSU process. Execute this command only under the guidance of the technical support. Continue? [Y/N]:y

Succeeded.

【相關命令】

· install activate

· issu load

1.1.26 issu rollback

issu rollback命令用來回滾到升級前的版本。

【命令】

issu rollback

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【使用指導】

應用場景

設備支持自動回滾和手動回滾，自動回滾定時器的時長由issu rollback-timer命令配置；手工回滾由issu rollback命令觸發。

當ISSU升級狀態為如下幾種情況時，支持手工回滾：

· Loaded

· Switching（兼容升級）

· Switchover（兼容升級）

· Accepted

注意事項

在重啟升級的Switching狀態下如果進行手工回滾或者發生自動回滾和在不兼容升級的Switching狀態下發生自動回滾，將會導致如下現象：

· 已升級的從設備重啟，此時主用主設備可能因正在進行主備倒換重啟而導致斷流。

· 回滾隻保證版本回到升級前，但不能保證主備狀態和升級前一致。

建議不要在Switching狀態下進行手工回滾，並且設置足夠長的自動回滾定時器時長。

【舉例】

# 回滾到升級之前的版本。

<Sysname> issu rollback

This command will quit the ISSU process and roll back to the previous version. Continue? [Y/N]:y

【相關命令】

· issu accept

· issu commit

· issu load

· issu run switchover

1.1.27 issu rollback-timer

issu rollback-timer命令用來設置回滾定時器時長。

undo issu rollback-timer命令用來恢複缺省情況。

【命令】

issu rollback-timer minutes

undo issu rollback-timer

【缺省情況】

回滾定時器的時長為45分鍾。

【視圖】

係統視圖

【缺省用戶角色】

network-admin

【參數】

minutes：回滾定時器的時長，取值範圍為0～120，單位為分鍾。如果時長設置為0，則表示關閉自動回滾功能。

【使用指導】

應用場景

設備隻有在兼容版本升級且存在多個成員設備的IRF係統情況下才能啟動回滾定時器。

注意事項

兼容版本升級的情況下，執行issu run switchover命令後係統會自動啟動回滾定時器。如果在指定的時間內（回滾定時器超時前）未執行issu accept或者issu commit命令，則係統會自動回滾到升級前的版本。

新設置的時長會在下次ISSU升級中生效。

【舉例】

# 設置回滾定時器時長為50分鍾。

<Sysname> system-view

[Sysname] issu rollback-timer 50

【相關命令】

· issu rollback

1.1.28 issu run switchover

issu run switchover命令用來進行ISSU倒換。

【命令】

issu run switchover

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【使用指導】

配置前提

工作機製

輸入該命令後，係統在不同情況下將自動執行不同的操作：

· 兼容升級：增量升級時係統會對升級的進程進行了進程級主備倒換；軟重啟或者重啟升級時係統會將當前主設備使用原版本重新啟動，將剛使用issu load命令升級的從設備選舉為新主設備。

· 不兼容版本升級：執行issu load後IRF分裂，生成兩個的IRF。執行issu run switchover重啟並升級原IRF，原IRF組重啟後加入新的IRF即完成升級過程，係統選擇新IRF的主設備為合並後IRF的主設備。

注意事項

當設備上隻有一個成員並需要升級時，不需要使用此命令。

兼容版本升級時，如果在回滾定時器超時時仍未執行issu accept或者issu commit命令，則係統會自動回滾到升級前的版本。

不兼容版本升級執行issu run switchover之後，即完成升級過程。

【舉例】

# 版本兼容情況下，進行主備倒換。

<Sysname> issu run switchover

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Switchover Way

1 Active standby process switchover

Upgrading software images to compatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

# 版本不兼容情況下，進行主備倒換，同時升級成員設備1（主設備）和成員設備2（從設備）。

<Sysname> issu run switchover

Upgrade summary according to following table:

flash:/feature1.bin

Running Version New Version

Test 0001015 Test 0001016

Slot Upgrade Way

1 Reboot

2 Reboot

Upgrading software images to incompatible versions. Continue? [Y/N]:y

This operation might take several minutes, please wait...Done.

表1-10 issu run switchover命令顯示信息描述表

字段	描述
Switchover Way	倒換方式，取值可能為： · Active standby process switchover：表示主備進程的倒換 · Master subordinate switchover：表示主設備和從設備之間的倒換
其它字段	請參見表1-9

字段

描述

Switchover Way

倒換方式，取值可能為：

· Active standby process switchover：表示主備進程的倒換

· Master subordinate switchover：表示主設備和從設備之間的倒換

其它字段

請參見表1-9

【相關命令】

· issu load

1.1.29 reset install log-history oldest

reset install log-history oldest命令用來清除ISSU日誌。

【命令】

reset install log-history oldest log-number

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

log-number：ISSU日誌的數量。

【使用指導】

執行本命令後，係統將按創建時間由早到晚的順序清除指定數量的ISSU日誌。

【舉例】

# 清除2條最早的ISSU日誌。

<Sysname> reset install log-history oldest 2

【相關命令】

· display install log

1.1.30 reset install rollback oldest

reset install rollback oldest命令用來清除ISSU回滾點。

【命令】

reset install rollback oldest point-id

【視圖】

用戶視圖

【缺省用戶角色】

network-admin

【參數】

point-id：係統存儲的回滾點的編號。

【使用指導】

執行本命令後，將清除指定回滾點以及在此回滾點之前創建的所有回滾點，請謹慎使用。

【舉例】

# 清除編號為2以及在此回滾點之前創建的所有回滾點。

<Sysname> reset install rollback oldest 2

【相關命令】

· display install rollback

不同款型規格的資料略有差異, 詳細信息請向具體銷售和400谘詢。H3C保留在沒有任何通知或提示的情況下對資料內容進行修改的權利!

熱門推薦

熱門推薦

H3C服務器

HPE服務器

熱門推薦

H3C存儲

HPE存儲

熱門推薦

商用台式機

商用筆記本

商用顯示器

配件

熱門推薦

熱門推薦

智能終端

技術解決方案

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

專業安全服務

安全運營服務

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

技術支持

自助服務

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

熱門推薦

公司刊物

加入我們

國家/地區

01-基礎配置命令參考

目錄

09-ISSU命令

1 ISSU

1.1 ISSU配置命令

應用場景

注意事項

1.1.3 display install committed

應用場景

注意事項

1.1.4 display install inactive

工作機製

注意事項

應用場景

注意事項

1.1.10 display install which

概念介紹

應用場景

工作機製

1.1.12 display issu state

注意事項

1.1.13 display version comp-matrix file

工作機製

注意事項

1.1.15 install activate

配置前提

注意事項

配置前提

應用場景

工作機製

注意事項

1.1.18 install deactivate

配置前提

注意事項

1.1.20 install rollback to

應用場景

注意事項

應用場景

工作機製