Mise à niveau d’Apstra sur la même VM (sur place)

Note:

Si vous effectuez une mise à niveau sur place, vous ne recevrez pas les correctifs du système d’exploitation Linux Ubuntu, y compris les mises à jour des vulnérabilités de sécurité. Pour recevoir ces mises à jour, vous devez effectuer une mise à niveau sur une nouvelle machine virtuelle. Pour effectuer une mise à niveau sur place, continuez à lire.

Pour mettre à niveau le serveur Apstra, vous devez disposer des privilèges d’administrateur du système d’exploitation Apstra et des autorisations du groupe d’utilisateurs administrateurs Apstra.

Étape 1 : Validation avant la mise à niveau

Reportez-vous à la section Chemins de mise à niveau pour confirmer que vous effectuez une mise à niveau vers une version prise en charge. (Vous pouvez trouver votre version actuelle d’Apstra en accédant à Platform > About dans l’interface graphique d’Apstra. À partir de la version 4.2.1 d’Apstra, la version Apstra est également affichée dans le menu de navigation de gauche de l’interface graphique, sous le logo Juniper Apstra.)
Par défaut, la mise à niveau d’Apstra crée le sous-réseau Docker supplémentaire 172.18.0.1/16. Si vous utilisez ce sous-réseau ailleurs dans votre réseau, la mise à niveau d’Apstra peut échouer. Si cela s’applique à vous, consultez Mises à niveau du réseau Docker et d’Apstra pour savoir comment utiliser un autre sous-réseau.
Connectez-vous au serveur Apstra en tant qu’administrateur (par exemple, si l’adresse IP de votre serveur Apstra est 10.28.105.3, la commande sera ssh admin@10.28.105.3).
Vérifiez que la machine virtuelle dispose de suffisamment de mémoire pour contenir deux versions du logiciel Apstra en même temps. Exécutez la commande free -h pour vérifier si l’utilisation de la mémoire est inférieure à 50 %.
Si le taux d’utilisation est supérieur à 50 %, arrêtez le serveur Apstra en douceur, ajoutez des ressources, puis redémarrez le serveur Apstra.

Exécutez la commande service aos status pour vérifier que le serveur est actif et qu’il n’y a aucun problème.

Consultez les notes de mise à jour de la nouvelle version d’Apstra pour connaître les modifications de rendu de configuration qui pourraient avoir un impact sur le plan de données. Mettez à jour les configlets si nécessaire.
Passez en revue chaque blueprint pour confirmer que toutes les configurations de service ont réussi. Si nécessaire, annulez le déploiement et supprimez les équipements du blueprint pour résoudre toute configuration de service en attente ou défaillante.
Examinez chaque plan pour détecter les anomalies de la sonde et résolvez-les autant que possible. Prenez note de toutes les anomalies restantes.
Reportez-vous à la section Équipements et versions NOS éligibles pour vérifier que vos versions NOS sont compatibles avec la nouvelle version d’Apstra. Effectuez une mise à niveau ou une rétrogradation, selon vos besoins, vers l’une des versions prises en charge.
Si vous utilisez des équipements Junos et que vous effectuez une mise à niveau vers Apstra version 4.2.1, la configuration parfaite doit inclure les éléments essentiels mgmt_junos VRF. Pour plus d’informations, consultez l’article KB77094 de la base de connaissances d’assistance Juniper.

PRUDENCE:

Si la configuration parfaite n’inclut pas le mgmt_junos VRF, le déploiement échoue.
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.
Supprimez tous les configlets utilisés pour configurer les pare-feu. Si vous utilisez les filtres du moteur de routage du micrologiciel sur des appareils, vous devez les mettre à jour pour inclure l’adresse IP du nouveau contrôleur et des machines virtuelles de travail.
Pour mettre à niveau les agents système des appareils, Apstra doit être en mesure de fournir un SSH à tous les appareils à l’aide des informations d’identification configurées lors de la création des agents. Pour le vérifier à partir de l’interface graphique d’Apstra, accédez à Périphériques > agents, cochez la ou les cases correspondant au(x) périphérique(s) à cocher, puis cliquez sur le bouton Vérifier dans le menu Agent. Vérifiez que tous les états de la tâche sont à l’état SUCCESS. En cas d’échec d’une tâche de vérification, résolvez le problème avant de procéder à la mise à niveau d’Apstra.
En tant qu’utilisateur root, exécutez la commande sudo aos_backup pour sauvegarder le serveur Apstra.
Note:
PRUDENCE:

