Actualizar una instancia de Looker alojada por el cliente
Organízate con las colecciones
Guarda y clasifica el contenido según tus preferencias.
Recibirás una notificación cuando haya nuevas versiones de Looker disponibles. Te recomendamos que actualices Looker con frecuencia para estar al día de las correcciones de errores y las nuevas funciones.
Si tienes un clúster de instancias de Looker, debes actualizar un solo nodo por completo antes de actualizar las demás instancias.
En este proceso de actualización se da por hecho que tu instancia de Looker incluye la secuencia de comandos de inicio, que se debería haber instalado como parte del proceso de instalación inicial de Looker.
Descarga la versión más reciente de los archivos JAR de Looker tal como se describe en la página de documentación Descargar los archivos JAR de Looker.
Detén el proceso de Looker desde la shell como usuario looker:
sudo su - looker
cd /home/looker/looker
./looker stop
Si estás actualizando un clúster de Looker, repite este proceso para que Looker se detenga en todos los nodos.
Crea una copia de seguridad de todo tu directorio de Looker, incluidos los directorios ocultos (consulta la página de documentación Restaurar copias de seguridad para obtener más información).
Cambia el nombre de looker-x.x.x.jar a looker.jar y de looker-dependencies-x.x.x.jar a looker-dependencies.jar. Copia looker.jar y looker-dependencies.jar en el directorio del servidor (/home/looker/looker/looker.jar). Ambos archivos deben estar en el mismo directorio.
Inicia el proceso de Looker desde el shell como usuario looker:
Si vas a actualizar un clúster de Looker, inicia el proceso de Looker en un solo nodo. No inicies Looker en los demás nodos hasta que el primer nodo haya completado el proceso de actualización.
./looker start
También puedes usar el comando java -jar para iniciar Looker. El archivo JAR principal encontrará el archivo JAR de dependencia siempre que esté en el directorio ./looker junto con el archivo JAR principal.
Cuando actualizas tu versión de Looker, Looker también debe actualizar su base de datos interna. La actualización de la base de datos suele tardar menos de cinco minutos, pero a veces puede tardar más que el proceso de inicio de Looker. Si intentas iniciar Looker mientras la base de datos interna se está actualizando, el proceso de demonización se agotará en seis minutos y aparecerá el mensaje "Timed out waiting for Looker to start" (Se ha agotado el tiempo de espera para iniciar Looker).
Durante una actualización, las migraciones necesarias pueden tardar hasta una hora, sobre todo si te saltas varias versiones. Si recibes este mensaje de error, espera a que se complete la actualización y a que se inicie Looker. Puedes confirmar si el proceso de actualización sigue en curso con el siguiente comando:
ps -f $(pgrep -f -- '-jar looker.jar')
Si detienes y reinicias el proceso de Looker mientras se están actualizando las bases de datos internas, estas pueden dañarse. Si esto ocurre, restaura Looker a partir de una copia de seguridad y vuelve a realizar la actualización.
Si vas a actualizar un clúster de Looker, espera a que el primer nodo haya completado el proceso de actualización antes de iniciar Looker en los demás nodos.
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-20 (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."]]