Guida completa: installare un pacchetto linux (.tar.gz) su WSL - MetCast

Questa guida illustra il metodo corretto per installare un programma fornito come archivio .tar.gz (come OpenGrADS) su WSL (Windows Subsystem for Linux), evitando i comuni problemi di permessi e di percorso. 🐧


L'errore più comune, e la causa di tutti i nostri problemi iniziali, è tentare di eseguire operazioni su file Linux all'interno di una cartella di Windows.

• Percorso sbagliato ❌: /mnt/c/Users/utente/Downloads
  Questo è il tuo disco di Windows. Lavorare qui causa errori di permessi (utime, change mode) perché il file system di Windows (NTFS) non gestisce i permessi come quello di Linux (ext4).
• Percorso corretto ✅: ~ (che sta per /home/utente)
  Questa è la tua cartella home personale all'interno del file system di Linux. Lavorare qui garantisce che i permessi siano gestiti correttamente e le operazioni sui file siano molto più veloci.

Assumiamo che tu abbia già scaricato il file opengrads-2.2.1.oga.1-bundle-x86_64-pc-linux-gnu-glibc_2.17.tar.gz nella cartella Downloads di Windows.


Ogni operazione deve iniziare da qui. Apri il terminale WSL e assicurati di essere nella tua cartella home.

Bash

cd ~ 

• cd: comando per "cambiare directory" (Change Directory).
• ~: una scorciatoia che rappresenta sempre la tua cartella home personale (es. /home/utente).

Ora che sei nel posto giusto, copia il file di installazione dalla cartella Downloads di Windows alla tua posizione attuale.

Bash

cp /mnt/c/Users/utente/Downloads/opengrads-2.2.1.oga.1-bundle-x86_64-pc-linux-gnu-glibc_2.17.tar.gz . 

• cp: comando per "copiare" (Copy).
• /mnt/c/...: il percorso completo del file sorgente su Windows.
• .: significa "qui, nella cartella corrente". È un dettaglio fondamentale.

Scompatta il file .tar.gz. Trovandoti nel file system di Linux, questa operazione non produrrà alcun errore.

Bash

tar -zxvf opengrads-2.2.1.oga.1-bundle-x86_64-pc-linux-gnu-glibc_2.17.tar.gz 

• tar: il programma per gestire gli archivi.
• -z: filtra l'archivio attraverso gzip per decomprimerlo.
• -x: dice a tar di extrarre i file.
• -v: modalità "verbosa", mostra i nomi dei file man mano che vengono estratti.
• -f: indica che l'argomento successivo è il nome del file da processare.

Per mantenere il sistema pulito, sposta la cartella appena estratta nella directory /opt, il luogo standard per i software opzionali installati manualmente.

Bash

sudo mv opengrads-2.2.1.oga.1 /opt/opengrads-2.2.1 

• sudo: esegue il comando con i privilegi di amministratore, necessari per scrivere in cartelle di sistema come /opt.
• mv: comando per "spostare" (MoVe). Sposta la cartella sorgente nella destinazione, rinominandola in modo più semplice.

Passo 5: indica al sistema dove trovare il programma (PATH)

Questo è il passo finale di configurazione. Dobbiamo modificare il PATH, una variabile di sistema che elenca le cartelle in cui il terminale cerca i comandi.

1. Apri il file di configurazione con l'editor di testo nano:
   Bash

   nano ~/.bashrc 

2. Aggiungi la riga corretta in fondo al file. Abbiamo scoperto, tramite ispezione (ls), che il percorso corretto non conteneva bin.
   Bash

   export PATH="/opt/opengrads-2.2.1/Contents:$PATH" 

   • export PATH=...: imposta la variabile PATH.
   • "/opt/...": è il percorso della cartella che contiene l'eseguibile opengrads.
   • :$PATH: è fondamentale. Aggiunge il nuovo percorso a tutti quelli già esistenti, senza sovrascriverli.
3. Salva e chiudi nano con la sequenza: Ctrl+X, poi Y (o S), poi Invio.

Ricarica la configurazione nel terminale attuale e lancia il programma per verificare che tutto funzioni.

1. Attiva le modifiche:
   Bash

   source ~/.bashrc 

   • source: legge ed esegue i comandi contenuti in un file, applicandoli alla sessione corrente.
2. Verifica l'installazione:
   Bash

   opengrads 

Se il prompt cambia in ga->, l'installazione è completata con successo.

Errore	Causa probabile	Soluzione
Cannot utime: Operation not permitted o Cannot change mode: Operation not permitted	Stai eseguendo il comando tar in una cartella di Windows (es. /mnt/c/...).	Copia il file nella tua home di Linux (~) ed estrailo lì. (Passo 1 e 2)
command not found	1. Il percorso nel file .bashrc è sbagliato.<br/>2. Non hai ricaricato la configurazione con source.	1. Ispeziona la cartella con ls -lF per trovare il percorso esatto dell'eseguibile e correggi la riga in .bashrc. (Passo 5)<br/>2. Esegui il comando source ~/.bashrc. (Passo 6)
Impossibile digitare la tilde (~)	La combinazione di tasti non funziona nel terminale WSL.	Scrivi cd , poi copia ~ e incollalo nel terminale con il tasto destro del mouse.