Validación de cables para Nexus Network Fabric

En este artículo se explica la validación de cables de Fabric, donde la función principal de la API de diagnóstico consiste en comprobar todos los dispositivos de tejido para detectar posibles problemas de cableado. La API de diagnóstico evalúa si los dispositivos interconectados cumplen la lista de materiales (BOM) y según el recurso Unidades de mantenimiento de existencias (SKU), clasificándolos como compatibles o no compatibles. Los tipos de dispositivo incluyen Customer Edge (CE), Top of Rack (TOR), Management (MGMT) y Network Packet Broker (NPB). Los resultados se presentan en un formato JSON, que abarca detalles como el estado de validación, los errores, el tipo de identificador y el identificador de dispositivo vecino. Estos resultados se almacenan en una cuenta de almacenamiento proporcionada por el cliente. Es fundamental para la implementación general que los errores identificados en este informe se resuelven antes de pasar al paso De implementación del clúster. La validación calble también admite el uso de una cuenta de almacenamiento proporcionada por el cliente para almacenar archivos de salida mediante la versión de api 2024-06-15-preview.

Para más información sobre la lista de materiales, consulte SKUs del operador Azure Nexus.

Prerrequisitos

• Asegúrese de que Nexus Network Fabric se ha aprovisionado correctamente.
• Proporcione el identificador de malla de red y la dirección URL de almacenamiento con acceso WRITE a través de un ticket de soporte.
• La cuenta de almacenamiento tiene estos requisitos previos:
  • La cuenta de almacenamiento debe estar en una región de Azure diferente a la región de Azure de Network Fabric.
  • Storage Blob Data Contributor el rol debe asignarse a Nexus Network Fabric RP con acceso asignado a la cuenta de almacenamiento.
• El soporte técnico de Microsoft debe parchear Nexus Network Fabric con una dirección URL de SAS de almacenamiento activa antes de realizar la validación de cableado.

Creación de una solicitud de soporte técnico de Azure para patching Nexus Network Fabric:

• Consulte Creación de una solicitud de soporte técnico de Azure.
• Escriba Nexus Network Fabric para el problema y haga clic en Go.
• Seleccione Azure Operator Nexus como servicio con el que tiene problemas.
• Seleccione Subscription dónde se encuentra el recurso.
• Seleccione General en el campo de recursos y haga clic en Next.
• Seleccione Network fabric instance provisioning en el mensaje de problemas y haga clic en Next.
• Ahora seleccione Create a support request en la parte superior del panel de soporte.
• Haga clic Next en la pestaña Problem description.
• Recommended solution Espere y, a continuación, haga clic en el vínculo de nuevo en "Volver a la solicitud de soporte técnico".
• Vuelva a hacer clic Next en la pestaña Problem description nuevamente para continuar a Additional details.
• Rellene los detalles de solicitud necesarios para parchear Nexus Network Fabric y, a continuación, haga clic en Next
• Revise la información de la Review + create pestaña y, a continuación, haga clic en Create.

Generación de la dirección URL de almacenamiento

Para crear un contenedor en la cuenta de almacenamiento, consulte Creación de un contenedor.

Para generar una dirección URL de SAS para que el contenedor proporcione acceso de escritura a Nexus Fabric, consulte Generación de una firma de acceso compartido.

Validación del cableado

1. Ejecute el siguiente comando de la CLI de Azure:

   az networkfabric fabric validate-configuration –resource-group "<NFResourceGroupName>" --resource-name "<NFResourceName>" --validate-action "Cabling" --no-wait --debug  
   

   Se muestra la siguiente salida (truncada). Copie la URL de la sección Azure-AsyncOperation de la salida de depuración. Esta parte de la dirección URL se usa en el paso siguiente para comprobar el estado de la operación.

   cli.azure.cli.core.sdk.policies:     'Azure-AsyncOperation': '<Azure-AsyncOperation-endpoint url>'
   

   El siguiente error indica que Fabric no está corregido con un URL de SAS válido.

   azure.core.exceptions.HttpResponseError: Operation returned an invalid status 'OK'
   

2. Puede comprobar mediante programación el estado de la operación ejecutando el siguiente comando:

   az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
   {
     "endTime": "<OPERATION_COMPLETION_TIME>",
     "id": "<OPERATION_ID>",
     "name": "OPERATION_NAME",
     "properties": {
       "url": "CABLING_REPORT_STORAGE_URL"
     },
     "resourceId": "<FABRIC_RID>",
     "startTime": "<OPERATION_START_TIME>",
     "status": "Succeeded"
   }
   

   El estado de la operación indica si la API se realizó correctamente o no.

   Nota:

   La operación tarda aproximadamente 20~40 minutos en completarse en función del número de bastidores.

3. Descargue y lea los resultados validados del <CABLING_REPORT_STORAGE_URL> devuelto desde el comando completado.

La salida de ejemplo se muestra en las secciones siguientes.

Ejemplo de salida de validación de Borde de Cliente (CE) a Borde de Proveedor (PE)

