lionbackup-klienten
Backuppen sker via en let klient skrevet i Go, der stilles til rådighed som en open source-klient.
Hvad klienten gør
Klienten varetager hele den lokale del af en backup:
- Komprimere de valgte data,
- Kryptere — med klientsidig end-to-end-kryptering aktiveret forlader kun kryptotekst dit system,
- Overføre til en tilgængelig Citadel i den valgte Storage Zone.
Svigter et endpoint under overførslen, skifter klienten selv til en anden tilgængelig Citadel.
Platforme
Klienten understøtter Linux, Windows og macOS (beta). Færdigbyggede binærfiler er klar til download; kildekoden er offentligt tilgængelig.
Konfiguration
Til driften lægger du i den lokale konfiguration:
- det projektbundne adgangstoken,
- ved klientsidig kryptering nøglematerialet,
- de stier eller datakilder, der skal sikkerhedskopieres.
Fordi klienten er open source, kan man efterprøve, hvordan komprimering, kryptering og overførsel foregår — en transparens, der passer til lionbackups suveræne kurs.
Et fuldt forløb fra login til første backup findes under Kom godt i gang.
Flere backupjob på én maskine
Et projekt kan have flere konfigurationer, fx en daglig kørsel for dokumenter
og en ugentlig for databasen. Hver konfiguration navngiver sit job med
name::
lionbackup:
name: daily-docs
Navnet vises i outputtet og i logfilens navn (lionbackup-<name>-YYYYMMDD.log).
Flere konfigurationer kan dermed dele én log_directory, uden at deres linjer
blandes sammen i én fil. Mangler name:, udleder klienten det af
konfigurationens filnavn (daily-docs.yaml → daily-docs). Det anbefales at
holde filnavn og name: ens.
Læsefejl, særlige Windows-mapper og gennemsigtighed
Fra klient v0.1.2:
- Windows-legacy-junctions (skjulte kompatibilitetslinks som "Billeder" i profilmappen) springes altid over – de er ulæselige pr. design og indeholder ingen data.
- Læsefejl under en kilde (adgang nægtet, fil fjernet under kørslen) giver som standard en advarsel + overspring; til sidst rapporterer klienten summen af oversprungne poster. En manglende eller ulæselig kilde afbryder fortsat.
- Adfærden konfigureres med
on_read_errorilionbackup.yaml:warn(standard) ellerabortfor hårdt stop ved første fejl.
on_read_error: warn # eller: abort
Klienten fortæller sine trin ("Trin 1/3: kontrollerer kilder …", scanningsstatus hvert sekund), så man selv ved meget store mapper straks kan se, hvad der sker.
Windows: åbne filer via skyggekopi
Under Windows læser klienten filer, som et program holder eksklusivt åbne, fra
en skyggekopi (VSS) af drevet. Det er slået til som standard
(use_vss: true) og kræver administratorrettigheder. Uden dem springer
klienten låste filer over, sikkerhedskopierer resten og nævner dem i loggen.
Vælg derfor "Kør med højeste rettigheder" for sikkerhedskopier via
Opgavestyring.
Skyggekopien læser ganske vist filerne i en kørende database, men uden at
inddrage databasen. Pålidelig er en sikkerhedskopi, som databasen selv skriver,
fx via en pre_backup-kommando (se nedenfor) til en mappe, som klienten
sikkerhedskopierer.
Hyper-V-VM'er
Fra klient 0.2.0 sikkerhedskopierer klienten hele VM'er på en Windows
Server med Hyper-V-rollen. I konfigurationen står kun deres navne, som Get-VM
viser dem; hvilke filer der hører til, spørger klienten Hyper-V om ved hver
kørsel.
lionbackup:
hyperv:
vms:
- FILESRV01
- DC01 # eller "*" for alle VM'er på værten
files: # valgfri, kan udelades
- D:\Delte
- Applikationskonsistent, uden nedlukning. Skyggekopien oprettes via DiskShadow med Hyper-V-writeren. Med integrationstjenesten til backup (volumenskyggekopi) i gæsten er det en online-backup, hvor også programmer som SQL Server bliver konsistente; uden den sætter Hyper-V kortvarigt VM'en i gemt tilstand.
- Én backup pr. VM, opbygget som en eksport fra Hyper-V. Efter
gendannelsen læser
Import-VMden ind som en kopi med nyt ID. - Fuld backup. Hver kørsel sikkerhedskopierer hele VM'en. Standardgrænsen på 100 GB pr. backup (se Grænser) hæver vi på forespørgsel.
- Forudsætninger. Windows Server 2025 eller 2022, klienten kører som
administrator, VM-filer på lokale volumener på en selvstændig vært. VM'er på
Cluster Shared Volumes eller SMB-delinger, pass-through-diske og VHD Sets
afviser klienten med en meddelelse. Uden DiskShadow (Windows 10/11), eller
hvis Hyper-V-writeren fejler, sikkerhedskopierer den kun crash-konsistent og
advarer;
on_writer_error: abortafbryder i stedet. - Ældre kontrolpunkter efter importen. Et kontrolpunkt, der allerede fandtes
før backuppen, starter først med Secure Boot i den importerede VM, når
Secure Boot-skabelonen er sat igen
(
Set-VMFirmware -VM $vm -EnableSecureBoot On -SecureBootTemplate MicrosoftWindows). Efter en import fra Hyper-Vs egen eksport er det det samme.
En trin-for-trin-vejledning med gendannelsestest findes på bloggen: Backup af Hyper-V VM'er uden at lukke dem ned og Gendan en Hyper-V VM fra skyen.
Kommandoer før og efter backuppen
Fra klient 0.2.0 udfører klienten egne kommandoer, der står under
hooks:, fx et databasedump før backuppen:
lionbackup:
hooks:
pre_backup:
- 'C:\Scripts\sikkerhedskopier-database.cmd'
post_backup:
- 'C:\Scripts\efter-backup.cmd'
timeout_sec: 3600 # pr. kommando, standard 3600
| Trin | Hvornår | Hvis kommandoen fejler |
|---|---|---|
pre_backup | før alt andet, endda før kilderne kontrolleres | Kørslen sikkerhedskopierer intet. |
post_snapshot | så snart skyggekopien findes, ellers efter læsningen | Backuppen fortsætter, men slutter med en fejl. |
post_backup | altid til sidst, også efter fejl | Kørslen slutter med en fejl. |
Sæt kommandoer i enkelte anførselstegn: Et kolon efterfulgt af et mellemrum
eller et # i kommandoen ødelægger ellers YAML'en. Under Windows køres de via
cmd.exe /C, under Linux og macOS via /bin/sh -c.
Den, der må ændre konfigurationen, kan bruge den til at køre kommandoer, på en
server ofte som administrator. Gem konfigurationen, så kun administratorer kan
ændre den. Under Linux og macOS afviser klienten hooks: i en konfiguration,
som gruppen eller andre må skrive til.