Mailix の更新は更新パッケージ mailix-update-<version>.zip として提供されます。内容は同じバージョンのインストールパッケージと同じです。更新ではアプリケーションのファイルが置き換えられ、設定ファイルとすべてのユーザーデータはそのまま保持されます。
新しいバージョンが公開されたとき
ライセンスの cron ジョブが、新しい Mailix が公開されているかを ARN に問い合わせます (有効なライセンスのみ)。新しいバージョンは、cPanel アカウントの所有者と会社の AI 管理者に向けて 設定 → Mailix → 会社概要 に表示されます。更新があります、バージョン、リリースノート、そして ARN Smart が指定した場合は 重要な更新 が表示されます。root には新しいバージョンごとに cron メールが1通届きます。Mailix が自動で更新をインストールすることはありません。
mailix-update で更新する
root として次を実行します:
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-update check
/usr/local/cpanel/base/3rdparty/mailix/bin/mailix-update install
install は開始前に確認を求めます。--yes を指定すると確認を省略します。このコマンドは ARN から HTTPS 経由でのみパッケージをダウンロードし、サイズ、SHA-256、署名付き応答、ARN Smart のリリース署名を検証したうえで、実行中のバージョンと config.php を /root/mailix-releases/ に保存し、新しいバージョンのインストールスクリプトを実行します。失敗した場合は、以前のバージョンが再インストールされます。Mailix 1.2.9 以降では、SSH 接続が切れてもインストールスクリプトは実行を続けます。出力は /root/mailix-releases/ 内のログファイルに書き込まれ、終了時に表示されます。リリースノートを読んでいる間にダウンロードリンクの有効期限が切れた場合、コマンドは同じバージョンを ARN にもう一度要求します。
手動で更新する前に
- 設定ファイルと Mailix のデータをバックアップします (下記の「バックアップする内容」を参照)。
- ARN Smart から新しいバージョンの更新パッケージを入手しておきます。
サーバー全体のインストールを手動で更新する
更新パッケージを新しい空のフォルダーに展開し、root としてインストールスクリプトを再度実行します:
mkdir -p /root/mailix-1.2.9
unzip mailix-update-1.2.9.zip -d /root/mailix-1.2.9
cd /root/mailix-1.2.9
bash cpanel/install.sh
スクリプトは、パッケージを展開したフォルダーからのみ実行し、/usr/local/cpanel/base/3rdparty/mailix にあるインストール済みのコピーからは決して実行しないでください。Mailix 1.2.9 以降では、安全に処理できない 2 つのケース(他のファイルを含むフォルダー、またはインストール済みのコピー)のいずれでも、何も変更せずに停止します。
スクリプトはアプリケーション全体を置き換えるため、新しいバージョンに存在しないファイルは残りません。config/config.php は保持され、Mailix 1.2.5 以降はライセンスも保持されます。アプリのマニフェストとスタートページは再公開され、バックアップ除外の行は存在しない場合にのみ追加されます。
ユーザーは次にページを読み込んだときに新しいバージョンを利用できます。Mailix はバージョン付きのアドレスからスクリプトを読み込むため、ブラウザーや cPanel のキャッシュに古いファイルが残ることはありません。
スタンドアロンのインストールを更新する
更新パッケージを既存のファイルに上書きして展開します。config/config.php とストレージフォルダーはパッケージに含まれていないため、そのまま残ります。
更新後
Mailix を開き、設定 → Mailix → 会社概要 を確認します。バージョン に新しいバージョン番号が表示されます。
バックアップする内容
| 対象 | 場所 | 理由 |
|---|---|---|
| 設定 | config/config.php | サーバーのオプション |
| Mailix のデータ (サーバー全体) | 各 cPanel アカウントの ~/.mailix | 設定、Mailix に保存された連絡先、2段階認証、会社の AI アカウント |
| Mailix のデータ (スタンドアロン) | storage_dir フォルダー | すべてのメールボックスの同じデータ |
| ライセンス (サーバー全体、1.2.5 以降) | /etc/mailix/licence.json | サーバーのライセンス認証 |
重要: ストレージのルートにある
2fa-secret.keyファイルを、各メールボックスの2fa.jsonファイルと一緒にバックアップしてください。このキーで2段階認証のシークレットを復号します。キーがないと、2段階認証を使っているメールボックスはリカバリーコードでしかサインインできません。
作成済みのアーカイブ (~/.mailix/users/*/archive) はメールボックス自身のメールのコピーで、72時間後に削除されるため、バックアップには不要です。インストールスクリプトは cPanel のアカウントバックアップからこれらを除外します。その他のバックアップツールでは、ご自身で除外してください。
サーバーから Mailix を削除する
展開した Mailix フォルダーで、root として次を実行します:
bash cpanel/uninstall.sh
スクリプトはサーバーと cPanel の Webmail 画面から Mailix を削除し、アプリのマニフェストフォルダーを削除して、cPanel のバックアップ除外リストから Mailix の行を取り除きます。
- 各アカウントの
~/.mailixのデータは保持されます。不要になった場合はご自身で削除してください。 - 毎週の自動返信を使っていたメールボックスでは、アカウントの crontab に
# Mailix weekly automatic replyで終わる行が1行残ります。Mailix がなければ何もせず終了するだけです。cPanel の Cron ジョブ ページで削除できます。 - Mailix 1.2.5 以降: ライセンスの cron ジョブは削除され、
/etc/mailixのライセンスは保持されるため、同じサーバーに再インストールすると再び使用されます。ライセンスを別のサーバーに移す方法は Mailix サーバーライセンスの認証と確認 を参照してください。
スタンドアロンのインストールを削除するには、そのフォルダーと、不要であればストレージフォルダーを削除します。