looker-x.x.x.jar을 looker.jar로, looker-dependencies-x.x.x.jar을 looker-dependencies.jar로 바꿉니다. looker.jar와 looker-dependencies.jar를 서버 디렉터리(/home/looker/looker/looker.jar)에 복사합니다. 두 파일 모두 동일한 디렉터리에 있어야 합니다.
셸에서 Looker 사용자로서 Looker 프로세스를 시작합니다.
Looker 클러스터를 업데이트하는 경우 한 노드에서만 Looker 프로세스를 시작합니다. 첫 번째 노드가 업데이트 프로세스를 완료할 때까지 다른 노드에서 Looker를 시작하지 마세요.
./looker start
java -jar 명령어를 사용하여 Looker를 시작할 수도 있습니다. 핵심 JAR은 종속 항목 JAR을 ./looker 디렉터리에 있는 한 핵심 JAR과 함께 찾습니다.
Looker 버전을 업데이트할 때 Looker는 내부 데이터베이스도 업데이트해야 합니다. 데이터베이스 업데이트는 일반적으로 5분 이내에 완료되지만 Looker 시작 프로세스보다 오래 걸릴 수 있습니다. 내부 데이터베이스가 아직 업데이트되는 동안 Looker를 시작하려고 하면 'Looker 시작을 기다리는 동안 제한 시간이 초과되었습니다'라는 메시지와 함께 6분 후에 데몬화 프로세스가 타임아웃됩니다.
업데이트하는 동안 필수 마이그레이션은 최대 1시간이 걸릴 수 있으며 여러 출시 버전을 건너뛰는 경우에는 특히 그렇습니다. 이 오류 메시지가 표시되면 업데이트가 완료되고 Looker가 시작될 때까지 기다립니다. 다음 명령어를 사용하여 업데이트 프로세스가 계속 실행 중인지 확인할 수 있습니다.
ps -f $(pgrep -f -- '-jar looker.jar')
내부 데이터베이스 업데이트가 진행되는 동안 Looker 프로세스를 중지하고 다시 시작하면 내부 데이터베이스가 손상될 수 있습니다. 이 경우 기존 백업에서 Looker를 복원하고 다시 업데이트를 수행합니다.
Looker 클러스터를 업데이트하는 경우 다른 노드에서 Looker를 시작하기 전에 첫 번째 노드가 업데이트 프로세스를 완료할 때까지 기다립니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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."]]
