アクセス ポイントへのイメージのプレダウンロード

アクセス ポイントへのイメージのプレダウンロードについて

ネットワークの停止を最小限に抑えるため、アクセス ポイントをリセットしたり、ネットワーク接続を切断したりせずに、deviceからのアクセス ポイントにアップグレード イメージをダウンロードしてください。以前は、アップグレード イメージをdeviceにダウンロードしてコントローラをリセットすると、アクセス ポイントがディスカバリ モードに移行してしまう場合がありました。アクセス ポイントで新しいイメージを含むコントローラが検出されると、新しいイメージがダウンロードされ、アクセス ポイントがリセットされ、ディスカバリ モードに移行し、deviceに再参加されていました。

これで、コントローラにアップグレード イメージをダウンロードできるようになります。コントローラがアップグレード イメージを使用して起動すると、AP はコントローラに参加し、Registered（登録済み）状態に移行します。これは、すでに AP イメージが AP にプレダウンロードされているためです。

アクセス ポイントへのイメージのプレダウンロードの制限

以下は、アクセス ポイントにイメージをプレダウンロードする際の制約事項です。

  • 同時プレダウンロードの最大数は、コントローラの wncd インスタンスごとに 100 個（9800-L の場合は 25 個）に制限されています。ただし、プレダウンロードは、開始時に wncd インスタンスごとに 16 のセットでトリガーされ、60 秒ごとに繰り返されます。

  • アクセス ポイントの使用可能なメモリの全容量が 16 MB の場合は、アップグレード イメージをダウンロードすると空き容量が不足するおそれがあるため、クラッシュ情報ファイル、無線ファイル、およびバックアップ イメージが存在する場合、それらはすべて自動的に削除され、空き容量が確保されます。ただし、プレダウンロード イメージはアクセス ポイントのバックアップ イメージがあればそれらに置き換えられるため、この制限はプレダウンロード プロセスには影響しません。

  • すべてのプライマリ、セカンダリ、ターシャリ コントローラで、同じイメージを実行する必要があります。そうしないと、この機能は有効になりません。

  • リセット時に、すべてのアクセス ポイントでイメージのダウンロードが完了していることを確認する必要があります。

  • アクセス ポイントには、2 種類のソフトウェア イメージだけを保存できます。

  • Cisco Wave 1 AP は、Cisco AireOS リリース 8.3 から Cisco IOS XE Gibraltar 16.10.1 への移行中にイメージを 2 回ダウンロードする場合があります。これにより、移行中の AP のダウンタイムが増大します。

  • show ap image コマンドは、コントローラの AP イメージに関する累積統計を表示します。show ap image コマンドを使用する前に、clear ap predownload statistics コマンドを使用して統計をクリアして、正しいデータが表示されるようにすることをお勧めします。

  • Cisco Catalyst 9800-CL ワイヤレスコントローラは、自己署名証明書のみをサポートしていて、シスコ証明書はサポートしていません。Cisco Catalyst 9800-CL ワイヤレスコントローラ間でアクセスポイントを移動し、Cisco Catalyst 9800-CL コントローラで AP の参加に失敗した場合は、capwap ap erase all コマンドを実行して AP に保存されているハッシュ文字列を削除します。

  • AP イメージのプレダウンロード中に、WNCD CPU が 99% に上昇することがあります。これは正常な動作であり、クラッシュやクライアントまたは AP の切断の問題は発生しません。

アクセス ポイントへのイメージのプレダウンロード（CLI）

始める前に

イメージをアクセス ポイントにプレダウンロードする際に、覚えておく必要がある前提条件があります。

  • プレダウンロードは、デバイスがインストールモードで起動している場合にのみ可能です。


    （注）  

    AP イメージのプレダウンロードは、イメージタイプではなく AP モデルに基づいて行われます。プレダウンロードは、モデルが新しい機能 XML ファイルに存在する場合にのみ許可されます。また、機能 XML を適切に変更することで、コントローラは特定のモデルに対する既存の AP イメージをオーバーライドできます。

  • TFTP サーバー、フラッシュ イメージ、または USB から新しいイメージをコピーできます。

  • すでに最新のアップグレード イメージが AP に存在する場合、プレダウンロードはトリガーされません。show ap image コマンドを使用して、プライマリ イメージとバックアップ イメージのバージョンがアップグレード イメージと同じであるかどうかを確認します。

  • show ap image コマンドは、コントローラの AP イメージに関する累積統計を表示します。show ap image コマンドを使用する前に、 clear ap predownload statistics コマンドを使用して統計をクリアして、正しいデータが表示されるようにすることをお勧めします。

  • AP のプレダウンロード中に AP が SSO 後にフラップした場合、AP はプレダウンロード状態のままになります。ap image predownload abort コマンドを発行してから、clear ap predownload stats コマンドを発行することをお勧めします。この場合のみ、プレダウンロードを再開できます。

