Mise à niveau du DCD Apstra sur une nouvelle machine virtuelle (VM-VM)

La mise à niveau d’Apstra DCD sur une nouvelle VM inclut des correctifs du système d’exploitation Ubuntu Linux et des mises à jour de sécurité. Pour la mise à niveau, vous devez disposer des privilèges d’administrateur du système d’exploitation DCD Apstra et des autorisations de groupe d’administrateurs.

Étape 1 : Validation préalable à la mise à niveau

  1. Consultez Chemins de mise à niveau pour confirmer que vous effectuez une mise à niveau vers une version prise en charge. Dans l’interface graphique d’Apstra DCD, recherchez votre version actuelle sous le logo Juniper Apstra DCD dans le menu de navigation supérieur gauche.
  2. Connectez-vous au serveur DCD Apstra en tant qu’administrateur (par exemple, si l’adresse IP de votre serveur DCD Apstra était 10.28.105.3, la commande serait ssh admin@10.28.105.3).
  3. Exécutez la commande service aos status pour vérifier que le serveur est actif et n’a aucun problème.
  4. Consultez les notes de version d’Apstra Data Center Director pour connaître les modifications de rendu de configuration susceptibles d’avoir un impact sur le plan de données.
  5. Passez en revue chaque blueprint pour confirmer que toutes les configurations de service sont à l’état SUCCEEDED. Si nécessaire, annulez le déploiement et supprimez les appareils du blueprint pour résoudre toute configuration de service en attente ou ayant échoué.
  6. Examinez chaque blueprint pour détecter les anomalies de sonde et résolvez-les autant que possible. Prenez note de toute anomalie restante.
  7. Reportez-vous au Guide de l’utilisateur Apstra Data Center Director (Références > les équipements > les équipements qualifiés et les versions NOS) pour vérifier que les modèles d’appareils et les versions NOS sont qualifiés sur la nouvelle version DCD d’Apstra. Mettez à niveau ou rétrogradez selon vos besoins vers l’une des versions prises en charge.
  8. Si vous utilisez des équipements Junos, la configuration vierge doit inclure les éléments essentiels mgmt_junos VRF.
    MISE EN GARDE :

    Si la configuration vierge n’inclut pas le mgmt_junos VRF, le déploiement échouera.

  9. Supprimez toute configuration AAA de l’appareil. Lors de la mise à niveau de l’appareil, les informations d’identification configurées de l’agent de l’appareil sont requises pour l’accès SSH.
  10. Supprimez tous les configlets utilisés pour configurer les pare-feu. Si vous utilisez les filtres du moteur de routage de FW sur des appareils, mettez-les à jour pour inclure l’adresse IP du nouveau contrôleur et des machines virtuelles de travail.
  11. Pour mettre à niveau les agents système des appareils, Apstra DCD a besoin d’un accès SSH à tous les appareils utilisant les informations d’identification configurées. Dans l’interface graphique d’Apstra DCD, accédez à Appareils > Appareils gérés, sélectionnez le ou les appareils à vérifier, puis cliquez sur Vérifier dans le menu Agent. Assurez-vous que tous les états des tâches indiquent RÉUSSITE. Corrigez les échecs des tâches de vérification avant de mettre à niveau le DCD d’Apstra.
  12. En tant qu’utilisateur root , exécutez la commande sudo aos_backup de sauvegarde du serveur DCD Apstra.
    MISE EN GARDE :

    La mise à niveau du serveur DCD d’Apstra exclut les révisions de Time Voyager. Pour revenir à un état antérieur, vous avez besoin de cette sauvegarde. Les états précédents ne sont pas disponibles en raison de changements dans les conceptions de référence entre les versions DCD d’Apstra.

  13. Copiez les fichiers de sauvegarde vers /var/lib/aos/snapshot/<shapshot_name> un emplacement externe.
  14. Assurez-vous que la nouvelle machine virtuelle dispose des ressources serveur requises pour le serveur DCD Apstra.

