Cisco IAC 4.0 ネットワーク検出のトラブルシューティング ガイド

概要

このトラブルシューティングガイドでは、Cisco IAC 4.0ネットワーク検出の問題を特定して解決する方法について説明します。

• 概要
• Cisco IACネットワーク検出のアクティビティ図
• ネットワーク検出の設定とログリソースの場所
• 基本的なヘルスチェック
• ネットワーク検出に関する一般的な問題
  • ネットワーク検出モジュールが実行されていません
  • IACラッパーからProcess Orchestratorへの接続の問題
  • サービス項目を作成できません
  • デバイスが検出されなかった場合
  • 存在発見
  • インベントリ検出
  • トポロジ検出

Cisco IACのネットワーク検出は、Cisco IACで発信するデバイスの種類を選択し、Cisco IACで情報を検索（検出）して返し、使用するデバイスを登録します。Cisco IACネットワーク検出のワークフローの概要は次のとおりです。

1. 検出プロセスの開始
2. 検出タイプの選択
1. ネイバー探索
2. Pingスイープまたは
3. ネイバーとpingスイープ
3. クレデンシャルとシードデバイスまたはサブネット情報の入力
4. 検出されたデバイスの登録
5. 登録済みデバイスのネットワークポッドへの割り当て

Cisco IACネットワーク検出のアクティビティ図

Cisco IACは、ネットワーク検出を通じて既存のネットワーク/オブジェクトを検出できます。

ネットワーク検出の設定とログリソースの場所

1. コンフィギュレーション ファイル
   • /opt/cisco/XMP_Platform/discovery/conf/iac.properties
     • Process Orchestratorと対話するためのクレデンシャルが含まれます
     • OVAを導入するPowerCLIスクリプトには、クレデンシャルが必要です
     • プラットフォーム要素としてのIAC管理アプライアンスの登録時に、同じクレデンシャルを指定する必要があります
2. ログ ファイル
   1. /opt/cisco/XMP_Platform/logs/iac/discovery.log
      • ログファイルに検出プロセスの例外が含まれています
      • ログがローテーションされる
   2. 到達不能デバイス
   • /opt/cisco/XMP_Platform/discovery/output/unreachable.xml
   3. 検出されたデバイス
      • /opt/cisco/XMP_Platform/discovery/output/devices.xml
3. 接続パラメータの表示
   1. 「Service Portal/Setup/Connections/Update Cloud Infrastructure/
      • プラットフォーム要素タイプとして[Cisco IAC Management Appliance]を選択します
      • 管理アプライアンスのIPアドレスの選択
   2. [Service Item Manager]/[Manage Service Items]に移動し、[Cloud Platform Elements]グループを展開します
      • [Cisco IAC Management Appliance]に移動します
4. 接続パラメータの更新
   • 「Service Portal/Setup/Connections/Update Cloud Infrastructure/
     • プラットフォーム要素タイプとして[Cisco IAC Management Appliance]を選択します
     • 管理アプライアンスのIPアドレスの選択

基本的なヘルスチェック

• [Local Time Health Check]：ネットワーク検出サーバのローカル時刻を返します。
• http://SERVER_HOST:8080/xmp-disc/disc/healthcheck
• バージョンチェック：
• http://SERVER_HOST:8080/xmp-disc/disc/version
• アプライアンスホストへのログイン
• cat /etc/appliance.version
• マニフェストの確認：
• アプライアンスホストへのログイン
• cat /etc/appliance.manifest

ネットワーク検出に関する一般的な問題

1. ネットワーク検出モジュールが実行されていません
   1. ラッパーアプリケーションが展開されているかどうかを確認します
      • Network Discovery Webアプリケーションxmp-disk.warが$XMP_HOME/apache-tomcat-7.0.40/webappsに正常に配備されていることを確認します。
      • Webアプリケーションの展開エラーについては、$XMP_HOME/instances/instance1/logs/Startup.logを確認してください。
      • Apache Tomcatのデバッグレベル$XMP_HOME/conf/logConfig/xmpmain_log4j.xmlを確認します（必要に応じて設定を変更し、変更後にNetwork Discoveryモジュールを再起動します）。
   2. 次の手順を実行して、ネットワーク検出モジュールが稼働していることを確認します。
      • service xmp status
   3. 必要に応じて起動します。
      • service xmp start
   4. 管理アプライアンスのTomcatサーバが起動し、ポート8080をリッスンしている必要があります。
   5. ログファイル$XMP_HOME/instances/instance1/logs/Startup.logをチェックして、ネットワーク検出モジュールがエラーなしで起動したことを確認します。
2. IACラッパーからProcess Orchestratorへの接続の問題
   1. IACネットワーク検出ラッパーは、プロセス検出結果を送信し、Process Orchestratorに送信します。サービスアイテムは、サービスカタログに作成されます。
   2. $XMP_HOME/discovery/conf/iac.propertiesファイルの設定が正しいことを確認します。
      1. Process Orchestratorホスト名
      2. ポート名と接続プロトコル（使用されているHTTPまたはHTTPSによって異なる）
      3. 認証タイプ（基本またはウィンドウ）
      4. 認証タイプがwindowsの場合は認証ドメイン
      5. Credentials
   3. Process Orchestratorマシンは、Managementから到達可能である必要があります。
   4. SSLが管理アプライアンスとProcess Orchestratorの間で使用されている場合は、SSL設定が正しい必要があります。通信の方向が異なるため、これはProcess Orchestratorから管理アプライアンスへの設定とは異なり、個別に設定および検証する必要があります。
   5. マネージドアプライアンスからメッセージを送信する通信エラーは、$XMP_HOME/instances/instance1/logs/iac/discovery.logに記録されます。