手順

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

ステップ 1

install add file bootflash:file-name

例:

Device# install add file bootflash:image.bin

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

ステップ 2

ap image predownload or ap name ap-name image predownload

例:

Device# ap image predownload
Device# ap name ap1 image predownload

すべてのアクセスポイントに、またはデバイスに接続している特定のアクセスポイントに、新しいイメージをダウンロードします。

ステップ 3

show ap image

例:

Device# show ap image

アクセスポイントのプレダウンロード ステータスを確認します。

このコマンドでは、最初にステータスが Predownloading として表示され、ダウンロードが完了すると Completed に移行します。

ステップ 4

show ap name ap-name image

例:

Device# show ap name ap1 image

特定の AP におけるイメージの詳細を提供します。

ステップ 5

ap image swap or ap name ap-name image swap or ap image swap completed

例:

Device# ap image swap

プレダウンロードが完了した AP どうしのイメージを交換します。

（注）  

 

新しいイメージを AP にプレダウンロードしなくても、ap image swap コマンドを使用して AP イメージをスワップできます。また、イメージをスワップするための制限や前提条件はありません。

ステップ 6

install activate

例:

Device# install activate

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

再起動可能なパッケージの場合、このコマンドは適切なポストインストール スクリプトをトリガーして必要なプロセスを再起動します。また、再起動できないパッケージの場合は、リロードをトリガーします。

（注）  

 

この手順により、完全なコントローラスタック（HA が使用されている場合はプライマリコントローラとセカンダリコントローラの両方）がリロードされます。

ステップ 7

install commit

例:

Device# install commit

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

アクティブ化の後で、システムがアップしている間、または最初のリロード後にコミットできます。パッケージがアクティブになっていてもコミットされていない場合は、最初のリロード後はアクティブの状態を保ちますが、2 回目のリロード後はアクティブ状態を保ちません。

アクセスポイントへのイメージのプレダウンロード（GUI）

手順

ステップ 1

[Administration] > [Software Management] を選択し、[Software Upgrade] タブをクリックします。

次の手順を続行するには、インストールモードである必要があります。

ステップ 2

ファイルの受信のために選択した [Transport Type]、[File System]、および [File Path] を選択します。

ステップ 3

[AP Image Predownload] チェックボックスをオンにします。

デバイスに非アクティブなイメージファイルがすでにある場合は、未使用のイメージを削除して最新のイメージのダウンロードを続行するように求めるダイアログボックスが表示されます。

ステップ 4

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

これにより、アップグレードプロセスが開始され、[Status] ダイアログボックスでプレダウンロードの進行状況を表示および確認できます。[Show Logs] アイコンをクリックして進行状況ログを確認することもできます。

ステップ 5

プレダウンロード操作が成功したら、[Save Configuration & Activate] ボタンをクリックします。

ステップ 6

アクティブ化操作を確定するには、[Yes] をクリックします。

この操作により、互換性チェックが実行され、パッケージがインストールされて、パッケージのステータスの詳細が更新されます。アクティブ化が成功すると、デバイスによりリロードされます。コミットされていないファイルがある場合は、そのファイルを削除するように求められます。

ステップ 7

[Commit] ボタンをクリックして、更新プロセスを完了します。

アクセスポイントへのイメージのプレダウンロード（YANG）

YANG を NETCONF および RESTCONF で使用すると、自動化されたプログラミング可能なネットワーク操作の望ましいソリューションが実現します。

アクセスポイントにイメージをプレダウンロードするために次の RPC が使用されます。


