Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
SUR CETTE PAGE
 

Guide de remplacement d’appareil Juniper Apstra

Dans un réseau de datacenter fonctionnel, il est essentiel de remplacer un appareil défaillant ou qui doit être réaffecté ou réutilisé à d’autres fins. Ce document décrit comment remplacer un appareil géré par Juniper Apstra à l’aide de l’interface graphique d’Apstra et du fournisseur Apstra Terraform.

Remplacer un équipement géré à l’aide de l’interface graphique d’Apstra

Le remplacement d’un appareil géré dans l’interface graphique d’Apstra est un ensemble de tâches simples. Les équipements gérés sont extraits de leur rôle dans la structure à l’aide de plans d’équipements logiques et d’interfaces et sont affectés à un blueprint.

Remarque :

Dans ces procédures, nous remplaçons le périphérique leaf2 dans l’interface graphique. L’équipement de remplacement (leaf2) est exactement le même que l’équipement physique (marque, modèle et configuration de port) que celui que nous remplaçons.

Dans cette rubrique, nous allons vous montrer comment remplacer un appareil en utilisant les méthodes suivantes :

Supprimer une branche avec un appareil toujours connecté

  1. Dans le menu de navigation de gauche de l’interface graphique d’Apstra, accédez à Blueprints > Blueprint ID > Staged > Physical > Build, puis cliquez sur l’icône Appareils .

    Physical network topology view with spine switches spine1 and spine2, leaf switches leaf1, leaf2, and leaf3, connected servers, and assigned system IDs.

  2. Cliquez sur ID système attribués - Nœuds gérés , puis cliquez sur l’icône Modifier les affectations d’ID système .

    Assigned System IDs section showing nodes spine1 spine2 leaf1 leaf2 leaf3 with unique IDs. Red arrow highlights icon to change system ID assignments.

  3. Cliquez sur l’icône de la corbeille, puis sur Mettre à jour les affectations pour annuler l’affectation de leaf2. User interface showing a table for assigning systems with rows for spine2, leaf1, and leaf2. Leaf2 is highlighted with an arrow pointing to a red trash bin icon for removing assignments. Radio buttons offer options: Deploy, Ready, Drain, Undeploy.

    Ici, nous pouvons voir que leaf2 n’est plus attribué.

  4. Table titled Assigned System IDs - Managed Nodes listing nodes spine1, spine2, leaf1, leaf2, and leaf3 with system IDs. Leaf2 is not assigned, indicated by a yellow warning icon and red box. Toolbar with action icons at the top.

  5. Accédez à l’onglet Non validé et cliquez sur l’icône Valider la fusée.

    Uncommitted changes in network tool UI with tabs Dashboard, Analytics, Staged, Active, Time Voyager. Warnings, successful indicators, Commit rocket, Revert buttons. System Node leaf2 marked as CHANGED.

  6. Ajoutez un commentaire si vous le souhaitez, puis cliquez sur Valider.Dialog box to commit changes from Staged to Active with optional description field for new blueprint revision.

  7. Une fois la validation terminée, accédez à Appareils > Appareils gérés pour revenir à la vue du tableau Appareils gérés.

    User interface showing device management section with vertical navigation menu on the left. Highlighted

    Leaf2 n’est plus attribué du blueprint.

    Screenshot of a network management interface showing device details. Highlighted row: IP 10.28.252.14, hostname leaf2, state OOS-READY, no blueprint assigned.

  8. Désinstallez l’agent de leaf2 en cliquant sur l’icône Désinstaller . Network management interface showing device information and agent management options. Device table with highlighted row for IP 10.28.252.14, state OOS-READY, no blueprint assigned. Agent panel with uninstall option marked.

  9. Dans la boîte de dialogue contextuelle, cliquez sur Confirmer pour désinstaller l’agent système.

  10. Une fois la désinstallation terminée, l’état leaf2 s’affiche sous la forme oos-nocomms avec un x rouge dans la colonne Communications .

    Network management interface showing a table of Juniper devices with details like IP address, device key, profile, hostname, OS, state, comms status, and job state. Highlighted row: IP 10.28.252.14, hostname leaf2, state OOS-NOCOMMS, blueprint not assigned, last job type UNINSTALL, job state SUCCESS.
  11. La dernière étape consiste à supprimer complètement l’appareil leaf2 d’Apstra. Il y a deux étapes :

    1. Tout d’abord, cliquez sur l’icône de la corbeille dans le panneau Appareil .

      User interface with columns labeled Device and Agent. Red arrow points to trash bin icon labeled Delete Device, indicating device deletion action.

      Cliquez ensuite sur Supprimer dans la boîte de dialogue suivante pour supprimer l’appareil.

      Confirmation dialog asking 'Delete this resource' with a red Delete button featuring a trash can icon.

    2. Cliquez sur l’icône Désinstaller l’agent dans le panneau Agent .

      User interface with columns labeled Device and Agent; icon in Agent column highlighted with red arrow and labeled Uninstall Agent.

      Cliquez ensuite sur Confirmer dans la boîte de dialogue pour désinstaller l’agent.