Le serveur Apstra mis à niveau n’inclut aucune révision de Time Voyager, donc si vous avez besoin de revenir à un état antérieur, cette sauvegarde est nécessaire. Les états précédents ne sont pas inclus en raison du couplage étroit avec les conceptions de référence, qui peut changer entre les versions d’Apstra.
Copiez les fichiers de sauvegarde à partir d’un /var/lib/aos/snapshot/<shapshot_name> emplacement externe.

Étape 2 : Déployer un nouveau serveur Apstra

Téléchargez le package d’installation Apstra pour votre plate-forme à partir de Juniper Support Downloads (par exemple, aos_server_4.1.2-269) et transférez-le sur le serveur Apstra.

Décompressez le package d’installation d’Apstra.

Si vous utilisez un cluster Apstra (agents hors boîtier, sondes IBA), téléchargez également le package d’installation sur les nœuds de travail. Vous mettrez à niveau les nœuds de travail dans une étape ultérieure.
Connectez-vous au serveur Apstra en tant qu’administrateur.

Exécutez la sudo bash aos_<aos_version>.run commande, où <aos_version> est la version du fichier d’exécution. Par exemple, si la version est 4.0.1-1045 la commande, elle sera sudo bash aos_4.1.1-287.run comme indiqué ci-dessous.

Lorsque vous exécutez cette commande, si des versions antérieures d’Apstra sont détectées, le script passe en mode de mise à niveau au lieu du nouveau mode d’installation. Le nouveau conteneur Docker s’installe à côté des conteneurs Docker de la version précédente. Le script importe les données de la version précédente et les migre vers Apstra SysDB sur la nouvelle version.

Le script de mise à niveau présente une vue récapitulative des appareils de la structure qui recevront des modifications de configuration lors de la mise à niveau. À partir de la version 4.1.2 d’Apstra, un message d’avertissement s’affiche à l’écran vous recommandant de lire les notes de mise à jour et la documentation sur les chemins de mise à niveau avant de continuer. Les notes de mise à jour incluent une catégorie pour les modifications du rendu de la configuration, à partir de la version 4.1.2 d’Apstra. Les modifications apportées au rendu de la configuration sont clairement documentées en haut, ce qui explique l’impact de chaque modification sur le réseau.

À partir de la version 4.0.1 d’Apstra, le récapitulatif de mise à niveau d’Apstra affiche des informations séparées par rôles d’équipement (superspine, spine, leaf, leaf pair et commutateur d’accès, par exemple). Si une configuration incrémentielle a été appliquée au lieu d’une configuration complète, plus de détails s’affichent sur les modifications.

Une fois que vous avez examiné le récapitulatif, entrez q pour quitter le résumé. Le menu interactif Mise à niveau d’AOS s’affiche et vous permet de vérifier le changement de configuration exact sur chaque appareil. Si vous utilisez des configlets, vérifiez que la nouvelle configuration poussée par la mise à niveau n’entre pas en conflit avec les configlets existants.
PRUDENCE:

La conception de référence d’Apstra dans la nouvelle version d’Apstra peut avoir été modifiée d’une manière qui invalide les configlets. Pour éviter des résultats inattendus, vérifiez que vos configlets n’entrent pas en conflit avec la configuration nouvellement rendue. Si vous devez mettre à jour vos configlets, quittez la mise à niveau, mettez à jour vos configlets, puis relancez la mise à niveau.
Si vous souhaitez poursuivre la mise à niveau après avoir examiné les modifications en attente, entrez c. L’ancienne version d’Apstra est supprimée et la nouvelle version d’Apstra est activée sur le serveur. Une fois la mise à niveau terminée, accédez à Platform > About dans l’interface graphique d’Apstra pour vérifier la version.

PRUDENCE:

La mise à niveau du serveur Apstra est un processus perturbateur. Lorsque vous effectuez une mise à niveau sur place (même machine virtuelle) et que vous poursuivez la mise à niveau à partir de ce point, vous ne pouvez pas revenir en arrière. La seule façon de revenir à la version précédente consiste à réinstaller une nouvelle machine virtuelle avec la version précédente et à restaurer la base de données à partir de la sauvegarde que vous avez effectuée précédemment. Vous avez fait une sauvegarde, n’est-ce pas ?
Si vous souhaitez arrêter la mise à niveau, entrez q pour interrompre le processus. Si vous quittez à ce stade et décidez plus tard de mettre à niveau, vous devez recommencer le processus depuis le début.
Si vous utilisez un cluster Apstra, les nœuds de travail se déconnectent du contrôleur Apstra et passent à l’état FAILED. Cet état signifie que les agents hors boîte et les conteneurs de sondes IBA qui se trouvent sur les nœuds de travail ne sont pas disponibles ; Les équipements gérés par les agents offbox restent cependant en service. Après avoir mis à niveau les agents dans une étape ultérieure, vous mettrez à niveau les nœuds de travail de votre cluster Apstra et les agents et/ou sondes deviendront disponibles.

