Aggiornare le versioni

Aggiornare a una nuova versione

Un aggiornamento sostituisce solo il programma. Le tue impostazioni, i crediti, la cronologia dei file condivisi, i download incompleti e i file completati sono conservati in una posizione che la nuova versione non sovrascrive, quindi nella maggior parte dei sistemi aggiornare significa installare la nuova versione sopra la vecchia. Lo ZIP per Windows è l’unica eccezione: qui i tuoi dati si trovano dentro la cartella del programma, quindi leggi la sua sezione prima di estrarre qualsiasi cosa.

Dove si trovano i tuoi dati

Cosa usi	Programma	I tuoi dati
Installer per Windows	`C:\Program Files\eMule Qt`	`%LOCALAPPDATA%\eMuleQt`, con `Incoming` e `Temp` all’interno
ZIP per Windows (portable)	La cartella `eMule` che hai estratto	La stessa cartella: `config`, `Incoming` e `Temp` accanto a `emuleqt.exe`
macOS	`emuleqt.app` in Applicazioni	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Linux	La cartella `eMuleQt` del tarball	`~/eMuleQt/Config`, `~/eMuleQt/Incoming`, `~/eMuleQt/Temp`
Docker	L’immagine	I volumi `/config` e `/data`

Se in Opzioni hai spostato Incoming, Temp o le cartelle condivise altrove, restano dove le hai messe. Nessun aggiornamento le tocca.

Prima di ogni aggiornamento

Chiudi eMule Qt e il suo core. La finestra e il core (emulecored) sono due programmi distinti. Se l’icona della catena nella barra di stato è spezzata, il core è scollegato e continua a girare dopo la chiusura della finestra. Controlla che non sia rimasto nessun emulecored in Gestione attività, in Monitoraggio Attività o con pgrep emulecored.
Fai una copia di backup della cartella config. È piccola e una copia non costa nulla. I download incompleti in Temp non richiedono un backup per un normale aggiornamento.

Installer per Windows

Scarica il nuovo setup (eMuleQt-vX.Y.Z-win64-setup.exe) dalla pagina di download.
Eseguilo. Trova la vecchia installazione e mette la nuova versione nella stessa cartella. Se eMule Qt e il suo core sono in esecuzione, vengono chiusi per te.
Lascia deselezionata l’opzione “Importa impostazioni da eMule”. In un aggiornamento parte deselezionata, perché il tuo profilo eMule Qt è già in uso.
Avvia eMule Qt.

Non serve disinstallare prima. Anche se lo fai, il programma di disinstallazione non tocca %LOCALAPPDATA%\eMuleQt.

ZIP per Windows (portable)

Nella versione portable la cartella config si trova dentro la cartella del programma, e lo ZIP ne contiene una propria. Ecco cosa contiene la cartella config dello ZIP:

File del programma da sostituire: eMule.tmpl, la cartella webserver, nodes.ed3knod e GeoLite2-Country.mmdb.
File iniziali di cui dovresti conservare la tua copia: server.met, nodes.dat, webservices.dat e FakeFileFilter.dat. Se lo ZIP li sovrascrive, la tua lista di server e i contatti Kad tornano a quelli forniti. Non si rompe nulla, ma perdi le liste che avevi costruito.

Nello ZIP non c’è nessuno dei tuoi file personali: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, i file .part in Temp e i download completati. Estrarre lo ZIP non può toccarli.

Come aggiornare

Chiudi eMule Qt e il suo core (vedi sopra).
Estrai la nuova versione in una cartella temporanea, non sopra la tua installazione.
Nella cartella temporanea eMule\config, elimina server.met, nodes.dat, webservices.dat e FakeFileFilter.dat.
Copia tutto il contenuto della cartella temporanea eMule sopra la tua cartella eMule esistente e conferma la sostituzione dei file.
Avvia eMule Qt, poi elimina la cartella temporanea.

.:Aggiorna sul posto, non spostare

Viene la tentazione di estrarre in una cartella nuova e copiare solo config. Non farlo. I tuoi download incompleti sono in Temp e i file completati in Incoming, entrambe nella vecchia cartella, e preferences.yml ne memorizza i percorsi completi. Una cartella nuova parte con una lista di download vuota, oppure continua a usare la vecchia cartella senza che te ne accorga. Se vuoi davvero spostare l’installazione, sposta l’intera cartella e poi controlla le directory in Opzioni.

Se hai modificato i file dell’interfaccia web in config\webserver, fanne prima un backup: l’aggiornamento li sostituisce.

macOS

Chiudi eMule Qt e il suo core (vedi sopra).
Apri la nuova immagine disco: eMuleQt-vX.Y.Z-macOS-arm64.dmg per Apple silicon oppure eMuleQt-vX.Y.Z-macOS-x86_64.dmg per Intel.
Trascina eMule Qt in Applicazioni e scegli Sostituisci.
Avvia eMule Qt.

I tuoi dati in ~/eMuleQt sono fuori dall’app e restano come sono.

Linux

Chiudi eMule Qt e il suo core (vedi sopra).
Estrai il nuovo tarball nello stesso posto del vecchio, in modo che sovrascriva la vecchia cartella eMuleQt: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
Avvia eMule Qt. La voce di menu e i tipi di file continuano a funzionare perché il percorso non è cambiato.

.:Non eliminare prima la vecchia cartella

Se hai estratto il tarball nella tua cartella home, il programma e i tuoi dati condividono un’unica cartella: il programma è ~/eMuleQt e i tuoi dati sono ~/eMuleQt/Config, Incoming e Temp. Eliminare la vecchia cartella del programma prima dell’aggiornamento cancellerebbe anche tutto questo. Estrarre sopra è sempre sicuro, perché il tarball non contiene le cartelle Config, Incoming o Temp. La sua cartella config in minuscolo contiene i valori predefiniti forniti, e eMule Qt non li copia mai sopra i file che hai modificato.

Se estrai la nuova versione in un altro posto, avviala una volta da lì e eMule Qt aggiorna la sua voce di menu con il nuovo percorso.

Docker

Scarica la nuova immagine e ricrea il container. I tuoi dati si trovano nei volumi:

Docker Compose: docker compose pull && docker compose up -d
Docker semplice: docker pull ghcr.io/moddermule/emuleqt:latest, poi rimuovi il vecchio container e avviane uno nuovo con le stesse opzioni -v.

Come vieni a sapere di una nuova versione

eMule Qt controlla da solo la disponibilità di nuove versioni e mostra una finestra con le novità e un link alla pagina di download. Per controllare subito, usa Strumenti → Link → Controllo versione. Se la finestra indica che un aggiornamento è obbligatorio, la tua versione ha gravi bug noti e eMule Qt si chiude finché non aggiorni.

Un core che gira senza finestra, su un server o un NAS, può installare gli aggiornamenti da solo: avvialo come emulecored --autoupdate. Scarica ogni nuova release, la verifica, la installa come descritto in questa pagina, conservando i tuoi file di configurazione anche in un’installazione portable, e si riavvia con le stesse opzioni. I container Docker non si aggiornano da soli: scarica invece la nuova immagine.

Torna all’Aiuto