Installazione

Aggiornare BiblioViva

Questa pagina spiega come portare BiblioViva all'ultima versione, per chi gestisce il computer su cui gira. I dati della biblioteca (utenti, libri, prestiti, foto, impostazioni) restano dove sono.

Tempo: circa 10 minuti, in gran parte attesa per lo scaricamento.
Occorrente: il terminale del computer di BiblioViva (vedere Collegarsi al computer) e una copia di sicurezza recente.
Per la copia di sicurezza: l'account admin di BiblioViva.

Procedura

Fare una copia di sicurezza

Fare una copia di sicurezza con Esegui backup ora, come descritto nella sezione Fare una copia subito del passo Copie di sicurezza.

La copia notturna e quella da conservare fuori dal computer sono spiegate nello stesso passo.

Aggiornare

Aprire il terminale del computer di BiblioViva, come al passo Collegarsi al computer.

Copiare il comando seguente, incollarlo e premere Invio. È lo stesso comando dell'installazione.

curl -fsSL https://raw.githubusercontent.com/itotm/biblioviva/main/setup.sh | bash -s -- --lang it

Attendere. Il programma riconosce l'installazione già fatta, non pone alcuna domanda e scrive una riga come la seguente, con la cartella e il modo di collegamento (tailscale o lan) che BiblioViva ha già.
```
BiblioViva è già installato in /home/<utente>/biblioviva (tailscale): aggiornamento.
```
Attendere la fine. Il programma scarica la versione più recente, riavvia BiblioViva e scrive «BiblioViva è pronto.» con l'indirizzo di sempre. Il riavvio interrompe BiblioViva per alcuni istanti: farlo quando nessuno lavora al banco.

Nota. Il programma riscrive il file compose.yml della cartella biblioviva (e, con Tailscale, tailscale/serve.json) con quelli del modo di collegamento in uso. Il file .env, con la chiave di Tailscale e la versione scelta, e le cartelle config e backups non si toccano. Chi ha modificato compose.yml a mano deve rifare la modifica.

Aggiornare con i comandi di Docker (alternativa)

Per chi preferisce non riscaricare il programma di installazione, due comandi bastano.

Entrare nella cartella di BiblioViva.
```
cd ~/biblioviva
```
Scaricare la versione più recente.
```
docker compose pull
```
Riavviare BiblioViva con la versione scaricata.
```
docker compose up -d
```

Restare su una versione

Per impostazione predefinita BiblioViva segue l'ultima versione pubblicata. Per fermarlo a una versione precisa, per esempio per non cambiare versione durante l'anno scolastico:

Aprire il file .env con l'editor del terminale.
```
nano ~/biblioviva/.env
```
Trovare la riga che comincia con BIBLIOVIVA_IMAGE= e sostituire la parte dopo il segno = con la versione voluta, per esempio:
```
BIBLIOVIVA_IMAGE=ghcr.io/itotm/biblioviva:1.0.0
```
Salvare con Ctrl+O e Invio, uscire con Ctrl+X, poi eseguire i comandi della sezione precedente (docker compose pull, poi docker compose up -d).

Per tornare all'ultima versione, scrivere di nuovo ghcr.io/itotm/biblioviva:latest. Il comando di installazione rieseguito non cambia questa riga.

Risultato

BiblioViva risponde allo stesso indirizzo di prima, la pagina di accesso si apre e i libri, gli utenti e i prestiti sono quelli di prima.

Possibili problemi

Il comando risponde «permission denied» a proposito di Docker: il terminale va chiuso e riaperto dopo l'installazione di Docker (vedere Installare BiblioViva), oppure si antepone sudo ai comandi docker.
«BiblioViva non risponde ancora»: attendere due minuti e rieseguire il comando; se il messaggio resta, la lettura del registro è descritta in Installare BiblioViva.
Dopo l'aggiornamento qualcosa non va: ripristinare la copia fatta all'inizio, come in Ripartire da una copia di sicurezza, e rimandare l'aggiornamento restando sulla versione di prima come descritto sopra.

Pagine correlate

Copie di sicurezza

Ripartire da una copia di sicurezza

Installare BiblioViva