Étape 2 : Déployer un nouveau serveur DCD Apstra

Remarque :

Si vous avez personnalisé le /etc/aos/aos.conf fichier sur l’ancien serveur DCD Apstra (par exemple, si vous avez mis à jour le metadb champ pour utiliser une interface réseau différente), réappliquez ces modifications à la nouvelle VM du serveur DCD Apstra. La migration automatique n’a pas lieu.

  1. En tant qu’utilisateur d’assistance enregistré, téléchargez l’image de la machine virtuelle Apstra DCD et transférez-la vers le nouveau serveur Apstra DCD.
  2. Installez et configurez la nouvelle image de la machine virtuelle DCD Apstra avec la nouvelle adresse IP (le même nom de domaine complet ou un nouveau nom de domaine complet peut être utilisé).
  3. Vérifiez les points suivants pour le nouveau serveur DCD Apstra :
    • Accès SSH à l’ancien serveur DCD Apstra.

    • Connectivité aux agents système (voir Ports de communication requis).

    • Accès à des systèmes externes tels que NTP, DNS, serveur vSphere et serveur LDAP/TACACS+.

Étape 3 : Importer l’état

Remarque :

Évitez d’effectuer des opérations d’écriture d’API/d’interface graphique sur l’ancien serveur DCD Apstra après avoir lancé l’importation de la nouvelle machine virtuelle. Les modifications apportées ne seront pas transférées sur le nouveau serveur DCD Apstra.

  1. Connectez-vous au nouveau serveur DCD Apstra en tant qu’administrateur utilisateur.
  2. Exécutez la sudo aos_import_state commande pour importer SysDB à partir de l’ancien serveur, appliquer les traductions nécessaires et importer la configuration. Incluez les arguments suivants, le cas échéant :
    • --ip-address <old-Apstra DCD-server-ip>
  3. Entrez le nom d’utilisateur de l’administrateur :
    • Utilisation --username <admin-username>
    • Pour les clusters DCD Apstra avec de nouvelles adresses IP de nœud Worker, incluez --cluster-node-address-mapping <old-node-ip> <new-node-ip>
    • Pour conserver l’ancien serveur DCD Apstra, utilisez --disable-original-Apstra DCD-server {prompt,disable,keep}. Par exemple : --disable-original-Apstra DCD-server keep.

    • Exécutez les vérifications des conditions préalables de mise à niveau sans mise à niveau à l’aide de --dry-run-connectivity-validation.

    • Ignorer la validation de la connectivité iavec --skip-connectivity-validation.

    • Si les informations d’identification SSH de l’ancienne version d’Apstra DCD sont moins strictes que la nouvelle version, ajoutez-les --override-cluster-node-credentials à la commande lors de l’importation de la base de données pour éviter l’échec de la aos_import_state mise à niveau.

    • Pour les équipements Junos sans VRF de gestion configurés, utilisez ---skip-junos-mgmt-vrf-check pour un processus de mise à niveau sans échec.

    Exemple de commande : Machine virtuelle unique ou cluster DCD Apstra avec les mêmes nœuds de travail

    Exemple de commande : Cluster DCD Apstra avec de nouveaux nœuds de travail

    Dans l’exemple ci-dessus, 10.28.105.4 et 10.28.105.7 sont les anciennes adresses IP de nœud de travail ; 10.28.105.6 et 10.28.105.8 sont les nouvelles adresses IP de nœud de travail.

    La racine est requise pour importer la base de données, il vous sera donc demandé le mot de passe SSH et le mot de passe root de la VM DCD Apstra distante.

    Remarque :

    Lors de la mise à niveau d’un cluster DCD Apstra, vérifiez que le mot de passe SSH de l’ancien contrôleur, de l’ancien et du nouveau travailleur est identique. Sinon, la mise à niveau échoue à l’authentification. Le « Mot de passe SSH pour la machine virtuelle AOS distante » s’applique aux machines virtuelles du contrôleur à distance, de l’ancien travailleur et du nouveau travailleur. Après la mise à niveau, si vous le modifiez, mettez à jour le mot de passe SSH des machines virtuelles de travail dans l’interface graphique (Platform > Apstra Data Center Director > Nodes) d’Apstra.

    Remarque :

    La taille du blueprint et les ressources de la machine virtuelle du serveur DCD Apstra déterminent le temps nécessaire pour terminer l’importation. Si l’importation de la base de données dépasse la valeur par défaut (40 min ou 2400 secondes), l’opération peut 'expirer'. Utilisez la AOS_UPGRADE_DOCKER_EXEC_TIMEOUT commande pour incrémenter la valeur du délai d’expiration si nécessaire.

    Par exemple, la commande suivante augmente le délai avant l’expiration à 2 heures (7200 secondes).

    admin@aos-server:~$ sudo AOS_UPGRADE_DOCKER_EXEC_TIMEOUT=7200 aos_import_state --ip-address 10.10.10.10 --username admin

    Le script de mise à niveau affiche un résumé des appareils de la fabric recevant des modifications de configuration pendant la mise à niveau Un avertissement vous conseille de lire d’abord les notes de version et la documentation sur les chemins de mise à niveau d’Apstra DCD. Les notes de version incluent une catégorie pour les modifications du rendu de la configuration. Les changements de rendu de configuration sont documentés en haut des notes de mise à jour, détaillant leur impact sur le réseau.

    Le résumé de la mise à niveau d’Apstra présente des informations par rôle d’appareil : superspine, spine, leaf, paire leaf et commutateur d’accès. Si une configuration incrémentielle a été appliquée au lieu d’une configuration complète, davantage de détails sur les modifications s’affichent

  4. Le menu interactif Mise à niveau AOS vous permet de passer en revue les modifications de configuration sur chaque appareil. Vérifiez que la nouvelle configuration de la mise à niveau n’entre pas en conflit avec les configlets existants.
    MISE EN GARDE :

    La nouvelle version d’Apstra DCD peut modifier la conception de référence d’Apstra DCD, invalidant les configlets. Vérifiez vos configlets pour éviter les conflits avec la configuration mise à jour. Si des mises à jour sont nécessaires, quittez la mise à niveau, modifiez vos configlets et redémarrez la mise à niveau.

  5. Si vous souhaitez poursuivre la mise à niveau après avoir examiné les modifications en attente, entrez c.
  6. Si vous souhaitez arrêter la mise à niveau, entrez q pour abandonner le processus. Si vous quittez à ce stade et décidez plus tard de mettre à niveau, vous devez recommencer le processus depuis le début.
    Remarque :

    Si la mise à niveau du DCD Apstra échoue (ou en cas de dysfonctionnement), vous pouvez arrêter le nouveau serveur DCD Apstra en douceur et redémarrer l’ancien serveur DCD Apstra pour poursuivre les opérations.

