Como atualizar uma instância do Looker hospedada pelo cliente
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Você vai receber uma notificação quando novas versões do Looker estiverem disponíveis. Recomendamos atualizar o Looker regularmente para ficar por dentro das correções de bugs e dos novos recursos.
Se você tiver um cluster de instâncias do Looker, será necessário atualizar 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 precisa ter sido instalado como parte do processo inicial de instalação do Looker.
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.
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.
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 será encerrado em seis minutos com a mensagem "Tempo limite excedido aguardando a inicialização 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 a inicialização 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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-31 UTC."],[],[],null,["# Updating a customer-hosted Looker instance\n\n| We strongly advise against using these instructions to roll back to an earlier version of Looker. This can cause serious problems that are tedious and difficult to recover from. Instead, we recommend that you [restore a backup](/looker/docs/restoring-backups) if you need to go back to an earlier version of Looker.\n\nYou will be notified of new Looker releases as they become available. We recommend updating Looker regularly to keep current with bug fixes and new features.\n\u003e If you have a [cluster](/looker/docs/clustering-looker) of Looker instances, you must update a single node completely before updating the other instances.\n\nThis update process assumes your Looker instance includes the startup script, which should have been installed as part of the [initial Looker installation process](/looker/docs/installing-looker-application).\n\n1. Download the most recent release of the Looker JAR files as described on the [Downloading the Looker JAR Files](/looker/docs/downloading-looker-jar-files) documentation page.\n2. Stop the Looker process from shell, as the **looker** user:\n\n sudo su - looker\n cd /home/looker/looker\n ./looker stop\n\n If you are updating a Looker cluster, repeat this process so that Looker is stopped on every node.\n3. Back up your entire Looker directory, including hidden directories (see the [Restoring backups](/looker/docs/restoring-backups) documentation page for more detail).\n\n4. If you have [migrated Looker's default in-memory database to an external MySQL database](/looker/docs/migrating-looker-backend-db-to-mysql), or if you are updating a Looker cluster, back up the MySQL database.\n\n5. Rename `looker-x.x.x.jar` to `looker.jar` and `looker-dependencies-x.x.x.jar` to `looker-dependencies.jar`. Copy `looker.jar` and `looker-dependencies.jar` to the server directory (`/home/looker/looker/looker.jar`). Both files *must* be in the same directory.\n\n6. Start the Looker process from the shell as the **looker** user:\n\n If you are updating a Looker cluster, start the Looker process on one node only. Do not start Looker on the other nodes until the first node has completed the update process. \n\n ./looker start\n\n You can also use the `java -jar` command to start Looker. The core JAR will find the dependency JAR as long as it is in the `./looker` directory along with the core JAR.\n\n In addition, if you'd rather use a Looker-provided startup script, you can find a startup script at: \u003chttps://github.com/looker/customer-scripts\u003e.\n\n When you update your Looker version, Looker must also update its internal database. The database update usually takes less than five minutes, but it can sometimes take longer than the Looker startup process. If you try to start Looker while the internal database is still updating, the daemonizing process will time out in six minutes with the message \"Timed out waiting for Looker to start.\"\n\n During an update, the required migrations can take up to an hour, especially if you are skipping several releases. If you receive this error message, wait for the update to finish and for Looker to start. You can confirm whether the update process is still running by using the command: \n\n ps -f $(pgrep -f -- '-jar looker.jar')\n\n Stopping and restarting the Looker process while the internal database updates are in progress can corrupt the internal database. If this happens, restore Looker from an existing backup and perform the update again.\n7. If you are updating a Looker cluster, wait until the first node has completed the update process before starting Looker on the other nodes."]]
