透過命令列（CLI）介面執行手動升級

手動升級模式可讓您直接透過命令列控制 CubeCOS 的升級。 透過此方法，您可以遠端登入節點並執行系統指令來管理更新流程。

僅在以下情況下才使用手動升級：

• 一鍵升級失敗
• 您需要對特定節點進行精確控制
• 您正在使用 CubeCOS 3.0.0 版

註解

如果您使用的是 CubeCOS 3.1.0 或更新版本，請先嘗試 一鍵升級。

先決條件

開始之前，請先參閱「一鍵升級指南」中的 先決條件 和 升級流程 章節。

上傳韌體檔案

在進行升級之前，請先確認叢集的運作狀態，並上傳必要的檔案。

檢查叢集狀態

在開始升級之前，請檢查叢集的健康狀態，以確保所有服務均運作正常。

1. 進入叢集管理模式。

   cluster

2. 檢查叢集狀態：

   check

3. 請確認所有服務均顯示 ok 狀態。

確認所有節點皆運作正常

1. 開啟 CubeCOS 使用者介面。
2. 前往 首頁 > 節點。
3. 請確認所有節點均顯示為正常狀態。

上傳韌體檔案

1. 請從您的本地電腦將韌體和 MD5 校驗和檔案上傳至 /var/update/ 目錄：

   scp <local-file-path> <your-username>@<your-cluster-ip>:/var/update/

   替換：

   • <local-file-path>：韌體或校驗和檔案的本地路徑
   • <your-username>：您的叢集使用者名稱
   • <your-cluster-ip>：您的叢集 IP 位址

2. 出現提示時，請輸入您的 SSH 密碼。

3. 請針對叢集中的所有主機重複執行上傳操作。

驗證已上傳的韌體檔案

在開始升級之前，請確保所有韌體檔案均已上傳至叢集中的每台主機。

1. 進入更新管理模式。

   update

2. 已上傳的韌體映像清單：

   list

3. 出現提示時，請選擇 local。 此選項用於指定您上傳檔案的位置。

安裝韌體

請將韌體安裝至叢集中的所有主機。

1. 進入更新管理模式。

   update

2. 開始互動式安裝程序。

   update

3. 出現提示時，請選擇 local。 此選項用於指定您上傳檔案的位置。

4. 請選擇您要安裝的影像檔案。

5. 請輸入 YES 以確認安裝。

6. 請等待安裝程序顯示已完成。

在重新啟動前遷移虛擬機器

為確保服務不中斷，請在升級及重新啟動之前，將所有虛擬機器 (VM) 從該節點遷移至其他節點。

危險

叢集升級可能會影響效能，因此請務必在維護時段內執行此任務。

請僅在主節點上執行以下指令。

1. 進入 IAAS 管理模式。

   iaas

2. 存取運算管理：

   compute

3. 將虛擬機器從節點中移出：

   upgrade_host_evacuation

重新啟動叢集

韌體升級需要重新啟動。

:::warning[One [時間操作]

僅需在叢集的主節點上進行手動遷移。 後續的主機將自動遷移虛擬機器，並依序重新啟動。

:::

請在主節點上執行此指令：

1. 請在主節點上執行以下指令，以啟動整個叢集的滾動式重新啟動作業。

   reboot

2. 一旦主節點完成初始化程序，第二個節點便會自動重新啟動。

3. 重新啟動之前，虛擬機器會自動遷移至其他節點。 重新啟動後，自動自舉程序會自動觸發。

4. 此操作將針對叢集中的所有節點執行。

驗證升級

升級完成後，請檢查叢集的健康狀態，以確保所有服務均正常運作。

1. 進入叢集管理模式。

   cluster

2. 檢查叢集的健康狀態。

   check

3. 請確保健康狀態為 OK。 以下範例顯示預期輸出：

             Service  Status  Report
          IaasDb      ok  [ mysql(v) ]
       Baremetal      ok  [ ironic(v) ]
          K8SaaS      ok  [ rancher(v) ]
      ObjectStor      ok  [ swift(v) ]
   ... # output abbreviated

檢查所有節點的韌體版本

升級完成後，請確認每個節點的韌體版本是否與您上傳的版本相符。

1. 進入韌體管理模式。

   firmware

2. 檢查目前活躍的韌體分區上的版本。

   list

3. 請確認目前啟用的韌體版本與您上傳的版本相符。 以下範例顯示預期輸出：

   1: CUBE_3.1.0_20260203-2300_be0cb70 [ACTIVE]
   Firmware Version: Cube Appliance 3.1.0
   Installation Date: Feb  5, 2026 11:33:20 AM
   Installation Type: Re-install USB
   Last Boot: Feb  5, 2026 11:46:38 AM
   Comment:
   2: CUBE_3.1.0_20260203-2300_be0cb70
   Firmware Version: Cube Appliance 3.1.0
   Installation Date: Feb  5, 2026 11:35:05 AM
   Installation Type: Re-install USB
   Last Boot: Never
   Comment:

升級後檢查所有節點

檢查所有節點的狀態，以確保它們均已啟動且處於正常運作狀態。

1. 開啟 CubeCOS 使用者介面。
2. 導航至 首頁 > 節點。
3. 從節點清單中檢查所有節點的狀態。

檢查所有虛擬機器的狀態

檢查所有虛擬機器的狀態，以確保它們均處於活躍狀態。

1. 開啟 Skyline UI。
2. 導航至 首頁 > 運算 > 執行個體。
3. 從虛擬機器清單中檢查所有虛擬機器的狀態。