跳到主內容
版本：3.1

CubeCOS 一鍵更新與升級安裝指南

本指南說明如何升級韌體並更新修補套件。 它涵蓋了整個更新流程，從檔案上傳和 MD5 驗證，到自動滾動升級及虛擬機器遷移。 本指南還包含故障排除步驟及錯誤代碼參考。

先決條件​

在開始升級/更新之前，請確認以下事項：

  1. 請查閱新版本的發行說明與變更紀錄。
    • 發行說明：瞭解此版本的新功能、已知問題及相容性。
    • 更新日誌：查看具體的程式碼修正與元件更新清單。
  2. 請確認所有服務均處於正常狀態且無錯誤。
  3. 請將升級／更新作業排定在非尖峰時段進行，以將對生產環境的影響降至最低。
  4. 如需更多資訊，請參閱 CubeCOS 升級指南。

升級 CubeCOS 韌體​

韌體升級是用於將整個系統遷移至新基礎版本，此過程涉及節點分割，並會重置所有現有的修補包資料。

註解

升級韌體後，所有修補包的記錄與套件將被重置。

  1. 前往 韌體列表 頁面。 請前往 首頁 > 維護 > 更新 > 韌體列表 標籤頁。

  2. 上傳韌體檔案及 MD5 校驗碼檔案。

    1. 點擊 上傳韌體。

    2. 點擊 從電腦上傳，然後選取韌體檔案。

    3. 點擊 選擇校驗碼 以上傳校驗碼檔案

    4. 選取檔案後，請點擊 完成 以開始上傳作業。

      註解

      如果上傳在 MD5 校驗和檢查時失敗，請驗證檔案的完整性。

  3. 要開始升級程序，請按一下 更新。

  4. 若要執行不中斷的滾動式叢集升級，請勾選 滾動式更新 核取方塊。

    警告

    這使得叢集能夠以滾動式的方式進行無中斷運作。 若未設定此選項，叢集將同時重新啟動。

    • 每個節點將依序進行更新。
    • 系統會在更新前自動將虛擬機從節點中移出，以避免服務中斷。

  5. 監控更新：系統將在所有節點上啟動並行韌體更新（分割階段）。

    • 如果您選擇 滾動升級，在所有節點的分區階段完成後，滾動升級程序將自動開始。
    • 如果某個節點發生故障。 例如，由於虛擬機疏散失敗，自動滾動升級會立即停止。 要解決此問題，請檢查 CubeCOS 日誌以找出原因。 如果繼續操作是安全的，請點擊 仍要繼續。

  6. 所有節點更新完成後，請按 完成 返回 韌體列表 頁面。

  7. 請確認顯示的版本與上傳的版本一致。

安裝 CubeCOS 修補包​

Fixpack 提供針對特定問題的修補程式，無需變更整個系統版本即可進行安裝或還原。

  1. 前往 修正套件列表 頁面。 導覽至 首頁 > 維護 > 更新 > 修補程式清單。

  2. 上傳修補包檔案及 MD5 校驗碼檔案。

    1. 點擊 上傳修正套件。

    2. 點擊 從電腦上傳，然後選取修補包檔案。

    3. 點擊 選擇校驗碼 以上傳校驗碼檔案

    4. 選取檔案後，請點擊 完成 以開始上傳作業。

      註解

      如果上傳在 MD5 校驗和檢查時失敗，請驗證檔案的完整性。

  3. 開始安裝程序。 點擊 安裝。

    註解

    安裝最新的修正套件之前，必須先安裝所有先前所需的依賴項。

  4. 若修正套件需要重新啟動，請重新啟動 CubeCOS 系統。 點擊 立即重新啟動。

  5. 安裝修正套件時，請考量回滾事宜。

    • 適用於支援回滾功能的修補包。
      1. 若要還原至上一個修補程式包，請按一下 「是，還原」。
      2. 如果修補套件需要重新啟動，請勾選核取方塊，然後按一下 是，安裝。
    • 對於不支援回滾功能的修正套件，請提示使用者接受。 勾選方塊，然後按一下「是，安裝」。

  6. 所有節點更新完成後，請按一下 完成，並返回 修補程式清單 頁面。

還原​

如果修補包安裝失敗（參見 安裝 CubeCOS 修補包 中的第 4 步），您可以回滾至上一版本。 只有當安裝過程出現錯誤時，才需要執行此操作。

還原至上一版本​

若您在使用修補套件時遇到問題，請依照以下步驟執行還原。

  1. 在 修補程式包清單 中，找到您要移除的修補程式包。
  2. 請確認此修補套件是否包含回滾選項。
  3. 點擊 還原。
  4. 要完成此程序，請點擊 確認。

系統排錯​

若發生節點故障，請登入故障的節點，並使用以下指令檢查日誌：

journalctl -fu cube-cos-api

下表列出了韌體分區階段的錯誤代碼，並針對每個問題提供了建議的解決措施：

程式碼訊息建議採取的行動
UPG1001無法連線至節點 node_name檢查 VIP 節點與目標節點之間的 SSH 連線
UPG1002無法將韌體套件同步至節點 node_name請檢查 VIP 節點和目標節點上是否存在該韌體套件
UPG2001韌體更新失敗，僅有 num_success/num_node 個節點成功進行分區透過命令列（CLI）介面執行更新指令。
UPG2002韌體更新失敗，目標分割區已損毀在發生失敗的節點上執行更新指令。 否則，請確認韌體來源、驗證校驗和並檢查硬碟狀態
UPG2003韌體更新因未知錯誤而失敗，需進一步調查韌體更新因未知錯誤而失敗，需進一步調查

佔位符定義：

  • num_success：成功完成分區階段的節點數量。
  • num_node：叢集中的節點總數。
  • node-name：節點的主機名稱或 ID。
資訊

有關如何透過命令列（CLI）介面執行更新指令的詳細資訊，請參閱 透過命令列（CLI）手動升級。