简介
ACI遵循直通交换，这意味着数据包在计算CRC之前已经转发。这些数据包通常会被存储并转发为输出错误。由于ACI不会丢弃这些数据包，因此相同的数据包会通过数据包，并且路径上的stomp 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）。 可以使用以下URL从Cisco DevNet代码交换下载这些脚本。
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将每五分钟收集一次文件中的CRC和FCS错误数据，最长持续时间为7天。
从终端运行脚本–1(ACI_CRC_Poller.py)。请输入给定集群中某个APIC的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.脚本–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/ <<<<<<<<<<<<<<
3. 脚本现在将要求执行结束时间。
请以yyyy-mm-dd hh:mm 格式输入时间（根据交换矩阵的本地时区），最少5分钟，最多7天。
此时，脚本–1开始每五分钟从交换矩阵收集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中用户指定的位置。
如以下示例所示进行验证。
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.现在是执行第二个脚本(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.脚本–2将以表格格式打印数据，如下例所示。
首先，它将在用户指定的时间间隔内列出具有非零CRC和FCS错误的节点接口，以及其CRC/FCS计数器的差异。使用LLDP，该脚本还将确定与给定接口挂接的邻居设备，最重要的是，它将从交换矩阵的角度指示哪个节点/接口是错误的来源，以及哪些节点接口刚刚看到由于Stomp而产生的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.此外，该脚本将向用户提供以下选项，以便排序和查看精细数据，即脚本1和2收集的数据。
用户可以选择数字1-3之间的选项作为输入。请参阅以下示例。
1.Sort the data further
2.View the granular data of an interface
3.Exit
Input the number:
在下面的示例中，我们将选择选项2，它帮助我们查看任何给定接口的精细数据。
该脚本将提示用户输入上面打印表格中各自的POD编号、节点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)):
在我们的示例中，我们一天只收集了几分钟数据，因此只看到一个日期是9月27日的选项。
因此，我们的输入为“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$
反馈