Étape 4 : État d’importation pour les analyses basées sur l’intention

Remarque :

Depuis Apstra DCD 5.0.0, nous n’attribuons plus de balises aux sondes et aux platines et ne prenons plus en charge le service de evpn-host-flap-count télémétrie.

Pour supprimer ou désactiver des widgets ou des sondes pour l’analyse basée sur l’intention, ajoutez les arguments suivants à la sudo aos_import_state commande :

  • --iba-remove-unused widgets: Supprimer les widgets inutilisés du tableau de bord.

  • --iba-remove-probe-and-stage-tags: Supprimer les balises des sondes et des platines.

  • --iba-number-non-unique-probe-labels: Ajoutez des numéros de série aux étiquettes de sonde non uniques.

  • --iba-number-non-unique-dashboard-labels: Ajoutez des numéros de série aux étiquettes de tableau de bord non uniques.

  • --iba-disable-probe-with-evpn-host-flap-count-service: Désactivez les sondes non prédéfinies à l’aide du service evpn-host-flap-count.

  • --iba-strip-dashboard-labels-widget-labels: Supprimez les espaces de début/fin des étiquettes du tableau de bord et des widgets.

  • --iba-strip-probe-labels-processor-names: Supprimer les espaces de début/fin des étiquettes de sonde et des noms de processeur.

