インサービス ソフトウェア アップグレード

インサービス ソフトウェア アップグレードについて

In-Service Software Upgrade（ISSU）は、ネットワークがパケットの転送を継続したまま、ワイヤレスコントローラのイメージを新しいリリースにアップグレードする手順です。ISSU を活用することで、ネットワークを停止させずにソフトウェアをアップグレードすることができます。

ISSU はまた、アクティブネットワークに影響を与えずにコールドパッチを適用するためにも使用できます。

ISSU は、次の Cisco Catalyst 9800 シリーズ ワイヤレス コントローラでのみサポートされ、アップグレードのみがサポートされます。

  • Cisco Catalyst 9800-80 ワイヤレスコントローラ

  • Cisco Catalyst 9800-40 ワイヤレスコントローラ

  • Cisco Catalyst 9800-L ワイヤレスコントローラ

  • Cisco Catalyst 9800-CL ワイヤレスコントローラ（プライベートクラウド）

ISSU のワークフローの概要

  1. コントローラのソフトウェアイメージをフラッシュメモリにオンボードします。

  2. AP イメージを AP にダウンロードします。

  3. コントローラのソフトウェアイメージをインストールします。

  4. 変更を確定します。

インサービス ソフトウェア アップグレードを実行するための前提条件

  • アクティブコントローラとスタンバイコントローラの両方がインストールモードであり、bootflash:/packages.conf から起動されていることを確認します。

  • アップグレード中にネットワークまたはデバイスが設定されていないことを確認します。

  • アップグレードは、ネットワークが安定しているときにスケジュールします。

  • 無停電電源を確保します。アップグレードの手順中に電源が中断されると、ソフトウェアイメージが破損する可能性があります。

インサービス ソフトウェア アップグレードに関するガイドラインと制限事項

  • install activate issu コマンド実行から 6 時間以内に install commit コマンドを実行しない場合、元のコミット位置に戻ります。遅延コミットの手順を使用して、コミットを遅延させることができます。

  • ISSU アップグレード中、AP ローリングアップグレードが進行しているときは install abort コマンドが機能しません。アップグレードをキャンセルするには、代わりに install abort issu コマンドを使用する必要があります。

  • ISSU アップグレード中、次のような警告メッセージが表示されます。 
    found 46 disjoint TDL objects
    。機能上の影響はないため、警告メッセージは無視できます。

  • ISSU のアップグレード中、電源の再投入後に両方のコントローラ（アクティブとスタンバイ）のイメージが異なる場合、ISSU の自動キャンセルがトリガーされ、両方のコントローラが同じバージョンになります。次に、サンプルシナリオを示します。アクティブコントローラに Version1（V1）ソフトウェアをインストールしてから、SMU ホットパッチを適用してコミットを実行します。ここで、ISSU を使用してソフトウェアを Version2 にアップグレードし、それからアクティブコントローラの電源を再投入します。この時点で、システムのバージョンは一致しません（V1 と V2）。一括同期の完了後、この段階でアクティブコントローラがリロードされます。これで、両方のコントローラが同じバージョン（V1 と V1）になります。

  • スタンバイコントローラで設定の同期に失敗したためにキャンセルされた ISSU アップグレードは、V1 のソフトウェアイメージにロールバックされます。ただし、この情報は show install コマンドのログでは確認できません。現在の ISSU の状態を確認するには、show issu state detail コマンドを実行します。

  • clear install コマンドを有効にするには、まずグローバル コンフィギュレーション モードで service internal コマンドを実行し、次に特権 EXEC モードで clear install コマンドを実行します。

  • コントローラに古いロールバック履歴があり、その後スタックが形成されると、イメージのロールバックが影響を受ける可能性があります。clear install state コマンドを実行して古い情報をクリアし、バンドルモードでコントローラを起動することを推奨します。

  • clear install state コマンドは、フラッシュまたはストレージから SMU ファイルを削除しません。SMU を削除するには、install remove file コマンドまたは install remove inactive コマンドを使用します。

  • イメージのアップグレード後に新しいアクティブコントローラが起動すると、Web GUI ウィンドウで古いログが show logs の一部として保持されません。

  • ISSU 機能のローリング AP アップグレード手順中にステートフル スイッチオーバー（SSO）または高可用性（HA）イベントが発生した場合、ローリング AP アップグレードは停止します。その後、ap image upgrade コマンドを使用して、アップグレードプロセスを再開する必要があります。

  • ISSU 手順後に HA の形成に失敗した場合は、いずれかのシャーシをリロードして HA を再度形成する必要があります。

  • show ap image コマンドを使用する前に、clear ap predownload statistics コマンドを使用します。これにより、プレダウンロードの後に毎回適切なデータを取得できます。

  • アクティブコントローラとスタンバイコントローラ間のソフトウェアバージョンの不一致を回避するため、以下のシナリオでは install issu abort コマンドを使用して ISSU プロセスを手動でキャンセルします。

    • ISSU 手順中、スタンバイホットの後に RP リンクがダウンし、自動中止タイマーの期限が切れた後もリンクがダウンしたままになる。

    • ISSU 手順中、スタンバイコントローラがスタンバイホットになる前に RP リンクがダウンする。

  • Cisco TrustSec（CTS）は RMI インターフェイスでサポートされていません。

  • ISSU を使用する AP アップグレードの実行中にスイッチオーバーが発生した場合、アップグレードプロセスがスイッチオーバー後に自動的に再開されます。

  • WPA3 suite-b-192、suite-b、または gcmp128/gcmp256/ccmp256 がすでに設定されている場合、17.12 から 17.15 への ISSU アップグレードは失敗します。

