Versionen aktualisieren

Auf eine neue Version aktualisieren

Ein Update ersetzt nur das Programm, sonst nichts. Deine Einstellungen, Credits, den Verlauf freigegebener Dateien, unfertige Downloads und fertige Dateien speichert eMule Qt an einem Ort, den die neue Version nicht überschreibt. Auf den meisten Systemen genügt es daher, die neue Version über die alte zu installieren. Die Ausnahme ist das Windows-ZIP: Dort liegen deine Daten im Programmordner, lies also den passenden Abschnitt, bevor du etwas entpackst.

Wo deine Daten liegen

Du verwendest Programm Deine Daten
Windows-Installer C:\Program Files\eMule Qt %LOCALAPPDATA%\eMuleQt, darin Incoming und Temp
Windows-ZIP (portabel) Der entpackte eMule-Ordner Derselbe Ordner: config, Incoming und Temp neben emuleqt.exe
macOS emuleqt.app in Programme ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Linux Der eMuleQt-Ordner aus dem Tarball ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Docker Das Image Die Volumes /config und /data

Wenn du Incoming, Temp oder deine freigegebenen Ordner in den Optionen an einen anderen Ort verschoben hast, bleiben sie dort. Kein Update fasst sie an.

Vor jedem Update

  1. Beende eMule Qt und den Core. Das Fenster und der Core (emulecored) sind zwei getrennte Programme. Ist das Kettensymbol in der Statusleiste unterbrochen, ist der Core getrennt und läuft weiter, wenn du das Fenster schließt. Prüfe im Task-Manager, in der Aktivitätsanzeige oder mit pgrep emulecored, dass kein emulecored mehr läuft.
  2. Sichere deinen Config-Ordner. Er ist klein, und eine Kopie kostet nichts. Unfertige Downloads in Temp brauchen bei einem normalen Update keine Sicherung.

Windows-Installer

  1. Lade das neue Setup herunter (eMuleQt-vX.Y.Z-win64-setup.exe) von der Download-Seite.
  2. Starte es. Es findet die alte Installation und legt die neue Version im selben Ordner ab. Ein laufendes eMule Qt samt Core wird für dich beendet.
  3. Lass „Einstellungen von eMule importieren“ deaktiviert. Bei einem Update ist die Option standardmäßig nicht angehakt, weil dein eMule-Qt-Profil bereits verwendet wird.
  4. Starte eMule Qt.

Du musst nicht zuerst deinstallieren. Auch wenn du es tust, lässt der Deinstaller %LOCALAPPDATA%\eMuleQt unberührt.

Windows-ZIP (portabel)

In der portablen Version liegt dein config-Ordner im Programmordner, und das ZIP bringt einen eigenen config-Ordner mit. Das steckt im config-Ordner des ZIP:

  • Programmdateien, die ersetzt werden sollen: eMule.tmpl, der Ordner webserver, nodes.ed3knod und GeoLite2-Country.mmdb.
  • Startdateien, von denen du deine eigene Kopie behalten solltest: server.met, nodes.dat, webservices.dat und FakeFileFilter.dat. Wenn das ZIP sie überschreibt, fallen deine Serverliste und deine Kad-Kontakte auf die mitgelieferten zurück. Es geht nichts kaputt, aber die selbst aufgebauten Listen sind weg.

Keine deiner persönlichen Dateien ist im ZIP enthalten: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, die .part-Dateien in Temp und deine fertigen Downloads. Das Entpacken kann sie nicht berühren.

So aktualisierst du

  1. Beende eMule Qt und den Core (siehe oben).
  2. Entpacke die neue Version in einen temporären Ordner, nicht über deine Installation.
  3. Lösche im temporären Ordner eMule\config die Dateien server.met, nodes.dat, webservices.dat und FakeFileFilter.dat.
  4. Kopiere den gesamten Inhalt des temporären eMule-Ordners über deinen bestehenden eMule-Ordner und bestätige das Ersetzen der Dateien.
  5. Starte eMule Qt und lösche dann den temporären Ordner.
