User Guide Getting Started Help Center Documentation Community Training
Looker
  
English
Français
Deutsch
日本語
Downloading the Looker JAR Files

You must download the Looker JAR files in order to install or update the Looker application for a customer-hosted deployment. This page describes two methods for downloading the Looker JAR files:

  1. Using the Download Looker JAR files webpage
  2. Calling the API

Before you can download the JAR files, you must accept an End User License Agreement (EULA), which is available on the Download Looker JAR files webpage using the specifications below. Each user downloading the JAR files must accept this EULA; however, each user only needs to accept the EULA once. (If the EULA is updated in the future, each user will also have to accept the newer version.)

Using the Download Looker JAR file(s) Webpage

You can access the Download Looker JAR files webpage at this link: https://download.looker.com/validate:

You will need to enter:

  1. Your Looker license number.
  2. Your email address. This must be a privately hosted email domain.
  3. The Looker version you would like to download. If you select Latest Version, you will download the latest version of the Looker JAR files for the current Looker release. If you select Specific Version, you will need to enter the Looker core JAR file name exactly.

The naming convention of JAR files for each release includes the . in the version number and follows a set pattern. For example, the JAR file names for Looker 6.18 are looker-6.18.jar and looker-dependencies-6.18.jar.

After you enter this information, click Get Download.

If you have not already accepted the EULA, a EULA Acceptance form will appear. Click Read Terms and Conditions to view the EULA in its entirety. Then, enter your First Name and Last Name and check the check box next to I agree to the Terms and Conditions.

After you enter this information, click Get Download:

Click Download 1 of 2 to download the Looker core JAR file. Then click Download 2 of 2 to download the Looker dependencies JAR file. This link expires after 10 minutes. If the link expires, you can restart the download process.

Calling the API

Before you can download the JAR files by calling the API, you must first accept the EULA through the Download Looker JAR files webpage.

You can then make the necessary API call by making a POST request to the HTTPS endpoint with any desired method — JavaScript, Java, Ruby, shell command, etc. For any of these requests to work, you must use the POST method to send the API payload to https://apidownload.looker.com/download. The API payload must contain values for lic, email, and latest.

The latest property denotes the version of the Looker JAR. If you want to download the latest version of the JAR files for the current Looker release (looker-latest.jar), specifying “latest” is sufficient. If you want to download a specific version, set latest to “specific” and include another key-value pair within the API payload called specific with the desired core JAR file name as the value.

You only need to call the API once, as the initial response will contain both download links and will be available for a 10 minute period. You will need to download both JAR files separately.

Here are two examples of making a request written in ES6 (JavaScript). To request the latest version:

    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);
    })

To request a specific JAR version (for example, Looker 6.18):

        data: {
            lic: "YOUR-LOOK-ERLI-CENS-EKEY",
            email: "contact@email.com",
            latest: "specific",
            specific: "looker-6.18-latest.jar"
        }

Here are two example shell commands for making POST requests to the HTTPS endpoint.

To request a specific version of JAR files using the wget command (for example, Looker 6.18):

wget -O- --header=Content-Type:application/json\
--post-data='{"lic": "YOURLOOKERLICENSE", "email": "contact@email.com", "latest":"specific",\
"specific":"looker-6.18-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-6.18-latest.jar"}'\
"https://apidownload.looker.com/download"

Another option is to request the latest JAR files using a series of curl and wget commands to download and save the files locally:

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

Alternatively, if you have jq and wget installed, you can use the shell command examples below.

To request the latest JAR files using a series of wget commands:

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

You can also download other versions of the JAR by setting LOOKER_VERSION to latest, 6.18-latest, or another supported version in the example series of commands below. For example, to request the core and dependencies files for Looker 6.18:

export LOOKER_VERSION="6.18-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)"

A successful response will contain both URLs of the downloads and SHA-256 hashes of the JAR files.

API payload errors, such as missing or mistyped input parameters, will result in an “Invalid request body” response. Providing an incorrect license key or omitting a specific value when requesting a specific version will result in an “Invalid request” response.

Issues with downloading both JAR files may result in a message in the splitJarMessage field.

If you have not previously accepted the latest EULA, the response will contain three fields: eulaMessage, eulaText, and eulaNeeded. The eulaMessage will indicate that the user must first accept the EULA via the Download Looker JAR file webpage before the API will return a download URL.

Top