networkFabricInfoSkuId": "M8-A400-A100-C16-ab", 
  "racks": [ 
    { 
      "rackId": "AR-SKU-10005", 
      "networkFabricResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.managedNetworkFabric/networkFabrics/NFName", 
      "rackInfo": { 
        "networkConfiguration": { 
          "configurationState": "Succeeded", 
          "networkDevices": [ 
            { 
              "name": "AR-CE1", 
              "deviceSourceResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/NFName-AggrRack", 
              "roleName": "CE1", 
              "deviceSku": "DCS-XXXXXXXXX-36", 
              "deviceSN": "XXXXXXXXXXX", 
              "fixedInterfaceMaps": [ 
                { 
                  "name": "Ethernet1/1", 
                  "description": "AR-CE1:Et1/1 to PE1:EtXX", 
                  "deviceConnectionDescription": "SourceHostName:Ethernet1/1 to DestinationHostName:Ethernet", 
                  "sourceHostname": "SourceHostName", 
                  "sourcePort": "Ethernet1/1", 
                  "destinationHostname": "DestinationHostName", 
                  "destinationPort": "Ethernet", 
                  "identifier": "Ethernet1", 
                  "interfaceType": "Ethernet", 
                  "deviceDestinationResourceId": null, 
                  "speed in Gbps": "400", 
                  "cableSpecification": { 
                    "transceiverType": "400GBASE-FR4", 
                    "transceiverSN": "XKT220900XXX", 
                    "cableSubType": "AOC", 
                    "modelType": "AOC-D-D-400G-10M", 
                    "mediaType": "Straight" 
                  }, 
                  "validationResult": [ 
                    { 
                      "validationType": "CableValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Device Configuration detail", 
                        "error": null, 
                        "reason": null 
                      } 
                    }, 
                    { 
                      "validationType": "CableSpecificationValidation", 
                      "status": "Compliant", 
                      "validationDetails": { 
                        "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                        "error": "null", 
                        "reason": null 
                      } 
                    } 
                  ] 
                },

Validación del conmutador Borde del Cliente a Top Of Rack (TOR)

{ 
                      "name": "Ethernet11/1", 
                      "description": "AR-CE2:Et11/1 to CR1-TOR1:Et24", 
                      "deviceConnectionDescription": " SourceHostName:Ethernet11/1 to DestinationHostName:Ethernet24", 
                      "sourceHostname": "SourceHostName", 
                      "sourcePort": "Ethernet11/1", 
                      "destinationHostname": "DestinationHostName ", 
                      "destinationPort": "24", 
                      "identifier": "Ethernet11", 
                      "interfaceType": "Ethernet", 
                      "deviceDestinationResourceId": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx/resourceGroups/ResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkDevices/ NFName-CompRack", 
                      "speed in Gbps": "400", 
                      "cableSpecification": { 
                        "transceiverType": "400GBASE-AR8", 
                        "transceiverSN": "XYL221911XXX", 
                        "cableSubType": "AOC", 
                        "modelType": "AOC-D-D-400G-10M", 
                        "mediaType": "Straight" 
                      }, 
                      "validationResult": [ 
                        { 
                          "validationType": "CableValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Device Configuration detail", 
                            "error": null, 
                            "reason": null 
                          } 
                        }, 
                        { 
                          "validationType": "CableSpecificationValidation", 
                          "status": "Compliant", 
                          "validationDetails": { 
                            "deviceConfiguration": "Speed: 400 ; MediaType : Straight", 
                            "error": "", 
                            "reason": null 
                          } 
                        } 
                      ]

Estados de validación

Atributos de validación

Problemas conocidos y limitaciones en la validación de cables

• No se admite la validación de cables de conexiones entre TOR y servidores de cómputo que estén apagados o no aprovisionados en el clúster Nexus. Estas interfaces muestran el Unknown estado en el informe.
• No se admite la validación de cables de conexiones entre interfaces MGMT y servidores de cómputo que están apagados o no provisionados en el clúster Nexus, ni en los controladores de servidores de cómputo. Estas interfaces muestran el estado Unknown en el informe.
• La validación de cables para NPB no se admite para las interfaces loopback y nni-direct porque actualmente no hay soporte del proveedor para show lldp neighbors. Estas interfaces muestran el estado Unknown en el informe.
• La detección de vecinos de LLDP no se admite en los puertos de dispositivo NPB y la validación de cables para estos puertos se realiza solo mediante la coincidencia de números de serie.
• La dirección URL de almacenamiento debe estar en una región diferente de Network Fabric. Por ejemplo, si fabric se hospeda en Este de EE. UU., la dirección URL de almacenamiento debe estar fuera del Este de EE. UU.
• La validación de cables admite cuatro bastidores con 16 nodos de cálculo por bastidor y ocho bastidores con 16 nodos de cálculo por lista de materiales (BOM).
• Cuando el dispositivo de destino está apagado, los cables faltan o están desconectados, o si no se admite la validación para el tipo de interfaz, la interfaz muestra el estado Unknown. Es importante evaluar todas las Unknown interfaces que están Not-Connected en el BOM para determinar si se requiere una acción de reparación.

Problemas típicos de NonCompliant validación de cables Unknown

Convertir el informe de validación de cables en formato HTML

Consulte How to Convert Cable Validation report JSON output to HTML (Cómo convertir la salida JSON del informe de validación de cables en HTML).