インサービス ソフトウェア アップグレードを使用したソフトウェアのアップグレード

イメージから別のイメージへの完全なイメージのアップグレードを実行するには、次の手順を使用します。


（注）  

ISSU は、メジャーリリース内およびメジャーリリース間でのみサポートされます。たとえば、17.3.x から 17.3.y、17.6.x から 17.6.y（メジャーリリース内）および 17.3.x から 17.6.x、17.3.x から 17.9.x（メジャーリリース間）、現在サポートされているリリースの 2 つ後のリリースまでです。ISSU は、マイナーリリース内およびマイナーリリース間、またはマイナーリリースとメジャーリリース間ではサポートされません。たとえば、17.4.x から 17.4.y または 17.4.x から 17.5.x または 17.3.x から 17.4.x です。

ISSU ダウングレードは、Cisco Catalyst 9800 シリーズ ワイヤレス コントローラ プラットフォームではサポートされていません。

（注）  

ap upgrade staggered コマンドを使用して、アップグレードする AP の割合を設定することを推奨します。

手順

  コマンドまたはアクション 目的

ステップ 1

install add file file-name

例:

Device# install add file <>

コントローラのソフトウェアイメージがフラッシュに追加されて展開されます。

（注）  

 

スイッチ用 Cisco Catalyst 9800 ワイヤレス コントローラで、 install add file sub-package-file-name コマンドを実行して、ワイヤレス サブパッケージ ファイルを展開します。

ステップ 2

ap image predownload

例:

Device# ap image predownload

AP イメージのプレダウンロードを実行します。

プレダウンロードの進行状況を確認するには、show ap image コマンドを使用します。

ステップ 3

install activate issu [ auto-abort-timer timer]

例:

Device# install activate issu

互換性チェックを実行し、パッケージをインストールして、パッケージのステータスの詳細を更新します。

必要に応じて、イメージをコミットせずに新しいソフトウェアの追加をキャンセルする時間制限を設定できます。有効な値は 30 ～ 1200 分です。

ステップ 4

次のコマンドのいずれかを実行します。

  • install abort issu 
    Device# install abort issu

    アップグレードプロセスをキャンセルし、デバイスを以前のインストール状態に戻します。これは、コントローラと AP の両方に適用されます。

  • install commit 
    Device# install commit

    リロードが繰り返されても持続するようにアクティブ化の変更をコミットします。

    （注）  

     

    前のステップが完了してから 6 時間以内に install commit コマンドを実行しない場合、元のコミット位置に戻ります。

ISSU を使用したソフトウェアのアップグレード（GUI）

始める前に

  1. デバイスは、インストールモードである必要があります。

  2. デバイスには HA ペアが必要です。スタンバイコントローラはオンラインで、SSO モードになっている必要があります。

    show issu state detail コマンドを使用して詳細を確認できます。