.:Am selben Ort aktualisieren, nicht verschieben
Es ist verlockend, in einen frischen Ordner zu entpacken und nur config hinüberzukopieren. Tu das nicht. Deine unfertigen Downloads liegen in Temp und deine fertigen Dateien in Incoming, beide im alten Ordner, und preferences.yml speichert ihre vollständigen Pfade. Ein neuer Ordner startet mit leerer Download-Liste oder nutzt unbemerkt weiter den alten Ordner. Wenn du die Installation wirklich verschieben willst, verschiebe den ganzen Ordner und prüfe danach die Verzeichnisse in den Optionen.

Wenn du die Dateien im Ordner config\webserver für die Weboberfläche geändert hast, sichere sie vorher: Das Update ersetzt sie.

macOS

  1. Beende eMule Qt und den Core (siehe oben).
  2. Öffne das neue Disk-Image: eMuleQt-vX.Y.Z-macOS-arm64.dmg für Apple Silicon oder eMuleQt-vX.Y.Z-macOS-x86_64.dmg für Intel.
  3. Ziehe eMule Qt in den Ordner Programme und wähle Ersetzen.
  4. Starte eMule Qt.

Deine Daten in ~/eMuleQt liegen außerhalb der App und bleiben unverändert.

Linux

  1. Beende eMule Qt und den Core (siehe oben).
  2. Entpacke den neuen Tarball am selben Ort wie den alten, sodass er den alten eMuleQt-Ordner überschreibt: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
  3. Starte eMule Qt. Dein Menüeintrag und die Dateitypen funktionieren weiter, weil sich der Pfad nicht geändert hat.
.:Lösche nicht zuerst den alten Ordner
Wenn du den Tarball in deinen Home-Ordner entpackt hast, teilen sich Programm und Daten einen Ordner: Das Programm liegt in ~/eMuleQt, deine Daten in ~/eMuleQt/Config, Incoming und Temp. Würdest du den alten Programmordner vor dem Update löschen, wäre alles davon ebenfalls weg. Darüber zu entpacken ist immer sicher, denn der Tarball enthält keine Ordner Config, Incoming oder Temp. Sein kleingeschriebener Ordner config enthält die mitgelieferten Standardwerte, und eMule Qt kopiert sie nie über Dateien, die du geändert hast.

Wenn du die neue Version an einem anderen Ort entpackst, starte sie einmal von dort, dann aktualisiert eMule Qt seinen Menüeintrag auf den neuen Pfad.

Docker

Lade das neue Image und erstelle den Container neu. Deine Daten liegen in den Volumes:

  • Docker Compose: docker compose pull && docker compose up -d
  • Einfaches Docker: docker pull ghcr.io/moddermule/emuleqt:latest, dann den alten Container entfernen und einen neuen mit denselben -v-Optionen starten.

Wie du von einer neuen Version erfährst

eMule Qt prüft selbstständig auf neue Versionen und zeigt ein Fenster mit den Änderungen und einem Link zur Download-Seite. Für eine sofortige Prüfung nutze Extras → Links → Versionsprüfung. Steht in dem Fenster, dass ein Update erforderlich ist, hat deine Version bekannte schwere Fehler, und eMule Qt beendet sich, bis du aktualisierst.

Ein Core, der ohne Fenster auf einem Server oder NAS läuft, kann Updates selbst installieren: Starte ihn als emulecored --autoupdate. Er lädt jedes neue Release herunter, prüft es, installiert es so, wie diese Seite es beschreibt, behält dabei auch in einer portablen Installation deine eigenen Config-Dateien und startet mit denselben Optionen neu. Docker-Container aktualisieren sich nicht selbst: Lade stattdessen das neue Image.

 

Zurück zur Hilfe