Como atualizar uma instância do Looker

Você receberá notificações sobre as novas versões do Looker quando elas forem disponibilizadas. Recomendamos atualizar o Looker regularmente para ficar sempre atualizado com correções de bugs e novos recursos.

Se você tiver um cluster de instâncias do Looker, atualize um único nó antes de atualizar as outras instâncias.

Esse processo de atualização pressupõe que sua instância do Looker inclui o script de inicialização, que deve ter sido instalado como parte do processo de instalação inicial do Looker.

  1. Faça o download da versão mais recente dos arquivos JAR do Looker, conforme descrito na página de documentação Como fazer o download dos arquivos JAR do Looker.

  2. Interrompa o processo do Looker no shell como usuário Looker.

    sudo su - looker
cd /home/looker/looker
./looker stop

    Se você estiver atualizando um cluster do Looker, repita o processo acima para interromper o Looker em todos os nós.

  3. Faça backup de todo o diretório do Looker, inclusive dos diretórios ocultos. Consulte a página de documentação Restaurar backups para ver mais detalhes.

  4. Se você tiver migrado o banco de dados padrão na memória do Looker para um banco de dados MySQL externo ou se estiver atualizando um cluster do Looker, faça backup do banco de dados MySQL.

  5. Renomeie looker-x.x.x.jar para looker.jar e looker-dependencies-x.x.x.jar para looker-dependencies.jar. Copie looker.jar e looker-dependencies.jar para o diretório do servidor (/home/looker/looker/looker.jar). Os dois arquivos precisam estar no mesmo diretório.

  6. Inicie o processo do Looker no shell como usuário Looker:

    Se você estiver atualizando um cluster do Looker, inicie o processo do Looker em apenas um nó. Não inicie o Looker nos outros nós até que o primeiro nó conclua o processo de atualização.

    ./looker start

    Também é possível usar o comando java -jar para iniciar o Looker. O JAR principal encontrará a dependência JAR desde que esteja no diretório ./looker junto com o JAR principal.

    Além disso, se preferir usar um script de inicialização fornecido pelo Looker, é possível encontrar um script de inicialização em: https://github.com/looker/customer-scripts (em inglês).

    Quando você atualiza sua versão do Looker, o banco de dados interno dele também precisa ser atualizado. A atualização do banco de dados geralmente leva menos de cinco minutos, mas pode demorar um pouco mais do que o processo de inicialização do Looker. Se você tentar iniciar o Looker enquanto o banco de dados interno ainda estiver sendo atualizado, o processo de daemon será encerrado em seis minutos com a mensagem "Tempo limite atingido aguardando o início do Looker."

    Durante uma atualização, as migrações necessárias podem levar até uma hora, especialmente se você estiver pulando várias versões. Se você receber essa mensagem de erro, aguarde o fim da atualização e o início do Looker. É possível confirmar se o processo de atualização ainda está em execução usando o comando:

    ps -f $(pgrep -f -- '-jar looker.jar')

    Interromper e reiniciar o processo do Looker enquanto as atualizações do banco de dados interno estiverem em andamento pode corromper o banco de dados interno. Caso isso aconteça, restaure o Looker de um backup existente e execute a atualização novamente.

  7. Se você estiver atualizando um cluster do Looker, aguarde até que o primeiro nó conclua o processo de atualização antes de iniciar o Looker nos outros nós.