Sebaiknya buat cadangan instance Looker sebelum memperbarui Looker. Lihat halaman dokumentasi Membuat cadangan untuk mengetahui petunjuknya.
Untuk menginstal atau mengupdate aplikasi Looker untuk deployment yang dihosting pelanggan, Anda harus mendownload file Looker JAR. Halaman ini menjelaskan dua metode untuk mendownload file Looker JAR:
Sebelum dapat mendownload file JAR, Anda harus menyetujui Perjanjian Lisensi Pengguna Akhir (PLPA), yang tersedia di halaman web Download file Looker JAR menggunakan spesifikasi di halaman ini. Setiap pengguna yang mendownload file JAR harus menyetujui PLPA ini hanya satu kali. (Jika PLPA diperbarui di masa mendatang, setiap pengguna juga harus menyetujui versi yang lebih baru.)
Menggunakan halaman web Download file Looker JAR
Anda dapat mengakses halaman web Download file Looker JAR di link ini: https://download.looker.com/validate:
- Masukkan nomor lisensi Looker Anda.
- Masukkan alamat email Anda. Ini harus berupa domain email yang dihosting secara pribadi.
Pilih versi Looker yang akan didownload.
Jika memilih Versi Terbaru, Anda akan mendownload file Looker JAR versi terbaru untuk rilis Looker saat ini. Jika memilih Versi Tertentu, Anda harus memasukkan nama file JAR inti Looker dengan tepat.
Konvensi penamaan file JAR untuk setiap rilis menyertakan
.
dalam nomor versi dan mengikuti pola yang ditetapkan. Misalnya, nama file JAR untuk Looker 22.2 adalahlooker-22.2.jar
danlooker-dependencies-22.2.jar
.Pilih Dapatkan Download.
Jika Anda belum menyetujui PLPA, formulir Persetujuan PLPA akan muncul. Pilih Baca Persyaratan dan Ketentuan untuk melihat PLPA secara keseluruhan. Selanjutnya, masukkan Nama Depan dan Nama Belakang dan centang kotak di samping Saya menyetujui Persyaratan dan Ketentuan. Terakhir, pilih Get Download.
Pilih Download 1 dari 2 untuk mendownload file Looker core JAR. Lalu, pilih Download 2 dari 2 untuk mendownload file JAR dependensi Looker. Masa berlaku link ini akan berakhir setelah 10 menit. Jika tautan sudah tidak berlaku, Anda dapat memulai ulang proses download.
Memanggil API
Sebelum dapat mendownload file JAR dengan memanggil API, Anda harus terlebih dahulu menyetujui PLPA melalui halaman web Mendownload file Looker JAR.
Selanjutnya, Anda dapat membuat panggilan API yang diperlukan dengan membuat permintaan POST ke endpoint HTTPS dengan metode apa pun yang diinginkan — JavaScript, Java, Ruby, perintah shell, dll. Agar permintaan ini dapat berfungsi, Anda harus menggunakan metode POST untuk mengirim payload API ke https://apidownload.looker.com/download. Payload API harus berisi nilai untuk lic
, email
, dan latest
.
Properti latest
menunjukkan versi Looker JAR. Untuk mendownload file JAR versi terbaru untuk rilis Looker saat ini (looker-latest.jar
), cukup menentukan "latest"
. Untuk mendownload versi tertentu, tetapkan latest
ke "specific"
dan sertakan pasangan nilai kunci lain dalam payload API yang disebut specific
dengan nama file JAR inti yang diinginkan sebagai nilai.
Anda hanya perlu memanggil API satu kali; respons awal akan berisi link download dan akan tersedia selama 10 menit. Anda harus mendownload kedua file JAR secara terpisah.
Berikut dua contoh pembuatan permintaan yang ditulis dalam ES6 (JavaScript). Untuk meminta versi terbaru:
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);
})
Untuk meminta versi JAR tertentu (misalnya, Looker 22.2):
none
data: {
lic: "YOUR-LOOK-ERLI-CENS-EKEY",
email: "contact@email.com",
latest: "specific",
specific: "looker-22.2-latest.jar"
}
Berikut adalah dua contoh perintah shell untuk membuat permintaan POST ke endpoint HTTPS.
Untuk meminta versi file JAR tertentu menggunakan perintah wget
(misalnya, 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"
Untuk meminta file JAR terbaru menggunakan serangkaian perintah curl
dan wget
guna mendownload dan menyimpan file secara lokal:
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')"
Atau, jika Anda sudah menginstal jq dan wget
, Anda dapat menggunakan contoh perintah shell berikut.
Untuk meminta file JAR terbaru menggunakan serangkaian perintah wget
:
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)"
Anda juga dapat mendownload JAR versi lain dengan menetapkan LOOKER_VERSION
ke latest
, 22.2-latest
, atau versi yang didukung lainnya dalam rangkaian contoh perintah berikut. Misalnya, untuk meminta file inti dan dependensi untuk 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)"
Respons yang berhasil akan berisi URL download dan hash SHA-256 file JAR.
Error payload API, seperti parameter input yang tidak ada atau salah ketik, akan menghasilkan respons "Isi permintaan tidak valid". Memberikan kunci lisensi yang salah atau menghapus nilai specific
saat meminta versi specific
akan menghasilkan respons "Permintaan tidak valid".
Masalah saat mendownload kedua file JAR dapat menyebabkan pesan di kolom splitJarMessage
.
Jika Anda belum menyetujui PLPA terbaru sebelumnya, responsnya akan berisi tiga kolom: eulaMessage
, eulaText
, dan eulaNeeded
. eulaMessage
akan menunjukkan bahwa Anda harus menyetujui PLPA terlebih dahulu melalui halaman web Download file Looker JAR sebelum API menampilkan URL download.