新しいホームサーバーへのHome Assistant安全移行チェックリスト

エヴァ・ウォンテクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

安全なHome Assistantの移行は、新しいサーバーがログイン画面に到達した時点で完了ではありません。古いサーバーを廃止する前に、新しいホストで同じ設定、無線機器、統合、ストレージパス、ネットワーク上の識別情報、ローカル制御の動作を復元する必要があります。

移行は、ロールバック用のコピーを利用できる状態で行う復旧テストとして扱ってください。新しいバックアップを作成し、古いサーバーの依存関係を記録してから、移行先で復元し、無線機器とネットワークストレージを再接続し、重要な自動化をテストします。その後、新しい環境が通常利用と再起動に耐えるまで、元のサーバーは電源を切ったまま完全な状態で保持してください。

完全バックアップを新たに作成し、復旧キーを古いホストの外部に保管する

Home Assistantの現在のバックアップワークフローでは、異なる種類のデバイス間を含め、オンボーディング中に移行できます。開始前に、移行先に十分なストレージがあることを確認し、バックアップをダウンロードするなどして保存してください。また、バックアップを復号するために必要な緊急キットは、交換対象のマシンとは別の場所に保管してください。

現在のHome Assistantの移行手順では、新しいデバイスのオンボーディング中に古いデバイスのバックアップを使用します。また、ネットワークストレージと無線機器の移行には、追加の作業が必要になる場合があると明記されています。

移行中に唯一のバックアップを上書きしないでください。少なくとも1つは両方のサーバーから独立したコピーを保持してください。そうすれば、移行先ディスクの故障や誤ったリセットによって、復旧元のバックアップと元のインストールが同時に失われる事態を防げます。

バックアップでは物理的に移行されない依存関係を記録する

バックアップはHome Assistantの状態を保持できますが、USB ZigbeeまたはZ-Waveスティック、ネットワークケーブル、UPS接続、外部データベースホスト、MQTTブローカー、リバースプロキシ、NAS共有、ルーターの予約設定を物理的に移動することはできません。古いホストの電源を切る前に、これらの依存関係を書き出してください。

古いHome AssistantのIPアドレスまたはホスト名、外部URL、ネットワークストレージのマウント、Recorderが外部データベースを使用している場合のデータベースURL、ブローカーのアドレス、USBデバイス、無線の種類、ホスト側のComposeまたはVM設定を記録します。この一覧があれば、復元の失敗と外部依存関係の欠落を区別できます。

より広範なZimaSpaceの移行チェックリストでも同じ原則が適用されています。つまり、移行元を保護し、対象範囲を明確にし、移行先を検証し、通常利用が確認できるまで古いコピーを保持します。

ZigbeeとZ-Waveネットワークは個別の移行手順として扱う

同じUSB無線機器を新しいホストへ移動する場合は、再接続してデバイスパスを確認してください。新しいサーバーで内蔵無線機器や交換用無線機器を使用する場合は、Home Assistantのバックアップだけでコーディネーターの識別情報が変わると考えず、無線ネットワーク自体を移行してください。

ZHAはネットワークバックアップを自動的に作成し、メッシュ全体を再ペアリングせずに、サポート対象の別のコーディネーターへZigbeeネットワークを移行できます。移行プロセスでは、必要に応じて無線機器のIEEE識別情報も転送されます。

Z-Waveには別個のコントローラー状態があります。最近のZ-Wave JS UIの移行に関する議論では、Z-Waveサービスを新しいハードウェアへ移行する際、サービスのストアとNVMバックアップが重要な復旧資産であることが確認されています。両方の無線ネットワークを、それぞれ固有の復旧手順を持つ資産として扱ってください。

まず復元し、その後に外部ストレージとネットワークサービスを再接続する

ルーター、DNS、NASの権限、複数のサービスアドレスを同時に変更する前に、バックアップから移行先のHome Assistantインスタンスを起動してください。新しいホストと古いホストの違いを一度に1つの主要な変数に絞ると、移行の問題を診断しやすくなります。

古いインストールでネットワークストレージを使用していた場合は、復元後に再接続し、想定していた共有名と認証情報を確認してください。外部データベースまたはMQTTブローカーを使用していた場合は、すでに正常に動作していたHome Assistantの設定を変更する前に、新しいホストからDNSとTCPの接続性をテストしてください。

アプリケーションの状態は移行できますが、ホスト固有の依存関係は正しく再作成する必要があります。Home Assistantのバックアップで物理的に移動できないもの、つまり無線機器、ホストのネットワーク設定、外部ストレージ、データベースサービス、ブローカーのエンドポイント、古いサーバーが管理していたデプロイ設定に重点を置いて、移行記録を作成してください。

古いサーバーを廃止する前に受け入れテストを実施する

  • 想定していたユーザー、ダッシュボード、統合、ヘルパー、自動化、エリアが存在することを確認する。
  • 重要なローカル自動化を1つ実行し、実際のデバイスからフィードバックが返ることを確認する。
  • Zigbee、Z-Wave、Bluetooth、その他の無線デバイスが利用可能であることを確認する。
  • Recorderの履歴と統計が正常に書き込まれていることを確認する。
  • ネットワークストレージのパスを1つテストし、使用している場合はMQTTなどの外部依存関係も1つテストする。
  • ローカルアクセスとリモートアクセスを個別にテストする。
  • 新しいHome Assistantホストを一度再起動し、重要なローカル制御のテストを繰り返す。

この2回目の起動テストに合格して初めて、古いサーバーの消去または再利用を検討してください。それまでは、元のインストールを電源オフにし、競合する無線機器やIPアドレスから切り離した状態で、ロールバック用の参照環境として利用できるよう保持してください。

サポートとヒント

もっと読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.