Como fazer o download dos arquivos JAR do Looker

Recomendamos que você crie um backup da sua instância do Looker antes de atualizar o Looker. Consulte a página de documentação Como criar backups para ver instruções.

Para instalar ou atualizar o aplicativo Looker para uma implantação hospedada pelo cliente, faça o download dos arquivos JAR do Looker. Esta página descreve dois métodos de download dos arquivos JAR do Looker:

  1. Usando a página da Web Fazer o download de arquivos JAR do Looker
  2. Como chamar a API

Antes de fazer o download dos arquivos JAR, é necessário aceitar um Contrato de licença de usuário final (EULA), que está disponível na página da Web Fazer o download dos arquivos JAR do Looker usando as especificações nesta página. Cada usuário que fizer o download dos arquivos JAR precisará aceitar esse EULA apenas uma vez. Se o EULA for atualizado no futuro, cada usuário também precisará aceitar a versão mais recente.

Usando a página da Web Fazer o download dos arquivos JAR do Looker

Acesse a página da Web Fazer o download de arquivos JAR do Looker neste link: https://download.looker.com/validate:

  1. Insira o número da sua licença do Looker.
  2. Digite seu endereço de e-mail. Ele precisa ser um domínio de e-mail hospedado de forma particular.
  3. Selecione a versão do Looker para download.

    Se você selecionar Versão mais recente, fará o download da versão mais recente dos arquivos JAR do Looker para a versão atual do Looker. Se você selecionar Specific Version, será necessário inserir o nome de arquivo JAR principal do Looker.

    A convenção de nomenclatura dos arquivos JAR de cada versão inclui o . no número da versão e segue um padrão definido. Por exemplo, os nomes de arquivo JAR do Looker 22.2 são looker-22.2.jar e looker-dependencies-22.2.jar.

  4. Clique em Fazer o download.

    Se você ainda não tiver aceito o Contrato de licença do usuário final (EULA), o formulário de Aceitação do EULA será exibido. Clique em Ler os Termos e Condições para ver o EULA na íntegra. Em seguida, digite seu nome e sobrenome e marque a caixa de seleção ao lado de Concordo com os Termos e Condições. Em seguida, clique em Download:

  5. Clique em Fazer download de 1 de 2 para fazer o download do arquivo JAR principal do Looker. Em seguida, clique em Fazer o download 2 de 2 para fazer o download do arquivo JAR de dependências do Looker. Esse link expira após 10 minutos. Se o link expirar, você poderá reiniciar o processo de download.

Como chamar a API

Antes de fazer o download dos arquivos JAR chamando a API, você precisa aceitar o EULA na página da Web Fazer o download de arquivos JAR do Looker (em inglês).

Em seguida, você pode fazer a chamada de API necessária fazendo uma solicitação POST para o endpoint HTTPS com qualquer método desejado: JavaScript, Java, Ruby, comando de shell etc. Para que essas solicitações funcionem, use o método POST para enviar o payload da API para https://apidownload.looker.com/download. O payload da API precisa conter valores para lic, email e latest.

A propriedade latest indica a versão do JAR do Looker. Para fazer o download da versão mais recente dos arquivos JAR para a versão atual do Looker (looker-latest.jar), basta especificar "latest". Para fazer o download de uma versão específica, defina latest como "specific" e inclua outro par de chave-valor no payload da API chamado specific com o nome do arquivo principal de JAR desejado.

Você só precisa chamar a API uma vez. A resposta inicial conterá ambos os links de download e ficará disponível por um período de 10 minutos. Você precisará fazer o download dos dois arquivos JAR separadamente.

Veja dois exemplos de como fazer uma solicitação escrita em ES6 (JavaScript). Para solicitar a versão mais recente, faça o seguinte:

    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 solicitar uma versão específica do JAR (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" }

Veja dois exemplos de comandos do shell para fazer solicitações POST para o endpoint HTTPS.

Para solicitar uma versão específica dos arquivos JAR usando 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 solicitar os arquivos JAR mais recentes usando uma série de comandos curl e wget para fazer o download e salvar os arquivos 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
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')"

Como alternativa, se você tiver jq e wget instalados, use os seguintes exemplos de comando do shell.

Para solicitar os arquivos JAR mais recentes usando uma série de comandos wget, faça o seguinte:

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

Você também pode fazer o download de outras versões do JAR definindo LOOKER_VERSION como latest, 22.2-latest ou outra versão compatível na seguinte série de exemplos de comando. Por exemplo, para solicitar os arquivos principais e de dependências do 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)"

Uma resposta bem-sucedida conterá URLs de downloads e hashes SHA-256 dos arquivos JAR.

Os erros de payload da API, como parâmetros de entrada ausentes ou digitados incorretamente, resultam em uma resposta de "corpo de solicitação inválido"" Fornecer uma chave de licença incorreta ou omitir um valor specific ao solicitar uma versão specific resultará em uma resposta "Solicitação inválida"

Problemas no download dos dois arquivos JAR podem resultar em uma mensagem no campo splitJarMessage.

Se você não tiver aceitado o Contrato de licença do usuário final (EULA) mais recente, a resposta incluirá três campos: eulaMessage, eulaText e eulaNeeded. eulaMessage indica que você precisa aceitar o EULA primeiro na página da Web Fazer o download do arquivo JAR do Looker antes de a API retornar um URL de download.