Remplacer une ServiceNav Box Ubuntu 16.04 par une ServiceNav Box 4.17 Ubuntu 20.04

Contexte

Utiliser cette procédure pour migrer une ServiceNav Box Ubuntu 16.04 vers une ServiceNav Box déployée à l’aide du master 4.17.1 – Ubuntu 20.04 LTS.

Le principe est le suivant :

• créer une nouvelle ServiceNav Box
• depuis la nouvelle ServiceNav Box, lancer un script de migration qui copie les données de l’ancienne ServiceNav Box, y compris sa configuration réseau, éteint cette dernière et redémarre la nouvelle ServiceNav Box

 

Création de la nouvelle ServiceNav Box

Récupérer le master de la ServiceNav Box au bon format, sur le site ftp://software.servicenav.io (contacter l’assistance afin d’ obtenir les identifiants)

Importer le master dans l’environnement de virtualisation.

Configurer le réseau pour cette ServiceNav Box.

Étapes détaillées ici.

Préparer l’ancienne ServiceNav Box

La copie des données se fait depuis la nouvelle ServiceNav Box sous SSH, sur le port habituel. Ce port doit donc être ouvert sur l’ancienne ServiceNav Box, ce qui doit être le cas si les deux ServiceNav Box sont sur le même réseau LAN.

Pour tester que le port de connexion SSH habituel est bien ouvert sur l’ancienne ServiceNav Box, exécuter la commande suivante sur la nouvelle ServiceNav Box :

telnet <IP ancienne SNB> <port SSH>

Dans le cas inverse, modifier le fichier /etc/init.d/iptables.sh sur l’ancienne ServiceNav Box et recharger ce fichier.

 

Se connecter sur l’ancienne ServiceNav Box et exécuter la commande suivante :

service nagios stop

Exécuter la migration

Se connecter avec un client SSH sur la nouvelle ServiceNav Box.

Lancer la commande suivante en étant connecté avec l’utilisateur root:

/usr/local/nagios/bin/importConfigurationFromBox.sh --host <IP locale ancienne SNB> -u coadmin -p <password> --halt-remote --reboot

Aide en ligne de la commande

/usr/local/nagios/bin/importConfigurationFromBox.sh –host [host] -u [user] -p [password] [options]

–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).

Opérations post-migration

Se reconnecter sur la nouvelle SNB et redémarrer remoteOperationBox : 

service remoteOperationBox restart

Redémarrer Nagios :

service nagios restart

Recharger la configuration de la supervision pour la SNB depuis le website ServiceNav.

Tester la bonne configuration NTP :

ntpq -np

Repasser sur la configuration de la messagerie :

dpkg-reconfigure exim4-config

Tester l’envoi d’un email :

echo "mail from snb" | mail -s "mail from snb" prenom.nom@mail.com

Si l’ancienne ServiceNav Box était utilisée comme collecteur des remontées des agents ServiceNav, il convient d’ouvrir le port en regard, fermé par défaut :

1. Editer le fichier /etc/init.d/iptables.sh
2. Décommenter la ligne : iptables -A INPUT -p tcp –dport $PORT_NSCA -j ACCEPT
3. Exécuter : /etc/init.d/iptables.sh

Relancer le service snmp :

service snmpd restart

Vérifier la bonne remontée des données de supervision sur le website ServiceNav.

Important – version 4.17.0 : une fois la nouvelle ServiceNav Box liée à ServiceNav, se rendre dans Configuration > Boitier, sélectionner la ServiceNav Box et cliquer sur « Lancer la migration », afin de permettre son passage en version 4.17.1

Modification du mot de passe de l’utilisateur coadmin

Sous l’utilisateur coadmin, faire la commande

passwd

suivre les indications pour indiquer le mot de passe du compte coadmin que le script ne peut pas modifier pour des raisons de sécurité.

Erreurs connues

Si lors de l’exécution du script, le log suivant s’affiche :

[ERROR] Migrating network configuration : multiple network interface found : <nom des interfaces>

Cela signifie que la box dispose de plusieurs interfaces réseaux et que le script n’a pas pu sélectionner automatiquement la bonne interface réseau à configurer.

Pour résoudre le problème manuellement :

1. Ouvrir le fichier /etc/netplan/90-snb.yaml en édition avec des droits root
2. Remplacer INTERFACE_NAME par le nom d’interface à configurer et enregistrer les modifications
3. Lancer la commande netplan apply avec des droits root pour appliquer les changements de configurations