Passo 2 di 8

Collegarsi al computer

Questo passo spiega come aprire il terminale del computer di BiblioViva, la finestra in cui si digitano i comandi dei passi successivi. Richiede circa 10 minuti. Un terminale è una finestra di testo in cui si scrive un comando e si legge la risposta del computer.

PC con Linux e Tailscale

Occorrente

Il nome utente e la password annotati nel passo Preparare il computer.
Il PC stesso, con tastiera e schermo collegati; oppure un altro computer sulla stessa rete, se è installato il server SSH.

Procedura

Sul PC di BiblioViva, accedere con il nome utente e la password annotati. Con una versione con ambiente grafico, aprire poi "Terminale" dal menu delle applicazioni (di solito anche con Ctrl+Alt+T). Con una versione server l'accesso mostra già il terminale.
Per collegarsi da un altro computer invece (Windows, macOS o Linux): aprire il terminale (in Windows dal menu Start scrivendo "PowerShell"; in macOS "Terminale" dalla cartella Utility; in Linux "Terminale" dal menu delle applicazioni).
Digitare il comando seguente, sostituendo <utente> con il nome utente annotato, e premere Invio.
```
ssh <utente>@biblioviva.local
```
Alla prima connessione rispondere yes alla domanda sull'impronta della chiave e premere Invio. La domanda compare solo la prima volta.
Digitare la password e premere Invio. Mentre si digita la password non compare nulla: è normale.
Se il nome biblioviva.local non risponde, cercare l'indirizzo del PC nell'elenco dei dispositivi del router (per esempio 192.168.1.50) e usarlo al posto del nome.
```
ssh <utente>@<indirizzo>
```
Il nome biblioviva.local funziona da un altro computer solo se il PC lo annuncia in rete: con la rete locale lo fa dopo il passo Installare BiblioViva, che aggiunge il servizio necessario quando manca.

Copiare e incollare un comando

I passi successivi indicano comandi da copiare. Per eseguirne uno:

Selezionare il comando nella pagina e copiarlo (Ctrl+C; in macOS Cmd+C).
Passare alla finestra del terminale e incollarlo.
- Nel terminale di Linux: Ctrl+Shift+V.
- Nel Terminale di Windows: clic con il tasto destro del mouse nella finestra, oppure Ctrl+Shift+V.
- Nel Terminale di macOS: Cmd+V.
Premere Invio per eseguire il comando.

Verifica prima di proseguire

Il terminale mostra una riga che termina con il simbolo del prompt ($) e che comincia con il nome utente, la chiocciola e il nome del computer:

<utente>@biblioviva:~ $

Il terminale è pronto: i comandi dei passi successivi si incollano qui. Quando la riga non compare, si veda "Possibili problemi".

Possibili problemi

"Connection refused" (connessione rifiutata): il PC o il Raspberry Pi non è ancora pronto, oppure SSH non è attivo. Attendere alcuni minuti e riprovare. Se il messaggio resta, per il PC installare il server SSH (sudo apt install -y openssh-server); per il Raspberry Pi ripetere la scrittura della scheda attivando SSH.
"Permission denied, please try again" (password sbagliata): digitare di nuovo la password con attenzione, badando alla disposizione della tastiera (maiuscole, simboli). Dopo tre tentativi falliti il programma si ferma: ripetere il comando.
"Could not resolve hostname biblioviva.local" (nome non trovato): il computer non risponde al nome. Controllare che sia acceso e collegato alla stessa rete, poi usare l'indirizzo che mostra il router.
"Connection timed out": l'indirizzo non è quello del computer o il computer non è raggiungibile. Controllare l'indirizzo nell'elenco del router.
"REMOTE HOST IDENTIFICATION HAS CHANGED": la scheda del Raspberry Pi è stata riscritta e il nome è già noto con un'altra chiave. Eliminare la vecchia chiave con il comando seguente e ripetere il collegamento.
```
ssh-keygen -R biblioviva.local
```

Altri problemi: Problemi comuni.

Pagine correlate

Passo precedente: Preparare il computer
Passo successivo: Preparare la rete
Glossario