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 per gli utenti finali una sola volta. Se in futuro il Contratto di licenza per gli utenti finali verrà aggiornato, ogni utente dovrà accettare anche la versione più recente.

Utilizzo della 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 l'ultima versione dei file JAR di Looker per la release corrente di Looker. Se selezioni Versione specifica, devi inserire esattamente il nome file JAR di Looker Core.

  4. Fai clic su Scarica.

    Se non hai ancora accettato il Contratto di licenza con l'utente finale (EULA), viene visualizzato il modulo Accettazione EULA. Seleziona Leggi Termini e condizioni per visualizzare il contratto EULA nella sua interezza. Poi, inserisci il Nome e il Cognome e seleziona la casella di controllo accanto a Accetto i Termini e condizioni. Infine, fai clic su Scarica.

  5. Fai clic su Download 1 of 2 (Scarica 1 di 2) per scaricare il file JAR di Looker Core. Quindi, fai clic su Scarica 2 di 2 per scaricare il file JAR delle dipendenze di Looker. Questo link scade dopo 10 minuti. Se il link scade, puoi riavviare la procedura 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 inviando una richiesta POST all'endpoint HTTPS con qualsiasi metodo desiderato, ad esempio JavaScript, Java, Ruby, comando shell e così via. Affinché qualsiasi di queste richieste funzioni, devi utilizzare il metodo POST per inviare il payload dell'API all'indirizzo https://apidownload.looker.com/download. Il payload dell'API deve contenere 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 per il 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 scaricarli e salvarli 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 del file 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 di base 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 un "Corpo della richiesta non valido". la risposta corretta. Se fornisci una chiave di licenza errata o ometti un valore specific quando richiedi una versione specific, riceverai una risposta "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.