<rpc xmlns="urn:ietf:params:xml:ns:netconf:base:1.0" message-id="101">
  <set-rad-predownload-all xmlns="http://cisco.com/ns/yang/Cisco-IOS-XE-wireless-access-point-cmd-rpc">
    <uuid>12312341231234</uuid>
  </set-rad-predownload-all>
</rpc>

YANG モデルの詳細については、https://github.com/YangModels/yang/tree/master/vendor/cisco/xe にある『Cisco IOS XE Programmability Configuration Guide』および『YANG Data Models on Github』を参照してください。

次のリンクを使用して、NETCONF/YANG 機能の開発者のサポートコミュニティに問い合わせることができます。

https://developer.cisco.com/

アクセス ポイント プレダウンロード プロセスのモニタリング

このセクションでは、アクセス ポイントのプレダウンロード プロセスのモニタリングに使用できるコマンドについて説明します。

アクセス ポイント のプレダウンロード イメージのダウンロード中に、対応するアクセス ポイントのプレダウンロードの進捗を確認するには、show ap image コマンドを入力します。 

Device# show ap image
Total number of APs  : 1

Number of APs 
       Initiated                  : 1
       Predownloading             : 1
       Completed predownloading   : 0
       Not Supported              : 0
       Failed to Predownload      : 0

AP Name                           Primary Image   Backup Image    Predownload Status    Predownload Ver...  Next Retry Time    Retry Count 
------------------------------------------------------------------------------------------------------------------------------------------
AP1                               10.0.1.66       10.0.1.66       Predownloading        10.0.1.67           NA                           0 



Device# show ap image

Total number of APs  : 1

Number of APs 
       Initiated                  : 1
       Predownloading             : 0
       Completed predownloading   : 1
       Not Supported              : 0
       Failed to Predownload      : 0

AP Name                           Primary Image   Backup Image    Predownload Status    Predownload Ver...  Next Retry Time    Retry Count 
------------------------------------------------------------------------------------------------------------------------------------------
AP1                               10.0.1.66       10.0.1.67       Complete              10.0.1.67           NA   
                        0

特定の AP におけるイメージの詳細を表示するには、次のコマンドを使用します。

Device# show ap name APe4aa.5dd1.99b0 image
 
AP Name : APe4aa.5dd1.99b0
Primary Image : 16.6.230.46
Backup Image : 3.0.51.0
Predownload Status : None
Predownload Version : 000.000.000.000
Next Retry Time : N/A
Retry Count : 0

AP イメージのダウンロード時間機能拡張について（OEAP またはテレワーカーのみ）

ワイヤレスコントローラとアクセスポイント（AP）は、CAPWAP を使用して相互に通信します。CAPWAP には、制御とデータの 2 つのチャネルがあります。制御チャネルは、設定メッセージの送信、イメージとクライアントキー、または AP へのコンテキストのダウンロードに使用されます。現在の実装では、制御チャネルには単一のウィンドウがあります。単一のウィンドウは、コントローラから送信されるすべてのメッセージが AP によって確認応答される必要があることを意味します。次の制御パケットは、前の制御パケットが AP によって確認応答されるまで送信されません。

AP イメージのダウンロード時間拡張機能によって、コントローラから AP へ移行する制御パケットの複数のスライディングウィンドウに対するサポートが追加されます。スライディングウィンドウは、単一のウィンドウの代わりに N（静的）に設定できます。リクエストキューのサイズは、AP がサポートする最大ウィンドウサイズに基づいて決定されます。

表 1. 推奨ウィンドウサイズ

リンク帯域幅1

RTT が 200 ミリ秒未満

RTT が 200 ミリ秒超

20 Mbps 超

10

15

5 ～ 20 Mbps

10

15

1 ～ 5 Mbps

5

10

1 Mbps 未満

3

5
1 表に示されている推奨ウィンドウサイズは、パケット損失が 1% 未満の場合向けです。CAPWAP リンクをサポートするネットワークでパケット損失が 1% を超える場合は、ウィンドウサイズより小さい値を使用します。ラウンドトリップ時間（RTT）が約 100 ミリ秒で、パケットドロップが 0.5% 未満の適切なリンクの場合、パフォーマンスを向上させるために最大 20 のウィンドウサイズを使用します。