Une fois terminé, l’appareil leaf2 est supprimé du blueprint.

Supprimer un équipement leaf défaillant

Pour cette procédure, nous supprimerons un qui a échoué et ne communique plus avec Apstra.

  1. Dans le menu de navigation de gauche de l’interface graphique d’Apstra, accédez à Blueprints> Staged > Physical > Build et cliquez sur l’icône Appareils . Si l’appareil existe déjà dans le tableau, vous pouvez ignorer cette étape et passer à l’étape 2.

  2. Cliquez sur ID système attribués - Nœuds gérés > puis cliquez sur l’icône Modifier les affectations d’ID système .

  3. Cliquez sur l’icône de la corbeille pour supprimer l’affectation leaf2, puis cliquez sur Mettre à jour les affectations.

  4. Vérifiez que leaf2 n’est plus attribué.

  5. Accédez à l’onglet Non validé , puis cliquez sur l’icône Valider la fusée.

  6. Ajoutez un commentaire si vous le souhaitez, puis cliquez sur Valider.

    User interface for committing blueprint changes with header 'Commit changes from Staged to Active', info box on revisions, description field with 'Remove leaf2 from blueprint', and Commit button.

  7. Une fois la validation terminée, accédez au panneau Périphériques > Périphériques gérés pour revenir à la vue du tableau des périphériques gérés.

    L’appareil Leaf2 n’est plus attribué du blueprint.

  8. Cliquez sur l’icône de la corbeille dans le panneau Appareil .

    Network management interface showing a device table with details like Management IP, Device Key, and State. Device with IP 10.28.252.14 is highlighted, marked OOS-READY, not assigned to a blueprint. Action panel on right includes a trash bin icon to remove failed devices.

  9. Cliquez sur Supprimer pour supprimer le périphérique défaillant (leaf2) du tableau Périphériques gérés .

  10. Supprimez l’agent de l’appareil.

    Sélectionnez l’appareil dans le tableau Appareils gérés (10.28.252.14 dans notre exemple) et cliquez sur l’icône de la corbeille dans le panneau Agent pour supprimer l’agent.

    Agent panel with icons for actions; trash can icon labeled Delete Agent at bottom; column labeled Actions with three-dot menus.

  11. Cochez la case Forcer la suppression, puis cliquez sur Supprimer pour forcer la suppression.

    Apstra interface screenshot: Warning about communication failure with device. Checkbox labeled Force Delete and Delete button highlighted.

Vous avez réussi à supprimer l’appareil défaillant du blueprint.

Ajouter l’appareil de remplacement au blueprint

