EV Observe - Migrer une Box

Modifié le 11/08/2022 19:16

Attention : Effectuez toujours un snapshot de votre Box virtuelle avant une migration. Les impacts que la migration peut avoir au sein de votre plateforme ne sont pas pris en charge par le Support EasyVista.

La migration d'une Box peut être réalisée pour :

  • mettre à jour le système d'exploitation (OS) en installant la dernière version de Ubuntu supportée par EV Observe ;
  • remplacer un boîtier défectueux (boîtier instable, présentant des comportements imprévisibles), mais encore accessible, en le migrant vers une nouvelle Box.
     

La migration peut se faire :

  • Version minimum de la Box : 4.17 Depuis l'application web. Dans ce cas, aucune machine n'est nécessaire : la migration s'effectue en sélectionnant les Box éligibles à la migration puis en lançant le traitement.
      Open url.png voir Procédure
  • Vers une Box déployée à l'aide du master Ubuntu 20.04 LTS. Dans ce cas, la migration de l'OS s'effectue en instanciant une nouvelle Box, puis en copiant la configuration réseau et les données de l'ancienne Box.
      Open url.png voir Procédure
     

Comment choisir le type de migration
La montée de version vers Ubuntu 20.04 LTS provoque de 2h à 4h d'indisponibilité totale, ce qui implique aucune notification et aucune collecte (absence de données brutes) durant ce laps de temps. Si vous souhaitez éviter ce temps d'indisponibilité et un trou de données, effectuez la migration depuis une Box déployée à l'aide du master Ubuntu 20.04 LTS.

Remarques

  • Les montées de versions applicatives sont automatiques et réalisées par la plateforme EV Observe.
  • L'espace disque libre avant lancement de la migration doit être de 5 GB sur la Box à mettre à jour.

Attention

  • Dans le cas d'un changement de Box, le mot de passe de la nouvelle Box ne doit pas contenir de $, sous peine que le script de migration ne fonctionne pas.
  • Pour la génération du mot de passe d'une Box Hyper-V, n'utilisez pas de caractères de ponctuation. Ces caractères ne sont pas toujours correctement interprétés par la console Hyper-V, ce qui rendrait son accès impossible sans connexion réseau.

Bonnes pratiques

  • Une configuration ou un contexte spécifique au sein de la Box peuvent générer une erreur et bloquer la montée de version. Pour cette raison, planifiez la migration lors des heures ouvrées afin de bénéficier du Support EasyVista en cas de problème.
  • Effectuez la migration progressivement, sur des lots réduits de Box.
  • Effectuez des snapshots sur les Box virtuelles les plus critiques, afin de faciliter le retour arrière en cas de problème.
  • Déclarez une maintenance sur les Box à migrer pour la durée de la mise à jour (valeur conseillée : 4h) afin d'éviter des alertes / faux positifs coûteux en temps.
  • L'accès aux Box est sécurisé par un mot de passe.
    • À la fin de la migration, remplacez le mot de passe par défaut.
    • Utilisez un générateur de mots de passe, avec au minimum les règles de génération suivantes : 12 caractères ; majuscules / minuscules / chiffres / ponctuation / unicité des caractères.

Procédures

Comment migrer depuis l'interface EV Observe

À partir de : EV Observe platform version 4.17

Prérequis

  • La Box doit pouvoir accéder à internet, et en particulier au dépôt Ubuntu, afin de récupérer les sources d'installation.
  • Si nécessaire, agrandissez l'espace disque de la partition Linux. L'espace minimum requis est de 5 GB  - Open url.png voir Procédure détaillée
  • A minima, les protocoles ci-dessous doivent être autorisés vers l'extérieur. Note : La liste peut évoluer selon la mise à jour des dépôts appelés lors de l'installation.
    • Protocole ping ==> echo (7)
    • Protocole http ==> 80
    • Protocole https ==> 443
    • Protocole ftp ==> 21
       

Étape 1 : Sélection des Box à mettre à jour

1. Affichez la liste des Box, via le menu Configuration > Général > Boîtier.

Best Practice icon.png  Pour afficher l'ensemble des Box de vos sites ou clients, cochez la case Compte et subordonnés dans l'arbre des sociétés et des sites.
     Migration from application - Select all companies and sites boxes.png

2. Sélectionnez les boîtiers à mettre à jour.

Note : Seuls les boîtiers dont le statut est Mise à jour possible peuvent être sélectionnés.
 

Étape 2 : Lancement de la mise à jour des Box éligibles

1. Cliquez sur Lancer la mise à jour.

  • Les boîtiers sélectionnés et éligibles débutent leur mise à jour.
    • Le statut Mise à jour envoyée indique que la demande de mise à jour a été envoyée à la Box.
    • Le statut Mise à jour en cours indique que la Box est en cours de mise à jour. Ce statut peut persister de 2h à 4h, laps de temps durant lequel la Box n'est pas fonctionnelle.
  • À la fin de la migration, tous les boîtiers pour lesquels l'opération s'est effectuée sans erreur prennent le statut Version à jour et disposent de la version Ubuntu 20.04 LTS.

2. Corrigez les erreurs pour les boîtiers pour lesquels la migration n'a pas pu être effectuée, puis relancez la migration.

Note : Le redémarrage du service remoteOperationBox (planifié quotidiennement dans la nuit) réinitialise les statuts d'erreurs et rend de nouveau les Box éligibles à la migration. Il est inutile de relancer la migration de celles-ci tant que vous n'avez pas traité la cause de l'erreur.

