En checklista för säker migrering av Home Assistant till en ny hemmaserver

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

En säker Home Assistant-migrering är inte klar när den nya servern når inloggningsskärmen. Den nya värden måste återställa samma konfiguration, radioenheter, integreringar, lagringssökvägar, nätverksidentitet och beteende för lokal styrning innan den gamla servern tas ur drift.

Se flytten som ett återställningstest med en tillgänglig återställningskopia. Skapa en ny säkerhetskopia, anteckna den gamla serverns beroenden, återställ på målet, återanslut radioenheter och nätverkslagring och testa kritiska automatiseringar. Behåll sedan källan avstängd men intakt tills den nya installationen klarar normal användning och en omstart.

Skapa en ny fullständig säkerhetskopia och förvara återställningsnyckeln utanför den gamla värden

Home Assistants aktuella arbetsflöde för säkerhetskopiering stöder migrering under konfigureringen, även mellan olika enhetstyper. Innan du börjar bör du kontrollera att målet har tillräckligt med lagringsutrymme, ladda ned säkerhetskopian eller på annat sätt spara den och förvara nödutrustningen som behövs för att dekryptera den på avstånd från maskinen som ska ersättas.

Den aktuella migreringsproceduren för Home Assistant använder en säkerhetskopia från den gamla enheten vid konfigureringen av den nya enheten och påpekar uttryckligen att nätverkslagring och radiomigrering fortfarande kan kräva uppföljande arbete.

Skriv inte över den enda säkerhetskopian under flytten. Behåll minst en kopia som är fristående från båda servrarna, så att en felaktig måldisk eller oavsiktlig återställning inte kan slå ut både återställningskällan och källinstallationen.

Dokumentera beroenden som inte flyttas fysiskt av en säkerhetskopia

En säkerhetskopia kan bevara Home Assistant-tillståndet, men den kan inte fysiskt flytta en USB-sticka för Zigbee eller Z-Wave, en nätverkskabel, en UPS-anslutning, en extern databasserver, en MQTT-mäklare, en omvänd proxy, en NAS-resurs eller en routerreservation. Skriv ned dessa beroenden innan du stänger av den gamla värden.

Anteckna den gamla Home Assistant-IP-adressen eller värdnamnet, den externa URL:en, nätverkslagringens monteringspunkter, databasens URL om Recorder körs externt, mäklaradressen, USB-enheter, radiotyper och eventuella Compose-inställningar eller VM-inställningar på värdnivå. Den här inventeringen gör det möjligt att skilja en misslyckad återställning från ett externt beroende som saknas.

Den mer omfattande migreringschecklistan för ZimaSpace följer samma regel: skydda källan, fastställ vad som faktiskt omfattas, verifiera målet och behåll den gamla kopian tills normal användning har bekräftats.

Flytta Zigbee- och Z-Wave-nätverk som ett separat migreringssteg

Om samma USB-radio flyttas till den nya värden ansluter du den igen och verifierar enhetssökvägen. Om den nya servern använder en annan inbyggd radio eller en ersättningsradio ska du migrera radionätverket i stället för att utgå från att Home Assistant-säkerhetskopian ensam ändrar koordinatorns identitet.

ZHA gör automatiska säkerhetskopior av nätverket och stöder migrering av ett Zigbee-nätverk till en annan kompatibel koordinator utan att hela meshnätverket behöver parkopplas igen. Migreringsprocessen kan även överföra radioenhetens IEEE-identitet när det behövs.

Z-Wave har ett separat styrenhetstillstånd. En aktuell diskussion om migrering av Z-Wave JS UI bekräftar att tjänstens datalager och en NVM-säkerhetskopia är de viktigaste tillgångarna för återställning när Z-Wave-tjänsten flyttas till ny maskinvara. Behandla båda radionäten som tillgångar med egna återställningsrutiner.

Single board computer zimaboard2

Återställ först, återanslut sedan extern lagring och nätverkstjänster

Starta den nya Home Assistant-instansen från säkerhetskopian innan du ändrar routern, DNS, NAS-behörigheter eller flera tjänsteadresser samtidigt. En migrering är lättare att felsöka när den nya värden bara skiljer sig från den gamla i en större variabel åt gången.

Om den gamla installationen använde nätverkslagring ska du ansluta den igen efter återställningen och verifiera de förväntade resursnamnen och inloggningsuppgifterna. Om den använde en extern databas eller MQTT-mäklare ska du testa DNS- och TCP-anslutningen från den nya värden innan du ändrar Home Assistant-konfiguration som redan fungerade.

Applikationens tillstånd kan flyttas, men värdspecifika beroenden måste fortfarande återskapas korrekt. Håll migreringsdokumentationen inriktad på sådant som en Home Assistant-säkerhetskopia inte kan flytta fysiskt: radioenheter, värdnätverk, extern lagring, databastjänster, mäklarändpunkter och eventuella distributionsinställningar som hanteras av den gamla servern.

Kör ett godkännandetest innan du avvecklar den gamla servern

  • Bekräfta att förväntade användare, instrumentpaneler, integrationer, hjälpare, automationer och områden finns.
  • Utlös en viktig lokal automation och bekräfta återkopplingen från den fysiska enheten.
  • Kontrollera att Zigbee-, Z-Wave-, Bluetooth- eller andra radioenheter är tillgängliga.
  • Bekräfta att historik och statistik i Recorder skrivs som de ska.
  • Testa en sökväg till nätverkslagring och ett externt beroende, till exempel MQTT om det används.
  • Testa lokal och fjärråtkomst separat.
  • Starta om den nya Home Assistant-värden en gång och upprepa det kritiska testet av lokal styrning.

Först när det här testet efter omstarten har godkänts bör du överväga att radera eller återanvända den gamla servern. Tills dess ska du hålla källinstallationen avstängd, frånkopplad från motstridiga radioenheter eller IP-adresser och tillgänglig som referens för återställning.

Support och tips

Mer att läsa

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.