Cisco CNS Configuration Engine 1.4 アドミニストレータ ガイド

設定処理

設定のアップデートが必要な場合、PIX は返された URL に HTTPS GET 要求を送信します。設定ファイルは、適用前にローカル バッファに完全に読み込まれます。これは、接続エラーによって PIX が部分的に設定された状態になるのを回避するためです。設定コマンドを適用中にエラーが発生しない場合（または config-data メッセージの errors 属性が continue である場合）、実行中の設定は write memory コマンドでフラッシュにコピーされます。すべての設定ファイルは replace モードで機能します。

PIX デバイスによる設定ダウンロードが完了すると、ログ ファイル エントリが生成されます。これは、pix.log 内のログ ファイル エントリと同じ内容を示します。

（注） ログ エントリは、PIX デバイスに対する設定の適用が成功したことを意味するものではありません。PIX デバイスによって設定ファイルがダウンロードされたという意味です。

イメージ処理

最初の HTTPS POST とともに状況に応じて送信される DeviceDetails XML では、PIX イメージについての情報（バージョンとチェックサム）が示されます。CNS Configuration Engine 1.4 は、ディレクトリのエントリに基づいて、イメージ URL を含む UpdateInfo XML およびチェックサムを返します。PIX はイメージを次々にダウンロードして適用します。また、必要に応じて PIX 自身をリロードします。エラーは、次の項で説明する方法で処理されます。

（注） イメージのダウンロードが成功したことを示す通知はありません。イメージ配布は CNS Configuration Engine 1.4 の外部である場合があり、PIX サーバはそれを追跡できないためです。また、PIX デバイスもイメージ アップグレートが成功したことを示す通知を出しません。

エラー処理

すべてのエラーは、HTTPS POST で ErrorList メッセージを使用してエラー URL に報告されます。

各設定エラー レポート（タイプ=error、warning、または info）は、CNS Configuration Engine 1.4 によって pix.log に記録されます。ディスク使用領域を節約するために、ログ ファイルは循環式になっています。エラーメッセージの内容は、PIX デバイス自体からのエラー XML です。

（注） 設定中に発生するエラーは、ダウンロードされた設定が PIX にまったく適用されなかったことを意味するものではありません。ログ ファイルで示されているエラーがこの特定のデバイスに関して発生したという意味です。

CNS Configuration Engine 1.4 から受信した URL のいずれかでデータを取得中に、エラーまたは通知（タイプ= warning、notification、informational、debugging、emergency、alert、critical および error）が発生した場合、ログ ファイル エントリが生成されます。

サーバからの UpdateInfo 応答にある URL の処理中にエラーが発生した場合、そのエラーは Error URL に報告されます。また、現在のコール ホームで受信したすべての URL の処理は中止されます。処理の続行は、PIX が再びホームをコールするまで延期されます。

すべてのアップデートが正常に完了すると、PIX デバイスによって別の DeviceDetails メッセージが CNS Configuration Engine 1.4 に送信されます。CNS Configuration Engine 1.4 は、再び UpdateInfo およびチェックサムを送信します。PIX デバイスはチェックサムを比較し、これ以上のアップデートが不要であることを確認します。

PIX デバイスからの DeviceDetails 要求の処理

PIX デバイスからの DeviceDetails 要求の処理のシーケンスは、次のとおりです。

1. PIX デバイスが HTTPS の POST 要求で DeviceDetails を XML ペイロードとして使用して CNS Configuration Engine 1.4 に接続します。

2. 新しい PIX Configuration servlet が要求を受信し、XML を構文解析し、DeviceID を取得します。

3. デバイスが認証されます。

4. この DeviceID と関連付けられているテンプレートが処理され、設定ファイルが生成されます。

5. 設定ファイルが PIX DTD に従って XML 形式に変換され、保存されます（この DeviceID 用のファイルがすでに存在する場合は上書きされます）。

6. XML 設定ファイルのチェックサムが計算され、URL が示されます。

7. PIX イメージおよび PDM イメージの URL と チェックサムが、PIX デバイスに添付されているイメージ オブジェクトから取得されます。

8. 対応するチェックサムが異なる場合、設定ファイルや各イメージのチェックサムと URL、および Error URL が HTTP 応答として XML ペイロード（UpdateInfo）とともに PIX デバイスに送信されます。

9. この時点でデバイスは、UpdateInfo 応答の内容に基づいて設定またはイメージを要求します。

10. エラーが発生した場合は、情報がエラー URL に送信されます。

11. エラー サーブレットがエラーを pix.log に記録します。

図 5-2 に、プル モデルのプロセス フローを示します。

図 5-2 デバイス アップデートのプル モデルのシーケンス図

PIX DeviceID

次に示す PIX CLI によって、PIX が DeviceDetails 要求で送信する DeviceID の値が決定されます。

[no] auto-update device-id hardware-serial | hostname | ipaddress [ if-name ] | mac-address [ if-name ] |
string text

• auto-update device-id コマンドでは、Management サーバにポーリングする際に送信するデバイス ID が指定されます。

• no auto-update device-id コマンドでは、デバイス ID がデフォルトのホスト名にリセットされます。

• hardware-serial オプションでは、PIX シリアル番号が使用されます。

• hostname オプションでは、PIX ホスト名が使用されます。

• ipaddress オプションでは、インターフェイスの IP アドレスが名前 if-name とともに使用されます。

インターフェイス名が指定されていない場合、リモート管理サーバとの通信に使用されるインターフェイスの IP アドレスが使用されます。

• mac-address オプションでは、インターフェイスの MAC アドレスが名前 if-name とともに使用されます。

インターフェイス名が指定されていない場合、リモート管理サーバとの通信に使用される MAC アドレスが使用されます。

• string オプションでは、指定されている テキスト が使用されます。

このテキストには、ホワイト スペースまたは文字 ‘、"、<、>、&、および ? は使用できません。

（注） PIX によって提供される DeviceID は、CNS Configuration Engine 1.4 の ConfigID および EventID に内部的にマッピングされるので、ハイフン（-）、下線（_）、ピリオド（.）、および英数字のみがサポートされます。