手順

ステップ 1

[Administration] > [Software Management] を選択します。

ステップ 2

[Software Upgrade] タブで、[ISSU Upgrade (HA Upgrade) (Beta)] チェックボックスをオンにします。

ステップ 3

[AP Upgrade Configuration] セクションで、[AP Upgrade per Iteration] ドロップダウンリストから、アップグレードする AP の割合を選択します。

ステップ 4

[Download & Install] をクリックします。

これにより、アップグレードプロセスが開始され、[Status] ダイアログボックスで進行状況を確認できます。

[Show Logs] リンクをクリックして、アップグレードプロセスの詳細を表示します。

（注）  

 

SSO は、アクティブコントローラでイメージをアクティブにするときに実行されます。SSO の後、コントローラに再度ログインする必要があります。

ステップ 5

アップグレード後、[Commit] ボタンと [ISSU Abort] ボタンが有効になります。

[Commit] をクリックしてアクティベーションの変更をコミットするか、[ISSU Abort] をクリックしてアップグレードプロセスを終了し、デバイスを以前のインストール状態に戻します。

遅延コミットによるインサービス ソフトウェア アップグレードを使用したソフトウェアのアップグレード

遅延コミットを使用してコントローラソフトウェアをアップグレードするには、この手順を使用します。これは、イメージをコミットせずに新しいソフトウェアを実行およびテストするために役立ちます。

手順

  コマンドまたはアクション 目的

ステップ 1

install add file file-name

例:

Device# install add file <file>

コントローラ ソフトウェア イメージをフラッシュに追加して展開します。

（注）  

 

スイッチ用 Cisco Catalyst 9800 ワイヤレス コントローラで、 install add file sub-package-file-name コマンドを実行して、ワイヤレス サブパッケージ ファイルを展開します。

ステップ 2

ap image predownload

例:

Device# ap image predownload

AP イメージのプレダウンロードを実行します。

ステップ 3

install auto-abort-timer stop

例:

Device# install auto-abort-timer stop

終了タイマーを停止して、デフォルトの終了時間である 6 ～ 8 時間後にアップグレードプロセスが終了しないようにします。

ステップ 4

install activate issu

例:

Device# install activate issu

互換性チェックを実行し、パッケージをインストールして、パッケージのステータスの詳細を更新します。

ステップ 5

install commit

例:

Device# install commit

リロードが繰り返されても持続するようにアクティブ化の変更をコミットします。

インサービス ソフトウェア アップグレードのモニタリング

install add ISSU の後、install activate ISSU の前に ISSU の状態を表示するには、次のコマンドを使用します。

Device# show issu state detail

