Looker インスタンスを更新する前に、Looker インスタンスのバックアップを作成することをおすすめします。手順については、バックアップの作成のドキュメント ページをご覧ください。
セルフホスト型デプロイの Looker アプリケーションをインストールまたは更新するには、Looker JAR ファイルをダウンロードする必要があります。このページでは、Looker JAR ファイルをダウンロードするための 2 つの方法について説明します。
JAR ファイルをダウンロードする前に、このページに記載されている仕様に沿って Looker JAR ファイルのダウンロードウェブページにある、エンドユーザー契約（EULA）に同意していただく必要があります。JAR ファイルをダウンロードする各ユーザーは、この EULA を 1 回のみ受け入れる必要があります。（今後 EULA が更新されると、各ユーザーも新しいバージョンを受け入れる必要があります）。
Looker JAR ファイルのダウンロード ウェブページの使用
Looker JAR ファイルのダウンロードのウェブページ（https://download.looker.com/validate）にアクセスします。
- Looker のライセンス番号を入力します。
- メールアドレスを入力します。 これは、非公開でホストされたメールドメインである必要があります。
ダウンロードする Looker のバージョンを選択します。
[最新バージョン] を選択すると、現在の Looker リリースの最新バージョンである Looker JAR がダウンロードされます。[特定のバージョン] を選択した場合は、Looker の JAR ファイル名をそのまま入力する必要があります。
各リリースの JAR ファイルの命名規則には、バージョン番号に
.が含まれ、設定パターンが適用されます。たとえば、Looker 22.2 の JAR ファイル名はlooker-22.2.jarとlooker-dependencies-22.2.jarです。[ダウンロードする] を選択します。
EULA をまだ承認していない場合は、[EULA 承認] フォームが表示されます。EULA 全体を表示するには、[利用規約を読む] を選択します。次に、[名] と [姓] に入力し、[利用規約に同意する] の横にあるチェックボックスをオンにします。最後に [ダウンロードする] を選択します。
[ダウンロード 1 / 2] を選択して、Looker コア JAR ファイルをダウンロードします。次に、[ダウンロード 2 / 2] を選択して、Looker 依存関係 JAR ファイルをダウンロードします。このリンクは 10 分後に期限切れになります。リンクが期限切れになった場合は、ダウンロード プロセスを再開できます。
API の呼び出し
API を呼び出して JAR ファイルをダウンロードする前に、[Looker の JAR ファイルをダウンロードする] ウェブページで EULA に同意する必要があります。
その後、必要なメソッド（JavaScript、Java、Ruby、シェルコマンドなど）を指定して HTTPS エンドポイントに POST リクエストを実行することにより、必要な API 呼び出しを行うことができます。これらのリクエストのいずれかが機能するには、POST メソッドを使用して https://apidownload.looker.com/download に API ペイロードを送信する必要があります。API ペイロードには、lic、email、latest の値を含める必要があります。
latest プロパティは、Looker JAR のバージョンを示します。現在の Looker リリース（looker-latest.jar）用の最新バージョンの JAR ファイルをダウンロードするには、"latest" を指定します。特定のバージョンをダウンロードするには、latest を "specific" に設定し、目的のコア JAR ファイル名を値として、specific という API ペイロード内に別の Key-Value ペアを含めます。
API を 1 回だけ呼び出す必要があります。最初のレスポンスにはダウンロード リンクの両方が含まれ、10 分間使用できます。両方の JAR ファイルは個別にダウンロードする必要があります。
ES6（JavaScript）で書かれたリクエストを行う 2 つの例を次に示します。最新バージョンをリクエストするには、次のようにします。
axios({
url: "https://apidownload.looker.com/download",
method: "post",
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "latest"
}
}).then(function (response) {
console.log(response.data);
})
特定の JAR バージョン（Looker 22.2 など）をリクエストするには、次のようにします。
none
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "specific",
specific: "looker-22.2-latest.jar"
}
HTTPS エンドポイントに POST リクエストを行うための 2 つのシェルコマンドの例を次に示します。
wget コマンドを使用して特定のバージョンの JAR ファイルをリクエストするには（Looker 22.2 など）:
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-dependencies-22.2-latest.jar"}'\
"https://apidownload.looker.com/download"
一連の curl コマンドと wget コマンドを使用して最新の JAR ファイルをリクエストし、ローカルにファイルをダウンロードして保存するには:
curl -X POST -H 'Content-Type: application/json' -d '{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"latest"}'
https://apidownload.looker.com/download > api_response.json
sed -i 1,12d api_response.json
wget -O "looker-latest.jar" "$(cat api_response.json | jq -r '.url')"
wget -O "looker-dependencies-latest.jar" "$(cat api_response.json | jq -r '.depUrl')"
または、jq と wget がインストールされている場合は、次のシェルコマンド例を使用できます。
一連の wget コマンドを使用して、最新の JAR ファイルをリクエストするには:
wget -O "looker-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .url -r)"
wget -O "looker-dependencies-latest.jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"latest\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
以下の一連のコマンド例で、LOOKER_VERSION を latest、22.2-latest、または別のサポートされているバージョンに設定することで、他のバージョンの JAR をダウンロードすることもできます。たとえば、Looker 22.2 のコアファイルと依存関係ファイルをリクエストするには、次のようにします。
none
export LOOKER_VERSION="22.2-latest"
none
wget -O "looker$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H 'Content-Type: application/json'\
-d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\": \"$(contact@email.com)\",\"latest\":\"specific\",\
\"specific\":\"looker-$(LOOKER_VERSION).jar\"} "https://apidownload.looker.com/download | jq .url -r)"
none
wget -O "looker-dependencies$(LOOKER_VERSION).jar" "$(shell curl -s -X POST -H\
'Content-Type: application/json' -d "{\"lic\": \"$(YOURLOOKERLICENSE)\", \"email\":\
\"$(contact@email.com)\",\"latest\":\"specific\", \"specific\":\"looker-dependencies-$(LOOKER_VERSION).jar\"}\
"https://apidownload.looker.com/download | jq .depUrl -r)"
正常なレスポンスには、ダウンロードの URL と JAR ファイルの SHA-256 ハッシュの両方が含まれます。
API ペイロード エラー（入力パラメータの欠落や入力の誤りなど）は、「無効なリクエスト本文」のレスポンスが返されます。不正なライセンスキーを指定するか、specific バージョンをリクエストする際に specific 値を省略すると、「無効なリクエスト」のレスポンスが返されます。
両方の JAR ファイルのダウンロードに問題がある場合、splitJarMessage フィールドにメッセージが表示されることがあります。
最新の EULA をまだ受け入れていない場合、レスポンスに eulaMessage、eulaText、eulaNeeded の 3 つのフィールドが含まれます。eulaMessage は、API がダウンロード URL を返す前に、Looker JAR ファイルのダウンロード ウェブページで EULA に同意する必要があることを示します。