Backup

Laikyk savo sąrankos kopiją, kad galėtum ją grąžinti po nesėkmingo atnaujinimo, sugedusio disko ar perkėlimo į naują kompiuterį.

Prieš pradedant

• Settings > Backups (nustatymai > backup) reikia teisės Change settings (keisti nustatymus). Atkurti gali tik savininkas.
• Norint atsisiųsti, ištrinti ar atkurti, reikia prisijungti slaptažodžiu per pastarąsias kelias minutes.

Backup padarymas

1. Atidaryk Settings > Backups.
2. Paspausk Back up now (daryti backup dabar). Naują backup turėtum pamatyti po Saved backups (išsaugotos kopijos).
3. Paspausk Download (atsisiųsti) šalia jo, kad kopija liktų ne serveryje.

Pagrindinio rakto išsaugojimas

Backup niekada neturi pagrindinio rakto, kuris atrakina slaptažodžius ir API raktus tavo nustatymuose. Be tinkamo rakto atkurtas backup jų perskaityti negali.

1. Po Master key (pagrindinis raktas) savininkas paspaudžia Download key kit (atsisiųsti rakto rinkinį).
2. Laikyk failą atskirai nuo serverio ir nuo savo backup. Turėtum pamatyti, kaip rakto rinkinio įspėjimas dingsta iš Settings > Backups ir iš būklės patikrų.

Kad vėliau jį panaudotum, pervardyk jį į holyarrs.key ir įdėk į konfigūracijos aplanką. Nesi savininkas? Paprašyk savininko jį atsisiųsti.

Backup atkūrimas

Danger

Pakeitimai, padaryti po backup, bus prarasti. Iš anksto pasiruošk tinkamą pagrindinį raktą.

1. Paspausk Restore from a file (atkurti iš failo) ir pasirink HolyArrs backup zip.
2. Patvirtink.
3. HolyArrs patikrina failą. Turėtum pamatyti Restore ready. It applies on the next start.
4. HolyArrs paleidžiamas iš naujo ir įdiegia backup. Su rekomenduojama Docker paleidimo iš naujo politika tai įvyksta pats.

Dabartinės tavo duomenų bazės perkeliamos į /config/backups/before-restore-<time>, todėl atkūrimą gali atšaukti.

Pasirinkimai

Kaip dažnai

Pasirinkimas	Kada daro backup	Ką palieka
Balanced (subalansuotas; pagal numatymą)	Kasdien	Paskutines 7 dienas ir 4 savaitines kopijas
Light (lengvas)	Kartą per savaitę	4 savaites. Mažiausiai vietos
Careful (atsargus)	Kasdien	Kiekvieną kopiją 30 dienų

Naujausias suplanuotas backup paliekamas visada. Šios taisyklės valo tik suplanuotus backup. Tavo pačio padaryti backup lieka, kol juos ištrini (šiukšliadėžės mygtukas eilutėje; to atšaukti negalima). HolyArrs taip pat daro backup prieš atnaujinimą, kuris keičia saugomus duomenis, ir palieka naujausius 3; žr. Atnaujinimai.

Perkėlimas į naują kompiuterį

Naujas diegimas pirmą kartą paleistas susikuria savo pagrindinį raktą. Tas raktas negali atrakinti senų backup, todėl atkūrimas atmetamas. Pirmiausia įdėk seną raktą. Pavyzdžiuose konteineris vadinasi holyarrs; naudok savo pavadinimą.

1. Prieš pirmą paleidimą sukurk konteinerį jo nepaleisdamas: docker compose create, arba savo docker run eilutę su docker create vietoje docker run -d.
2. Nukopijuok seną raktą: docker cp holyarrs.key holyarrs:/config/. Tinka ir rakto rinkinys, pervardytas į holyarrs.key. Tai veikia su pavadintu volume ar kompiuterio aplanku; HolyArrs paleidžiamas perduoda /config failus tavo PUID ir PGID. Jei naudoji HOLYARRS_MASTER_KEY_FILE, raktą įdėk į tą kelią kompiuteryje, kad jį galėtų skaityti tavo PUID ir PGID.
3. Atkurk backup. Pasirink vieną būdą:

   • Paleisk HolyArrs, baik pirmą paleidimą, tada Settings > Backups panaudok Restore from a file.

   • Arba atkurk prieš pirmą paleidimą. Įdėk zip nekeisdamas pavadinimo į aplanką backups ir nukopijuok jį su docker cp backups holyarrs:/config/. Tada vieną kartą paleisk atkūrimą su tuo pačiu image:

     • Compose: docker compose run --rm holyarrs restore <zip name>
     • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

     Jei naudoji rakto failo kelią, pridėk -e HOLYARRS_MASTER_KEY_FILE=<its path>, kad atkūrimas tikrintų pagal tavo raktą. restore --list parodo backup pavadinimus, kuriuos mato.

4. Paleisk HolyArrs. Turėtum pamatyti savo biblioteką ir nustatymus atgal.

Naują diegimą paleidai anksčiau, nei nukopijavai raktą? Jei joje nieko nereikia išsaugoti, sustabdyk HolyArrs, tuo pačiu docker cp nukopijuok seną raktą ant naujo, atkurk ir paleisk.

Jei neveikia

Požymis: „Backups are off in this build“. Priežastis: ši kopija veikia be backup tvarkyklės. Sprendimas: programoje nieko nepadarysi; backup valdiklių nėra.

Požymis: atsisiunčiant, ištrinant ar atkuriant prašo slaptažodžio. Priežastis: tam reikia neseno prisijungimo slaptažodžiu. Sprendimas: prisijunk iš naujo slaptažodžiu ir bandyk dar kartą.

Požymis: atkūrimas atmetamas dėl pagrindinio rakto. Priežastis: raktas konfigūracijos aplanke neatitinka backup. Sprendimas: grąžink tinkamą holyarrs.key ir bandyk dar kartą.

Atkūrimas taip pat atmeta zip, kuris per didelis ar sugadintas, turi netikėtų failų, yra iš naujesnės duomenų bazės versijos arba turi duomenų, kurių tavo raktas negali perskaityti.

Pažengusiems

Kas yra backup viduje

Kiekvienas backup yra zip su pagrindine duomenų baze, Events duomenų baze, jei tokia yra, ir backup.json (HolyArrs versija, duomenų bazių versijos, backup rūšis, sukūrimo laikas). Medijos, atsisiuntimų, iliustracijų, log ir pagrindinio rakto jame nėra.

Atkūrimas prieš pirmą paleidimą

docker cp veikia su pavadintu volume ar kompiuterio aplanku; HolyArrs paleidžiamas perduoda /config failus tavo PUID ir PGID. Su HOLYARRS_MASTER_KEY_FILE raktą įdėk į tą kelią kompiuteryje, kad jį galėtų skaityti PUID ir PGID.

1. Įdėk zip nekeisdamas pavadinimo į aplanką backups ir nukopijuok: docker cp backups holyarrs:/config/.
2. Vieną kartą paleisk atkūrimą su tuo pačiu image:
   • Compose: docker compose run --rm holyarrs restore <zip name>
   • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
3. Jei naudoji rakto failo kelią, pridėk -e HOLYARRS_MASTER_KEY_FILE=<its path>, kad atkūrimas tikrintų pagal tavo raktą.
4. Paleisk HolyArrs.

restore --list parodo backup pavadinimus, kuriuos mato.

Susiję puslapiai

• Atnaujinimai
• Diegimas
• Būklės patikros