Étape 5 : Conserver l’adresse IP de l’ancienne machine virtuelle (facultatif)

Effectuez les étapes suivantes avant de modifier le mode de fonctionnement et de mettre à niveau l’agent des appareils.

Pour conserver l’adresse IP de l’ancienne machine virtuelle :

  1. Arrêtez l’ancienne machine virtuelle ou remplacez son adresse IP par une autre adresse pour libérer l’adresse IP. Ceci est nécessaire pour éviter tout problème d’adresse IP dupliquée.
  2. Accédez au menu interactif Apstra DCD de la nouvelle VM à partir de la CLI.
  3. Cliquez sur Réseau pour mettre à jour l’adresse IP et confirmer les autres paramètres.
  4. Pour que la nouvelle adresse IP prenne effet, redémarrez le service réseau, soit à partir du même menu avant de quitter, soit à partir de la CLI après avoir quitté le menu.

Étape 6 : Modifier l’adresse IP DCD d’Apstra dans la configuration de flux après la mise à niveau du DCD d’Apstra (si vous ne réutilisez pas l’adresse IP d’origine)

Lors de la mise à niveau du DCD Apstra avec VM-to-VM, l’adresse IP du DCD Apstra change, sauf si vous réutilisez l’ancienne IP à l’étape 5.

Si l’adresse IP change, mettez à jour le composant Apstra DCD Flow pour capturer la nouvelle adresse IP comme suit :

  1. SSH vers la CLI de flux DCD d’Apstra (les identifiants par défaut sont Apstra DCD/Apstra DCD).
  2. Ouvrez /etc/juniper/flowcoll.yml.
  3. Modifiez le champ EF_JUNIPER_Apstra DCD_API_ADDRESS avec la nouvelle adresse IP.
  4. Exécuter sudo systemctl restart flowcoll.service.

Étape 7 : Changer le mode de fonctionnement en normal

Lorsque vous démarrez une mise à niveau du serveur DCD Apstra, le mode passe automatiquement de Normal à Maintenance . Le mode de maintenance empêche les agents hors boîtier de se connecter, arrête les déploiements de configuration et arrête les extractions de télémétrie. Pour revenir à la version précédente, arrêtez le nouveau serveur. Pour terminer la mise à niveau, repassez le mode Normal.

  1. Connectez-vous à l’interface graphique d’Apstra DCD.
  2. Pour afficher les modifications de configuration de service en attente, accédez au tableau de bord du blueprint et cliquez sur EN ATTENTE pour voir les appareils concernés.
  3. Dans le menu de navigation de gauche, accédez à Platform > Apstra DCD Cluster > Cluster Management.


  4. Cliquez sur le bouton Modifier le mode de fonctionnement , sélectionnez Normal, puis cliquez sur Mettre à jour. Tous les agents offbox, qu’ils se trouvent sur le contrôleur ou sur les machines virtuelles de travail, se connectent automatiquement et reconnectent les appareils et appliquent tous les changements de configuration en attente. Après quelques instants, les anomalies temporaires sur le tableau de bord se résolvent et la section de configuration du service indique que l’opération a réussi.

    Vous pouvez également accéder à la page Gestion des clusters à partir de la section inférieure gauche de n’importe quelle page. À partir de là, vous disposez également d’une visibilité continue sur l’intégrité de la plate-forme, en fonction des couleurs.

    En bas du menu de navigation de gauche, cliquez sur l’un des points, puis cliquez sur Mode de fonctionnement pour accéder à Gestion des clusters. Cliquez sur le bouton Modifier le mode de fonctionnement , sélectionnez Normal, puis cliquez sur Mettre à jour.


Étape 8 : Mise à niveau des agents pour les appareils

Mise à niveau des agents onbox

