Verificar cabos para arquitetura de rede Nexus

Este artigo explica a validação do cabo de malha, onde a principal função 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 de acordo com as Unidades de Manutenção de Estoque (SKUs) de recursos, classificando-os como compatíveis ou não compatíveis. Os tipos de dispositivos incluem dispositivos Customer Edge (CE), Top of Rack (TOR), Management (MGMT) e Network Packet Broker (NPB). 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 de escalabilidade também suporta o uso de uma conta de armazenamento fornecida pelo cliente para armazenar arquivos de saída usando a versão de api 2024-06-15-preview.

Para obter detalhes de BOM, consulte Azure Operator Nexus SKUs

Pré-requisitos

• Verifique se o Nexus Network Fabric foi provisionado com êxito.
• Forneça o ID de malha de rede e a URL de armazenamento com acesso para escritura via um pedido 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 Network Fabric.
  • A função de Storage Blob Data Contributor deve ser atribuída ao Nexus Network Fabric RP com acesso à conta de armazenamento.
• O Suporte da Microsoft deve aplicar um patch ao Nexus Network Fabric com uma URL SAS de armazenamento ativa antes de executar a validação do cabeamento.

Criando uma solicitação de suporte do Azure para aplicar patches no Nexus Network Fabric:

• Consulte Como criar uma solicitação de suporte do Azure
• Insira Nexus Network Fabric para o problema e clique em 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 sob o campo de recurso e clique em Next.
• Selecione Network fabric instance provisioning no prompt do problema 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, em seguida, clique no link de volta para 'Retornar à solicitação de suporte'
• Clique Next no Problem description separador novamente para continuar a Additional details
• Preencha os detalhes da solicitação necessários para corrigir o Nexus Network Fabric e clique em Next
• Reveja as informações no Review + create separador e, em seguida, clique em Create.

Gerar o 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 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 seguinte saída (truncada) é exibida. Copie o URL da seção Azure-AsyncOperation 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 a malha não foi corrigida 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 ~ 40 minutos para ser concluída com base no número de racks.

3. Faça o download e leia os resultados validados do <CABLING_REPORT_STORAGE_URL> retornado do comando concluído.

Exemplo de saída é mostrado nas seções a seguir.

Exemplo de saída de validação de 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 switch 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 cabos

• Não há suporte para a validação por cabo de conexões entre TOR e servidores de computação desligados ou não provisionados no cluster Nexus. Essas interfaces mostram o Unknown status no relatório.
• Não há suporte para a validação por cabo de conexões entre interfaces MGMT e servidores de computação desligados ou não provisionados no cluster Nexus ou nos controladores do servidor de computação. Essas interfaces mostram o Unknown estado no relatório.
• A validação de cabo para NPB não é suportada nas interfaces loopback e nni-direct porque atualmente não há suporte de fornecedor para show lldp neighbors. Essas interfaces mostram Unknown status no relatório.
• A descoberta de vizinhos LLDP não é suportada nas portas dos dispositivos NPB e a validação dos cabos para essas portas é realizada usando apenas a correspondência de número de série.
• A URL de armazenamento deve estar em uma região diferente da malha de rede. 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 cabos suporta quatro racks com 16 unidades de processamento por rack e oito racks com 16 unidades de processamento por BOMs (Lista de Materiais) de rack.
• Quando o dispositivo de destino está desligado, os cabos estão ausentes ou desconectados, ou se a validação não for suportada para o tipo de interface, a interface mostra o status Unknown. É importante avaliar todas as Unknown interfaces que estão Not-Connected em relação à lista técnica para determinar se a ação de reparo é necessária.

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

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

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