ACI向けFCSおよびCRCトラブルシューティングスクリプトの使用方法

ダウンロードオプション

PDF (215.5 KB)
Adobe Reader を使ってさまざまなデバイスで表示
ePub (82.8 KB)
iPhone、iPad、Android、ソニーの Reader、または Windows Phone 上で、さまざまなアプリを使って表示
Mobi (Kindle) (74.0 KB)
Kindle デバイスで、または Kindle アプリを使って複数のデバイスで表示

Updated: 2021 年 11 月 23 日

Document ID:217577

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポートコンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

内容

概要

スクリプトを手動で実行するための前提条件

コンテナからスクリプトを実行するための前提条件

スクリプトの実行手順

概要

ACIはカットスルースイッチングに従います。つまり、CRCを計算する前にパケットがすでに転送されています。通常、これらのパケットはストンプされ、出力エラーとして転送されます。ACIはこれらのパケットをドロップしないため、同じパケットがパケットを通過し、ストンプCRCカウンタがパス上で増加します。これは、CRCを検出するすべてのインターフェイスに障害があることを意味しているわけではありません。したがって、問題のあるポート/SFP/ファイバを切り分けるには、適切なトリアージが必要です。Pythonスクリプトによってトリアージプロセスが自動化され、トラブルシューティングが容易になり、手動タスクが不要になりました。このドキュメントでは、自動化スクリプトの使用方法を説明します（添付を参照）。

スクリプトを手動で実行するための前提条件

スクリプトの実行元となるクライアントマシンは、次の要件を満たす必要があります

a.Python3がインストールされている必要があります

b.ACIドメインへのネットワークアクセス

c. ACI_CRC_requirements.txt（添付）をインストールします。このファイルはここにあります。

ファイル(ACI_CRC_requirements.txt)をクライアントマシンにダウンロードします

ターミナルを開き、コマンド – pip3 install -r ACI_CRC_requirements.txtを実行します

ABCD-M-G24X:downloads abcd$ pip3 install -r ACI_CRC_requirements.txt

Collecting bcrypt==3.2.0 (from -r ACI_CRC_requirements.txt (line 1))
Downloading https://files.pythonhosted.org/packages/bf/6a/0afb1e04aebd4c3ceae630a87a55fbfbbd94dea4eaf01e53d36743c85f02/bcrypt-3.2.0-cp36-abi3-macosx_10_9_x86_64.whl
Collecting cffi==1.14.6 (from -r ACI_CRC_requirements.txt (line 2))
Downloading https://files.pythonhosted.org/packages/ca/e1/015e2ae23230d9de8597e9ad8c0b81d5ac181f08f2e6e75774b7f5301677/cffi-1.14.6-cp38-cp38-macosx_10_9_x86_64.whl (176kB)
|████████████████████████████████| 184kB 1.4MB/s 

**snip**

Successfully installed DateTime-4.3 Pillow-8.3.2 bcrypt-3.2.0 cffi-1.14.6 cryptography-3.4.8 cycler-0.10.0 kiwisolver-1.3.2 
matplotlib-3.4.3 numpy-1.21.2 pandas-1.3.2 paramiko-2.7.2 pyparsing-2.4.7 python-dateutil-2.8.2 pytz-2021.1 six-1.16.0 
stdiomask-0.0.5 tabulate-0.8.9 termcolor-1.1.0 zope.interface-5.4.0

コンテナからスクリプトを実行するための前提条件

コンテナは、上記のPythonパッケージがプリインストールされた状態で準備されています。

