9.2. Vérifier la réception du fichier cables.csv

Durée estimée : 1 jour

Propriétaire du composant exploitable : OELCM/HWaaS

Profil de compétences : ingénieur de déploiement

Le fichier cables.csv décrit toutes les connexions câblées entre les appareils matériels d'une instance Google Distributed Cloud (GDC) isolée. Il s'agit d'un fichier d'entrée obligatoire pour générer des remplacements d'assets.

Génération

  1. Assurez-vous de recevoir les fichiers de feuille de calcul "factory final dynamic data" (données dynamiques finales en usine) du fournisseur de matériel :
    1. Un fichier de feuille de calcul pour chaque rack de l'instance Distributed Cloud.
    2. Chaque feuille de calcul contient un onglet avec des informations sur les câbles.
  2. Collectez les enregistrements de câblage de chaque feuille de calcul "factory final dynamic data" (données dynamiques finales en usine) :
    1. Regroupez manuellement les enregistrements des câbles de chaque feuille de calcul dans une seule feuille combinée.
    2. Supprimez les lignes vides.
    3. Assurez-vous qu'il n'y a qu'une seule ligne d'en-tête en première ligne.
    4. Chaque ligne suivante contient la liste agrégée des enregistrements de câbles provenant des feuilles de calcul "factory final dynamic data" (données dynamiques finales en usine).
  3. Convertissez ou exportez la feuille de calcul agrégée "Données dynamiques finales de l'usine" au format CSV (valeurs séparées par une virgule).
  4. Exécutez gdcloud system assets format-cables --input-cables <path/to/aggregated-factory-final-csv> --output-cables <output-path> pour effectuer une conversion optimale de la liste des câbles "factory final dynamic data" au format Distributed Cloud cables.csv décrit dans les spécifications du format.

Spécification du format

Pour que l'outil de déploiement Distributed Cloud puisse analyser les informations du fichier cables.csv et configurer correctement le matériel de l'instance, vous devez mettre en forme le fichier de manière lisible par une machine. Cette section décrit le format attendu pour le fichier cables.csv.

Le fichier est au format standard de valeurs séparées par une virgule, où chaque enregistrement est séparé par un délimiteur ,. Chaque ligne, à l'exception de l'en-tête, fait référence à un câble dans l'instance Distributed Cloud.

Nom de la colonne Description Format
end_a_rack_location1 Emplacement du rack de l'appareil qui se connecte à l'extrémité A du câble. Obligatoire pour toutes les connexions.

Pour les connexions PDU (expression régulière) : ^PDU-[LR]$
Pour tous les autres appareils (expression régulière) : ^U[0-9]{2}$

Exemple de PDU : PDU-L indique un câble qui se connecte à un appareil PDU sur le côté gauche du rack, vu de l'arrière.
Exemple de non-PDU : U32 indique un câble qui se connecte à un appareil situé à l'emplacement U32 du rack.
end_a_device Nom du matériel connecté à l'extrémité A du câble. Obligatoire pour toutes les connexions.

Ce champ doit correspondre à la spécification de nommage de l'appareil.
end_a_port Nom du port de l'appareil matériel qui se connecte à l'extrémité A du câble. Obligatoire pour toutes les connexions.

Ce champ doit correspondre à la spécification de nommage des ports de l'appareil.
end_a_transceiver_vendor1 Fournisseur de l'émetteur-récepteur pour l'extrémité A du câble (le cas échéant). Obligatoire si l'extrémité A du câble comporte un émetteur-récepteur ou un élément optique. Ne spécifiez pas si le type de câble est AOC ou DAC.

Valeurs autorisées :
  • Cisco
  • HPE
  • Intel
  • NetApp
  • Palo Alto
  • Thales
end_a_transceiver_mpn Modèle de l'émetteur-récepteur pour l'extrémité A du câble (le cas échéant). Obligatoire uniquement si cette extrémité du câble à fibre optique est équipée d'un émetteur-récepteur/d'un module optique. Si le type de câble est AOC ou DAC, ce champ ne doit pas être spécifié.

Valeurs autorisées :
  • 25GBase-SR
  • AFBR-709DMZ-IN3
  • E10GSFPLR
  • PAN-QSFP28-100GBASE-LR4
  • PAN-SFP-PLUS-LR
  • PAN-T-Q28-100GBASE-SR4
  • PAN-T-S-PLUS-SR
  • QDD-400G-DR4-S
  • QDD-400G-FR4-S
  • QDD-400G-LR4-S
  • QDD-400G-SR4.2-BD
  • QSFP-100G-CWDM4-S
  • QSFP-100G-DR-S
  • QSFP-100G-FR-S
  • QSFP-100G-LR4-S
  • QSFP-100G-SL4
  • QSFP-100G-SR1.2
  • QSFP-100G-SR4-S
  • QSFP-40/100-SRBD
  • QSFP-4X10G-LR-S
  • SFP-10/25G-LR-S
  • SFP-10G-LR
  • SFP-10G-LR-US
  • SFP-10G-SR
  • SFP-25G-SR-S
  • X65404-N-C
  • X6606A
  • X-48895-00-R6