Boîtier avec le statut Prérequis non conformes

  • Erreur de disque : Agrandissez l'espace disque de la partition Linux de la Box, avec un minimum de 5 GB  - voir Procédure détaillée
  • Erreur d'accès au dépôt Ubuntu : Vérifiez que l'accès à internet est possible afin de récupérer les sources d'installation. Si nécessaire, configurez le proxy pour établir le lien VPN avec la plateforme  - Open url.png voir Procédure détaillée
     

Boîtier avec le statut Mise à jour échouée
Attention : Traitez rapidement cette erreur car la Box peut être dans un état instable et donc non fonctionnelle.

  • Restaurez un snapshot puis corrigez les erreurs. Relancez ensuite la migration.
  • Vous pouvez contacter le Support EasyVista pour être guidé dans la restauration du snapshot et la relance de la migration.
     

Étape 3 : Reconfiguration des Box collectant des traps SNMP 

   Open url.png voir Procédure détaillée

Comment migrer vers une Box déployée à l'aide du master Ubuntu 20.04 LTS

Étape 1 : Préparation de l'ancienne Box

1. Ouvrez le port de connexion SSH sur l'ancienne Box si celle-ci est utilisée comme collecteur des remontées des agents.

  • Vérifiez l'état du port, en exécutant la commande ci-dessous.
    Remplacez {IP_old_box} par l'adresse IP de l'ancienne Box et {SSH_port} par le port de connexion SSH de l'ancienne Box.

telnet {IP_old_box} {SSH_port}

  • Si le port SSH est fermé :
    • Ouvrez le fichier /etc/init.d/iptables.sh sur l'ancienne Box.
    • Activez la ligne iptables -A INPUT -p tcp –dport $PORT_SSH -j ACCEPT.
    • Exécutez la commande /etc/init.d/iptables.sh.

2. Arrêtez les services Nagios sur l'ancienne Box, en exécutant la commande ci-dessous.

service nagios stop

Étape 2 : Création d'une nouvelle Box à partir du master Ubuntu 20.04 LTS

1. Importez le master Ubuntu 20.04 LTS dans l'environnement de virtualisation, depuis le site sFTP (sftp://software.servicenav.io).

Note : Contactez le Support EasyVista pour obtenir les identifiants.

2. Configurez le réseau de la nouvelle Box.

   Open url.png voir Procédure détaillée
 

Étape 3 : Copie de la configuration réseau et des données de l'ancienne vers la nouvelle Box

1. Connectez-vous à la nouvelle Box avec un client SSH et en tant qu'utilisateur root.

2. Redémarrez la nouvelle Box, en exécutant la commande ci-dessous.

Remplacez {IP_old_box} par l'adresse IP de l'ancienne Box et {password_old_box} par le mot de passe pour se connecter à l'ancienne Box.

/usr/local/nagios/bin/importConfigurationFromBox.sh --host {IP_old_box} -u coadmin -p {password_old_box} --halt-remote --reboot

  • –host: Remote box hostname (required)
  • –port: Remote box port
  • –timeout: Connect timeout in seconds (default: 10)
  • -u, –user: Username used to connect to remote box (default: coadmin)
  • -p, –password: Password used to connect to remote box (required)
  • -o, –output: Filepath to log file (default: importConfigurationFromBox.log)
  • –halt-remote: Halt remote box upon operation success (default: false)
  • –reboot: Reboot this host upon operation success (default: false)

3. Redémarrez les services remoteOperationBox et Nagios sur la nouvelle Box, en exécutant les commandes ci-dessous.

service remoteOperationBox restart
service nagios restart

4. Rechargez la configuration de la supervision sur la nouvelle Box, en exécutant la commande ci-dessous.

ntpq -np

5. Configurez l'envoi des e-mails de notifications avec le service de messagerie Exim4 localisé sur la nouvelle Box, puis testez l'envoi d'un e-mail, en exécutant les commandes ci-dessous.

dpkg-reconfigure exim4-config
echo "mail from snb" | mail -s "mail from snb" first_name.name@mail.com

6. Redémarrez le service snmp sur la nouvelle Box, en exécutant la commande ci-dessous.

service snmpd restart

  • La nouvelle Box est instanciée dans l'application web.
  • Les données de supervision sont remontées de l'ancienne Box sur l'application web.

Note : Si l'erreur ci-dessous s'affiche, cela indique que le script de migration ne peut pas s'exécuter car la Box dispose de plusieurs interfaces réseaux.

[ERROR] Migrating network configuration : multiple network interface found : {interface_name}

Dans ce cas, vous devez indiquer quelle est l'interface réseau à configurer.

  • Ouvrez le fichier de configuration réseau Netplan /etc/netplan/90-snb.yaml/ avec des droits root.
  • Remplacez la valeur de la propriété Interface_name par {interface_name} qui est le nom de l'interface à configurer, tel qu'indiqué dans le message d'erreur.
  • Enregistrez les modifications.
  • Appliquez le changement de configuration en lançant la commande netplan apply avec des droits root.
     

Étape 4 : Migration de la nouvelle Box dans la version 4.17 depuis l'application web

1. Allez sur le menu Configuration > Général > Boîtier

2. Sélectionnez la nouvelle Box.

3. Cliquez sur Lancer la mise à jour.
 

Étape 5 : Sécurisation de la nouvelle Box via un mot de passe

Note : Le script de migration ne peut pas modifier le mot de passe pour des raisons de sécurité.

1. Exécutez la commande ci-dessous, en vous connectant avec l'utilisateur coadmin.

passwd

2. Suivez les indications pour modifier le mot de passe du compte coadmin.

Tags :
Powered by XWiki © EasyVista 2022