Varukoopiad

Hoia oma seadistusest koopiat, et panna see tagasi pärast viga uuenduses, katkist ketast või kolimist uuele arvutile.

Enne alustamist

• Settings > Backups (seaded > varukoopiad) vajab õigust Change settings (seadete muutmine). Taastada saab ainult omanik.
• Allalaadimine, kustutamine ja taastamine vajavad parooliga sisselogimist viimase mõne minuti jooksul.

Tee varukoopia

1. Ava Settings > Backups.
2. Vajuta Back up now (varunda kohe). Uus varukoopia peaks ilmuma jaotisse Saved backups (salvestatud varukoopiad).
3. Vajuta selle kõrval Download (laadi alla), et hoida koopiat väljaspool serverit.

Salvesta peavõti

Varukoopiad ei sisalda peavõtit, mis avab sinu seadetes olevad paroolid ja API-võtmed. Ilma sobiva võtmeta ei saa taastatud varukoopia neid lugeda.

1. Jaotises Master key (peavõti) vajutab omanik Download key kit (laadi alla võtmepakett).
2. Hoia fail serverist eemal ja varukoopiatest eraldi. Võtmepaketi hoiatus peaks kaduma lehelt Settings > Backups ja tervisekontrollidest.

Hiljem kasutamiseks nimeta see ümber holyarrs.key ja pane seadete kausta. Kas sa pole omanik? Palu omanikul see alla laadida.

Taasta varukoopia

Danger

Muudatused, mis on pärast varukoopiat tehtud, lähevad kaotsi. Hoia sobiv peavõti enne valmis.

1. Vajuta Restore from a file (taasta failist) ja vali HolyArrsi varukoopia zip.
2. Kinnita.
3. HolyArrs kontrollib faili. Näed teadet Restore ready. It applies on the next start.
4. HolyArrs taaskäivitub ja paneb varukoopia paika. Soovitatud Dockeri taaskäivituse poliitikaga juhtub see ise.

Sinu praegused andmebaasid liiguvad kausta /config/backups/before-restore-<time>, nii et taastamise saab tagasi võtta.

Valikud

Kui tihti

Valik	Varundab	Hoiab
Balanced (tasakaalus, vaikimisi)	Iga päev	Viimased 7 päeva ja 4 nädalakoopiat
Light (kerge)	Kord nädalas	4 nädalat. Kõige vähem ruumi
Careful (ettevaatlik)	Iga päev	Iga koopia 30 päeva

Uusim ajastatud varukoopia jääb alati alles. Need reeglid puhastavad ainult ajastatud varukoopiaid. Varukoopiad, mille ise teed, jäävad alles, kuni need kustutad (prügikasti nupp real; seda ei saa tagasi võtta). HolyArrs teeb varukoopia ka enne uuendust, mis muudab salvestatud andmeid, ja hoiab uusimat 3 koopiat; vaata Uuendused.

Kolimine uuele arvutile

Uus install teeb esimesel käivitusel oma peavõtme. See võti ei saa avada sinu vanu varukoopiaid, seega taastamisest keeldutakse. Pane vana võti enne paika. Näidetes on konteineri nimi holyarrs; kasuta enda nime.

1. Enne esimest käivitust loo konteiner käivitamata: docker compose create või oma docker run rida käsuga docker create käsu docker run -d asemel.
2. Kopeeri vana võti sisse: docker cp holyarrs.key holyarrs:/config/. Ka ümber nimetatud võtmepakett holyarrs.key sobib. See töötab nimega volume’i ja hosti kausta puhul; HolyArrs annab /config failid käivitumisel üle sinu PUID ja PGID kasutajale. Kui kasutad HOLYARRS_MASTER_KEY_FILE, pane võti hostis hoopis sellele teele, nii et sinu PUID ja PGID saavad seda lugeda.
3. Taasta varukoopia. Vali üks viis:

   • Käivita HolyArrs, lõpeta esimene käivitus, siis kasuta Restore from a file lehel Settings > Backups.

   • Või taasta enne esimest käivitust. Pane zip, nime muutmata, kausta nimega backups ja kopeeri see sisse käsuga docker cp backups holyarrs:/config/. Seejärel käivita taastamine ühe korra sama image’iga:

     • 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>

     Kui kasutad võtmefaili teed, lisa -e HOLYARRS_MASTER_KEY_FILE=<its path>, et taastamine kontrolliks sinu võtme vastu. restore --list näitab varukoopiate nimesid, mida see näeb.

4. Käivita HolyArrs. Näed oma meediakogu ja seaded tagasi.

Kas käivitasid uue installi enne võtme kopeerimist? Kui seal pole midagi säilitamist väärt, peata HolyArrs, kopeeri vana võti uue peale sama docker cp käsuga, taasta, siis käivita.

Kui see ei tööta

Sümptom: „Backups are off in this build“. Põhjus: see koopia töötab ilma varukoopiate haldurita. Lahendus: rakenduses pole midagi teha; varukoopia juhtnuppe pole.

Sümptom: allalaadimine, kustutamine või taastamine küsib sinu parooli. Põhjus: need vajavad hiljutist parooliga sisselogimist. Lahendus: logi uuesti parooliga sisse ja proovi uuesti.

Sümptom: taastamisest keeldutakse peavõtme tõttu. Põhjus: seadete kaustas olev võti ei sobi varukoopiaga. Lahendus: pane sobiv holyarrs.key tagasi ja proovi uuesti.

Taastamine keeldub ka zipist, mis on liiga suur või rikutud, sisaldab ootamatuid faile, pärineb uuemast andmebaasi versioonist või sisaldab andmeid, mida sinu võti ei saa lugeda.

Asjatundjale

Mis on varukoopias

Iga varukoopia on zip, milles on põhiandmebaas, sündmuste andmebaas (kui see on olemas) ja backup.json (HolyArrsi versioon, andmebaaside versioonid, varukoopia liik, tegemise aeg). Meediat, allalaadimisi, kaanepilte, logisid ja peavõtit selles pole.

Taasta enne esimest käivitust

docker cp töötab nimega volume’i ja hosti kausta puhul; HolyArrs annab /config failid käivitumisel üle sinu PUID ja PGID kasutajale. HOLYARRS_MASTER_KEY_FILE korral pane võti hoopis sellele hosti teele, nii et PUID ja PGID saavad seda lugeda.

1. Pane zip, nime muutmata, kausta nimega backups ja kopeeri see sisse: docker cp backups holyarrs:/config/.
2. Käivita taastamine ühe korra sama image’iga:
   • 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. Kui kasutad võtmefaili teed, lisa -e HOLYARRS_MASTER_KEY_FILE=<its path>, et taastamine kontrolliks sinu võtme vastu.
4. Käivita HolyArrs.

restore --list näitab varukoopiate nimesid, mida see näeb.

Seotud lehed

• Uuendused
• Paigaldamine
• Tervisekontrollid