-- Starting local lock acquisition on chassis 1 ---
Finished local lock acquisition on chassis 1
Current ISSU Status: Enabled 
Previous ISSU Operation: Abort Successful 
=======================================================
System Check Status
-------------------------------------------------------
Platform ISSU Support Yes
Standby Online Yes
Autoboot Enabled Yes
SSO Mode Yes
Install Boot Yes
Valid Boot Media Yes
=======================================================
No ISSU operation is in progress
show install summary
[ Chassis 1 2 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type St Filename/Version 
--------------------------------------------------------------------------------
IMG I 17.1.1.0.432 
IMG C 16.12.2.0.2707
--------------------------------------------------------------------------------
Auto abort timer: inactive
--------------------------------------------------------------------------------

ISSU をアクティブ化した後に ISSU の状態を表示するには、次のコマンドを使用します。

Device# show issu state detail

Current ISSU Status: In Progress 
Previous ISSU Operation: Abort Successful 
=======================================================
System Check Status
-------------------------------------------------------
Platform ISSU Support Yes
Standby Online Yes
Autoboot Enabled Yes
SSO Mode Yes
Install Boot Yes
Valid Boot Media Yes
=======================================================
Operation type: Step-by-step ISSU
Install type : Image installation using ISSU
Current state : Activated state
Last operation: Switchover
Completed operations:
Operation Start time
-------------------------------------------------------
Activate location standby Chassis 2 2019-09-17:23:41:12
Activate location active Chassis 1 2019-09-17:23:50:06
Switchover 2019-09-17:23:52:03
State transition: Added -> Standby activated -> Active switched-over
Auto abort timer: automatic, remaining time before rollback: 05:41:53
Running image: bootflash:packages.conf
Operating mode: sso, terminal state reached
show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type St Filename/Version 
--------------------------------------------------------------------------------
IMG U 17.1.1.0.432
--------------------------------------------------------------------------------
Auto abort timer: active on install_activate, time before rollback - 05:41:49
--------------------------------------------------------------------------------

コミットのインストール後に ISSU の状態を表示するには、次のコマンドを使用します。

Device# show issu state detail

--- Starting local lock acquisition on chassis 1 ---
Finished local lock acquisition on chassis 1
Current ISSU Status: Enabled 
Previous ISSU Operation: Successful 
=======================================================
System Check Status
-------------------------------------------------------
Platform ISSU Support Yes
Standby Online Yes
Autoboot Enabled Yes
SSO Mode Yes
Install Boot Yes
Valid Boot Media Yes
=======================================================
No ISSU operation is in progress
show install summary
[ Chassis 1/R0 2/R0 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type St Filename/Version 
--------------------------------------------------------------------------------
IMG C 17.1.1.0.432
--------------------------------------------------------------------------------
Auto abort timer: inactive
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

ISSU プロセスの終了後に ISSU の状態を表示するには、次のコマンドを使用します。

Device# show issu state detail
Current ISSU Status: In Progress 
Previous ISSU Operation: Abort Successful 
=======================================================
System Check Status
-------------------------------------------------------
Platform ISSU Support Yes
Standby Online Yes
Autoboot Enabled Yes
SSO Mode Yes
Install Boot Yes
Valid Boot Media Yes
=======================================================
Operation type: Step-by-step ISSU
Install type : Image installation using ISSU
Current state : Timeout-error state
Last operation: Commit Chassis 1
Completed operations:
Operation Start time
-------------------------------------------------------
Activate location standby Chassis 2 2019-09-17:23:41:12
Activate location active Chassis 1 2019-09-17:23:50:06
Switchover 2019-09-17:23:52:03
Abort 2019-09-18:00:14:13
Commit Chassis 1 2019-09-18:00:28:23
State transition: Added -> Standby activated -> Active switched-over -> Activated -> Timeout-error
Auto abort timer: inactive
Running image: bootflash:packages.conf
Operating mode: sso, terminal state reached
システム内のアクティブなパッケージの概要を表示するには、次のコマンドを使用します。
Device# show install summary

[ Chassis 1 2 ] Installed Package(s) Information:
State (St): I - Inactive, U - Activated & Uncommitted,
C - Activated & Committed, D - Deactivated & Uncommitted
--------------------------------------------------------------------------------
Type St Filename/Version 
--------------------------------------------------------------------------------
IMG C 16.12.2.0.2707
--------------------------------------------------------------------------------
Auto abort timer: inactive
--------------------------------------------------------------------------------

ISSU のトラブルシューティング

AP のプレダウンロードを完了する前に、install activate issu コマンドを使用します。

次のシナリオは、AP のプレダウンロードを完了する前に install activate issu コマンドを実行する場合に適用されます。このような場合、ap image predownload コマンドを実行してからアクティベーションに進む必要があります。 

Device# install activate issu

install_activate: START Wed Jan  8 04:48:04 UTC 2020
System configuration has been modified.
Press Yes(y) to save the configuration and proceed.
Press No(n) for proceeding without saving the configuration.
Press Quit(q) to exit, you may save configuration and re-enter the command. [y/n/q]
y
Building configuration...
[OK]Modified configuration has been saved
install_activate: Activating ISSU
NOTE: Going to start Activate ISSU install process
STAGE 0: System Level Sanity Check
===================================================
--- Verifying install_issu supported ---
--- Verifying standby is in Standby Hot state ---
--- Verifying booted from the valid media ---
--- Verifying AutoBoot mode is enabled ---
--- Verifying Platform specific ISSU admission criteria ---
CONSOLE: FAILED: Install operation is not allowed.
 Reason -> AP pre-image download is mandatory f
or hitless software upgrade.
 Action -> Trigger AP pre-image download.
FAILED: Platform specific ISSU admission criteria
ERROR: install_activate  exit(2 ) Wed Jan  8 04:48:37 UTC 2020