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 mais 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 para fazer o download dos arquivos JAR do Looker:

  1. Usar a página da Web Fazer o download dos 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), disponível na página da Web Fazer o download dos arquivos JAR do Looker usando as especificações contidas nesta página. Cada usuário que fizer o download dos arquivos JAR deve aceitar este Contrato de licença de usuário final (EULA, na sigla em inglês) 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 dos arquivos JAR do Looker neste link: https://download.looker.com/validate:

  1. Digite o número da sua licença do Looker.
  2. Digite seu endereço de e-mail. Precisa ser um domínio de e-mail hospedado de modo privado.
  3. Selecione a versão do Looker que será transferida por 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á preciso inserir exatamente o nome de arquivo JAR do Looker Core.

    A convenção de nomenclatura dos arquivos JAR para 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. Selecione Fazer o download.

    Se você ainda não tiver aceito o EULA, um formulário de EULA Aceitação será exibido. Selecione 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. Selecione Fazer o download.

  5. Selecione Download 1 de 2 para fazer o download do arquivo JAR do Looker Core. Em seguida, selecione Download 2 de 2 para fazer o download do arquivo JAR de dependências do Looker. Este link expira em 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 dos arquivos JAR do Looker.

Em seguida, você pode fazer a chamada de API necessária fazendo uma solicitação POST para o ponto de extremidade HTTPS com qualquer método desejado: JavaScript, Java, Ruby, comando shell, etc. Para que qualquer uma dessas solicitações funcione, é necessário usar o método POST para enviar a carga útil 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 JAR principal desejado como valor.

Você só precisa chamar a API uma vez. A resposta inicial contém os dois links de download e fica 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:

    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 ao endpoint HTTPS.

Para solicitar uma versão específica de 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 o jq e o wget instalados, poderá usar os exemplos de comando do shell a seguir.

Para solicitar os arquivos JAR mais recentes usando 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 é possível fazer o download de outras versões do JAR definindo LOOKER_VERSION como latest, 22.2-latest ou outra versão compatível na série de exemplos de comando a seguir. 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á os URLs dos 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 "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 com o download dos dois arquivos JAR podem resultar em uma mensagem no campo splitJarMessage.

Se você ainda não tiver aceitado o EULA mais recente, a resposta conterá três campos: eulaMessage, eulaText e eulaNeeded. O eulaMessage indicará que você precisa aceitar o EULA pela página da Web Fazer o download do arquivo JAR do Looker antes de a API retornar um URL de download.