docker login docker.io
docker pull aci-stomper 
docker run -d --name 
     
     
       -p 
      
        :80 aci-stomper (on your browser http://ContainerIP:someport) docker ps docker exec -it 
       
         /bin/bash root@6df99d5dbbad:/# cd /home/scripts/ root@6df99d5dbbad:/home/scripts# ls ACI_CRC_Parser.py ACI_CRC_Poller.py

スクリプトの実行手順

Pythonスクリプト（ACI_CRC_Poller.pyとACI_CRC_Parser.py）は全部で2つあります。これらのスクリプトは、次のURLを使用してCisco DevNet Code Exchangeからダウンロードできます。

https://developer.cisco.com/codeexchange/github/repo/CiscoDevNet/ACI-CRC-FCS-Checker

これらのスクリプトの実行元となるマシン/コンピュータに、両方をダウンロードします。

このドキュメントでは、script-1はACI_CRC_Poller.pyを指し、script-2はACI_CRC_Parser.pyを指します。

1. ACI_CRC_Poller.pyは、最長7日間、ファイル内のCRCおよびFCSエラーデータを5分ごとに収集します。

ターミナルからscript-1(ACI_CRC_Poller.py)を実行します。特定のクラスタ内のAPICの1つのOOB IPアドレスとそのクレデンシャルを入力してください。

ABCD-M-G24X:downloads abcd$ python3 ACI_CRC_Poller.py
Enter the IP address or DNS Name of APIC: 10.197.204.184
__________________________________________________________
Enter the username: admin
___________________________________________________________
Enter the password: **********
Trying to connect to APIC
Connection established to the APIC
___________________________________________________________

2. Script-1は、ローカルマシン/コンピュータ上のローカル/パスを要求し、レコードを格納します。有効なパスを入力してください。入力しないと、スクリプトは実行されません。

Please enter the folder where files have to be stored
_____________________________________________________________
VALID folder format:
EXAMPLE:
Windows-> C:\Users\Admin\Desktop\ACI\
MAC -> /User/admin/Desktop/ACI/
---------------------------------------------------------------------------------------------------
PLEASE NOTE that data collection and script execution might get impacted if folder format is not as below
--------------------------------------------------------------------------------------------------------
Enter the absolute path of the folder where the files have to be stored:/Users/abcd/Downloads/FCS_Checker/  <<<<<<<<<<<<<<

を選択します。スクリプトは、実行の終了時間を要求します。

yyyy-mm-dd hh:mm（ファブリックのローカルタイムゾーンごと）の形式で、最小5分、最大7日間の時間を入力してください。

この時点で、script-1は5分ごとに（ユーザによって指定された終了時間まで）ファブリックからFCS/CRCエラーの収集を開始し、以前の入力で指定されたパスのファイルにデータを保存します。

----------------------------------------------------------------
Enter the End Time until which the script runs(in the format of yyyy-mm-dd hh:mm, current time:2021-09-27 11:27....  maximum upto 2021-10-04 11:27): 2021-09-27 11:32 <<<<<
___________________________________________________________
The script is executing ........................
The script is executing ........................
ABCD-M-G24X:downloads abcd$

4.最初のスクリプトが正常に実行されると、ステップ2でユーザが指定した場所にrawデータファイルが保存されます。

次の例と同じことを確認します。

ABCD-M-G24X:FCS_Checker kbosu$ pwd
/Users/abcd/Downloads/FCS_Checker

ls -l
total 16
-rw-r--r--@ 1 kbosu  staff  1419 Sep 27 11:28 CRC_FCS_20210927_1128.txt
-rw-r--r--@ 1 kbosu  staff  1419 Sep 27 11:33 CRC_FCS_20210927_1133.txt
ABCD-M-G24X:FCS_Checker abcd$

5.次に、2番目のスクリプト(ACI_CRC_Parser.py)を実行します。

Script-2では、script-1によって作成されたファイルを使用して、さらに作業を進めます。

特定のクラスタ内のいずれかのAPICのOOB IPアドレスとそのクレデンシャルを入力してください。

また、ステップ2で最初のスクリプトの実行中に入力したファイルの場所と同じ場所を入力します。

ABCD-M-G24X:downloads abcd$ python3 ACI_CRC_Parser.py

Enter the IP address or DNS Name of APIC: 10.197.204.184
__________________________________________________________
Enter the username: admin
___________________________________________________________
Enter the password: **********
Trying to connect to APIC
Connection established to the APIC
_____________________________________________________________
Please enter the folder where files are stored
Please make sure we have at least two files exists in the directory where you have saved data 
_____________________________________________________________
--------------------------------------------------------------------------------------------------------
Enter the absolute path of the folder where the files are stored:/Users/abcd/Downloads/FCS_Checker/
___________________________________________________________
You have CRC and FCS for the below date range
1.2021-09-27
Fetching first and last file of the same date 20210927
CRC_FCS_20210927_1128.txt
CRC_FCS_20210927_1133.txt
__________________________________________________________
The script is executing.....
__________________________________________________________
The script execution has completed

6. Script-2では、次の例に示すように、データが表形式で印刷されます。

主に、ユーザが指定した時間間隔の間に、CRCおよびFCSエラーがゼロ以外のノードインターフェイスと、それらのCRC/FCSカウンタの差異がリストされます。LLDPを使用すると、スクリプトは特定のインターフェイスに接続されたネイバーデバイスも判別します。最も重要なのは、ファブリックの観点から、どのノード/インターフェイスがエラーの原因で、どのノードインターフェイスがStempによりCRCを参照しているかを示します。

FCSのトラブルシューティングの観点から見ると、「赤」で強調表示され、「ローカル」とマークされているものは、さらにトラブルシューティングを行う必要があります。

これは、不良または破損したパケットがからファブリックに入り、ファブリック内でCRCがフラッディングされるインターフェイスである可能性があります。

+--------+---------+--------------------+-----------+-----------+---------------+---------------+---------------+---------------+-------------------------------------------------------------------------------------+--------------+
| POD_ID | NODE_ID |     NODE_NAME      | NODE_ROLE | INTERFACE | 20210927_1128 | 20210927_1133 | 20210927_1128 | 20210927_1133 |                                      NEIGHBOR                                       | ERROR SOURCE |  
+--------+---------+--------------------+-----------+-----------+-----CRC-------+----CRC Diff---+----FCS--------+---FCS Diff----+-------------------------------------------------------------------------------------+--------------+
|   1    |   302   | bgl-aci06-t2-leaf2 |   leaf    |  eth1/44  | 5002806823759 |   127841888   | 5002806823759 |   127841888   | No LLDP /CDP neighbours found please check physically where this interface connects |    Local     |
|   1    |   101   |  bgl-aci06-spine1  |   spine   |  eth1/1   |  2981200154   |   132103050   |       0       |       0       |                System:bgl-aci06-t1-leaf1.cisco.com,Interface:Eth1/49                |    Stomp     |
|   1    |   101   |  bgl-aci06-spine1  |   spine   |  eth1/2   |    968286     |       0       |       0       |       0       |                                                                                     |   Historic   |
|   1    |   201   | bgl-aci06-t1-leaf1 |   leaf    |  eth1/1   |      12       |       0       |       0       |       0       |                                                                                     |   Historic   |
|   1    |   201   | bgl-aci06-t1-leaf1 |   leaf    |  eth1/51  | 4999243774529 |       0       |       0       |       0       |                                                                                     |   Historic   |
|   1    |   201   | bgl-aci06-t1-leaf1 |   leaf    |  eth1/52  | 5002807353809 |   127841212   |       0       |       0       |                System:bgl-aci06-t2-leaf2.cisco.com,Interface:Eth1/49                |    Stomp     |
|   1    |   202   | bgl-aci06-t1-leaf2 |   leaf    |  eth1/51  |    968286     |       0       |       0       |       0       |                                                                                     |   Historic   |
|   1    |   301   | bgl-aci06-t2-leaf1 |   leaf    |  eth1/44  | 4999245287405 |       0       | 4999245287405 |       0       |                                                                                     |   Historic   |
|   1    |   301   | bgl-aci06-t2-leaf1 |   leaf    |  eth1/49  | 4999823953891 |       0       |       0       |       0       |                                                                                     |   Historic   |
|   1    |   302   | bgl-aci06-t2-leaf2 |   leaf    |  eth1/49  | 4999243774529 |       0       |       0       |       0       |                                                                                     |   Historic   |
+--------+---------+--------------------+-----------+-----------+---------------+---------------+---------------+---------------+-------------------------------------------------------------------------------------+--------------+

7.さらに、スクリプトは、script-1および2によって収集された詳細なデータをソートおよび表示するための次のオプションをユーザに提供します。

ユーザは入力として1 ～ 3のオプションを選択できます。下の例を参照してください。

1.Sort the data further 
2.View the granular data of an interface
3.Exit

Input the number:

次の例では、任意のインターフェイスの詳細なデータを表示するのに役立つオプション2を示します。

このスクリプトは、上記の表に記載されている各POD番号(Node ID)、およびインターフェイスIDを入力するようユーザに促します（ステップ6）。

この例では、1-302-eth1/44を使用しています。ここで、POD IDは1、ノードIDは302、インターフェイスIDはeth1/44です。これはインターフェイスです

ローカルFCSは、ステップ6で示すように、スクリプトによって報告されました。

Input the number:2
---------------------------------------------------------------------------
Enter an interface for which you need granular data(POD_ID-NODE_ID-INTERFACE  Example:1-101-eth1/5): 1-302-eth1/44
----------------------------------------------------------------------

You have CRC and FCS data in the below date range
1.2021-09-27

Enter the date for which you need granular data(any number from the above list range(1-1)):

この例では、データを1日の数分だけ収集したため、日付が9月27日のオプションが1つだけ表示されます。

したがって、入力は「1」になります。

Enter the date for which you need granular data(any number from the above list range(1-1)): 1  

+-------+---------------+---------------+
| Time  |      CRC      |      FCS      |
+-------+---------------+---------------+
| 11:28 | 5002806823759 | 5002806823759 |
| 11:33 | 5002934665647 | 5002934665647 |
+-------+---------------+---------------+
----------------------------------------------------------------
Do you want to continue viewing the granular data(0/1), 1-yes, 0-no:0
--------------------------------------------------------------------------------

Please select any number below to sort the data further or to view granular data of an interface

1.Sort the data further 
2.View the granular data of an interface
3.Exit

Input the number:3
ABCD-M-G24X:downloads abcd$

更新履歴

改定	発行日	コメント
1.0	23-Nov-2021	初版

シスコエンジニア提供

Kallol Bosu
TAC
Solomon Sudhakar
TAC

ACI向けFCSおよびCRCトラブルシューティングスクリプトの使用方法

ダウンロード オプション

偏向のない言語

翻訳について

内容

概要

スクリプトを手動で実行するための前提条件

コンテナからスクリプトを実行するための前提条件

スクリプトの実行手順

更新履歴

シスコ エンジニア提供

このドキュメントは役に立ちましたか?

シスコに問い合わせ

このドキュメントは次の製品に対応しています

ダウンロードオプション

シスコエンジニア提供