Een veilige migratiechecklist voor Home Assistant naar een nieuwe homeserver

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Een veilige migratie van Home Assistant is niet voltooid zodra de nieuwe server het inlogscherm toont. De nieuwe host moet dezelfde configuratie, radioapparatuur, integraties, opslagpaden, netwerkidentiteit en lokale bediening herstellen voordat de oude server buiten gebruik wordt gesteld.

Beschouw de verhuizing als een hersteltest waarbij er nog een terugvalkopie beschikbaar is. Maak een nieuwe back-up, noteer de afhankelijkheden van de oude server, zet de back-up terug op de doellocatie, sluit radioapparatuur en netwerkopslag opnieuw aan en test kritieke automatiseringen. Houd de bron vervolgens uitgeschakeld maar intact totdat de nieuwe installatie normaal gebruik en een herstart heeft doorstaan.

Maak een nieuwe volledige back-up en bewaar de herstelsleutel buiten de oude host

De huidige back-upworkflow van Home Assistant ondersteunt migratie tijdens de installatie, ook tussen verschillende apparaattypen. Controleer voordat je begint of de doellocatie voldoende opslagruimte heeft, download de back-up of zorg dat je er op een andere manier een kopie van bewaart, en bewaar de noodkit die je nodig hebt om deze te ontsleutelen op een andere plek dan de machine die wordt vervangen.

De huidige migratieprocedure van Home Assistant gebruikt tijdens de installatie op het nieuwe apparaat een back-up van het oude apparaat en vermeldt uitdrukkelijk dat netwerkopslag en de migratie van radioapparatuur mogelijk nog extra werkzaamheden vereisen.

Overschrijf de enige back-up niet tijdens de verhuizing. Bewaar minstens één kopie die onafhankelijk is van beide servers, zodat een defecte doeldisk of onbedoelde reset niet zowel de herstelbron als de broninstallatie kan verwijderen.

Noteer de afhankelijkheden die een back-up niet fysiek verplaatst

Een back-up kan de status van Home Assistant bewaren, maar kan geen USB-stick voor Zigbee of Z-Wave, netwerkkabel, UPS-aansluiting, externe databaseserver, MQTT-broker, reverseproxy, NAS-share of routerreservering fysiek verplaatsen. Noteer deze afhankelijkheden voordat je de oude host uitschakelt.

Noteer het oude IP-adres of de hostnaam van Home Assistant, de externe URL, koppelingen met netwerkopslag, de database-URL als Recorder extern draait, het brokeradres, USB-apparaten, radiotypen en eventuele Compose- of VM-instellingen op hostniveau. Met deze inventarisatie kun je onderscheid maken tussen een mislukte terugzetting en een ontbrekende externe afhankelijkheid.

De bredere migratiechecklist van ZimaSpace hanteert dezelfde regel: bescherm de bron, bepaal wat er precies binnen de scope valt, controleer de bestemming en bewaar de oude kopie totdat normaal gebruik is aangetoond.

Zigbee- en Z-Wave-netwerken verplaatsen als een afzonderlijke migratiestap

Als dezelfde USB-radio naar de nieuwe host verhuist, sluit deze dan opnieuw aan en controleer het apparaatpad. Als de nieuwe server een andere ingebouwde of vervangende radio gebruikt, migreer dan het radionetwerk in plaats van ervan uit te gaan dat alleen de Home Assistant-back-up de identiteit van de coordinator verandert.

ZHA maakt automatisch netwerkback-ups en ondersteunt het migreren van een Zigbee-netwerk naar een andere ondersteunde coordinator zonder het hele mesh-netwerk opnieuw te koppelen. Tijdens het migratieproces kan indien nodig ook de IEEE-identiteit van de radio worden overgezet.

Z-Wave heeft een aparte controllerstatus. Een recente migratiediscussie over Z-Wave JS UI bevestigt dat de serviceopslag en een NVM-back-up de belangrijkste herstelmiddelen zijn bij het overzetten van de Z-Wave-service naar nieuwe hardware. Behandel beide radionetwerken als assets met eigen herstelprocedures.

Single board computer zimaboard2

Zet eerst de back-up terug en sluit daarna externe opslag en netwerkservices opnieuw aan

Start de nieuwe Home Assistant-instantie op vanuit de back-up voordat je de router, DNS, NAS-machtigingen of meerdere serviceadressen tegelijk wijzigt. Een migratie is makkelijker te diagnosticeren wanneer de nieuwe host op elk moment in slechts één belangrijke variabele verschilt van de oude host.

Als de oude installatie netwerkopslag gebruikte, sluit die dan na het terugzetten opnieuw aan en controleer de verwachte sharenaam en inloggegevens. Als er een externe database of MQTT-broker werd gebruikt, test dan de DNS- en TCP-verbinding vanaf de nieuwe host voordat je de Home Assistant-configuratie wijzigt die al naar behoren werkte.

De toepassingsstatus kan worden overgezet, maar hostspecifieke afhankelijkheden moeten nog steeds correct opnieuw worden aangemaakt. Richt het migratieverslag op de zaken die een Home Assistant-back-up niet fysiek kan overzetten: radio's, hostnetwerken, externe opslag, databaseservices, broker-eindpunten en eventuele implementatie-instellingen die door de oude server worden beheerd.

Voer een acceptatietest uit voordat je de oude server buiten gebruik stelt

  • Controleer of de verwachte gebruikers, dashboards, integraties, helpers, automatiseringen en ruimtes aanwezig zijn.
  • Activeer één belangrijke lokale automatisering en controleer de terugkoppeling van het fysieke apparaat.
  • Controleer of Zigbee-, Z-Wave-, Bluetooth- of andere radioapparaten beschikbaar zijn.
  • Controleer of Recorder de geschiedenis en statistieken normaal opslaat.
  • Test één netwerkopslagpad en één externe afhankelijkheid, zoals MQTT, indien gebruikt.
  • Test lokale en externe toegang afzonderlijk.
  • Start de nieuwe Home Assistant-host één keer opnieuw op en herhaal de kritieke test voor lokale bediening.

Pas nadat deze test bij de tweede start is geslaagd, kun je overwegen de oude server te wissen of voor een ander doel te gebruiken. Laat de broninstallatie tot die tijd uitgeschakeld, losgekoppeld van conflicterende radio's of IP-adressen en beschikbaar als referentie voor terugzetten.

Ondersteuning en tips

Meer om te lezen

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.