Transferir os ficheiros JAR do Looker

Para instalar ou atualizar a aplicação Looker para uma implementação alojada pelo cliente, tem de transferir os ficheiros JAR do Looker. Esta página descreve dois métodos para transferir os ficheiros JAR do Looker:

  1. Usando a página Web Transferir ficheiro JAR do Looker
  2. Chamar a API

Antes de poder transferir os ficheiros JAR, tem de aceitar um Contrato de Licença de Utilizador Final (EULA), que está disponível na página Web Transferir ficheiro JAR do Looker através das especificações nesta página. Cada utilizador que transfira os ficheiros JAR tem de aceitar este CLUF apenas uma vez. (Se o EULA for atualizado no futuro, cada utilizador também tem de aceitar a versão mais recente.)

Usar a página Web Transferir ficheiro JAR do Looker

Pode aceder à página Web Transferir ficheiro JAR do Looker através deste link: https://download.looker.com/validate. Para transferir os ficheiros JAR do Looker, siga estes passos:

  1. Introduza o número da licença do Looker.
  2. Introduza o seu endereço de email. Tem de ser um domínio de email alojado de forma privada.

  3. Selecione a versão do Looker a transferir.

    Se selecionar Versão mais recente, transfere a versão mais recente dos ficheiros JAR do Looker para a versão atual do Looker. Se selecionar Versão específica, tem de introduzir exatamente o nome do ficheiro JAR principal do Looker.

  4. Clique em Transferir.

    Se ainda não tiver aceitado o CLUF, é apresentado um formulário de aceitação do CLUF. Selecione Ler Termos de Utilização para ver o EULA na íntegra. Em seguida, introduza o seu primeiro nome e apelido, e selecione a caixa de verificação junto a Aceito os Termos de Utilização. Por último, clique em Transferir.

  5. Clique em Transferir 1 de 2 para transferir o ficheiro JAR principal do Looker. Em seguida, clique em Transferir 2 de 2 para transferir o ficheiro JAR de dependências do Looker. Este link expira após 10 minutos. Se o link expirar, pode reiniciar o processo de transferência.

Chamar a API

Antes de poder transferir os ficheiros JAR chamando a API, tem de aceitar primeiro o EULA através da página Web Transferir ficheiro JAR do Looker.

Em seguida, pode fazer a chamada API necessária fazendo um pedido POST para o ponto final HTTPS com qualquer método pretendido: JavaScript, Java, Ruby, comando de shell, etc. Para que qualquer um destes pedidos funcione, tem de usar o método POST para enviar o payload da API para https://apidownload.looker.com/download. A carga útil da API tem de conter valores para lic, email e latest.

A propriedade latest indica a versão do JAR do Looker. Para transferir a versão mais recente dos ficheiros JAR para a versão atual do Looker (looker-latest.jar), basta especificar "latest". Para transferir uma versão específica, defina latest como "specific" e inclua outro par de chave-valor na carga útil da API denominado specific com o nome do ficheiro JAR principal como valor.

Só precisa de chamar a API uma vez. A resposta inicial contém os links de transferência e está disponível durante 10 minutos. Tem de transferir os dois ficheiros JAR separadamente.

Seguem-se dois exemplos de como fazer um pedido escrito em ES6 (JavaScript). Para pedir a versão mais 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);
    })

Para pedir uma versão JAR específica (por exemplo, Looker 22.2): none data: { lic: "YOUR-LOOK-ERLI-CENS-EKEY", email: "contact@email.com", latest: "specific", specific: "looker-22.2-latest.jar" }

Seguem-se dois exemplos de comandos de shell para fazer pedidos POST ao ponto final HTTPS.

Para pedir uma versão específica de ficheiros JAR com o comando wget (por exemplo, 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"

Para pedir os ficheiros JAR mais recentes através de uma série de comandos curl e wget para transferir e guardar os ficheiros 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')"

Em alternativa, se tiver o jq e o wget instalados, pode usar os seguintes exemplos de comandos de shell.

Para pedir os ficheiros JAR mais recentes através de uma série de comandos 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)"

Também pode transferir outras versões do JAR definindo LOOKER_VERSION como latest, 22.2-latest ou outra versão suportada na seguinte série de exemplos de comandos. Por exemplo, para pedir os ficheiros principais e de dependências do 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)"

Os erros de payload da API, como parâmetros de entrada em falta ou com erros de ortografia, resultam numa resposta "Corpo do pedido inválido". Se fornecer uma chave de licença incorreta ou omitir um valor specific quando solicitar uma versão specific, recebe uma resposta "Pedido inválido".

Os problemas com a transferência de ambos os ficheiros JAR podem resultar numa mensagem no campo splitJarMessage.

Se não tiver aceite anteriormente o EULA mais recente, a resposta vai conter três campos: eulaMessage, eulaText e eulaNeeded. O eulaMessage indica que tem de aceitar primeiro o EULA através da página Web Transferir ficheiro JAR do Looker antes de a API devolver um URL de transferência.