Le serveur Apstra DCD et les agents onbox doivent exécuter la même version d’Apstra DCD. Si les versions sont différentes, les agents ne se connecteront pas au serveur DCD Apstra.

Si vous exécutez un blueprint multi-états, en particulier en 5 étapes, mettez à niveau les agents par étapes :

  • Tout d’abord, améliorez les superspines.

  • Ensuite, améliorez les épines.

  • Enfin, mettez à niveau les branches.

Cet ordre minimise les problèmes de recherche de chemin. Le routage peut temporairement passer du leaf au spine, puis revenir à un autre leaf, puis à un autre spine. Les mises à niveau intermédiaires réduisent ce risque.

Pour mettre à niveau un agent Onbox :

  1. Connectez-vous à l’interface graphique DCD d’Apstra en tant qu’administrateur utilisateur.

  2. Dans le menu de navigation de gauche, accédez à Appareils > Appareils gérés et cochez les cases du ou des appareils à mettre à niveau (jusqu’à 100 appareils à la fois). Vous pouvez mettre à niveau plusieurs agents onbox en même temps, mais l’ordre de mise à niveau des appareils est important.

    • Mettez d’abord à niveau les agents pour les superspines.
    • Agents de mise à niveau pour les spines en second.
    • Agents de mise à niveau pour les feuilles troisième.

    Lorsque vous sélectionnez un ou plusieurs périphériques, les menus Périphérique et Agent apparaissent au-dessus du tableau.

  3. Cliquez sur le bouton Installer pour lancer le processus d’installation.

    L’état de la tâche passe à EN COURS. Si les agents utilisent une version antérieure du logiciel Apstra DCD, ils sont automatiquement mis à niveau vers la nouvelle version. Ils se connectent ensuite au serveur et transmettent aux appareils les modifications de configuration en attente. La télémétrie reprend également, et l’état du travail passe à SUCCÈS.

  4. Dans la section Activité du tableau de bord du blueprint, vérifiez qu’il n’y a aucune anomalie sur l’appareil.

    Remarque : Pour revenir à la version précédente d’Apstra DCD après la mise à niveau de l’agent, créez une nouvelle machine virtuelle avec la version précédente d’Apstra DCD et restaurez la configuration sur la nouvelle machine virtuelle. Contactez l’assistance technique de Juniper pour obtenir de l’aide

Mise à niveau des agents OffBox

À partir d’Apstra DCD 6.1, cliquez sur le bouton Mettre à jour les clés d’hôte pour les agents hors boîtier de l’équipement géré.

Upgrade OffBox Agent(s)
Remarque : Le DCD d’Apstra suit les clés d’empreintes de l’hôte pour les appareils gérés. La mise à jour du contrôleur supprime les clés d’hôte apprises, ce qui empêche les processus des agents de démarrer tant qu’une connexion SSH n’est pas établie. Consultez Configurer de nouvelles clés SSH sur le serveur DCD Apstra pour obtenir des instructions.

Étape 9 : Arrêter l’ancien serveur DCD Apstra

Pour arrêter l’ancien serveur DCD Apstra, procédez comme suit :
  1. Mettez à jour toutes les entrées DNS pour utiliser la nouvelle adresse IP/FQDN du serveur DCD Apstra en fonction de votre configuration.
  2. Si vous utilisez un proxy pour le serveur DCD Apstra, assurez-vous qu’il pointe vers le nouveau serveur.
  3. Arrêtez gracieusement l’ancien serveur DCD Apstra. Si vous avez confirmé l’arrêter, la commande s’exécute service aos stop automatiquement.
  4. Si vous mettez à niveau un cluster DCD Apstra et que vous remplacez vos nœuds de travail par de nouvelles machines virtuelles, arrêtez les anciennes machines virtuelles de travail.
Prochaines étapes :

Mettez à niveau les versions NOS de votre appareil vers une version qualifiée si elles ne sont pas compatibles avec la nouvelle version DCD d’Apstra, consultez le Guide de l’utilisateur d’Apstra Data Center Director pour plus de détails.