Ripartire da una copia di sicurezza

• Tempo: da 20 a 40 minuti con un altro computer da preparare, circa 10 minuti se BiblioViva funziona già.
• Occorrente: un file di copia di sicurezza (vedere sotto quali) e l'account admin.
• Per ripristinare su un altro computer: i passi 1-4 dell'installazione, indicati più avanti.

Quale file serve

BiblioViva produce tre tipi di file; ciascuno si può ripristinare.

La configurazione (impostazioni, account del personale, modelli di tessere ed etichette) fa parte soltanto dei file .zip. Ripristinando una copia notturna .db la configurazione resta quella del primo avvio.

Procedura

Se BiblioViva funziona: ripristinare dal programma

1. Aprire BiblioViva con l'account admin, poi Amministrazione, poi Backup.
2. Per un file già nell'elenco, premere Ripristina… sulla sua riga.
3. Per un file portato da un altro computer, premere Carica un archivio e scegliere il file. Il browser accetta file fino a 30 MB; uno più grande si copia nella cartella backups del computer (sezione seguente) e poi si sceglie dall'elenco.
4. Leggere il controllo che BiblioViva mostra: le parti che il file contiene (con una casella ciascuna), quante righe ci sono ora e quante nel file. Togliere la spunta alle parti da non toccare: restano come sono.
5. Premere Ripristina. Alla domanda «Ripristinare le parti scelte?» confermare. I dati e la configurazione scelti sostituiscono quelli attuali.
6. Attendere il messaggio «Ripristino completato».

Copiare un file grande sul computer

1. Dal computer in cui si trova il file, copiarlo nella cartella backups del computer di BiblioViva, sostituendo <utente> con il nome utente e <file> con il nome del file. Il comando funziona nel terminale di Windows, macOS e Linux; al posto di biblioviva.local si può usare l'indirizzo con cui ci si collega al computer.

   scp <file> <utente>@biblioviva.local:biblioviva/backups/
   

2. Aprire Amministrazione, poi Backup: il file compare nell'elenco, e si ripristina con Ripristina….

Se BiblioViva non si apre: ripristinare dal terminale

Sul computer di BiblioViva, con il terminale aperto come al passo Collegarsi al computer.

1. Copiare il file nella cartella backups (con scp come sopra, o da una chiavetta).

2. Fermare BiblioViva.

   cd ~/biblioviva && docker compose stop app
   

3. Far leggere il file al programma di ripristino, sostituendo <file> con il suo nome. Il programma controlla il file e scrive che cosa contiene, senza cambiare nulla.

   docker compose run --rm --entrypoint bun app cli/backup-restore.js /backups/<file>
   

4. Se il controllo non segnala errori, ripetere il comando con --yes in fondo: ripristina davvero.

   docker compose run --rm --entrypoint bun app cli/backup-restore.js /backups/<file> --yes
   

5. Riavviare BiblioViva.

   docker compose start app
   

Dal primo avvio

Su un computer appena installato, o quando si ricomincia da capo, la configurazione guidata permette di ripristinare un archivio Esporta tutto senza rispondere alle sue domande. La scelta compare soltanto finché la configurazione guidata non è completata.

1. Aprire l'indirizzo di BiblioViva stampato da setup.sh: si apre la pagina Prima configurazione.
2. Nel primo passo, sotto la scelta della lingua, premere Ripristina da un backup.
3. Premere Scegli l'archivio e scegliere il file biblioviva-export-AAAAMMGG-HHMM.zip. Il browser accetta file fino a 30 MB.
4. Attendere il controllo. BiblioViva mostra la biblioteca che ha prodotto l'archivio, la data, la versione, quanti utenti, libri e prestiti contiene e gli account che potranno accedere.
5. Premere Ripristina. Impostazioni, dati e immagini tornano come erano nell'archivio, in una volta sola.
6. Attendere la schermata «Ripristino completato», che elenca gli account dell'archivio.
7. Premere Vai all'accesso e accedere con uno di quegli account, con la password che aveva nell'archivio.

Un archivio incompleto, di una versione più recente o che non è di BiblioViva viene rifiutato prima di cambiare qualsiasi cosa, con un messaggio che spiega il motivo. Per un archivio più grande di 30 MB completare la configurazione guidata e ripristinare dal terminale, come descritto sopra.

Su un altro computer

1. Preparare il computer e installare BiblioViva con i passi 1-4 del percorso scelto (vedere Installazione), con lo stesso modo di collegamento di prima.
2. Al passo Primo avvio ripristinare il file dalla prima schermata della configurazione guidata, come descritto nella sezione Dal primo avvio; il resto della configurazione guidata non serve.
3. Se la copia viene da un computer diverso, aprire Amministrazione, Configurazione, Prestazioni e controllare il campo Computer: la copia riporta quello del vecchio computer.

Risultato

Possibili problemi

• «Il file non è un archivio di BiblioViva.»: il file scelto non è un file prodotto da BiblioViva. Scegliere un file .db o .zip della cartella backups, oppure scaricare di nuovo la copia.
• «Il backup è di una versione diversa di BiblioViva…»: il file è stato fatto da una versione che ha le tabelle diverse. Installare la stessa versione (vedere «Restare su una versione» in Aggiornare BiblioViva), ripristinare, poi aggiornare.
• Dal primo avvio: «L'archivio è incompleto: mancano …»: il file non contiene tutte le parti di una biblioteca (le impostazioni, gli account, gli utenti o il catalogo). Scegliere un archivio fatto con Esporta tutto.
• Dal primo avvio: «L'archivio è stato creato da una versione più recente di BiblioViva…»: installare prima quella versione, ripristinare, poi aggiornare.
• Il ripristino segnala righe che «si riferiscono a … che non ci sarebbero»: aggiungere alla scelta la parte che il messaggio nomina e ripetere.
• Da terminale: «permission denied» a proposito di Docker: vedere Installare BiblioViva.

Pagine correlate