Hop til hovedindhold

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:

  1. Komprimere de valgte data,
  2. Kryptere — med klientsidig end-to-end-kryptering aktiveret forlader kun kryptotekst dit system,
  3. 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.
Open source

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_error i lionbackup.yaml: warn (standard) eller abort for 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-VM den 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: abort afbryder 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
TrinHvornårHvis kommandoen fejler
pre_backupfør alt andet, endda før kilderne kontrolleresKørslen sikkerhedskopierer intet.
post_snapshotså snart skyggekopien findes, ellers efter læsningenBackuppen fortsætter, men slutter med en fejl.
post_backupaltid til sidst, også efter fejlKø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.

Kommandoer kører med klientens rettigheder

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.