Étape 3 : Changez le mode de fonctionnement en mode normal

Lorsque vous lancez une mise à niveau du serveur Apstra, le mode de fonctionnement passe automatiquement de Normal à Maintenance . Une fois la mise à niveau terminée, vous devez repasser manuellement le mode à Normal.

Dans le menu de navigation de gauche de l’interface graphique d’Apstra, accédez à Platform > Apstra Cluster > Cluster Management.
Cliquez sur le bouton Modifier le mode de fonctionnement, sélectionnez Normal, puis cliquez sur Mettre à jour. Lorsque vous changez le mode sur Normal, tous les agents hors boîtier configurés sont activés, mais vous devez lancer la mise à niveau de tous les agents locaux (dans la section suivante).

Vous pouvez également accéder à la page Gestion des clusters à partir de la partie inférieure gauche de n’importe quelle page. À partir de là, vous bénéficiez également d’une visibilité continue sur l’état 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 du cluster. Cliquez sur le bouton Modifier le mode de fonctionnement , sélectionnez Normal, puis cliquez sur Mettre à jour.

Étant donné qu’ils sont encore en cours de mise à niveau, les agents ne seront pas connectés. Une fois la mise à niveau terminée, les agents se reconnectent au serveur et se reconnectent. Sur le tableau de bord du blueprint, les anomalies de vivacité pour spine et leaf seront également résolues.

Étape 4 : Mettre à niveau les agents Onbox

PRUDENCE:

Lorsque vous lancez une mise à niveau de l’agent, vous ne pouvez pas revenir à la version précédente. La seule façon de revenir à la version précédente consiste à réinstaller une nouvelle machine virtuelle avec la version précédente et à restaurer la base de données à partir de la sauvegarde que vous avez effectuée précédemment.

Connectez-vous à l’interface graphique d’Apstra en tant qu’administrateur utilisateur.
Dans le menu de navigation de gauche, accédez à Périphériques > Agents système > Agents et sélectionnez le(s) appareil(s) à mettre à niveau (jusqu’à 100 appareils à la fois à partir de la version 4.0.1 d’Apstra). Vous pouvez mettre à niveau plusieurs agents onbox en même temps, mais l’ordre de mise à niveau de l’appareil est important.
- Mettez d’abord à niveau les agents pour les superspines.
- Mettez à niveau les agents pour les épines en second.
- Agents de mise à niveau pour les branches en troisième position.
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 précédente du logiciel Apstra, ils sont automatiquement mis à niveau vers la nouvelle version. Ils se connectent ensuite au serveur et transmettent les modifications de configuration en attente aux appareils. La télémétrie reprend également, et les états de tâche passent à SUCCESS.
Dans la section Vivacité du tableau de bord du blueprint, vérifiez que vous n’avez aucune anomalie d’appareil.

Note:
Si vous devez revenir à la version précédente d’Apstra après avoir lancé la mise à niveau de l’agent, vous devez créer une nouvelle machine virtuelle avec la version précédente d’Apstra et restaurer la configuration sur cette machine virtuelle. Pour obtenir de l’aide, contactez l’assistance technique de Juniper.

Étape 5 : Mise à niveau des nœuds de travail (cluster Apstra uniquement)

Si vous utilisez un cluster Apstra (pour les agents offbox et/ou les sondes IBA), vous devez mettre à niveau les nœuds de travail ainsi que le nœud de contrôleur que vous avez déjà mis à niveau.

Si vous n’avez pas téléchargé le package d’installation d’Apstra sur les nœuds de travail lorsque vous l’avez téléchargé sur le serveur Apstra, faites-le maintenant.

À partir de chaque nœud de travail Apstra, exécutez la sudo bash aos_<aos_version>.run commande where <aos_version> est la version du fichier d’exécution. Par exemple, si la version est 4.1.1-287 la commande serait sudo bash aos_4.1.1-287.run (pas d’options). Il s’agit du même fichier que celui que vous avez utilisé pour mettre à niveau le contrôleur. Il n’y a pas d’invites lors de la mise à niveau du nœud de travail.

Prochaines étapes :

Si les versions NOS de vos équipements ne sont pas compatibles avec la nouvelle version d’Apstra, mettez-les à niveau vers une version qualifiée. (Consultez le Guide de l’utilisateur Juniper Apstra pour plus de détails.)