My Home NW Lab

逸般の誤家庭のネットワーク

Catalyst 9800でWeb UIからのSoftware Upgrade (Azure版で From: v17.7.1 -> To: v17.9.3 の一例)

Catalyst 9800-CL (Azure版)でWeb UIからのSoftware Upgradeの検証を行いました。 Azure版だと2023年07月時点で v17.7.1 のImageしか選択できなかったので、当時の推奨である v17.9.3 へのVersion調整を兼ねてAzure版を選んだのが背景にあります。 Software Upgradeの手順自体はCatalyst 9800シリーズで共通の手順となっております。

注意事項

  • 初期セットアップ直後のVersion調整を想定しているため、サービス断については考慮しておりません。

  • v17.4 以上では、Upgrade後にCommitを実行する必要があります。Commitを行わないと6時間後に元のVersionに戻ります。

    Cisco Catalyst 9800 Series Wireless Controller Software Configuration Guide, Cisco IOS XE Cupertino 17.7.x - Upgrading the Cisco Catalyst 9800 Wireless Controller Software [Cisco Catalyst 9800 Series Wireless Controllers] - Cisco
    https://www.cisco.com/c/en/us/td/docs/wireless/controller/9800/17-7/config-guide/b_wl_17_7_cg/m_upgrade_9800cl.html

    For 17.4 and later releases, this step is mandatory for the upgrade to be persisitent. If you do not click Commit, the auto-timer terminates the upgrade operation after 6 hours, and the controller reverts back to the previous image.

事前の計画に必要な情報源

事前の計画において調査に必要となるドキュメントをまとめました。

推奨Version

特定のVersionを選ぶ特別な理由がなければ、推奨Versionの情報をチェックしてください。

Recommended Cisco IOS XE Releases for Catalyst 9800 Wireless LAN Controllers - Cisco
https://www.cisco.com/c/en/us/support/docs/wireless/catalyst-9800-series-wireless-controllers/214749-tac-recommended-ios-xe-builds-for-wirele.html

Cisco Wireless Solutionsの互換性

Cisco Identity Services EngineやDNA Center等との製品連携を行っていると、互換性の整合性を取る必要があります。

Cisco Wireless Solutions Software Compatibility Matrix - Cisco
https://www.cisco.com/c/en/us/td/docs/wireless/compatibility/matrix/compatibility-matrix.html

Release Note

Software Upgrade作業において事前にケアしておく情報がないかをRelease Noteで確認しておきます。

Cisco Catalyst 9800 Series Wireless Controllers - Release Notes - Cisco
https://www.cisco.com/c/en/us/support/wireless/catalyst-9800-series-wireless-controllers/products-release-notes-list.html

筆者の場合はAzure版の v17.7.1 からのUpgradeであったので、v17.9.X のドキュメントからUpgrade Pathを確認して v17.7.1 から v17.9.3 に直接的にUpgradeできるかを確認しました。

Release Notes for Cisco Catalyst 9800 Series Wireless Controller, Cisco IOS XE Cupertino 17.9.x - Cisco
https://www.cisco.com/c/en/us/td/docs/wireless/controller/9800/17-9/release-notes/rn-17-9-9800.html#Cisco_Concept.dita_59a2987f-2633-4630-8c7b-a8e8aecdeaf7

Upgrade Pathの確認例

Software Upgradeの手順

Software Upgradeの手順がConfiguration Guideに載っているので該当Versionの情報を確認します。

Cisco Catalyst 9800 Series Wireless Controllers - Configuration Guides - Cisco
https://www.cisco.com/c/en/us/support/wireless/catalyst-9800-series-wireless-controllers/products-installation-and-configuration-guides-list.html

Software Upgradeの手順

Upgrade Mode に関する補足情報

Software Upgradeの作業において Upgrade Mode の指定箇所があり Install mode もしくは Bundle mode を指定可能です。 Best Practiceでは、起動時間の短縮やメモリ消費量の削減などの観点で Install mode が推奨されているため、本記事では Install mode を指定する想定にしております。

Cisco Catalyst 9800 Series Configuration Best Practices - Cisco
https://www.cisco.com/c/en/us/products/collateral/wireless/catalyst-9800-series-wireless-controllers/guide-c07-743627.html#Installvsbundlemode

作業前の設定の保存

  • 作業前に現状の設定を保存した上で、作業端末にコンフィグをダウンロードしておきます。作業前後の差分比較などに活用します。

    設定の保存とダウンロード (1/2)

    設定の保存とダウンロード (2/2)

Software Upgradeの実施

  • メニュー: Administration > Software ManagementSoftware Upgrades に移動します。

    メニュー: Administration > Software Management

  • Upgrade Mode はBest Practiceで推奨されている INSTALL (Install mode)のままにしておきます。

    Upgrade Mode

  • Transport TypeMy Desktop になっている状態で Source Fie Path ボタンを押下し、作業端末上にあるFirmwareを指定します。続いて Download & Install ボタンを押下します。

    Firmwareの転送とInstallの実行

  • Upgrade作業の時間待ちでWeb UIを操作せずに放置していると、セッションがタイムアウトする可能性があり、タイムアウトしてしまった場合は再読み込みを行ってくださいの旨が表示されます。このまま続行するかも問われているのでYes ボタンを押下します。

    Upgrade作業続行の確認

    下記はダイアログに表示されるメッセージです。

You are going to upgrade software on the device. During the upgrade the current session might time out. If so, please reload the browser window and login, to access webui.

Do you want to proceed?
  • Firmwareのファイル転送中はプログレス バーに転送状況が表示されます。ファイルの転送が完了してInstallの段階になると Status 欄の Install Image/Package... がローディングのアイコンになります。

    進行段階の確認

  • ファイルの転送とInstallが完了したら Save Configuration & Activate を押下します。

    Save Configuration & Activate

  • Firmware (Image)をアクティベーションすると再起動が発生するのでデバイスへの接続が失われる旨の警告と、アクティベーション後にはCommit操作が必要な旨が表示されます。実行タイミングに問題がなければ Yes ボタンを押下します。

    警告メッセージ

    下記はダイアログに表示されるメッセージです。

You are going to activate the newly installed image/package. In case of an image, this would cause a device reload. Network Connectivity to the device will be lost.

Once the image/package is activated, please perform the commit operation. If you are downgrading to an older release, the commit operation needs to be done via the command line interface using the command 'install commit'.
  • 再起動の完了後は、メニュー: Administration > Software ManagementSoftware Upgrades に移動し直します。Software Upgrades の画面に移動し直すと、タイマーが切れる前にCommitする必要がある旨のリマインダーが表示されるので OK ボタンを押下します。

    リマインダーの表示

    下記はダイアログに表示されるメッセージです。

The device has uncommitted IMG/PKG files. Please commit them before the timer expires.
  • Commit ボタンを押下します。

    Commit ボタン

  • Commitが反映されると Status の欄に表示されます。

    Commit の反映確認

Upgrade後の設定状態の確認

  • Upgrade後の設定状態を確認します。適宜、作業前後での差分比較を行ってください。

    WinMergeによる比較イメージ

関連記事

myhomenwlab.hatenablog.com