Validação de cabos para o Nexus Network Fabric

Este artigo explica a validação de cabo fabric, em que a função principal da API de diagnóstico é verificar todos os dispositivos de malha em busca de possíveis problemas de cabeamento. A API de Diagnóstico avalia se os dispositivos interconectados aderem à Lista de Materiais (BOM) e segundo as unidades de manutenção de estoque (SKUs) dos recursos, classificando-os como compatíveis ou não compatíveis. Os tipos de dispositivo incluem dispositivos Customer Edge (CE), TOR (Top of Rack), Management (MGMT) e NPB (Network Packet Broker). Os resultados são apresentados em um formato JSON, abrangendo detalhes como status de validação, erros, tipo de identificador e ID do dispositivo vizinho. Esses resultados são armazenados em uma conta de Armazenamento fornecida pelo cliente. É vital para a implantação geral que os erros identificados neste relatório sejam resolvidos antes de passar para a etapa de implantação do Cluster. A validação calável também dá suporte ao uso de uma conta de armazenamento fornecida pelo cliente para armazenar arquivos de saída usando a api versão 2024-06-15-preview.

Para obter detalhes sobre a lista de materiais (BOM), consulte os SKUs do Azure Operator Nexus

Pré-requisitos

• Verifique se o Nexus Network Fabric foi provisionado com êxito.
• Forneça a ID do Network Fabric e a URL de armazenamento com acesso WRITE por meio de um tíquete de suporte.
• A conta de armazenamento tem estes pré-requisitos:
  • A conta de armazenamento deve estar em uma região do Azure diferente da região do Azure do Network Fabric.
  • Storage Blob Data Contributor a função deve ser atribuída ao Nexus Network Fabric RP com acesso atribuído à conta de armazenamento.
• O Suporte da Microsoft deve atualizar o Nexus Network Fabric com uma URL SAS de armazenamento ativo antes de executar a validação de cabeamento.

Criando uma solicitação de suporte do Azure para correção de falhas no Nexus Network Fabric.

• Consulte Como criar uma solicitação de suporte do Azure
• Insira Nexus Network Fabric para o problema e clique Go.
• Selecione Azure Operator Nexus como o serviço com o qual você está tendo problemas.
• Selecione Subscription onde o recurso está localizado.
• Selecione General no campo de recurso e clique em Next.
• Selecione Network fabric instance provisioning no prompt de questão e clique em Next.
• Agora, selecione Create a support request na parte superior da folha de suporte.
• Clique Next na Problem description guia.
• Aguarde o Recommended solution e depois clique no link para voltar para "Retornar à solicitação de suporte".
• Clique Next na Problem description aba novamente para continuar a Additional details
• Preencha os detalhes da solicitação necessária para corrigir o Nexus Network Fabric e clique em Next
• Revise as informações na Review + create guia e então clique em Create.

Gerar a URL de armazenamento

Para criar um contêiner na conta de armazenamento, consulte Criar um contêiner

Para gerar uma URL SAS para o contêiner para fornecer acesso de gravação ao Nexus Fabric, consulte Gerar uma assinatura de acesso compartilhado

Validar cabeamento

1. Execute o seguinte comando da CLI do Azure:

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

   A saída a seguir (truncada) é exibida. Copie a URL da Azure-AsyncOperation seção da saída de depuração. Essa parte da URL é usada na etapa a seguir para verificar o status da operação.

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

   O erro a seguir indica que o Fabric não está corrigido com uma URL SAS válida:

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

2. Você pode verificar programaticamente o status da operação executando o seguinte 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"
   }
   

   O status da operação indica se a API foi bem-sucedida ou falhou.

   Observação

   A operação leva cerca de 20 a 40 minutos para ser concluída com base no número de racks.

3. Baixe e leia os resultados validados retornados pelo comando concluído do <CABLING_REPORT_STORAGE_URL>.

A saída de exemplo é mostrada nas seções a seguir.

Exemplo de saída de validação do CUSTOMER Edge (CE) para Provider Edge (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 
                      } 
                    } 
                  ] 
                },

Validação do comutador TOR (Customer Edge to Top Of Rack)

{ 
                      "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 
                          } 
                        } 
                      ]

Status da validação

Atributos de validação

Problemas conhecidos e limitações na validação de cabo

• Não há suporte para a validação de cabos de conexões entre os switches TOR e os servidores de computação que estão desligados ou não provisionados no cluster Nexus. Essas interfaces mostram Unknown status no relatório.
• Não há suporte para a validação de cabos de conexões entre interfaces MGMT e servidores de computação que estão desligados ou não provisionados no cluster Nexus ou nos Controladores de Servidor de Computação. Essas interfaces mostram o status Unknown no relatório.
• Não há suporte para validação de cabo para NPB e interfaces nni-direct porque atualmente não há suporte do fornecedor para show lldp neighbors. Essas interfaces mostram o status Unknown no relatório.
• Não há suporte para descoberta de vizinhos LLDP nas portas dos dispositivos NPB, e a validação do cabo para essas portas é realizada apenas por meio da correspondência de número de série.
• A URL de Armazenamento deve estar em uma região diferente do Network Fabric. Por exemplo, se o Fabric estiver hospedado no Leste dos EUA, a URL de armazenamento deverá estar fora do Leste dos EUA.
• A validação de cabo dá suporte a quatro racks com 16 unidades de computação por rack e oito racks com 16 unidades de computação por rack para BOMs.
• Quando o dispositivo de destino está desligado, ou os cabos estão faltando ou desconectados, ou se a validação não é suportada para o tipo de interface, a interface exibe o status Unknown. É importante avaliar todas as Unknown interfaces que estão Not-Connected em relação ao BOM para determinar se a ação de reparo é necessária.

Problemas típicos de validação de cabo NonCompliant e Unknown

Convertendo o relatório de validação de cabo em formato HTML

Consulte como converter a saída JSON do relatório de validação de cabo em HTML.