Procédure de changement d'IP

AVERTISSEMENT

Cockpit ne doit pas être utilisé pour reconfigurer cette interface.

La procédure "Changement IP" doit être utilisée pour mettre à jour la configuration réseau. Si l'IP n'a pas été mise à jour avec cette procédure, rétablissez la configuration du réseau pour restaurer les services TPE, et suivez cette procédure.

Avant de commencer la procédure de changement d'IP, assurez-vous d'avoir une archive de sauvegarde TPE valide pour pouvoir restaurer vos données.

Mode autonome

1. Connectez-vous au nœud TPE. Exécutez une commande ssh pour vous connecter au serveur :

   ssh support@${IP_OR_HOSTNAME_OF_TPE} -p 2222

2. Sauvegardez la configuration du Docker Swarm et quittez le cluster en exécutant cette commande (cela arrête tous les services TPE) :

   /usr/bin/tpe-update-node-ip-step1 -n tpe-node1

   Ce script génère un fichier (infra.yml sous le répertoire /home/support). Ne supprimez pas ce fichier.

3. Mettez à jour IP et redémarrez le réseau :

   AVERTISSEMENT

   Cockpit ne doit pas être utilisé pour reconfigurer cette interface.

   Modifiez le fichier de configuration (ethX : interface utilisée) et mettez à jour la variable IPADDR :

   sudoedit /etc/sysconfig/network-scripts/ifcfg-ethX

   et redémarrez le réseau :

   systemctl restart network

4. Restaurez la sauvegarde avec la nouvelle adresse IP

   Si l'IP mise à jour est utilisée pour SSH, reconnectez-vous au nœud TPE en utilisant la nouvelle IP :

   ssh support@${IP_OR_HOSTNAME_OF_TPE} -p 2222

   Restaurez la sauvegarde en exécutant le script suivant :

   /usr/bin/tpe-update-node-ip-step2 -n tpe-node1 -c '{"hosts": [ {"ip": "<IP address node1>", "hostname":"tpe-node1", "sup_pass": "<support_password>" }]}'

   Où :

   • <IP address node> doit être remplacé par l'adresse IP.
   • <support_password> doit être remplacé par le mot de passe de l'utilisateur support.

5. Redéployer le cluster

   Éditez le infra.yml et mettez à jour l'IP :

   $ vi infra.yml
   
   [...]
         tpe_nodes:
           hosts:
             tpe_node1:
               ansible_host: <IP address node>
               hostname: tpe-node1
   [...]

   Mettez à jour la configuration Docker infra.yml en utilisant ce fichier :

   docker config rm infra.yml
   docker config create infra.yml infra.yml

   Maintenant, redéployez le cluster :

   /usr/bin/tpe-update-node-ip-step3

6. Reconfigurez le nom d'hôte du Network server dans le module TPE Configuration Cockpit :

   • Connectez-vous à Cockpit en utilisant la nouvelle adresse IP
   • Allez dans le module de Configuration TPE
   • Si le champ "Nom d'hôte du Network server" contient l'ancienne adresse IP, mettez-le à jour avec la nouvelle.
   • Cliquez sur "Appliquer & Enregistrer" pour appliquer la nouvelle configuration

7. Reconfiguration de la passerelle :

   Si vous avez déjà provisionné et connecté la passerelle avant le changement d'adresse IP, vous devrez :

   • Reconfigurez la passerelle avec la nouvelle adresse IP de l'hôte TPE

   • Si IPsec (X.509) est utilisé pour la connexion Passerelle à TPE, vous devrez régénérer tous les certificats de Passerelle en exécutant le script suivant :

     /usr/bin/tpe-regenerate-bs-certificates

Mode Haute Disponibilité

1. Connectez-vous à un des nœuds TPE actifs qui ne sera pas mis à jour. Exécutez une commande ssh pour vous connecter au serveur :

   ssh support@${IP_OR_HOSTNAME_OF_TPE} -p 2222

2. Retirez du Docker Swarm le nœud où vous prévoyez de changer l'IP en exécutant cette commande :

   /usr/bin/tpe-update-node-ip-step1 -n <node_name>

   Où <node_name> doit être remplacé par "tpe-node1", "tpe-node2" ou "tpe-node3" selon le nœud où vous prévoyez de changer l'IP. Ce script génère un fichier (infra.yml dans le répertoire /home/support). Ne supprimez pas ce fichier.

3. Mettez à jour IP et redémarrez le réseau :

   Connectez-vous au nœud où vous prévoyez de changer l'IP. Exécutez une commande SSH pour vous connecter au serveur :

   ssh support@${IP_OR_HOSTNAME_OF_TPE} -p 2222

   Modifiez le fichier de configuration (ethX : interface utilisée) et mettez à jour la variable IPADDR :

   sudoedit /etc/sysconfig/network-scripts/ifcfg-ethX

   et redémarrez le réseau :

   systemctl restart network

4. Redéployez le cluster :

   Retournez au nœud utilisé à l'étape 1.

   Éditez le infra.yml et mettez à jour l'IP où <node_name> correspond au nœud où vous avez changé l'adresse IP ("node1", "node2" ou "node3") :

   $ vi infra.yml
   
   [...]
         tpe_nodes:
           hosts:
             [...]
             tpe_<node_name>:
               ansible_host: <IP address node>
               hostname: tpe-<node_name>
   [...]

   Mettez à jour la configuration Docker infra.yml en utilisant ce fichier.

   docker config rm infra.yml
   docker config create infra.yml infra.yml

   Maintenant, redéployez le cluster :

   /usr/bin/tpe-update-node-ip-step2 -n <node_name>

   Où <node_name> doit être remplacé par "tpe-node1", "tpe-node2" ou "tpe-node3" suivant le nœud où vous avez changé l'IP.

5. Reconfigurez le nom d'hôte principal du Network server dans le module TPE Configuration Cockpit :

   AVERTISSEMENT

   Cette étape doit être réalisée uniquement si vous avez changé l'adresse IP de node1.

   • Connectez-vous à Cockpit
   • Allez dans le module de Configuration TPE
   • Si le champ "Nom d'hôte du Network server" contient l'ancienne adresse IP du node1, mettez-le à jour avec la nouvelle.
   • Cliquez sur "Appliquer & Enregistrer" pour appliquer la nouvelle configuration.

6. Reconfigurez le nom d'hôte secondaire du Network server dans le module TPE Configuration Cockpit :

   AVERTISSEMENT

   Cette étape doit être réalisée uniquement si vous avez changé l'adresse IP de node2.

   • Connectez-vous à Cockpit
   • Allez dans le module de Configuration TPE
   • Si le champ "Nom d'hôte secondaire du Network server" contient l'ancienne adresse IP du node2, mettez-le à jour avec la nouvelle.
   • Cliquez sur "Appliquer & Enregistrer" pour appliquer la nouvelle configuration.

7. Reconfiguration de la passerelle :

   AVERTISSEMENT

   Cette étape doit être réalisée uniquement si vous avez changé l'adresse IP de node1 ou node2.

   • Si vous avez déjà approvisionné et connecté la passerelle avant que l'adresse IP ne change, vous devrez reconfigurer la passerelle avec la nouvelle adresse IP de l'hôte TPE

   • Si IPsec (X.509) est utilisé pour la connexion de la passerelle à TPE, vous devrez régénérer tous les certificats de la passerelle en exécutant le script suivant :

   /usr/bin/tpe-regenerate-bs-certificates

Le cluster est mis à jour.