Como atualizar uma instância do Looker hospedada pelo cliente

Para acessar as correções de bugs e os novos recursos mais recentes, atualize sua instância do Looker hospedada pelo cliente seguindo estas etapas manuais.

Antes de continuar, saiba que a reversão para uma versão anterior pode causar problemas graves. Em vez disso, sempre restaure de um backup se precisar reverter. Se você opera um cluster do Looker, atualize cada nó completamente, um de cada vez. Esse processo também pressupõe que sua instância inclua o script de inicialização instalado durante a configuração inicial.

  1. Baixe a versão mais recente dos arquivos JAR do Looker, conforme descrito na página de documentação Como baixar os arquivos JAR do Looker.

  2. Pare o processo do Looker no shell como o usuário looker:

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

    Se você estiver atualizando um cluster do Looker, repita esse processo para que o Looker seja interrompido em todos os nós.

  3. Faça backup de todo o diretório do Looker, incluindo os diretórios ocultos. Consulte a página de documentação Como restaurar backups para mais detalhes.

  4. Se você migrou 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 o 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 tenha concluído o processo de atualização.

    ./looker start

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

    Além disso, se preferir usar um script de inicialização fornecido pelo Looker, acesse: https://github.com/looker/customer-scripts.

    Quando você atualiza a versão do Looker, ele também precisa atualizar o banco de dados interno. A atualização do banco de dados geralmente leva menos de cinco minutos, mas às vezes pode demorar 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 daemonização vai atingir o tempo limite em seis minutos com a mensagem "Tempo limite atingido ao aguardar o início do Looker".

    Durante uma atualização, as migrações necessárias podem levar até uma hora, principalmente se você estiver pulando várias versões. Se você receber essa mensagem de erro, aguarde a conclusão da atualização e o início do Looker. Para confirmar se o processo de atualização ainda está em execução, use 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 estão em andamento pode corromper o banco de dados interno. Se isso acontecer, restaure o Looker de um backup e faça 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.