Versies bijwerken

Bijwerken naar een nieuwe versie

Een update vervangt alleen het programma. Je instellingen, credits, geschiedenis van gedeelde bestanden, onvoltooide downloads en voltooide bestanden staan op een plek die de nieuwe versie niet overschrijft. Op de meeste systemen betekent bijwerken dus dat je de nieuwe versie over de oude heen installeert. De Windows-ZIP is de enige uitzondering: daar staan je gegevens in de programmamap, dus lees dat gedeelte voordat je iets uitpakt.

Waar je gegevens staan

Je gebruikt Programma Je gegevens
Windows-installatieprogramma C:\Program Files\eMule Qt %LOCALAPPDATA%\eMuleQt, met Incoming en Temp erin
Windows-ZIP (portable) De eMule-map die je hebt uitgepakt Dezelfde map: config, Incoming en Temp naast emuleqt.exe
macOS emuleqt.app in Programma’s ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Linux De eMuleQt-map uit de tarball ~/eMuleQt/Config, ~/eMuleQt/Incoming, ~/eMuleQt/Temp
Docker De image De volumes /config en /data

Als je Incoming, Temp of je gedeelde mappen via Opties naar een andere plek hebt verplaatst, blijven ze waar jij ze hebt neergezet. Geen enkele update raakt ze aan.

Vóór elke update

  1. Sluit eMule Qt en de core af. Het venster en de core (emulecored) zijn twee programma’s. Als het ketting-pictogram in de statusbalk verbroken is, is de core losgekoppeld en blijft hij draaien nadat je het venster sluit. Controleer of er geen emulecored meer draait in Taakbeheer, Activiteitenweergave of met pgrep emulecored.
  2. Maak een back-up van je config-map. Die is klein en een kopie kost niets. Onvoltooide downloads in Temp hoeven bij een gewone update niet te worden geback-upt.

Windows-installatieprogramma

  1. Download de nieuwe setup (eMuleQt-vX.Y.Z-win64-setup.exe) van de downloadpagina.
  2. Voer hem uit. Hij vindt de oude installatie en zet de nieuwe versie in dezelfde map. Een draaiende eMule Qt en de bijbehorende core worden voor je afgesloten.
  3. Laat “Instellingen importeren uit eMule” uitgevinkt. Bij een update staat die standaard uit, omdat je eMule Qt-profiel al in gebruik is.
  4. Start eMule Qt.

Je hoeft niet eerst te verwijderen. Ook als je dat wel doet, laat het verwijderprogramma %LOCALAPPDATA%\eMuleQt met rust.

Windows-ZIP (portable)

In de portable versie staat je config-map in de programmamap, en de ZIP bevat zelf ook een config-map. Dit staat er in de config-map van de ZIP:

  • Programmabestanden die vervangen moeten worden: eMule.tmpl, de map webserver, nodes.ed3knod en GeoLite2-Country.mmdb.
  • Startbestanden waarvan je je eigen kopie moet bewaren: server.met, nodes.dat, webservices.dat en FakeFileFilter.dat. Als de ZIP ze overschrijft, gaan je serverlijst en Kad-contacten terug naar de meegeleverde versies. Er gaat niets stuk, maar je verliest de lijsten die je hebt opgebouwd.

Geen van je persoonlijke bestanden zit in de ZIP: preferences.yml, preferences.dat, cryptkey.dat, clients.met, known.met, de .part-bestanden in Temp en je voltooide downloads. Uitpakken kan ze niet aantasten.

Hoe je bijwerkt

  1. Sluit eMule Qt en de core af (zie hierboven).
  2. Pak de nieuwe versie uit in een tijdelijke map, niet over je installatie heen.
  3. Verwijder in de tijdelijke map eMule\config de bestanden server.met, nodes.dat, webservices.dat en FakeFileFilter.dat.
  4. Kopieer alles uit de tijdelijke eMule-map over je bestaande eMule-map en bevestig dat bestanden worden vervangen.
  5. Start eMule Qt en verwijder daarna de tijdelijke map.
.:Werk ter plekke bij, verplaats niets
Het is verleidelijk om in een nieuwe map uit te pakken en alleen config over te zetten. Doe dat niet. Je onvoltooide downloads staan in Temp en je voltooide bestanden in Incoming, beide in de oude map, en preferences.yml slaat hun volledige paden op. Een nieuwe map begint met een lege downloadlijst, of blijft zonder dat je het merkt de oude map gebruiken. Wil je de installatie echt verplaatsen, verplaats dan de hele map en controleer daarna de mappen onder Opties.

Als je de webinterfacebestanden in config\webserver hebt aangepast, maak dan eerst een back-up: de update vervangt ze.

macOS

  1. Sluit eMule Qt en de core af (zie hierboven).
  2. Open het nieuwe schijfkopie: eMuleQt-vX.Y.Z-macOS-arm64.dmg voor Apple silicon of eMuleQt-vX.Y.Z-macOS-x86_64.dmg voor Intel.
  3. Sleep eMule Qt naar Programma’s en kies Vervang.
  4. Start eMule Qt.

Je gegevens in ~/eMuleQt staan buiten de app en blijven ongewijzigd.

Linux

  1. Sluit eMule Qt en de core af (zie hierboven).
  2. Pak de nieuwe tarball uit op dezelfde plek als de oude, zodat de oude eMuleQt-map wordt overschreven: tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz
  3. Start eMule Qt. Je menu-item en bestandstypen blijven werken omdat het pad niet is veranderd.
.:Verwijder niet eerst de oude map
Als je de tarball in je thuismap hebt uitgepakt, delen het programma en je gegevens één map: het programma is ~/eMuleQt en je gegevens zijn ~/eMuleQt/Config, Incoming en Temp. Als je de oude programmamap vóór de update verwijdert, verdwijnt dat allemaal ook. Eroverheen uitpakken is altijd veilig, omdat de tarball geen mappen Config, Incoming of Temp bevat. De config-map met kleine letters bevat de meegeleverde standaardwaarden, en eMule Qt kopieert die nooit over bestanden die je hebt aangepast.

Pak je de nieuwe versie wel ergens anders uit, start hem dan één keer vanaf die plek, dan werkt eMule Qt zijn menu-item bij naar het nieuwe pad.

Docker

Haal de nieuwe image op en maak de container opnieuw aan. Je gegevens staan in de volumes:

  • Docker Compose: docker compose pull && docker compose up -d
  • Gewone Docker: docker pull ghcr.io/moddermule/emuleqt:latest, verwijder daarna de oude container en start een nieuwe met dezelfde -v-opties.

Hoe je van een nieuwe versie hoort

eMule Qt controleert zelf op nieuwe versies en toont een venster met wat er is veranderd en een link naar de downloadpagina. Om direct te controleren, gebruik je Extra → Links → Versiecontrole. Als het venster meldt dat een update vereist is, bevat je versie bekende ernstige bugs en sluit eMule Qt af totdat je bijwerkt.

Een core die zonder venster draait, op een server of NAS, kan zelf updates installeren: start hem als emulecored --autoupdate. Hij downloadt elke nieuwe release, controleert die, installeert hem zoals op deze pagina beschreven, houdt ook bij een portable installatie je eigen config-bestanden intact en start opnieuw met dezelfde opties. Docker-containers werken zichzelf niet bij: haal in plaats daarvan de nieuwe image op.

 

Terug naar Help