セルフホスト型 Looker インスタンスの更新

最新のバグの修正と新機能にアクセスするには、次の手動手順に沿って、セルフホスト型 Looker インスタンスを更新します。

続行する前に、以前のバージョンにロールバックすると重大な問題が発生する可能性があることに注意してください。元に戻す必要がある場合は、常にバックアップから復元してください。Looker クラスタを運用している場合は、各ノードを 1 つずつ完全に更新します。このプロセスでは、初期設定時にインストールされた起動スクリプトがインスタンスに含まれていることも前提としています。

  1. Looker JAR ファイルのダウンロードのドキュメント ページの説明に沿って、Looker JAR ファイルの最新リリースをダウンロードします。
  2. Looker ユーザーとして、シェルから Looker プロセスを停止します。

    sudo su - looker
    cd /home/looker/looker
    ./looker stop
    

    Looker クラスタを更新する場合は、このプロセスを繰り返して、すべてのノードで Looker が停止するようにします。

  3. 隠しディレクトリを含む Looker ディレクトリ全体をバックアップします(詳細については、バックアップの復元のドキュメント ページをご覧ください)。

  4. Looker のデフォルトのインメモリ データベースを外部 MySQL データベースに移行した場合、または Looker クラスタを更新する場合は、MySQL データベースをバックアップします。

  5. Looker を更新する前に、MySQL サーバー パラメータとバックエンド データベースのデフォルトの照合が utf8mb4_general_ci に設定されていることも確認してください。そうしないと、更新後に照合不一致エラーが表示されることがあります。

  6. looker-x.x.x.jar の名前を looker.jar に、looker-dependencies-x.x.x.jar の名前を looker-dependencies.jar に変更します。looker.jar と looker-dependencies.jar をサーバー ディレクトリ(/home/looker/looker/looker.jar)にコピーします。両方のファイルを同じディレクトリに置く必要があります。

  7. Looker ユーザーとして、シェルから Looker プロセスを開始します。

    Looker クラスタを更新する場合は、1 つのノードのみで Looker プロセスを開始します。最初のノードが更新プロセスを完了するまで、他のノードで Looker を起動しないでください。

    ./looker start
    

    java -jar コマンドを使用して Looker を起動することもできます。コア JAR とともに ./looker ディレクトリにある限り、コア JAR は依存関係 JAR を見つけます。

    さらに、Looker が提供する起動スクリプトを使用する場合は、https://github.com/looker/customer-scripts にある起動スクリプトをご覧ください。

    Looker のバージョンを更新する際、Looker は内部データベースも更新する必要があります。通常、データベースの更新は 5 分未満で完了しますが、Looker の起動プロセスよりも時間がかかる場合があります。内部データベースの更新中に Looker を起動しようとすると、デーモン プロセスが 6 分でタイムアウトし、「Looker 起動のためにタイムアウト待機中」というメッセージが表示されます。

    特に、複数のリリースをスキップしている場合は、更新中に必要な移行に最大 1 時間かかることがあります。このエラー メッセージが表示された場合は、更新が完了して Looker が起動するまで待ちます。更新プロセスがまだ実行中かどうかを確認するには、次のコマンドを使用します。

    ps -f $(pgrep -f -- '-jar looker.jar')
    

    内部データベースの更新中に Looker プロセスを停止して再起動すると、内部データベースが破損する可能性があります。この場合、既存のバックアップから Looker を復元して、更新を再度行います。

  8. Looker クラスタを更新中の場合は、最初のノードが更新プロセスを完了するまで待ってから、他のノードで Looker を起動します。