HowTo - FHEM Umzug von System A nach System B

Scenario: Umzug auf neues System

• System Alt: altes Linux, alte Hardware ...
• System Neu: neues Linux, neue/andere Hardware Plattform ...

Zwei verschiedenen Hardware Systeme sind etwas einfacher zu handhaben, es geht aber auch auf der gleichen Hardware (z.B. Raspberry Pi mit SD Card Wechsel oder USB-Bootstick). Ich habe alle Schritte mit einem Raspberry Pi(Raspberry OS Lite) und einer Virtuellen Maschine(debian 11 netinst) getestet. Dieses HowTo ist auch eine Ergänzung zu meinem vorjährigen Artikel.

Mit dem Raspberry Pi Imager kann man eine neue SD Card effektiv vorbereiten und das System grundlegen konfigurieren (Zahnradsymbol am rechten unteren Rand nachdem man das OS ausgewählt hat) 

Es gab von mir schon ein paar ähnliche Artikel, dieser hier soll ganz gezielt Schritt für Schritt zeigen was zu tun ist. Windows 10 hat ssh und scp eingebaut, andere Tools braucht man nicht. Wer nicht mit Windows CMD arbeiten will findet die Codezeilen für Schritt 1 am Ende auch für Linux und Powershell.

Man kann alle Schritte beliebig oft wiederholen / durchspielen und dabei lernen.

Achtung (03.2024): Das FHEM Installermodul wird leider nicht mehr gepflegt, es häufen sich die Meldungen, das mein hier gezeigtes Verfahren der Ermittlung der fehlenden Debianpakete nicht mehr funktioniert. Ich habe derzeit keine Problem Behebung!

Achtung: In der Shell alle Codezeilen immer einzeln ausführen! Mehrere Zeilen auf einmal kann funktionieren - muss aber nicht!

Schritt 1 - kopieren der notwendigen Dateien

Arbeiten unter Windows in der CMD Shell - Windows Taste + cmd + enter

REM ein paar Variablen setzen
set "alt=pi@raspib3"        # username und host vom alten System
set "neu=otto@vmdebianfhem" # username und host vom neuen System
set "pfad=/opt/fhem"        # der Pfad in dem FHEM installiert ist
REM aktuellstes Backup ermitteln
for /f %i in ('ssh %alt% -t "ls -rt1 %pfad%/backup | tail -1"') do set datei=%i
REM alternativ eine Variante mit Umweg über eine Datei
REM ssh %alt% -t "ls -rt1 %pfad%/backup | tail -1" > datei.txt
REM set /p datei= < datei.txt
REM die Dateien vom alten System holen
scp %alt%:%pfad%/\{backup/%datei%,fhem.cfg\} .
REM eventuell die Hardware umbauen
REM die Dateien aufs neue System schaffen
scp %datei% fhem.cfg %neu%:
REM Ab jetzt interaktiv auf dem neuen System - anmelden
ssh %neu%

Schritt 2 - das neue System vorbereiten und die fhem.cfg testen

Ich habe drei Scripte erstellt: 

Das erste Script konfiguriert Sprache, Zeitzone, Hostname. Dies war ursprünglich für das Standard Raspberry Image gedacht. Konfiguriert man das System beim Setup (debian netinst) oder mit dem Raspberry Pi Imager, braucht man dieses Script nicht.

Arbeitet man auf einem Raspberry und hat ein UART Modul im Einsatz (HM-MOD-RPI-PCB, Busware COC oder ähnliches) kann man das System mit dem zweite Script konfigurieren. Danach muss man einen reboot machen.

Das letzte Script installiert und konfiguriert ein aktuelles FHEM, testet die oben kopierte fhem.cfg und gibt Informationen über fehlende Pakete aus. 

# Scripts vom GitHub holen 
wget -N https://raw.githubusercontent.com/heinz-otto/raspberry/master/setup{Basic.sh,Uart.sh,Prereq.sh}
# Nur ausführen wenn das neue System noch eingerichtet werden muss: Sprache, Zeitzone, Hostname  
#bash setupBasic.sh
#bash setupUart.sh # nur bei Raspberry Pi Systemen mit Aufsteckmodulen nötig 
bash setupPrereq.sh

Jetzt installiert man die fehlenden Debian Pakete: zur einfachen Handhabung erzeugt das Script eine Datei "DebianPaket" im aktuellen Verzeichnis. 

