Dublējumi

Glabā savu iestatījumu kopiju, lai varētu to atjaunot pēc neveiksmīga atjauninājuma, salūzuša diska vai pārcelšanās uz jaunu datoru.

Pirms sāc

• Settings > Backups (Iestatījumi > Dublējumi) prasa atļauju Change settings (mainīt iestatījumus). Atjauno tikai īpašnieks.
• Lejupielādei, dzēšanai un atjaunošanai vajag pieteikšanos ar paroli pēdējo minūšu laikā.

Izveido dublējumu

1. Atver Settings > Backups.
2. Noklikšķini uz Back up now (dublēt tagad). Jaunajam dublējumam vajadzētu parādīties sadaļā Saved backups (saglabātie dublējumi).
3. Noklikšķini uz Download (lejupielādēt) blakus tam, lai kopiju glabātu ārpus servera.

Saglabā galveno atslēgu

Dublējumos nekad nav galvenās atslēgas, kas atver tavos iestatījumos saglabātās paroles un API atslēgas. Bez atbilstošās atslēgas atjaunots dublējums tās nevar nolasīt.

1. Sadaļā Master key (galvenā atslēga) īpašnieks noklikšķina uz Download key kit (lejupielādēt atslēgas komplektu).
2. Glabā failu prom no servera un atsevišķi no dublējumiem. Atslēgas komplekta brīdinājumam vajadzētu pazust no Settings > Backups un veselības pārbaudēm.

Lai to izmantotu vēlāk, pārdēvē failu par holyarrs.key un ieliec konfigurācijas mapē. Neesi īpašnieks? Palūdz īpašniekam to lejupielādēt.

Atjauno dublējumu

Bīstamība

Izmaiņas, kas veiktas pēc dublējuma izveides, tiks zaudētas. Vispirms sagatavo atbilstošo galveno atslēgu.

1. Noklikšķini uz Restore from a file (atjaunot no faila) un izvēlies HolyArrs dublējuma zip failu.
2. Apstiprini.
3. HolyArrs pārbauda failu. Tev vajadzētu redzēt Restore ready. It applies on the next start.
4. HolyArrs restartējas un ieliek dublējumu vietā. Ar ieteicamo Docker restartēšanas politiku tas notiek pats.

Tavas pašreizējās datubāzes pārvietojas uz /config/backups/before-restore-<time>, tāpēc atjaunošanu var atcelt.

Izvēles

Cik bieži

Izvēle	Dublē	Glabā
Balanced (līdzsvarots; noklusējuma)	Katru dienu	Pēdējās 7 dienas un 4 nedēļas kopijas
Light (viegls)	Reizi nedēļā	4 nedēļas. Vismazāk vietas
Careful (uzmanīgs)	Katru dienu	Katru kopiju 30 dienas

Jaunākais plānotais dublējums tiek glabāts vienmēr. Šie noteikumi tīra tikai plānotos dublējumus. Dublējumi, ko izveido pats, paliek, līdz tos izdzēs (atkritnes poga rindā; to nevar atsaukt). HolyArrs dublē arī pirms atjauninājuma, kas maina saglabātos datus, un glabā jaunākos 3; skaties Atjauninājumi.

Pārcelšanās uz jaunu datoru

Jauna uzstādīšana pirmajā palaišanā izveido savu galveno atslēgu. Šī atslēga neatver tavus vecos dublējumus, tāpēc atjaunošana tiek noraidīta. Vispirms ieliec vecā atslēgu vietā. Piemēros konteiners saucas holyarrs; izmanto savu nosaukumu.

1. Pirms pirmās palaišanas izveido konteineru, to nepalaižot: docker compose create vai savu docker run rindu ar docker create docker run -d vietā.
2. Iekopē veco atslēgu: docker cp holyarrs.key holyarrs:/config/. Der arī atslēgas komplekts, pārdēvēts par holyarrs.key. Tas darbojas ar nosauktu sējumu vai resursdatora mapi; HolyArrs palaišanas brīdī nodod /config failus tavam PUID un PGID. Ja izmanto HOLYARRS_MASTER_KEY_FILE, ieliec atslēgu šajā ceļā resursdatorā, lasāmu tavam PUID un PGID.
3. Atjauno dublējumu. Izvēlies vienu veidu:

   • Palaid HolyArrs, pabeidz pirmo palaišanu, tad izmanto Restore from a file sadaļā Settings > Backups.

   • Vai atjauno pirms pirmās palaišanas. Ieliec zip failu ar neizmainītu nosaukumu mapē backups un iekopē to ar docker cp backups holyarrs:/config/. Pēc tam vienreiz palaid atjaunošanu ar to pašu attēlu (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>

     Ja izmanto atslēgas faila ceļu, pievieno -e HOLYARRS_MASTER_KEY_FILE=<its path>, lai atjaunošana pārbauda pret tavu atslēgu. restore --list parāda dublējumu nosaukumus, ko tā redz.

4. Palaid HolyArrs. Tev vajadzētu redzēt savu bibliotēku un iestatījumus atpakaļ vietā.

Jauno HolyArrs palaidi pirms atslēgas iekopēšanas? Ja tajā nav nekā vērtīga, aptur HolyArrs, ar to pašu docker cp pārraksti jauno atslēgu ar veco, atjauno un tad palaid.

Ja tas nedarbojas

Simptoms: „Backups are off in this build”. Cēlonis: šī kopija darbojas bez dublējumu pārvaldnieka. Risinājums: lietotnē nav ko darīt; dublējumu vadīklu nav.

Simptoms: lejupielāde, dzēšana vai atjaunošana prasa paroli. Cēlonis: tām vajag nesenu pieteikšanos ar paroli. Risinājums: piesakies vēlreiz ar paroli un mēģini vēlreiz.

Simptoms: atjaunošana tiek noraidīta galvenās atslēgas dēļ. Cēlonis: atslēga konfigurācijas mapē neatbilst dublējumam. Risinājums: ieliec atpakaļ atbilstošo holyarrs.key un mēģini vēlreiz.

Atjaunošana noraida arī zip failu, kas ir pārāk liels vai bojāts, satur negaidītus failus, nāk no jaunākas datubāzes versijas vai satur datus, ko tava atslēga nevar nolasīt.

Pieredzējušiem

Kas ir dublējumā

Katrs dublējums ir zip ar galveno datubāzi, notikumu (Events) datubāzi, ja tāda ir, un backup.json (HolyArrs versija, datubāzu versijas, dublējuma veids, izveides laiks). Multivide, lejupielādes, noformējums, žurnāli un galvenā atslēga tajā nav.

Atjaunošana pirms pirmās palaišanas

docker cp darbojas ar nosauktu sējumu vai resursdatora mapi; HolyArrs palaišanas brīdī nodod /config failus tavam PUID un PGID. Ar HOLYARRS_MASTER_KEY_FILE ieliec atslēgu šajā resursdatora ceļā, lasāmu PUID un PGID.

1. Ieliec zip failu ar neizmainītu nosaukumu mapē backups un iekopē to: docker cp backups holyarrs:/config/.
2. Vienreiz palaid atjaunošanu ar to pašu attēlu:
   • 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. Ja izmanto atslēgas faila ceļu, pievieno -e HOLYARRS_MASTER_KEY_FILE=<its path>, lai atjaunošana pārbauda pret tavu atslēgu.
4. Palaid HolyArrs.

restore --list parāda dublējumu nosaukumus, ko tā redz.

Saistītais

• Atjauninājumi
• Uzstādīšana
• Veselības pārbaudes