BiblioViva Documentazione
CercaCtrl K
ITEN
  1. 1 · Preparare il computer
  2. 2 · Collegarsi al computer
  3. 3 · Preparare la rete
  4. 4 · Installare BiblioViva
  5. 5 · Primo avvio
  6. 6 · Collegare i dispositivi
  7. 7 · Provare il lettore e la stampante
  8. 8 · Copie di sicurezza
Passo 4 di 8

Installare BiblioViva

Questo passo installa BiblioViva sul computer preparato ai passi precedenti, con un solo comando da copiare nel terminale. Il programma setup.sh controlla il computer, installa Docker se manca, pone alcune domande, avvia BiblioViva e scrive l'indirizzo da aprire nel browser. Richiede da 5 a 15 minuti, in gran parte attesa per lo scaricamento di BiblioViva [VERIFY: tempi da misurare su un Raspberry Pi 4 con scheda SD].

  • PC con Linux e Tailscale

Docker è il programma che fa girare BiblioViva in un contenitore chiuso, separato dal resto del computer (vedere il glossario).

Occorrente

  • Il terminale del computer di BiblioViva, aperto al passo Collegarsi al computer.

  • Il computer collegato a internet.

  • La password dell'utente del computer, annotata al passo Preparare il computer: serve a sudo, il comando che dà al programma i diritti di amministratore.

  • La chiave di accesso generata al passo Preparare la rete, che inizia con tskey-auth-, a portata di mano per essere incollata.

Procedura

Avviare il programma

  1. Copiare il comando seguente.

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

  2. Incollarlo nel terminale e premere Invio (come si incolla un comando è spiegato in Collegarsi al computer). Il terminale scrive il titolo «Installazione di BiblioViva» e il programma comincia a controllare il computer.

Nota. L'opzione --lang it fa scrivere al programma in italiano; senza di essa il programma usa la lingua del computer, spesso l'inglese.

Il programma scarica i file di configurazione di BiblioViva dal suo archivio pubblico e le immagini dei programmi, e scrive tutto nella cartella biblioviva dell'utente. Il testo del programma si può leggere prima di eseguirlo: setup.sh.

Installare Docker, quando manca

Su un computer appena preparato Docker non c'è. In quel caso il programma lo dice e fa una domanda.

Docker non è installato. Il programma lo installa con lo script ufficiale di Docker (https://get.docker.com): servono alcuni minuti e la password dell'utente.
Installare Docker adesso? [S/n]
  1. Premere Invio (oppure S) per installare Docker. Rispondere n ferma il programma.
  2. Quando sudo chiede la password, digitare la password dell'utente e premere Invio. Mentre la si digita non compare nulla, nemmeno asterischi: è normale.
  3. Attendere. L'installazione di Docker scrive molte righe e dura alcuni minuti. Al termine il programma scrive: «Docker è installato. Per usare il comando docker senza sudo, chiudere il terminale e collegarsi di nuovo al termine.» L'installazione di BiblioViva prosegue senza interruzioni.

Nota. La frase sul terminale da chiudere riguarda il momento in cui l'installazione sarà finita: allora chiudere il terminale e collegarsi di nuovo come al passo Collegarsi al computer. Fino ad allora non occorre fare nulla. Se Docker era già installato, la frase non compare.

Rispondere alle domande

Le domande compaiono nell'ordine seguente. Il programma ripete la domanda quando la risposta non è valida («Risposta non valida.»).

Come raggiungere BiblioViva

Come raggiungono BiblioViva i computer e i telefoni della biblioteca?
  1) Con Tailscale: indirizzo sicuro (HTTPS), fotocamera, telefoni, anche fuori dalla scuola. Serve un account Tailscale gratuito.
  2) Solo dalla rete locale della scuola: nessun account, ma senza fotocamera e solo dentro la scuola.
Scelta [1/2]:
  1. Digitare 1 e premere Invio.

La risposta deve essere quella scelta al passo Preparare la rete. Cambiare idea più avanti è possibile, senza perdere i dati: vedere Passare dalla rete locale a Tailscale.