（注）  

  • ウィンドウサイズは、AP 参加プロセス中にのみ変更できます。

  • アップグレードを高速化するには、すべてのイメージのアップグレードを [install] モードにする必要があります。OEAP プレダウンロードを含めるには、one-shot コマンドからイメージのアップグレードを実行する必要があります。

  • テレワーカーまたは Office Extend Access Points（OEAP）専用の AP プロファイルに対してのみウィンドウサイズを設定します。

  • この機能を無効にした後は、AP のリロードは必要ありません。

  • この機能は、OEAP プロファイルでのみサポートされます。

  • GUI は AP のプレダウンロードをサポートしていません。したがって、AP は CAPWAP 参加フェーズ中にコントローラを切断した後にダウンロードします。AP のイメージのダウンロードに最大 1 時間かかる可能性があるため、ネットワークで長時間の中断が発生します。

重要

ソフトウェアを Cisco IOS XE Amsterdam 17.3.1 から Cisco IOS XE Gibraltar 16.12.4 以前にダウングレードする場合は、ダウングレードの前に CAPWAP マルチウィンドウを単一ウィンドウにリセットする必要があります。リセットを行わないと、手動での AP リカバリが必要になります。

AP イメージのダウンロード時間機能拡張ワークフローの概要

  1. 既存の AP 参加プロファイルをセレクトするか、新しいプロファイルを作成します。

  2. CAPWAP ウィンドウサイズを設定します。

  3. AP 参加プロファイルを既存のサイトタグまたは新しいサイトタグに関連付けます。

  4. 静的、フィルタ、ロケーション、AP、またはデフォルトのマッピング方法を使用して AP にサイトタグを適用します。

AP イメージのダウンロード時間機能拡張の設定（GUI）

手順

ステップ 1

[Configuration] > [Tags & Profiles] > [AP Join] > [CAPWAP] > [Advanced] を選択します。

ステップ 2

[CAPWAP Window Size] フィールドに、ウィンドウの測定単位を入力します。

ステップ 3

[Save & Apply to Device] をクリックします。

AP イメージのダウンロード時間機能拡張の設定（CLI）

手順

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

ステップ 1

configure terminal

例:

Device# configure terminal

グローバル コンフィギュレーション モードを開始します。

ステップ 2

ap-profile ap-profile

例:

Device(config)# ap profile capwap_multiwindow

AP プロファイルを設定します。

ステップ 3

capwap window size window-size

例:

Device(config-ap-profile)# capwap window size 20

AP CAPWAP 制御パケットの送信キューサイズを設定します。

（注）  

 

テレワーカーまたは OEAP 専用の AP プロファイルに対してのみウィンドウサイズを設定します。

ウィンドウサイズを変更すると、他の AP に影響を与える可能性があることに注意してください。

ステップ 4

end

例:

Device(config-ap-profile)# end

特権 EXEC モードに戻ります。

AP イメージのダウンロード時間機能拡張設定の確認

AP プロファイルに存在する CAPWAP ウィンドウサイズを表示するには、次のコマンドを使用します。

Device# show ap profile name default-ap-profile detailed | in wind

Capwap window size : 10

CAPWAP のステータスとモードを表示するには、次のコマンドを使用します。

Device# show capwap client rcb 

OperationState                     : UP
Name                               : AP4001.7A39.2D5A
MwarHwVer                          : 0.0.0.0
Location                           : default location
ApMode                             : Remote Bridge
ApSubMode                          : Not Configured
CAPWAP Path MTU                    : 1485
Software Initiated Reload Reason   : Reload command
CAPWAP Sliding Window
Active Window Size                 : 10
Last Request Send To Application   : 184
Expected Seq Num                   : 185
Received Seq Num                   : 184
Request Packet Count               : 42424
Out Of Range Packets Count         : 0
Window Moved  Packets Count        : 0
In Range Packets Count             : 960
Expected Packets Count             : 41464

CAPWAP ウィンドウサイズなどの AP 設定の詳細を表示するには、次のコマンドを使用します。

Device# show ap config general | in Wind

Capwap Active Window Size                       : 5
Capwap Active Window Size                       : 10
Capwap Active Window Size                       : 1