Examinons maintenant ce qui est nécessaire pour remplacer l’appareil dans le blueprint.

  1. Dans le menu de navigation de gauche de l’interface graphique d’Apstra, accédez à Appareils > Appareils gérés.

    Si l’appareil existe déjà dans le tableau, vous pouvez ignorer cette étape et passer à l’étape 2.

  2. Sur la page Appareils gérés , cliquez sur Créer un ou plusieurs agents onbox. Notez que les appareils SONIC utilisent des agents Onbox.

    Web interface for managing devices showing breadcrumb navigation Devices > Managed Devices, action buttons for creating agents, and a table listing device details like IP, hostname, OS, and status.

  3. Saisissez l’adresse, le nom d’utilisateur et le mot de passe de l’appareil, puis cliquez sur Créer.

    Configuration interface for creating Onbox System Agent with fields for device addresses, operation mode, username, and password, plus a Create button.

  4. Lorsque l’agent a terminé l’installation, cliquez sur Acquitter les systèmes sélectionnés dans le panneau Périphérique situé au-dessus du tableau Périphériques gérés .

    User interface for managing devices with toolbar icons. A red arrow highlights the Acknowledge selected systems icon, a checkmark in a circle.

  5. Cliquez sur Confirmer dans la boîte de dialogue pour accuser réception de l’appareil.

    Confirmation dialog box titled Acknowledge systems with Cancel and Confirm buttons; pink arrow points to Confirm.

  6. Accédez à Blueprints > Blueprint ID > Staged > Physical > Build, puis cliquez sur l’icône Appareils .

  7. Cliquez sur ID système attribués - Nœuds gérés , puis cliquez sur l’icône Modifier les affectations d’ID système .

  8. Sélectionnez le périphérique de remplacement leaf2, cliquez sur la case d’option Déployer , puis sur Mettre à jour les affectations.

    User interface for assigning systems in a network tool. Table with columns: Name, Role, Hostname, System ID, Deploy Mode. Each row details system info and deploy state options. Red trash bin icons for deletion. Dropdown for selecting System ID.

  9. Validez la modification en accédant à l’onglet Non validé , puis cliquez sur l’icône de fusée Valider .

  10. Commentez et cliquez sur Valider pour ajouter l’appareil de remplacement à votre blueprint.

    Remarque :

    Il faudra un certain temps pour stabiliser le déploiement et toute anomalie devrait finir par converger et disparaître.

    Commit changes from Staged to Active. Add a revision description, currently

Remplacer un équipement dans Apstra à l’aide d’Apstra Terraform Provider

Vous pouvez facilement remplacer un équipement dans un blueprint à l’aide d’Apstra Terraform Provider. Le diagramme ci-dessous montre la topologie que nous utilisons dans cette procédure.

Network topology interface showing 2D spine-leaf architecture with uncommitted changes. Nodes: spine1, spine2, rack_a_001_leaf1. Validation checks passed.

Dans l’exemple de configuration Terraform suivant, nous remplaçons l’équipement leaf ( rack_a_001_leaf1).
Remarque :

Nous supposons que la configuration Terraform est appliquée au serveur Apstra et que toutes les ressources du blueprint sont allouées et validées.

Exemple de configuration de Terraform

Pour remplacer un appareil à l’aide de Terraform :

  1. Supprimez le bloc de ressources suivant pour l’appareil de la configuration Terraform. Notez que vous ne pouvez pas supprimer un équipement d’Apstra sans le supprimer d’abord de votre blueprint.
    Dans cet exemple, nous supprimons l’appareil rack_a_001_leaf1 .

    Exécutez la terraform apply commande pour appliquer les modifications.

  2. Une fois l’application terminée, validez les modifications.
  3. Mettez à jour la configuration de Terraform avec les nouvelles informations pour l’appareil de remplacement.
    Remplacez le device_key et par les agent_id nouvelles valeurs.
    Vous pouvez dériver ces valeurs dans l’interface graphique d’Apstra en accédant à la page Appareils > appareils gérés et en sélectionnant l’adresse IP de l’appareil comme suit :
  4. Sur la page Appareil, copiez la clé d’appareil et l’ID d’agent codés à partir de la chaîne d’URL. Web-based device management interface showing device details for IP 10.28.24.235 with tabs for Device, Agent, Config, and Telemetry. Device is active, acknowledged, online, in full control mode, with hostname rack-a-001-leaf1. Red box highlights a long encoded string in the URL.
    Pour décoder la chaîne d’URL et obtenir les nouvelles device_key valeurs ( system-id) et ID d’agent, exécutez la pbpaste | base64 --decode commande. Par exemple :
    Remarque :

    Vous pouvez également dériver l’identifiant d’agent d’une source de données, de Swagger ou de la ressource Terraform qui l’a créé.
  5. Une fois que vous avez remplacé les informations dans Terraform, appliquez la nouvelle configuration :
  6. Validez vos modifications dans l’interface graphique d’Apstra ou dans Terraform pour terminer le remplacement de l’appareil.
Bon travail! Vous avez remplacé un appareil dans Apstra.
Remarque :

Dans nos exemples, nous avons supprimé toute configuration existante du nouvel appareil et effectué un redémarrage de l’appareil. Toutefois, dans certains cas d’utilisation, tels que les appareils SONiC, vous devrez peut-être supprimer toute configuration existante de l’appareil.

Par exemple :

Consultez le guide de l’utilisateur de Juniper Apstra pour plus d’informations sur la configuration d’un équipement SONiC.