Une liste de contrôle pour migrer Home Assistant en toute sécurité vers un nouveau serveur domestique

Eva Wong est la rédactrice technique et bricoleuse résidente chez ZimaSpace. Geek depuis toujours, passionnée par les laboratoires informatiques personnels et les logiciels open source, elle se spécialise dans la vulgarisation de concepts techniques complexes au moyen de guides pratiques et concrets. Eva pense que l’hébergement personnel doit être amusant, et non intimidant. À travers ses tutoriels, elle aide la communauté à démystifier les configurations matérielles, de la construction de leur premier NAS à la maîtrise des conteneurs Docker.

Une migration de Home Assistant sûre n’est pas terminée lorsque le nouvel serveur affiche l’écran de connexion. Le nouvel hôte doit retrouver la même configuration, les mêmes radios, intégrations, chemins de stockage, identité réseau et fonctionnalités de contrôle local avant que l’ancien serveur soit mis hors service.

Considérez le transfert comme un test de récupération avec une copie de retour arrière toujours disponible. Créez une nouvelle sauvegarde, consignez les dépendances de l’ancien serveur, restaurez-la sur la cible, reconnectez les radios et le stockage réseau, testez les automatisations critiques, puis laissez la source éteinte mais intacte jusqu’à ce que la nouvelle installation fonctionne normalement et passe un redémarrage.

Effectuez une nouvelle sauvegarde complète et conservez la clé de récupération hors de l’ancien hôte

Le processus de sauvegarde actuel de Home Assistant prend en charge la migration pendant la configuration initiale, y compris entre différents types d’appareils. Avant de commencer, vérifiez que la cible dispose d’un espace de stockage suffisant, téléchargez la sauvegarde ou conservez-la d’une autre manière, et gardez le kit d’urgence nécessaire pour la déchiffrer à l’écart de la machine remplacée.

La procédure de migration actuelle de Home Assistant utilise une sauvegarde de l’ancien appareil lors de la configuration initiale du nouvel appareil et indique explicitement que le stockage réseau et la migration des radios peuvent encore nécessiter des interventions supplémentaires.

Ne remplacez pas votre seule sauvegarde pendant le transfert. Conservez au moins une copie indépendante des deux serveurs, afin qu’un disque cible défaillant ou une réinitialisation accidentelle ne supprime pas à la fois la source de récupération et l’installation source.

Notez les dépendances qu’une sauvegarde ne peut pas déplacer physiquement

Une sauvegarde peut préserver l’état de Home Assistant, mais elle ne peut pas déplacer physiquement une clé USB Zigbee ou Z-Wave, un câble réseau, une connexion à un onduleur, un hôte de base de données externe, un broker MQTT, un proxy inverse, un partage NAS ou une réservation sur le routeur. Notez ces dépendances avant d’éteindre l’ancien hôte.

Notez l’ancienne adresse IP ou le nom d’hôte de Home Assistant, l’URL externe, les montages de stockage réseau, l’URL de la base de données si Recorder est externe, l’adresse du broker, les périphériques USB, les types de radios et les paramètres Compose ou de VM au niveau de l’hôte. Cet inventaire vous permettra de distinguer un échec de restauration d’une dépendance externe manquante.

La liste de contrôle de migration plus générale de ZimaSpace applique la même règle : protéger la source, définir précisément le périmètre, vérifier la destination et conserver l’ancienne copie jusqu’à ce que le fonctionnement normal soit confirmé.

Déplacer les réseaux Zigbee et Z-Wave en tant qu’étape de migration distincte

Si la même radio USB est déplacée vers le nouvel hôte, reconnectez-la et vérifiez son chemin d’accès. Si le nouveau serveur utilise une radio intégrée différente ou une radio de remplacement, migrez le réseau radio au lieu de supposer que la sauvegarde Home Assistant modifie à elle seule l’identité du coordinateur.

ZHA effectue automatiquement des sauvegardes réseau et permet de migrer un réseau Zigbee vers un autre coordinateur compatible sans réappairer tout le maillage. Le processus de migration peut également transférer l’identité IEEE de la radio si nécessaire.

Z-Wave dispose d’un état de contrôleur distinct. Une récente discussion sur la migration de Z-Wave JS UI confirme que le magasin de données du service et une sauvegarde NVM sont les éléments essentiels pour récupérer le service Z-Wave lors de son transfert vers un nouveau matériel. Considérez les deux réseaux radio comme des ressources ayant leurs propres procédures de récupération.

Restaurez d’abord, puis reconnectez le stockage externe et les services réseau

Démarrez l’instance Home Assistant cible à partir de la sauvegarde avant de modifier le routeur, le DNS, les autorisations du NAS ou plusieurs adresses de services à la fois. Il est plus facile de diagnostiquer une migration lorsque le nouvel hôte ne diffère de l’ancien que par une seule variable majeure à la fois.

Si l’ancienne installation utilisait un stockage réseau, reconnectez-le après la restauration et vérifiez les noms de partage et identifiants attendus. Si elle utilisait une base de données externe ou un broker MQTT, testez la connectivité DNS et TCP depuis le nouvel hôte avant de modifier la configuration Home Assistant qui fonctionnait déjà.

L’état de l’application peut être transféré, mais les dépendances propres à l’hôte doivent encore être recréées correctement. Pour le suivi de la migration, concentrez-vous sur les éléments qu’une sauvegarde Home Assistant ne peut pas relocaliser physiquement : les radios, le réseau de l’hôte, le stockage externe, les services de base de données, les points de terminaison du broker et les paramètres de déploiement gérés par l’ancien serveur.

Effectuez un test d’acceptation avant de mettre l’ancien serveur hors service

  • Vérifiez que les utilisateurs, tableaux de bord, intégrations, assistants, automatisations et zones attendus sont présents.
  • Déclenchez une automatisation locale importante et vérifiez le retour physique de l’appareil.
  • Vérifiez que les appareils Zigbee, Z-Wave, Bluetooth ou utilisant d’autres radios sont disponibles.
  • Vérifiez que l’historique et les statistiques de Recorder s’enregistrent normalement.
  • Testez un chemin de stockage réseau et une dépendance externe, comme MQTT si vous l’utilisez.
  • Testez séparément l’accès local et l’accès à distance.
  • Redémarrez une fois le nouvel hôte Home Assistant et répétez le test critique de contrôle local.

Ce n’est qu’après la réussite de ce deuxième test de démarrage que vous devriez envisager d’effacer l’ancien serveur ou de le réaffecter à un autre usage. D’ici là, laissez l’installation source hors tension, déconnectée des radios ou adresses IP susceptibles de créer des conflits et disponible comme référence pour revenir en arrière.

Assistance et conseils

À lire aussi

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.