Partager via


Valider des câbles pour Nexus Network Fabric

Cet article explique la validation de câble Fabric où la fonction primaire de l’API de diagnostic recherche les erreurs de câblage potentielles dans tous les appareils de structure. L’API Diagnostic évalue si les appareils interconnectés répondent à la nomenclature (BOM) et les classe comme étant conformes ou non conformes. Les résultats sont présentés au format JSON, englobant des informations telles que l’état de validation, les erreurs, le type d’identificateur et l’ID d’appareil voisin. Ces résultats sont stockés dans un compte de stockage fourni par le client. Il est vital au déploiement général de résoudre les erreurs identifiées dans ce rapport avant de passer à l’étape Déploiement de cluster.

Prérequis

  • Vérifiez que Nexus Network Fabric est correctement approvisionné.
  • Fournissez l’ID Network Fabric et l’URL de stockage avec un accès WRITE (en ÉCRITURE) via un ticket de support.

Remarque

L’URL de stockage (SAP) a une durée de vie limitée. Par défaut, elle est définie pour expirer au bout de huit heures. Si l’URL SAP expire, la structure doit alors faire l’objet d’une nouvelle correction.

Valider un câblage

  1. Exécutez la commande Azure CLI suivante :

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

    Le résultat suivant (tronqué) doit s’afficher. Copiez l’URL via la préversion privée. Cette portion de l’URL est utilisée dans l’étape suivante pour vérifier l’état de l’opération.

    https://management.azure.com/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/59fdc0c8-eeb1-4258-9163-3cf096490148*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-
    
    
  2. Vous pouvez vérifier de manière programmatique l’état de l’opération en exécutant la commande suivante :

    az rest -m get -u "<Azure-AsyncOperation-endpoint url>" 
    

    L’état de l’opération indique la réussite ou l’échec de l’API.

    Remarque

    L’achèvement de l’opération prend entre 20 et 40 minutes en fonction du nombre de racks.

  3. Téléchargez et parcourez les résultats validés à partir de l’URL de stockage.

L’exemple de sortie est illustré dans les sections suivantes.

Exemple de sortie de validation de périphérie du client (CE) vers périphérie du fournisseur (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 
                      } 
                    } 
                  ] 
                },

Validation de périphérie du client vers un commutateur Top of the 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 
                          } 
                        } 
                      ]

États de validation

Type d’état Définition
Conforme Quand l’état est conforme à la spécification de BOM
Non conforme Quand l’état n’est pas conforme à la spécification de BOM
Inconnu Quand l’état est inconnu

Attributs de validation

Attribut Définition
deviceConfiguration Configuration qui est disponible sur l’appareil.
error Erreur provenant de l’appareil
reason Ce champ est renseigné quand l’état de l’appareil est inconnu.
validationType Ce paramètre indique le type de validation. (validations de spécification de câble et câble)
deviceDestinationResourceId ID Azure Resource Manager du voisin connecté (appareil de destination)
roleName Rôle du Network Fabric Device (CE ou TOR)

Limitations et problèmes connus liés à la validation de câble

  • Les connexions postérieures à la validation entre des TOR et des serveurs de calcul ne sont pas prises en charge.
  • La validation de câble pour NPB n’est pas prise en charge, car il n’existe aucun support pour « show lldp neighbors » (afficher les voisins lldp) d’Arista.
  • L’URL de stockage doit se trouver dans une autre région de Network Fabric. Par exemple, si Fabric est hébergé dans USA Est, l’URL de stockage doit se situer en dehors d’USA Est.
  • La validation de câble prend en charge des BOM de quatre et de huit racks.

Générer l’URL de stockage

Reportez-vous à Créer un conteneur si vous souhaitez créer un conteneur.

Remarque

Entrez le nom du conteneur en utilisant uniquement des lettres en minuscules.

Reportez-vous à Générer une signature d’accès partagé pour créer l’URL SAP du conteneur. Fournissez une autorisation en ÉCRITURE pour SAP.

Remarque

Les URL ESAS sont à durée de vie limitée. Par défaut, elles sont définies pour expirer au bout de huit heures. Si l’URL SAP arrive à expiration, vous devez ouvrir un ticket de support Microsoft pour ajouter une nouvelle URL.