Atualizar uma instância do Looker alojada pelo cliente

Recomendamos vivamente que não use estas instruções para reverter para uma versão anterior do Looker. Isto pode causar problemas graves que são difíceis de resolver. Em alternativa, recomendamos que restaure uma cópia de segurança se precisar de voltar a uma versão anterior do Looker.

Recebe uma notificação sobre os novos lançamentos do Looker assim que estiverem disponíveis. Recomendamos que atualize o Looker regularmente para se manter a par das correções de erros e das novas funcionalidades.

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

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

1. Transfira a versão mais recente dos ficheiros JAR do Looker, conforme descrito na página de documentação Transferir os ficheiros JAR do Looker.

2. Pare o processo do Looker a partir da shell como utilizador looker:

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

   Se estiver a atualizar um cluster do Looker, repita este processo para que o Looker seja parado em todos os nós.

3. Faça uma cópia de segurança de todo o diretório do Looker, incluindo os diretórios ocultos (consulte a página de documentação Restaurar cópias de segurança para obter mais detalhes).

4. Se migrou a base de dados na memória predefinida do Looker para uma base de dados MySQL externa ou se estiver a atualizar um cluster do Looker, faça uma cópia de segurança da base de dados MySQL.

5. Mudar o nome de looker-x.x.x.jar para looker.jar e de 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). Ambos os ficheiros têm de estar no mesmo diretório.

6. Inicie o processo do Looker a partir da shell como o utilizador looker:

   Se estiver a atualizar um cluster do Looker, inicie o processo do Looker apenas num nó. Não inicie o Looker nos outros nós até que o primeiro nó tenha concluído o processo de atualização.

   ./looker start
   

   Também pode usar o comando java -jar para iniciar o Looker. O JAR principal encontra o JAR de dependência desde que esteja no diretório ./looker juntamente com o JAR principal.

   Além disso, se preferir usar um script de arranque fornecido pelo Looker, pode encontrar um script de arranque em: https://github.com/looker/customer-scripts.

   Quando atualiza a versão do Looker, o Looker também tem de atualizar a respetiva base de dados interna. Normalmente, a atualização da base de dados demora menos de cinco minutos, mas, por vezes, pode demorar mais tempo do que o processo de arranque do Looker. Se tentar iniciar o Looker enquanto a base de dados interna ainda estiver a ser atualizada, o processo de daemonização vai expirar em seis minutos com a mensagem "Tempo limite de espera para o início do Looker excedido".

   Durante uma atualização, as migrações necessárias podem demorar até uma hora, especialmente se estiver a ignorar várias versões. Se receber esta mensagem de erro, aguarde que a atualização termine e que o Looker seja iniciado. Pode confirmar se o processo de atualização ainda está em execução através do comando:

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

   Parar e reiniciar o processo do Looker enquanto as atualizações da base de dados interna estão em curso pode danificar a base de dados interna. Se isto acontecer, restaure o Looker a partir de uma cópia de segurança existente e faça a atualização novamente.

7. Se estiver a atualizar 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.