新しいバージョンへの更新
更新で置き換わるのはプログラムだけです。設定、クレジット、共有ファイルの履歴、未完了のダウンロード、完了したファイルは、新バージョンが上書きしない場所に保存されているため、ほとんどの環境では旧バージョンの上から新バージョンをインストールするだけで更新できます。例外は Windows ZIP 版です。この版ではデータがプログラムフォルダ内にあるため、展開する前に該当セクションをお読みください。
データの保存場所
| 実行環境 | プログラム | データ |
|---|---|---|
| Windows インストーラー | C:\Program Files\eMule Qt |
%LOCALAPPDATA%\eMuleQt(内部に Incoming と Temp を含む) |
| Windows ZIP(ポータブル版) | 展開した eMule フォルダ |
同じフォルダ:emuleqt.exe の隣に config、Incoming、Temp |
| macOS | アプリケーション内の emuleqt.app |
~/eMuleQt/Config、~/eMuleQt/Incoming、~/eMuleQt/Temp |
| Linux | tarball の eMuleQt フォルダ |
~/eMuleQt/Config、~/eMuleQt/Incoming、~/eMuleQt/Temp |
| Docker | イメージ | /config と /data のボリューム |
オプションで Incoming、Temp、共有フォルダを別の場所に移した場合、それらは指定した場所に残ります。更新で触れられることはありません。
更新前の準備
- eMule Qt とコアを終了します。ウィンドウとコア(
emulecored)は別々のプログラムです。ステータスバーの鎖アイコンが切れている場合、コアは切り離された状態で、ウィンドウを閉じても動き続けます。タスクマネージャー、アクティビティモニタ、またはpgrep emulecoredでemulecoredが残っていないことを確認してください。 - config フォルダをバックアップします。サイズは小さく、コピーしても負担になりません。通常の更新であれば、Temp 内の未完了ダウンロードのバックアップは不要です。
Windows インストーラー
- 新しいセットアップをダウンロードします(
eMuleQt-vX.Y.Z-win64-setup.exe)。入手先はダウンロードページです。 - 実行します。旧バージョンのインストール先が検出され、同じフォルダに新バージョンが入ります。起動中の eMule Qt とコアは自動的に終了されます。
- 「eMule から設定をインポート」はオフのままにします。更新時は、eMule Qt のプロファイルがすでに使われているため、初期状態でオフになっています。
- eMule Qt を起動します。
先にアンインストールする必要はありません。アンインストールした場合でも、アンインストーラーは %LOCALAPPDATA%\eMuleQt には触れません。
Windows ZIP(ポータブル版)
ポータブル版では、config フォルダはプログラムフォルダ内にあり、ZIP にも独自の config フォルダが含まれています。ZIP の config フォルダの内容は次のとおりです。
- 置き換えるべきプログラムファイル:
eMule.tmpl、webserverフォルダ、nodes.ed3knod、GeoLite2-Country.mmdb。 - 自分のコピーを残すべき初期ファイル:
server.met、nodes.dat、webservices.dat、FakeFileFilter.dat。ZIP で上書きされると、サーバーリストと Kad のコンタクトが同梱の状態に戻ります。動作に支障はありませんが、蓄積してきたリストは失われます。
個人用ファイルは ZIP に一切含まれていません:preferences.yml、preferences.dat、cryptkey.dat、clients.met、known.met、Temp 内の .part ファイル、完了したダウンロード。展開してもこれらに影響はありません。
更新の手順
- eMule Qt とコアを終了します(上記参照)。
- 新バージョンを一時フォルダに展開します。現在のインストール先には直接展開しないでください。
- 一時フォルダ内の
eMule\configから次のファイルを削除します:server.met、nodes.dat、webservices.dat、FakeFileFilter.dat。 - 一時フォルダ内の
eMuleフォルダの中身をすべて、既存のeMuleフォルダにコピーします。ファイルの置き換えを確認してください。 - eMule Qt を起動し、一時フォルダを削除します。
config だけをコピーしたくなるかもしれませんが、やめてください。未完了のダウンロードは Temp、完了したファイルは Incoming にあり、どちらも旧フォルダ内で、preferences.yml にはそれらのフルパスが保存されています。新しいフォルダではダウンロードリストが空の状態で始まるか、気付かないうちに旧フォルダを使い続けることになります。どうしてもインストール先を移したい場合は、フォルダ全体を移動し、その後オプションでディレクトリを確認してください。config\webserver 内の Web インターフェースのファイルを変更している場合は、更新で置き換えられるため、先にバックアップしてください。
macOS
- eMule Qt とコアを終了します(上記参照)。
- 新しいディスクイメージを開きます。Apple シリコンは
eMuleQt-vX.Y.Z-macOS-arm64.dmg、Intel はeMuleQt-vX.Y.Z-macOS-x86_64.dmgです。 - eMule Qt をアプリケーションにドラッグし、置き換えるを選びます。
- eMule Qt を起動します。
~/eMuleQt のデータはアプリの外にあり、そのまま残ります。
Linux
- eMule Qt とコアを終了します(上記参照)。
- 新しい tarball を旧バージョンと同じ場所に展開し、古い
eMuleQtフォルダを上書きします:tar xzf eMuleQt-vX.Y.Z-linux-x86_64.tar.gz - eMule Qt を起動します。パスが変わらないため、メニュー項目とファイルの関連付けはそのまま使えます。
~/eMuleQt、データは ~/eMuleQt/Config、Incoming、Temp です。更新前に古いプログラムフォルダを削除すると、これらもすべて消えてしまいます。tarball には Config、Incoming、Temp フォルダが含まれていないため、上書き展開なら常に安全です。小文字の config フォルダには同梱の初期設定が入っていますが、eMule Qt が変更済みのファイルに上書きコピーすることはありません。新バージョンを別の場所に展開した場合は、その場所から一度起動すると、eMule Qt がメニュー項目を新しいパスに更新します。
Docker
新しいイメージを pull し、コンテナを再作成します。データはボリュームに保存されています。
- Docker Compose:
docker compose pull && docker compose up -d - 通常の Docker:
docker pull ghcr.io/moddermule/emuleqt:latestを実行し、古いコンテナを削除して、同じ-vオプションで新しいコンテナを起動します。
新バージョンの通知について
eMule Qt は新バージョンを自動的に確認し、変更内容とダウンロードページへのリンクを表示するボックスを出します。すぐに確認したい場合は ツール → リンク → バージョンチェック を使ってください。ボックスに更新が必須と表示された場合、お使いのバージョンには既知の重大なバグがあり、更新するまで eMule Qt は終了します。
サーバーや NAS 上でウィンドウなしで動作するコアは、自力で更新をインストールできます。emulecored --autoupdate として起動してください。新しいリリースをダウンロードして検証し、このページで説明している方法でインストールします。ポータブル版でも自分の config ファイルは保持され、同じオプションで再起動します。Docker コンテナは自動更新されません。代わりに新しいイメージを pull してください。