メインコンテンツへスキップ

Unraid のアップグレード

Unraid OS をアップグレードすると、最新の機能、セキュリティ更新、およびハードウェアサポートを利用できます。このページでは、標準的なアップグレード手順と、トラブルシューティングのヒントおよび手動アップグレードのオプションについて説明します。

:::note[Prerequisites]

アップグレードを始める前に、USB フラッシュデバイスの完全なバックアップを作成してください。詳細は、フラッシュデバイスのバックアップ を参照してください。

:::

Best アップグレード前の手順
  1. フラッシュドライブと重要なデータをバックアップします。
  2. インストール予定のバージョンのリリースノートを確認します。
  3. すべてのプラグインを最新バージョンに更新します。
  4. 必要に応じて、次に進む前にアレイを停止します。
  5. Tools → Update OS ページを使用して Unraid OS を更新 します。
  6. アップグレードを完了するには、サーバーを再起動します。

標準アップグレード手順​

Unraid のアップグレードは、ユーザーフレンドリーなインターフェースを備えた新しい Update OS tool を使用して行います:

  1. WebGUI で、右上のドロップダウンメニューをクリックして Check for Update を選択するか、Tools → Update OS に移動します。
  2. 安定版リリースには Stable チャンネルを、ベータ版および RC には Next チャンネルを選択してください。
  3. View Changelog to Start Update をクリックします。Continue を押す前に、変更履歴が表示されるので確認してください。
  4. 最新の安定版リリースを適用するには、Confirm and start update をクリックします。
  5. プロンプトが表示されたら、サーバーを再起動してアップグレードを完了します。
注記

特に「Next」ブランチのリリースでは、更新にアクセスするために Unraid アカウントへのログインが必要になる場合があります。

ZFS プールのアップグレードに関する警告

Unraid 7.x にアップグレードすると、起動時または WebGUI で ZFS プール機能のアップグレードに関する警告が表示される場合があります。これらの警告は問題を示すものではなく、ZFS プールが古いバージョンの ZFS の機能を使用していることを示しているだけです。

プールのアップグレードは緊急ではありませんが、アップグレードする場合は、以前の Unraid バージョンでは動作しない可能性があることに注意してください。つまり、アップグレード後に以前の Unraid バージョンへ戻せない場合があります。

いつもどおり、ZFS プールをアップグレードする前にデータをバックアップすることを忘れないでください。

アップグレードの問題のトラブルシューティング​

アップグレード後に問題が発生した場合は、以下の該当する項目を参照してください。

アップグレード後にアレイまたは Docker コンテナの起動が遅い - クリックして展開/折りたたむ

特定のアップグレード後には、Docker コンテナの一度限りの移行が必要になる場合があります。この処理には時間がかかることがあり、特にイメージが多数ある場合はなおさらです。この処理中はしばらくお待ちください。最初の起動後にパフォーマンスは通常どおりに戻ります。

アップグレード後に Docker コンテナが正しく動作しない - クリックして展開/折りたたむ

「layers from manifest don't match image configuration」 のようなエラーが発生した場合は、Docker イメージファイルを再構築する必要があるかもしれません。手順は次のとおりです:

  1. Settings → Docker に移動し、Docker サービスを停止します。
  2. チェックボックスをオンにして Docker イメージを削除し、削除ボタンをクリックします。
  3. Docker を再起動してイメージを再作成します。
  4. Apps タブの Previous Apps に移動し、再インストールしたい項目にチェックを入れて、"Install xx Applications" をクリックします。
VM に "cannot get interface MTU" またはネットワークエラーが表示される - クリックして展開/折りたたむ

VM ネットワークにカスタムのブリッジ名を使用している場合は、次の手順に従ってすべての VMs をデフォルトの br0 ブリッジに更新してください。

  1. VMs タブに移動し、各 VM を編集します（Advanced View を有効にしてください）。
  2. ネットワークブリッジを br0 に設定し、Apply をクリックします。
  3. Settings → VM Manager（Advanced View で）に移動し、既定のブリッジを br0 に設定します。
VM への VNC アクセスが機能しない、または遅い - クリックして展開/折りたたむ

古い VMs では、VNC のビデオドライバを更新する必要がある場合があります。

  1. VMs タブから VM を編集します（Advanced View を選択）。
  2. VNC Video Driver を QXL（推奨）に設定します。QXL で十分な結果が得られない場合は、Cirrus または vmvga を試してください。
  3. Apply をクリックして変更を保存します。
VM が起動しない（EFI シェルが表示される） - クリックして展開/折りたたむ

If you have OVMF-based VMs created in older Unraid versions, you might encounter an EFI shell. You can boot the VM by entering the following commands:

  1. fs0: と入力します。
  2. 次に cd efi/boot と入力します。
  3. 最後に bootx64.efi と入力します。

fs0: で動作しない場合は、代わりに fs1: を試してください。問題が続く場合は、Unraid forums で सहायताを求めてください。

VM の起動を試みると "Invalid machine type" エラーが表示される - クリックして展開/折りたたむ

これを解決するには、WebGUI で VM を編集し、変更を加えずに Apply をクリックします。この操作により、マシンタイプが最新のサポート版に更新されます。

アップグレード後の VM のパフォーマンスが低い - クリックして展開/折りたたむ

アップグレード後に VM が遅い場合は、VM の設定（Advanced View）を開き、Machine タイプのバージョンを最新のリビジョンに更新してください（例: i440fx-2.5 から i440fx-2.7 に変更）。接頭辞は変更しないでください（たとえば、i440fx から Q35 に切り替えないでください）。

Unraid のダウングレード​

ダウングレードする前に、ダウングレード元のバージョンのリリースノートを必ず読んでください。"Rolling back" という見出しのセクションを探し、必要な重要な手順を確認してください。

WebGUI にアクセスできる場合は、Tools → Downgrade OS に移動できます。このオプションを使うと、Version History ページから zip ファイルをダウンロードしなくても、以前にインストールしていたバージョンにダウングレードできます。

Tools → Downgrade OS にダウングレードのオプションが表示されない場合は、以下に説明する手動の方法を使用してください。これは通常、前のバージョンのファイルがフラッシュドライブにないことを意味します。

手動ダウングレード​

手動ダウングレードが必要なのは、WebGUI にアクセスできない場合、またはダウングレードのオプションが利用できない場合だけです。続行する前に、USB フラッシュデバイスをバックアップすることが重要です。詳細については、フラッシュデバイスのバックアップ を参照してください。

  1. Unraid のバージョン ZIP ファイルを Version History からダウンロードしてください。
  2. ファイルをコンピューターに展開してください。
  3. flash ネットワーク共有（起動ボリュームです。UI に Boot device と表示されていても、共有名は flash のままの場合があります）にアクセスするか、USB 起動デバイスをコンピューターに接続します。
  4. まだ存在しない場合は、previous ディレクトリを作成してください。
  5. すべての bz* ファイルと changes.txt ファイルを previous ディレクトリに移動してください。
  6. 新しい bz* ファイルと changes.txt ファイルを起動ドライブのルートにコピーします。
  7. サーバーを再起動してください。