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. Questa pagina descrive due metodi per scaricare i file JAR di Looker:

  1. Utilizzare 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 riportate 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 all'indirizzo https://download.looker.com/validate. Per scaricare i file JAR di Looker:

  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 Versione più recente, scaricherai la versione più recente dei file JAR di Looker per la release di Looker corrente. Se selezioni Versione specifica, devi inserire esattamente il nome del file JAR di Looker Core.

  4. Fai clic su Esegui download.

    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 Esegui download.

  5. Fai clic su Download 1 of 2 (Scarica 1 di 2) per scaricare il file JAR di base di Looker. 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é una 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 i valori per lic, email e latest.

La proprietà latest indica la versione del file 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 nel payload dell'API denominata specific con il nome del 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.

Di seguito sono riportati due esempi di invio di 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 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" }

Di seguito sono riportati due esempi di comandi shell per inviare 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 del payload dell'API, ad esempio parametri di input mancanti o digitati in modo errato, generano una risposta "Testo della richiesta non valido". Se fornisci una codice licenza errata o ometti un valore specific quando richiedi una versione specific, riceverai una risposta "Richiesta non valida".

I problemi di download di entrambi i file JAR possono comportare la visualizzazione di un messaggio nel campo splitJarMessage.

Se non hai accettato in precedenza la versione più recente del contratto EULA, la risposta conterrà tre campi: eulaMessage, eulaText e eulaNeeded. Il messaggio eulaMessage ti indicherà che devi prima accettare il contratto EULA tramite la pagina web Scarica il file JAR di Looker prima che l'API restituisca un URL di download.