Download dei file JAR di Looker

Ti consigliamo di creare un backup della tua istanza di Looker prima di aggiornare Looker. Per istruzioni, consulta la pagina della documentazione relativa alla creazione di backup.

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. Utilizza la pagina web Scaricare file JAR di Looker
  2. Chiamare l'API

Prima di poter scaricare i file JAR, è necessario accettare il Contratto di licenza con l'utente finale (EULA, End User License Agreement) disponibile nella pagina web Scarica i file JAR di Looker utilizzando le specifiche riportate in questa pagina. Ogni utente che scarica i file JAR deve accettare il presente EULA solo una volta. Se in futuro il Contratto di licenza con l'utente finale viene aggiornato, ogni utente dovrà accettare anche la versione più recente.

Utilizzo della pagina web Scarica i file JAR di Looker

Puoi accedere alla pagina web Scarica i file JAR di Looker a questo link: https://download.looker.com/convalida:

  1. Inserisci il numero di licenza di Looker.
  2. Inserisci l'indirizzo email. Deve essere un dominio email ospitato privatamente.
  3. Seleziona la versione di Looker per il download.

    Se selezioni Last Version (Versione più recente), scarerai la versione più recente dei file JAR di Looker per la versione corrente di Looker. Se selezioni Versione specifica, devi inserire esattamente il nome del file JAR di Looker.

    La convenzione di denominazione dei file JAR per ogni release include i valori . nel numero di versione e seguono un pattern impostato. Ad esempio, i nomi file JAR per Looker 22.2 sono looker-22.2.jar e looker-dependencies-22.2.jar.

  4. Fai clic su Scarica download.

    Se non hai già accettato il Contratto di licenza con l'utente finale (EULA), verrà visualizzato il modulo Accettazione del Contratto di licenza con l'utente finale. Fai clic su Leggi Termini e condizioni per visualizzare il Contratto di licenza con l'utente finale nella sua interezza. Successivamente, inserisci il tuo Nome e il tuo Cognome, quindi seleziona la casella di controllo accanto ad Accetto i Termini e condizioni. Quindi, fai clic su Scarica download:

  5. Fai clic su Scarica 1 di 2 per scaricare il file JAR di base. Quindi, fai clic su Download 2 of 2 (Scarica 2 di 2) per scaricare il file JAR delle dipendenze Looker. Questo link scade dopo 10 minuti. Se il link scade, puoi riavviare la procedura di download.

Chiamare l'API

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

Puoi quindi effettuare la chiamata API necessaria inviando 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 della JAR di Looker. Per scaricare la versione più recente dei file JAR per la versione corrente di Looker (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 chiamato specific con il nome file JAR principale desiderato.

Dovrai chiamare l'API solo una 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 richieste scritte 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" }

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 in locale:

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

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 principali e relativi alle dipendenze per Looker 22.2: none export LOOKER_VERSION="22.2-latest" none 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)" none 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)"

Una risposta riuscita conterrà sia gli URL dei download sia gli hash SHA-256 dei file JAR.

Gli errori di payload delle API, come i parametri di input mancanti o digitati in modo errato, generano una risposta di tipo "Corpo della richiesta non valido". Se fornisci un codice licenza errato o ometti un valore specific quando richiedi una versione specific, verrà generata una risposta "Richiesta non valida".

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

Se non hai accettato l'ultimo Contratto di licenza con l'utente finale (EULA), 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 File JAR di Looker prima che l'API restituisca un URL di download.