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 la rete locale

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.

  • Nessun altro dato: la rete locale non richiede né account né chiave.

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 2 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.

Con la rete locale non c'è altra domanda: il programma passa subito all'installazione. Se il computer non ha il servizio che gli dà il nome biblioviva.local (avahi-daemon), il programma lo installa da solo.

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

== Installazione di avahi-daemon, che rende raggiungibile il computer con il nome biblioviva.local

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

== Avvio di BiblioViva

== Attesa che BiblioViva risponda (fino a 180 secondi)

La riga su avahi-daemon compare solo se il servizio manca.

  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:

    http://biblioviva.local:8080
    http://192.168.1.50:8080

(da un computer della rete della scuola; se il nome non funziona, usare l'indirizzo numerico)

  1. Annotare i due indirizzi che il programma scrive: quello con il nome e quello numerico (il secondo è assente se il programma non riesce a leggere l'indirizzo del computer). L'indirizzo numerico cambia da scuola a scuola: è quello che il router ha riservato al passo Preparare la rete. Servono 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