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 sont conformes à la nomenclature et aux références SKU des ressources, et classe ces appareils comme étant conformes ou non conformes. Parmi les types d’appareils, citons les suivants : CE (Customer Edge), TOR (Top of Rack), MGMT (Management) et NPB (Network Packet Broker). 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.

Pour plus d’informations sur la nomenclature, reportez-vous à Références SKU Azure Operator Nexus.

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.
• Les prérequis pour le compte de stockage sont les suivants :
  • Le compte de stockage doit se trouver dans une région Azure différente de celle de la région Azure Network Fabric.
  • Le rôle Storage Blob Data Contributor doit être attribué à Nexus Network Fabric RP avec un accès attribué au compte de stockage.
• Le Support Microsoft doit appliquer un correctif à Nexus Network Fabric avec une URL SAP de stockage active avant d’exécuter la validation du câblage.

Création d’une demande de support Azure pour l’application de correctifs à Nexus Network Fabric :

• Reportez-vous à Création d’une demande de support Azure.
• Entrez Nexus Network Fabric comme problème, puis cliquez sur Go.
• Sélectionnez Azure Operator Nexus pour indiquer le service qui vous pose problème.
• Sélectionnez l’abonnement (Subscription) où se trouve la ressource.
• Sélectionnez General sous le champ de la ressource, puis cliquez sur Next.
• Sélectionnez Network fabric instance provisioning sous l’invite du problème, puis cliquez sur Next.
• Sélectionnez maintenant Create a support request en haut du panneau de support.
• Cliquez sur Next sous l’onglet Problem description.
• Attendez la solution recommandée (Recommended solution), puis cliquez sur le lien pour revenir à la demande de support.
• Cliquez à nouveau sur Next sous l’onglet Problem description pour accéder à Additional details.
• Remplissez les détails de la demande requis pour appliquer le correctif Nexus Network Fabric, puis cliquez sur Next.
• Passez en revue les informations sous l’onglet Review + create, puis cliquez sur Create.

Générer l’URL de stockage

Pour créer un conteneur dans le compte de stockage, reportez-vous à Créer un conteneur.

Pour générer une URL SAP pour le conteneur afin de fournir un accès en écriture à Nexus Fabric, reportez-vous à Générer une signature d’accès partagé.

Valider le 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 à partir de la section Azure-AsyncOperation de la sortie de débogage. Cette portion de l’URL est utilisée dans l’étape suivante pour vérifier l’état de l’opération.

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

   L’erreur suivante indique que la structure n’est pas corrigée avec une URL SAP valide :

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

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

   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 lisez les résultats validés à partir de l’URL <CABLING_REPORT_STORAGE_URL> retournée à l’issue de la commande.

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 du commutateur CE (Customer Edge) vers TOR (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 
                          } 
                        } 
                      ]

États de validation

Attributs de validation

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

• La validation des câbles des connexions entre TOR et les serveurs de calcul qui sont hors tension ou non approvisionnés dans le cluster Nexus n’est pas prise en charge. Ces interfaces affichent l’état Unknown dans le rapport.
• La validation des câbles des connexions entre les interfaces MGMT et les serveurs de calcul qui sont hors tension ou non approvisionnés dans le cluster Nexus ou les contrôleurs de serveur de calcul n’est pas prise en charge. Ces interfaces affichent l’état Unknown dans le rapport.
• La validation des câbles pour NPB n’est pas prise en charge pour les interfaces loopback et nni-direct, car le fournisseur ne prend actuellement pas en charge show lldp neighbors. Ces interfaces affichent l’état Unknown dans le rapport.
• 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 des câbles prend en charge quatre racks avec 16 calculs par rack et huit racks avec 16 calculs par nomenclature de rack.
• Lorsque l’appareil de destination est hors tension, les câbles sont manquants ou déconnectés, ou si la validation n’est pas prise en charge pour le type d’interface, l’interface affiche l’état Unknown. Il est important d’évaluer toutes les interfaces Unknown dans l’état Not-Connected par rapport à la nomenclature pour déterminer si une action de réparation est requise.

Problèmes standard de validation des câbles NonCompliant et Unknown

Conversion du rapport de validation des câbles au format HTML

Reportez-vous à Comment convertir la sortie JSON du rapport de validation des câbles au format HTML.