3. Process Orchestratorはサービスカタログ – サービス項目を作成できません
   1. Process Orchestratorは、管理アプライアンスから送信されたデータとネットワークデバイスの既存のデータを分析し、サービスカタログ内のサービス項目を作成または更新します。通常、Process Orchestratorとサービスカタログ間の通信の問題は、ネットワーク検出に固有のものではありません。ただし、サービス項目の作成に失敗すると、ネットワーク検出モジュールデータベースとサービスカタログが同期しなくなる可能性があります。この問題を解決する最善の方法は、ネットワーク検出モジュールデータベースをクリーンアップし（DBが現在固定されていないため、ネットワーク検出モジュールを再起動します）、通信の問題が修正されたら、完全な再検出を実行することです。不足しているサービス項目が作成され、既存のサービス項目がネットワークからの最新情報で更新されます。
   2. ネットワーク検出モジュールを再起動できない場合：
      • ネットワークの完全な再検出を実行します。
      • ブラウザでhttp://<management_appliance>:8080/xmp-disk/disk/resync-topoに電話します。ネットワーク検出モジュールリポジトリ内のすべてのトポロジリンクは、Process Orchestratorに再送信され、次にサービスカタログに再送信されます。
4. デバイスが検出されなかった場合
   1. 存在の検出ログファイル$XMP_HOME/instances/instance1/logs/existenceDiscovery.logでエラーを確認します。
   2. ディレクトリ$XMP_HOME/discovery/outputを確認します。
      • devices.xml：すべての正常に検出されたデバイスと、一致するクレデンシャルおよびその他の情報。
      • unreachable.xml：検出を試みたが失敗したすべてのデバイスをリストします。エラーの原因(<filterReason>)を確認します。
5. 存在発見
   1. 存在の検出が実行されるたびに、$XMP_HOME/discovery/conf/uploadに一時的な設定ファイルが作成されます。ディレクトリが存在し、書き込み可能であることを確認します。このディレクトリのコンフィギュレーションファイルをチェックして、ネットワーク検出の設定と入力引数が正しいことを確認します（「入力パラメータが正しいことを確認する」を参照）。
   2. $XMP_HOME/discovery/confの検出設定ファイルを確認します。テンプレートファイルは、IACソースリポジトリ内のものと一致している必要があります。
   3. MacまたはLinuxのsnmpwalkユーティリティを使用すると、自動検出を実行する前にSNMPクレデンシャルの有効性を確認できます。
      • 例：SNMP v2c:snmpwalk -v 3 -l authPriv -u snmpadmin -a MD5 -A $PASSWORD -x AES128 -X $PASSWORD 10.10.10.10 1.3.6.1.2.1.1.5
      • 例：SNMP v3:snmpwalk -v 3 -l authPriv -u admin -a MD5 -A $PASSWORD -x DES -X $PASSWORD 10.10.10.10 1.3.6.1.2.1.1.5
   4. ネイバー探索に基づくネットワーク探索では、検出するすべてのデバイスでCDPまたはLLDPを有効にする必要があります。有効にしないと、シードデバイスだけが検出されます。
   5. pingスイープの検出にはICMP:
      • ICMPが有効になっており、デバイスにpingが実行できることを確認します。
      • 管理アプライアンスのIACユーザに、$XMP_HOME/discovery/binのfpingユーティリティを実行する権限があることを確認します。
6. インベントリ検出：検出されたデバイスから追加のインベントリ情報（デバイスタイプ、シリーズなど）を取得できない場合：
   1. 対象のデバイスタイプのデバイスパッケージがインストールされていることを確認します。インストールされているパッケージの一覧については、$XMP_HOME/instances/instance1/logs/devicePackageLoader.logを参照してください。
   2. エラーについては$XMP_HOME/instances/instance1/logs/inventory.logを確認してください。
   3. $XMP_HOME/conf/mdfdata.xmlに各デバイスタイプのエントリが含まれていることを確認します。
   4. デバイスがSSH経由でアクセスできること、およびSNMP経由でv2cまたはv3のいずれかであり、クレデンシャルが正しいことを確認します。
   5. 特定のケースでは、デバイスが検出されても、そのインベントリが検出されない場合は正常です。これは通常、デバイスがまだサポートされていないことを意味します。つまり、デバイスタイプに使用できるデバイスパッケージやインストールされていないデバイスパッケージです。デバイスの一部が到達可能であることも意味します。
   6. INFOログが有効（デフォルト設定）で、デバイスインベントリが正常に読み取られた場合。
      • 追加のインベントリ情報が見つかった場合は、$XMP_HOME/instances/instance1/logs/iac/discovery.logに次の行を印刷する必要があります。
      • たとえば、[INFO] [XMPIceEventListener]デバイス2010用に収集されたインベントリ
7. トポロジ検出
   1. トポロジリンクを検出するには、そのターミネーションポイントデバイスの両方を検出し、インベントリを正常に照会する必要があります。
   2. デバイスでCDPまたはLLDPが有効になっており、SNMP経由のネイバーに関する情報が機能していることを確認します。一般的な問題の1つは、SNMPが同期外れになる場合があり、「show cdp neighbors」でも修正情報が表示される場合があることです。