Download dei file JAR di Looker

Per installare o aggiornare l'applicazione Looker per un deployment ospitato dal cliente, devi scaricare i file JAR di Looker. In questa pagina vengono descritti due metodi per scaricare i file JAR di Looker:

  1. Utilizzando la pagina web Scarica il file JAR di Looker
  2. Chiamare l'API

Prima di poter scaricare i file JAR, devi accettare un Contratto di licenza con l'utente finale (EULA), disponibile nella pagina web Scarica il file JAR di Looker utilizzando le specifiche in questa pagina. Ogni utente che scarica i file JAR deve accettare questo Contratto di licenza con l'utente finale (EULA) una sola volta. (se il Contratto di licenza con l'utente finale (EULA) verrà aggiornato in futuro, ogni utente dovrà anche accettare la versione più recente.

Utilizza la pagina web Scarica il file JAR di Looker

Puoi accedere alla pagina web Scarica il file JAR di Looker a questo link: https://download.looker.com/validate. Per scaricare i file JAR di Looker, segui questi passaggi:

  1. Inserisci il numero di licenza di Looker.
  2. Inserisci il tuo indirizzo email. Deve essere un dominio email ospitato privatamente.
  3. Seleziona la versione di Looker da scaricare.

    Se selezioni Ultima versione, scaricherai la versione più recente dei file JAR di Looker per la release corrente di Looker. Se selezioni Versione specifica, devi inserire esattamente il nome file JAR di base di Looker.

  4. Fai clic su Scarica.

    Se non hai già accettato il Contratto di licenza con l'utente finale (EULA), viene visualizzato un modulo di accettazione del Contratto di licenza con l'utente finale (EULA). Seleziona Leggi i Termini e condizioni per visualizzare il Contratto di licenza con l'utente finale (EULA) nella sua interezza. Inserisci il tuo nome e cognome e seleziona la casella di controllo accanto ad Accetto i Termini e condizioni. Infine, fai clic su Scarica.

  5. Fai clic su Download 1 of 2 per scaricare il file JAR del core di Looker. Quindi, fai clic su Download 2 of 2 per scaricare il file JAR delle dipendenze di Looker. Questo link scade dopo 10 minuti. Se il link scade, puoi riavviare il processo di download.

Chiamata all'API

Prima di poter scaricare i file JAR chiamando l'API, devi accettare il Contratto di licenza con l'utente finale (EULA) tramite la pagina web Scarica il file JAR di Looker.

Puoi quindi effettuare la chiamata API necessaria effettuando una richiesta POST all'endpoint HTTPS con qualsiasi metodo desiderato: JavaScript, Java, Ruby, comando shell e così via. Affinché una di queste richieste funzioni, devi utilizzare il metodo POST per inviare il payload dell'API a https://apidownload.looker.com/download. Il payload dell'API deve contenere i valori per lic, email e latest.

La proprietà latest indica la versione di JAR di Looker. Per scaricare la versione più recente dei file JAR per la release di Looker corrente (looker-latest.jar), è sufficiente specificare "latest". Per scaricare una versione specifica, imposta latest su "specific" e includi un'altra coppia chiave-valore all'interno del payload dell'API denominato specific con il nome file JAR principale come valore.

Devi chiamare l'API una sola volta; la risposta iniziale conterrà entrambi i link di download e sarà disponibile per un periodo di 10 minuti. Dovrai scaricare entrambi i file JAR separatamente.

Ecco due esempi di come effettuare una richiesta scritta in ES6 (JavaScript). Per richiedere la versione più recente:

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

Per richiedere una versione di JAR specifica (ad esempio, Looker 22.2): none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

Ecco due esempi di comandi shell per effettuare richieste POST all'endpoint HTTPS.

Per richiedere una versione specifica dei file JAR utilizzando il comando wget (ad esempio, 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"

Per richiedere i file JAR più recenti utilizzando una serie di comandi curl e wget per scaricare e salvare i file localmente:

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

In alternativa, se hai installato jq e wget, puoi utilizzare i seguenti esempi di comandi shell.

Per richiedere i file JAR più recenti utilizzando una serie di comandi 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)"

Puoi anche scaricare altre versioni di JAR impostando LOOKER_VERSION su latest, 22.2-latest o un'altra versione supportata nella seguente serie di esempi di comandi. Ad esempio, per richiedere i file core e delle dipendenze per 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)"

Gli errori di payload dell'API, ad esempio parametri di input mancanti o digitati in modo errato, generano una risposta "Corpo della richiesta non valido". Se fornisci un codice licenza errato o ometti un valore specific quando richiedi una versione specific, la risposta sarà "Richiesta non valida".

I problemi con il download di entrambi i file JAR potrebbero generare un messaggio nel campo splitJarMessage.

Se in precedenza non hai accettato il Contratto di licenza con l'utente finale (EULA) più recente, la risposta conterrà tre campi: eulaMessage, eulaText e eulaNeeded. eulaMessage indicherà che devi accettare il Contratto di licenza con l'utente finale (EULA) tramite la pagina web Scarica il file JAR di Looker prima che l'API restituisca un URL di download.