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. Utilizzo della pagina web Scarica 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 file JAR di Looker utilizzando le specifiche riportate in questa pagina. Ogni utente che scarica i file JAR deve accettare questo EULA una sola volta. Se in futuro il Contratto di licenza con l'utente finale verrà aggiornato, ogni utente dovrà accettare anche la versione più recente.

Utilizzo della pagina web Scarica file JAR di Looker

Puoi accedere alla pagina web Download Looker JAR file a questo link: https://download.looker.com/validate. Per scaricare i file JAR di Looker:

  1. Inserisci il numero di licenza 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 di Looker corrente. Se selezioni Specific Version (Versione specifica), devi inserire esattamente il nome del file JAR di Looker Core.

  4. Fai clic su Ottieni download.

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

  5. Fai clic su Scarica 1 di 2 per scaricare il file JAR principale 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.

Chiamare l'API

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

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

La proprietà latest indica la versione del file JAR di Looker. Per scaricare l'ultima versione 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 chiamata 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 creazione di una richiesta scritta in ES6 (JavaScript). Per richiedere l'ultima versione:

    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 comandi shell di esempio 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
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 principali 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 API, ad esempio parametri di input mancanti o digitati in modo errato, generano una risposta "Corpo 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 con il download di entrambi i file JAR potrebbero generare un messaggio nel campo splitJarMessage.

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