end_a_adapter_vendor1 Fournisseur de l'adaptateur pour l'extrémité A du câble (le cas échéant). Obligatoire si l'extrémité A du câble est dotée d'un adaptateur.

Valeurs autorisées :
  • Cisco
  • FS
  • HPE
  • Mellanox
end_a_adapter_mpn1 Modèle de l'adaptateur pour l'extrémité A du câble (le cas échéant). Obligatoire uniquement si cette extrémité du câble est équipée d'un adaptateur.

Valeurs autorisées :
  • CVR-QSFP-SFP10G
  • CVR-QSFP28-SFP25G
  • MAM1Q00A-QSA28
  • QSFP28-SFP28
  • RJ45-DB9
end_b_rack_location1 Emplacement du rack de l'appareil matériel qui se connecte à l'extrémité B du câble. Identique à end_a_rack_location.
end_b_device Nom du matériel connecté à l'extrémité B du câble. Identique à end_b_device.
end_b_port Nom du port de l'appareil auquel est branchée l'extrémité B du câble. Identique à end_a_port.
end_b_transceiver_vendor1 Fournisseur de l'émetteur-récepteur pour l'extrémité B du câble (le cas échéant). Identique à end_a_transceiver_vendor.
end_b_transceiver_mpn Modèle de l'émetteur-récepteur pour l'extrémité B du câble (le cas échéant). Identique à end_a_transceiver_mpn.
end_b_adapter_vendor1 Fournisseur de l'adaptateur pour l'extrémité B du câble (le cas échéant). Identique à end_a_adapter_vendor>.
end_b_adapter_mpn1 Modèle de l'adaptateur pour l'extrémité B du câble (le cas échéant). Identique à end_a_adapter_mpn.
type Type de câble. Obligatoire pour tous les câbles.

Valeurs autorisées :
  • AOC
  • AOC 2x
  • CAT6
  • DAC
  • DAC 2x
  • DAC 4x
  • MMF
  • MMF 4x
  • MMF DAC
  • MMF MPO-12
  • RJ45
  • SMF
  • SMF 4x
vendor1 Fournisseur du câble. Obligatoire pour tous les câbles.

Valeurs autorisées :
  • Cisco
  • FS
  • HPE
  • NetApp
  • Panduit
  • ProLabs
mpn Modèle du câble. Obligatoire pour tous les câbles.1
Bloque la génération d'éléments si aucun des éléments end_a_transceiver_mpn, end_b_transceiver_mpn et mpn n'est spécifié pour les connexions de dérivation et de torsion.

Valeurs autorisées :
  • QSFP-100G-CU3M
  • QSFP-4SFP25G-CU3M
  • X-26013-00
  • X-QSFP-4SFP25G-CU2M
  • X66211A-05-C
  • X66211A-2
  • X66211B-2-N-C
  • X66240A-05
  • X66240A-05-N-C
speed1 Vitesse du câble (en Go). Obligatoire pour tous les câbles.

Expression régulière : ^[0-9]+$
Exemple : 100

La vitesse des connexions -ft et -bk des panneaux de répartition sera différente.

Exemple :
xx-aa-torsw01:Eth1/1 <-> xx-aa-ppl01:r03Ap01BO-bk Speed:100
xx-aa-objs01:e1a <-> xx-aa-ppl01:r03Ap01BO-ft Speed:25
xx-aa-objs01:e2a <-> xx-aa-ppl01:r03Ap02BO-ft Speed:25
length Longueur du câble. Obligatoire pour tous les câbles.

Expression régulière : ^[0-9]*\.?[0-9]+(ft|m)$
Exemple : .5m
color1 Couleur du câble. Obligatoire pour tous les câbles.

Valeurs autorisées :
  • turquoise
  • noir
  • blue
  • vert
  • orange
  • violet
  • rouge
  • blanc
  • jaune
description Description du câble. Facultatif.

Tout texte est autorisé.

Le champ 1 est vérifié pour le format, mais n'empêche pas la génération de composants.

Exemple

Voici un exemple de fichier cables.csv pour une instance GDCH imaginaire à un rack qui ne contient que quelques câbles et appareils.

end_a_rack_location,end_a_device,end_a_port,end_a_transceiver_vendor,end_a_transceiver_mpn,end_a_adapter_vendor,end_a_adapter_mpn,end_b_rack_location,end_b_device,end_b_port,end_b_transceiver_vendor,end_b_transceiver_mpn,end_b_adapter_vendor,end_b_adapter_mpn,type,vendor,mpn,length,color,notes
42,za-aa-torsw01,Eth1/23/1,Cisco,QSFP-100G-SL4,,,40,az-aa-base03,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-1
42,za-aa-torsw01,Eth1/23/2,Cisco,QSFP-100G-SL4,,,39,az-aa-base02,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-2
42,za-aa-torsw01,Eth1/23/3,Cisco,QSFP-100G-SL4,,,38,az-aa-base01,s1p1,HPE,25GBase-SR,,,MMF 4x,Panduit,FZ8RL7NQSVNM2.5,2.5m,Aqua,example-note-3