Che computer è

Che computer è questo?
  1) micro: un computer molto piccolo, con 512 MB di memoria
  2) small: un Raspberry Pi 4 con 2 GB e scheda SD
  3) medium: un PC non recente con disco rigido
  4) large: un PC con disco SSD
Scelta [small, proposta per questo computer]:

Il profilo regola quanta memoria e quanto lavoro BiblioViva chiede al computer: uno troppo alto per un computer piccolo lo rende lento (vedere il glossario). Il programma guarda la memoria e il tipo di disco e propone il profilo adatto, scritto tra le parentesi quadre.

  1. Premere Invio per accettare la proposta. Il profilo si può cambiare più avanti da BiblioViva.

La chiave di Tailscale

Incollare la chiave di autenticazione di Tailscale (inizia con tskey-auth-):
  1. Incollare la chiave annotata al passo Preparare la rete (come per i comandi: Ctrl+Shift+V nel terminale di Linux, tasto destro o Ctrl+Shift+V in quello di Windows, Cmd+V in macOS) e premere Invio. La chiave resta visibile sullo schermo mentre la si incolla.
  2. Se il programma risponde «La chiave di Tailscale deve iniziare con tskey-.», la chiave è incompleta o è un'altra: incollarla di nuovo, per intero, quando il programma la richiede.

Importante. Il programma scrive la chiave nel file .env della cartella biblioviva, leggibile solo dall'utente del computer. Non copiare né spedire quel file: contiene un segreto.

Attendere l'installazione

Il programma scrive poi le fasi del lavoro, ciascuna preceduta da ==, e tra l'una e l'altra le righe dei programmi che chiama.

== Preparazione della cartella /home/<utente>/biblioviva

== Scaricamento di BiblioViva (la prima volta può richiedere alcuni minuti)

== Avvio di BiblioViva

== Attesa che BiblioViva risponda (fino a 180 secondi)
  1. Attendere. Lo scaricamento è la fase più lunga, soprattutto su un Raspberry Pi con scheda SD. Il terminale scrive righe con percentuali e sigle ("Pulling", "Download complete"): sono normali.
  2. Non chiudere il terminale e non spegnere il computer finché il programma non ha scritto l'indirizzo.

Annotare l'indirizzo

Al termine il programma scrive che BiblioViva è pronto e l'indirizzo da aprire.

BiblioViva è pronto. Aprire nel browser:

    https://biblioviva.<tailnet>.ts.net

(da un dispositivo con Tailscale collegato all'account della scuola; la prima apertura può richiedere qualche secondo)

  1. Annotare l'indirizzo che il programma scrive: al posto di <tailnet> ha il nome della rete della scuola, che finisce con .ts.net. Serve al passo Primo avvio.

  2. Se Docker è stato installato durante questa esecuzione, chiudere il terminale e collegarsi di nuovo come al passo Collegarsi al computer.

Verifica prima di proseguire

  • Il programma si è concluso senza messaggi di errore e l'ultima parte che ha scritto comincia con «BiblioViva è pronto.».

  • Sotto quella frase compare un indirizzo, ed è annotato.

  • Il comando seguente, dato nel terminale, elenca i contenitori di BiblioViva con lo stato Up (o running):

    cd ~/biblioviva && docker compose ps

    Se il comando risponde «permission denied» a proposito di Docker, il terminale non è stato ancora riaperto dopo l'installazione di Docker: chiuderlo e collegarsi di nuovo, oppure ripetere il comando con sudo davanti.

Quando uno dei punti manca, si veda «Possibili problemi». Eseguire di nuovo il comando del primo punto della procedura non fa danni: il programma riconosce l'installazione già fatta e la aggiorna senza fare domande (vedere Aggiornare BiblioViva).

Possibili problemi

Il programma scrive il messaggio di errore e si ferma. Dopo aver rimosso la causa, ripetere il comando del primo passo della procedura.

Altri problemi: Problemi comuni.

Pagine correlate

Indice A–Z