Mendownload file JAR Looker

Untuk menginstal atau mengupdate aplikasi Looker untuk deployment yang dihosting pelanggan, Anda harus mendownload file JAR Looker. Halaman ini menjelaskan dua metode untuk mendownload file JAR Looker:

  1. Menggunakan halaman web Download file JAR Looker
  2. Memanggil API

Sebelum dapat mendownload file JAR, Anda harus menyetujui Perjanjian Lisensi Pengguna Akhir (EULA), yang tersedia di halaman web Download file JAR Looker menggunakan spesifikasi di halaman ini. Setiap pengguna yang mendownload file JAR harus menyetujui EULA ini hanya satu kali. (Jika EULA diperbarui pada masa mendatang, setiap pengguna juga harus menyetujui versi yang lebih baru.)

Menggunakan halaman web Download file JAR Looker

Anda dapat mengakses halaman web Download file JAR Looker di link ini: https://download.looker.com/validate. Untuk mendownload file JAR Looker, ikuti langkah-langkah berikut:

  1. Masukkan nomor lisensi Looker Anda.
  2. Masukkan alamat email Anda. Domain ini harus berupa domain email yang dihosting secara pribadi.

  3. Pilih versi Looker yang akan didownload.

    Jika memilih Versi Terbaru, Anda akan mendownload file JAR Looker versi terbaru untuk rilis Looker saat ini. Jika memilih Specific Version, Anda harus memasukkan nama file JAR inti Looker dengan tepat.

  4. Klik Dapatkan Download.

    Jika Anda belum menyetujui PLPA, formulir Persetujuan PLPA akan muncul. Pilih Baca Persyaratan dan Ketentuan untuk melihat EULA secara keseluruhan. Selanjutnya, masukkan Nama Depan dan Nama Belakang Anda, lalu centang kotak di samping Saya setuju dengan Persyaratan dan Ketentuan. Terakhir, klik Get Download.

  5. Klik Download 1 of 2 untuk mendownload file JAR inti Looker. Kemudian, klik Download 2 of 2 untuk mendownload file JAR dependensi Looker. Masa berlaku link ini akan berakhir setelah 10 menit. Jika masa berlaku link berakhir, Anda dapat memulai ulang proses download.

Memanggil API

Sebelum dapat mendownload file JAR dengan memanggil API, Anda harus menyetujui EULA terlebih dahulu melalui halaman web Download file JAR Looker.

Kemudian, Anda dapat melakukan panggilan API yang diperlukan dengan membuat permintaan POST ke endpoint HTTPS dengan metode yang diinginkan — JavaScript, Java, Ruby, perintah shell, dll. Agar permintaan ini 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 JAR Looker. Untuk mendownload file JAR versi terbaru untuk rilis Looker saat ini (looker-latest.jar), cukup tentukan "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 sebagai nilainya.

Anda hanya perlu memanggil API sekali; respons awal akan berisi link download dan akan tersedia selama periode 10 menit. Anda harus mendownload kedua file JAR secara terpisah.

Berikut adalah 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 untuk 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 telah 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 versi JAR lainnya dengan menetapkan LOOKER_VERSION ke latest, 22.2-latest, atau versi lain yang didukung dalam serangkaian contoh perintah berikut. Misalnya, untuk meminta file inti dan dependensi untuk Looker 22.2:

export LOOKER_VERSION="22.2-latest"

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)"

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)"

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 menghilangkan nilai specific saat meminta versi specific akan menghasilkan respons "Permintaan tidak valid".

Masalah terkait download kedua file JAR dapat menyebabkan pesan di kolom splitJarMessage.

Jika Anda belum menyetujui PLPA terbaru sebelumnya, respons akan berisi tiga kolom: eulaMessage, eulaText, dan eulaNeeded. eulaMessage akan menunjukkan bahwa Anda harus menyetujui EULA terlebih dahulu melalui halaman web Download file JAR Looker sebelum API menampilkan URL download.