Partilhar via

Validar cabos para estrutura 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

Nota

Como parte de nosso compromisso contínuo com a segurança e a modernização, estamos anunciando o fim do suporte para acesso baseado em URL de Assinatura de Acesso Compartilhado (SAS) a contas de armazenamento fornecidas pelo cliente na versão 2508.1 do Operador do Azure.

Pré-requisitos

  • Verifique se o Nexus Network Fabric foi provisionado com êxito.
  • Forneça a ID da malha de rede 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 Network Fabric.
    • Storage Blob Data Contributor função deve ser atribuída à 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 ativa antes de realizar a validação de cabeamento.

Nota

A partir da atualização da API 2024-06-15-preview, trazer sua própria conta de armazenamento é o método preferido. Os usuários devem criar ou associar as instâncias de malha à sua conta de armazenamento referindo-se ao artigo Configurar o armazenamento BYO-Your-Own (Bring- for Network Fabric ).

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 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 aviso de 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 separador Problem description novamente para continuar para 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.

Nota

A URL de armazenamento (SAS) é de curta duração. Por padrão, ele é definido para expirar em oito horas. Se a URL SAS expirar, a malha deverá ser corrigida novamente.

Gerar o URL de armazenamento

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

Nota

Digite o nome do contêiner usando apenas letras minúsculas.

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

Nota

Os URLs SAS são de curta duração. Por padrão, ele é definido para expirar em oito horas. Se a URL SAS expirar, você deverá abrir um tíquete de suporte da Microsoft para adicionar uma nova URL.

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.

    Nota

    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 pelo 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

Tipo de status Definição
Compatível O estado de validação é compatível com a especificação da Lista de Materiais para a interface.
Não conforme O status de validação não é compatível com a especificação de lista técnica para a interface.
Desconhecido A validação não consegue recuperar os detalhes da conexão da interface ou os dados lldp não são retornados. O Unknown status será retornado se o dispositivo de destino estiver desligado, ausente, desconectado ou sem suporte para esse tipo de interface.

Atributos de validação

Atributo Definição
deviceConfiguration Configuração disponível no dispositivo.
error Erro do dispositivo.
reason Este campo é preenchido quando o estado do dispositivo é desconhecido.
validationType Este parâmetro indica que tipo de validação. (validações de cabos e especificações de cabos).
deviceDestinationResourceId ID do Gestor de Recursos Azure do dispositivo vizinho conectado (dispositivo de destino).
roleName A função do dispositivo de malha de rede (CE ou TOR).

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 estado 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 para loopback e nni-direct interfaces porque atualmente não há suporte de fornecedor para show lldp neighbors. Essas interfaces mostram o Unknown estado no relatório.
  • A descoberta de vizinhos LLDP não é suportada em portas de dispositivo NPB, e a validação de cabo para essas portas é executada 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 computadores por rack e oito racks com 16 computadores por BOMs de rack (Lista de Materiais).
  • 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, o estado da interface mostra-se como 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 típicos de validação de cabos NonCompliant e Unknown

tipoDeValidação Estado Erro Resolução
Cabo Validação NonCompliant Device cable connection is incorrect. Verifique se as conexões nas interfaces de origem e destino correspondem à lista técnica. O deviceConfiguration pode ajudar a identificar a data da porta de destino retornada na interface.
Cabo Validação Unknown Unable to fetch data from the device. Verifique se as conexões nas interfaces de origem e destino estão conectadas e correspondem à lista técnica
Cabo Validação NonCompliant Device cabling in <INTERFACE> incorrect. A interface não está conectada. Verifique se as conexões nas interfaces de origem e destino estão conectadas de acordo com a lista técnica.
Cabo Validação Unknown Port <INTERFACE> has no connections as per device response. Verifique se as conexões nas interfaces de origem e destino estão conectadas e correspondem à lista técnica.
ValidaçãoDaEspecificaçãoDoCabo Unknown Unable to fetch Interface Status for <INTERFACE>. Verifique se as conexões nas interfaces de origem e destino estão conectadas e correspondem à lista técnica.
ValidaçãoDaEspecificaçãoDoCabo NonCompliant Device cable connection is incorrect Verifique se a placa de interface e os cabos correspondem à especificação da lista técnica nesta interface.

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.