Migration der Homelaufwerke

Das Paket iserv-supportutils>=2026.01.07-1 stellt das Tool logodidact-migrate-user-files bereit. Die Option --ld-fqnd steht erst ab iserv-supportutils>=2026.02.11-1

logodidact-migrate-user-files --help

logodidact-migrate-user-files [-h] [-l {DEBUG,INFO,WARNING,ERROR}] [--mapping-file MAPPING_FILE] [--mount-point MOUNT_POINT] [--no-dry-run]

Migrates user homes from LogoDidact backup drive to iserv3-file

options:
  -h, --help            show this help message and exit
  -l {DEBUG,INFO,WARNING,ERROR}, --log-level {DEBUG,INFO,WARNING,ERROR}
                        specify log level (default: info)
  --ld-fqdn FQDN        set fqdn of ld server (must only be set if usb backup device is used)
  --mapping-file MAPPING_FILE
                        use csv file with format ld_account;iserv_account to map ld accounts to iserv account
  --mount-point MOUNT_POINT
                        specify a different mount point than /mnt
  --no-dry-run          disable dry-run mode

Das Skript erwartet im Default-Fall eine LD-Backup-Platte unter /mnt und versucht für jedes Benutzer-Home unter /snapshot/latest/var/lib/lxc/logosrv/rootfs/home/users/<ld-account>einen rsync der Inhalte nach /home/<iserv-account>/Files durchzuführen. Das Skript geht im Standardfall davon aus, dass es <ld-account> und <iserv-account> identisch sind. Sollte es sich um eine USB-Backup-Platte handeln, wird zusätzlich der FQDN der LogoDidact-Instanz erwartet, weil dieser dann Teil des Backup-Pfads wird. Der FQDN muss mit dem Argument --ld-fqdn übergeben werden. Zunächst wird der Vorgang simuliert, bis das Skript mit --no-dry-run aufgerufen wird.

Abweichende Mountpoint der LD-Backup-Platte können mit --mount-point <Mount-Point> (bspw. --mount-point /mnt/ld-backup) angegeben werden. Gibt es abweichende Accountnamen-Strategie zwischen LD- und IServ-Accountnamen, kann dem Skript eine Zuordnungsdatei (CSV, utf-8) per --mapping-file <Pfad> (bspw. --mapping-file /root/account-mapping.csv) übergeben werden. Die Datei muss zeilenweise Zuordnungen im Format ld-account; iserv-account enthalten. Kommentare mit führender Raute sind erlaubt.

# ld.account;iserv.account 
benblu;benjamin.bluemchen
c.columna;carla.columna

Das Skript schreibt für jeden Aufruf ein Logfile logodidact-migrate-user-files-YYYY-MM-DD-hhmmss.log in der Linux-Home des aufrufenden Benutzers (zum Anzeigen des konkreten Verzeichnisnamens echo $HOME).

Info

Im Loglevel DEBUG gibt das Skript auch die verwendeten rsync-Befehle nach STDOUT aus, damit im Fehlerfall der Befehl manuell ausgeführt werden und ein konkretes Debugging erfolgen kann.