バックアップを復元する

Looker バックアップの作成については、バックアップの作成についてのドキュメント ページをご覧ください。

Looker を新しいホストに復元するには、Looker インストール手順の以下のステップのみを行います。

  • 新しいサーバーが最小サーバー仕様に準拠していることを確認します。
  • ntpd または chronyd を有効にします。
  • Looker のユーザー、グループ、ホーム ディレクトリを作成します。
  • Looker アプリケーションのダウンロードと残りのすべてのインストール手順をスキップします。

新しいホストの準備が整ったら、次の手順を行います。

  • バックアップからファイルを復元します。
  • Looker を起動します:

    sudo su - looker
    cd looker
    ./looker start
    

クラスタ環境

クラスタ環境の MySQL データベースを復元するには:

  • クラスタ内で実行中の Looker をすべて停止します。
  • データベースを復元します。
  • Looker インスタンスを 1 つずつ起動します。

MySQL データベースを復元する方法の詳細については、MySQL のドキュメントをご覧ください。

キーストアに依存しないバックアップの復元

AES-256 GCM 暗号化に移行され、キーストアに依存しないバックアップを生成したセルフホスト型のインストールでは、復元を実行した後、Looker の内部データベースを更新する必要があります。

キーストアに依存しないバックアップを復元したら、次の手順に従って KEK を復号し、新しいローカル キーストアを使用して KEK を再暗号化し、内部データベースの鍵エントリを更新します。

  1. Looker を停止します。

    cd looker
    ./looker stop
    

    Looker がクラスタ化されている場合は、作業を続行する前にすべてのノードを停止してください。

    後で restore_dr_backup コマンドを発行するときにノードが実行されていると、このコマンドは失敗し、「このバックエンド Looker データベースに接続されている他のライブノードがあります。Looker が過去 1 分以内にシャットダウンされた場合は、しばらくしてからもう一度お試しください。それ以外の場合は、クラスタ内のすべてのノードがシャットダウンしていることを確認してください」というエラー メッセージが表示されます。

  2. Looker が、Looker を復元した場所のローカル キーストアで使用される CMK にアクセスできることを確認します。復元場所の CMK がファイルに格納されている場合は、環境変数 LKR_MASTER_KEY_FILE を使用して CMK ファイルのパスを指定できます。

    export LKR_MASTER_KEY_FILE=<path_to_CMK_file>
    

    復元場所の CMK を環境変数に直接指定する場合は、LKR_MASTER_KEY_ENV 環境変数を使用します。

    export LKR_MASTER_KEY_ENV=<CMK_value>
    
  3. 内部データベースを更新します。

    ./looker restore_dr_backup <path_to_CMK_file>
    

    ここで、<path_to_CMK_file> は、キーストアに依存しないバックアップを取ったときに作成されたプレーン テキストの鍵ファイルのパスとファイル名です。鍵ファイルの形式は次のとおりです。

    {"dbmk":"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\n","backup_uid":"XCXvRa38mNeqT6+HRBCo2Q=="}
    

    ここで、dbmk の値は、Base64 エンコードの 256 ビット暗号鍵であり、backup_uid は鍵をデータベースに保存するときに使用する一意の名前です。

Looker の内部データベースを更新したら、通常どおり Looker を起動できます。Looker を実行したら、キーストアに依存しないバックアップの作成に使用した平文の鍵ファイルを削除することをおすすめします。