Nach der Installation startet man FHEM neu und führt zur Kontrolle nochmal das letzte Script aus.    

# entsprechend der Ausgabe Pakete installieren
sudo apt install $(<DebianPaket)
sudo systemctl restart fhem
# zur Kontrolle
bash setupPrereq.sh

Debian Pakete sollten jetzt keine mehr vermisst werden. Fehlen weiterhin Perl Module, muss man diese mit cpan installieren. Meist ist das etwas langwieriger.

Die folgende Beschreibung ist nur ein Ansatz, es kann sein, das die Module auch völlig anders installiert werden müssen. Siehe dazu auch im Wiki.

sudo apt install make curl
sudo cpan CPAN
sudo cpan install $(<PerlModul)

Schritt 3 - testen ob ein restore vom produktiven FHEM läuft 

Jetzt erfolgt der erste Test ob FHEM nach einem restore läuft.

Empfehlung: Altes FHEM System vorher beenden, um Probleme im Netzwerk zu vermeiden! (Cloudsystem mögen doppelte Anmeldung nicht usw.)

sudo systemctl stop fhem
sudo tar -xvzf $(ls -rt1 FHEM*.tar.gz | tail -1) -C /opt/fhem/
sudo systemctl start fhem

Schritt 4 - finale Umstellung

War der vorherige Test erfolgreich - wird umgestellt:

1. stop fhem und exit im neuen System, 
2. backup im Browser für das alte System starten und auf Abschluss warten, 
3. die neue backup Datei vom alten auf das neue System kopieren (Schritt 1), 
4. FHEM auf dem alten System beenden (ssh %alt% sudo systemctl stop fhem), 
5. mit dem neuen System verbinden (ssh %neu%), 
6. restore machen und FHEM starten (Schritt 3). 

Die entsprechenden Befehlszeilen stehen in den Abschnitten Schritt 1 und Schritt 3. 

Andere Shell für Schritt 1

Der Syntax unterscheidet an sich leicht - die Schritte an sich sind gleich!

Linux Shell :

# Variable setzen
alt=pi@raspib3
neu=otto@vmdebianfhem
pfad=/opt/fhem
# letztes Backup ermitteln
datei=$( ssh $alt -t "ls -rt1 $pfad/backup | tail -1|tr -d '\n'" )
# die Dateien holen
scp $alt:$pfad/\{backup/$datei,fhem.cfg\} .
# die Dateien aufs neue System schaffen
scp $datei fhem.cfg $neu:
# Ab jetzt interaktiv auf dem neuen System - anmelden
ssh $neu

In der Windows Powershell kann man die Variablen leichter setzen als in der CMD, dafür ist es immer wieder ein Abenteuer Programme (ssh scp) mit ein paar Parametern aufzurufen:

# Variable setzen
$alt='pi@raspib3'
$neu='otto@vmdebianfhem'
$pfad='/opt/fhem'
# letztes Backup ermitteln
$datei=$( ssh $alt -t "ls -rt1 $pfad/backup | tail -1|tr -d '\n'" )
# die Dateien holen - die Setzung der Klammern und Hochkommas ist eine echte Hürde
scp "${alt}:${pfad}/{backup/${datei},fhem.cfg}" .
# die Dateien aufs neue System schaffen
scp ${datei} fhem.cfg ${neu}:
# Ab jetzt interaktiv auf dem neuen System - anmelden
ssh $neu

Es gibt verschiedene Möglichkeiten Strings aus Zeichen und Variablen zusammenzusetzen. Die Zeile mit scp berücksichtigt folgendes:

• Die Parameterübergabe an scp erfordert zwei getrennte Strings: quelle und ziel.
• Die doppelten Anführungszeichen erzeugen einen String und ermöglichen die Auflösung von Variablen innerhalb.
• Die geschweifte Klammern (braces) ${variable} grenzen den Namen von den anderen Zeichenketten ab. Beim Doppelpunkt ist das existenziell, beim Schrägstrich könnte man es auch weglassen.
• Achtung: zwei geschweifte Klammern im String "pfad/{datei1,datei2}" bewirken im Linux die "Brace Expansion" und haben nichts mit Variablen zu tun. Interessanterweise muss man sie, im Gegensatz zur Linuxshell, in der Powershell nicht schützen/escapen.
• Konsequenterweise müsste das Ziel (der Punkt) auch in "." gesetzt werden, es funktioniert aber ohne.

ToDo?

Code Block

Das ist mein Platzhalter für Erweiterungen.