更新客戶代管的 Looker 執行個體

我們會在 Looker 推出新版本時通知您。建議您定期更新 Looker，以便掌握最新的錯誤修正和新功能。

如果您有 Looker 執行個體的叢集，請務必先完全更新單一節點，再更新其他執行個體。

這項更新程序假設您的 Looker 例項包含開機指令碼，而該指令碼應已在初始 Looker 安裝程序中安裝。

  1. 請按照「下載 Looker JAR 檔案」說明文件頁面所述，下載最新版本的 Looker JAR 檔案。

  2. 以 looker 使用者身分，從殼層停止 Looker 程序：

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

    如果您要更新 Looker 叢集，請重複執行這項程序，以便在每個節點上停止 Looker。

  3. 備份整個 Looker 目錄，包括隱藏的目錄 (詳情請參閱「還原備份」說明文件頁面)。

  4. 如果您已將 Looker 的預設記憶體內資料庫遷移至外部 MySQL 資料庫，或是正在更新 Looker 叢集，請備份 MySQL 資料庫。

  5. 將 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)。兩個檔案必須位於相同目錄中。

  6. 以 looker 使用者身分，從殼層啟動 Looker 程序：

    如果您要更新 Looker 叢集，請只在一個節點上啟動 Looker 程序。在第一個節點完成更新程序前，請勿在其他節點啟動 Looker。

    ./looker start

    您也可以使用 java -jar 指令啟動 Looker。只要依附元件 JAR 與核心 JAR 位於 ./looker 目錄中，核心 JAR 就會找到依附元件 JAR。

    此外，如果您想使用 Looker 提供的開機指令碼，可以前往 https://github.com/looker/customer-scripts 下載。

    更新 Looker 版本時，Looker 也必須更新內部資料庫。資料庫更新作業通常會在五分鐘內完成，但有時可能比 Looker 啟動程序耗時更久。如果在內部資料庫仍在更新時嘗試啟動 Looker， daemonizing 程序會在六分鐘後逾時，並顯示「等待 Looker 啟動時逾時」訊息。

    在更新期間，必要的遷移作業可能需要一小時才能完成，特別是如果您跳過多個版本時。如果您收到這則錯誤訊息，請等待更新完成，然後啟動 Looker。您可以使用下列指令，確認更新程序是否仍在執行：

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

    在內部資料庫更新期間停止及重新啟動 Looker 程序，可能會導致內部資料庫毀損。如果發生這種情況，請從現有備份還原 Looker，然後再次執行更新。

  7. 如果您要更新 Looker 叢集，請等到第一個節點完成更新程序，再開始在其他節點啟動 Looker。