跳到主內容
版本：3.0

CubeCOS 安裝

CubeCOS 的安裝包含以下步驟。

  1. 映像檔復原（安裝）：將 CubeCOS 復原（安裝）至終端節點的目標裝置。
  2. 角色配置：為叢集設定配置節點角色，設定網路資訊，並在需要時啟用高可用性功能。
  3. 叢集設定：安裝完成並配置節點角色後，可執行 set_ready 指令初始化軟體定義儲存（SDS），並完成 CubeCOS 的叢集服務設定。

CubeCOS 安裝的先決條件​

資訊

請在繼續安裝前，確認已滿足所有硬體與網路需求。

下載安裝檔案​

請前往 CubeCOS GitHub 儲存庫，下載與您選擇的安裝方式相符的安裝檔案。

CubeCOS 支援並提供以下安裝方式的安裝媒體：

  • 透過USB隨身碟啟動：直接從USB裝置啟動並安裝。
  • 虛擬媒體或DVD的ISO檔：使用虛擬媒體掛載ISO檔，或將其燒錄至實體DVD以進行安裝。
  • 透過 PXE 伺服器進行網路開機 (IMG/ISO)：使用 PXE 伺服器透過網路部署，支援 IMG 或 ISO 格式。

開始安裝流程​

準備好您選擇的安裝媒體並從該媒體啟動目標機器後，請繼續啟動安裝程序。

登入進行映像檔復原（安裝）並設定 CubeCOS​

資訊

在開始設定之前，請先確認 IP 位址與 IP CIDR 配置。 請確保：

  • 指派的 IP 位址位於正確的子網範圍內。
  • CIDR 表示法能精確反映預期的網路遮罩（例如，/24 對應 255.255.255.0）。
  • 目標網路內不存在IP衝突。
危險

映像檔復原（安裝）操作將清除所選硬碟上的所有資料。

在繼續操作前，請先備份所有重要資料。

  1. 在 uefi-installer 登入提示符號中，輸入以下憑證資訊。

    1. 使用者名稱：admin
    2. 密碼：admin

  2. 執行以下指令以開始安裝：

    1. 出現提示時，請選擇目標分割區

    2. 請輸入 YES 以確認

      restore
    解決「未找到映像檔」錯誤

    如果安裝程式回傳 hex_install: Error: No映像檔 found 錯誤，請依照 解決「No映像檔 found」錯誤 中的步驟來排除此問題。

  3. 安裝完成後，請使用以下指令重新啟動系統：

    1. 請輸入 YES 以確認

      reboot
single-node-functions

開始使用 CubeCOS 控制台​

完成 restore 程序並重新啟動後，你會看到 CubeCOS 節點初始畫面。

按下 F2 鍵以開始設定程序。

cubecos_3_0_console-image

登入以開始安裝​

使用預設使用者登入：

  • 使用者名稱：admin
  • 密碼：admin

選擇設定選項 - 安裝精靈​

輸入 1 以啟動互動式設定精靈。

    First Time Setup Options:
    1: Wizard
    2: Advanced
    Enter index: 1

閱讀並接受最終用戶授權協議（EULA）​

請依照提示閱讀並接受授權條款。

    -- Welcome --
    Welcome to the Cube Appliance setup wizard.
    Using this setup wizard, you can:
    * View and accept the Software License Agreement
    * Set the appliance password
    * View and configure networking

    Press Enter to continue.

    -- Software License Agreement --
    Currently selected language: English
    1: Select language for license display
    2: Read Bigstack terms
    3: Read non-Bigstack terms
    4: Proceed to acceptance

    Select option: 4

    By choosing 'I agree,' you agree that (1) you have had the opportunity to
    review the terms of licenses presented above and (2) such terms govern this
    transaction. If you do not agree, choose 'I do not agree'.
    1: I agree
    2: I do not agree

    Select option: 1

變更密碼​

預設情況下，CubeCOS會在執行 set_ready 後更新密碼。 其採用格式 [email protected]，其中 xxx.xxx 代表叢集 VIP 的最後兩個八位元組。

註解

若叢集 VIP 為 192.168.100.100，更新後的預設密碼將為：[email protected]。

手動變更密碼：

    -- Appliance Password --
    Password changes are applied immediately.
    Password has not been modified.
    1: Change password
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Change Password -
    Enter old password: admin
    Enter new password:
    Confirm new password:
    Password successfully changed.

設定主機名稱​

警告

有效的主機名稱必須使用小寫英文字母，且不得包含特殊字元（!@#$%^&*()）、底線（_）或空格。

有效的主機名稱必須：

  • 僅包含小寫字母（a-z）、數字（0-9）及連字號（-）
  • 不得超過64個字元
  • 在同個環境內不可重複
  • 開頭必須為英文字母
  • 不可全為數字
    -- Host Name Configuration --
    Host name: unconfigured
    1: Change the host name
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Change the Host Name -
    Enter the new host name: control-converged

    -- Host Name Configuration --
    Host name: control-converged
    1: Change the host name
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

[選擇性] 建立網路介面聚合​

網路介面聚合屬選擇性功能，僅適用於需要網路高可用的部署情境。 欲深入瞭解網路配置選項與部署情境，請參閱網路配置章節。

如果不需要設定網路介面聚合和VLAN介面，可直接前往 Configure an IP address for a specific interface。

資訊

若已連接網路纜線，[速度]欄位將顯示連線狀態（例如：1000Mb/s、10Gb/s）。 若未偵測到連接線，則顯示 N/A。

警告

請勿使用系統保留名稱（例如 bond0、bond1、bondx 或 bd0）作為綁定介面名稱。

    -- Network Bonding Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display policy
    2: Configure network bonding
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

[選擇性] 建立 VLAN​

若無需進行VLAN標記，請跳過此步驟。

    -- VLAN Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display policy
    2: Configure vlan network
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

為特定介面設定 IP 位址​

為主要介面指派靜態 IPv4 位址、子網路遮罩及預設閘道。 本指南假設僅存在一個標記為 IF.1 的網路介面。

在繼續操作之前，請確保您備妥以下資訊：

  • CubeCOS 管理 VIP 的靜態 IP 位址
  • 管理網路的子網路遮罩
  • 子網路的預設閘道
  • 將使用的 DNS 伺服器 IP 位址
    -- Networking Settings --
    ---------------------------------------------------
       Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display device status
    2: Display policy
    3: Configure IF.1
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 3

    - Configure IF.1 -
    Enter the IPv4 address: <your-cluster-ip-address>
    Enter the IPv4 subnet mask: <your-subnet-mask>
    Enter the IPv4 default gateway: <your-gateway-address>

    -- Networking Settings --
    ---------------------------------------------------
    Label   BusID/Slaves     Driver  State    Speed
    ---------------------------------------------------
        IF.1   0000:04:00.0      r8169     UP    1000F
    ---------------------------------------------------
    1: Display device status
    2: Display policy
    3: Configure IF.1
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

設定 DNS 伺服器​

輸入 CubeCOS 應使用的 DNS 伺服器，可為內部或外部 DNS 解析器。 設定最多三個要使用的 DNS 伺服器。 以下範例用於設定外部 DNS 伺服器為 1.1.1.1。

    -- DNS Configuration --
    No DNS servers configured.
    1: Set DNS server 1
    2: Set DNS server 2
    3: Set DNS server 3
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

    - Set DNS Server 1 -
    Enter the DNS server IP address: 1.1.1.1

設定時區​

資訊

在叢集的所有節點上設定相同的時區。 時間同步的穩定性對於協調服務運作、確保日誌時間戳準確性，以及避免同步問題至關重要。

要設定時區，請選擇選項 1。

    -- Time Configuration --
    Time configuration changes are applied immediately.
    Time Zone: America/New_York
    Date: 05/29/2025
    Time: 14:00:37
    1: Change the time zone
    2: Change the date
    3: Change the time
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

設定 CubeCOS 節點角色​

若要瞭解 CubeCOS 架構與節點角色，請參閱 架構章節 或 角色章節。

    -- Cube Role --
    Current role: undef
    Current Management: IF.1
    Current Domain/Region: default/RegionOne
    Current Cube Secret Seed: N/A
    1: Change role
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: 1

當系統提示時，請輸入以下數值：

警告

叢集秘密種子用來加密並產生叢集內的參數。 設定獨特且強大的值，以確保叢集通訊與加密運算的安全性。

    - Change Role -
    Select a role:
    1: control
    2: compute
    3: storage
    4: control-converged
    5: edge-core
    6: moderator
    Enter index: 4                                          # Select the desired role, control-converged is selected for example
    Specify external IP/domain [optional]:                  # Leave blank
    Specify management interface: IF.1                      # Interface for control/API traffic
    Specify provider interface: IF.1                        # Interface for VM data and external traffic
    Specify overlay interface: IF.1                         # Interface used for internal SDN tunnel traffic
    Specify storage interface [frontend(,backend)]: IF.1    # Interface for Ceph traffic
    Specify region ("RegionOne"):                           # Keep default or customize as needed
    Specify cluster secret seed: <replace-with-your-secret> # Unique secret shared among nodes in the same cluster
    Specify management CIDR ("10.254.0.0/16"):              # (Optional) Change only if there is a subnet conflict, must be /16 subnet

設定高可用性​

註解

單節點部署不支援高可用性 (HA)

單節點部署不支援高可用性，請按 n 跳過此設定。

在三節點叢集上啟用高可用性，以提供容錯功能。

請選擇選項 1 以執行 變更高可用性。 然後回答 是 以啟用高可用性 Cube。

    -- Cube High Availability --
        Current HA setting: disabled
        1: Change HA
        x: Exit
        p: Previous screen
        n: Next screen

        Select option: 1

        - Change HA -
        High Available Cube:
        1: Yes
        2: No
        Enter index: 1

請選擇選項 n 以繼續。

        Specify control virtual Hostname: <cluster-virtual-hostname>
        Specify control virtual IP: <cluster-virtual-ip>
        Specify control group hostname [HOST,HOST,...]: <control-node-hostname-1>,<control-node-hostname-2>,<control-node-hostname-3>
        Specify control group address [IP,IP,...]: <control-node-ip-1>, <control-node-ip-2>, <control-node-ip-3>

        -- Cube High Availability --
        Current HA setting: enabled
        Current Control Virtual Hostname: ccvip                                   # sample output
        Current Control Virtual IP: 10.32.2.230                                   # Sample output
        Current Control Group: cc1(10.32.2.231),cc2(10.32.2.232),cc3(10.32.2.233) # example output
        1: Change HA
        x: Exit
        p: Previous screen
        n: Next screen

        Select option: n

開始政策設定與加入叢集​

在任何 CubeCOS 集群部署中，第一個初始化的控制主機將成為主節點。 此節點負責建立核心服務初始化，並為叢集套用基礎配置。

Apply and confirm master node policy application

在第一個控制節點完成策略套用之前，請勿繼續進行其他控制節點的操作。

在主節點完成之前啟動其他節點可能導致：

  • 服務註冊失敗
  • 組態漂移
  • 叢集不穩定性或狀態不一致

在主節點完成設定並顯示政策成功套用的訊息（Policy changes were successfully applied）後，即可設定其餘兩個控制節點。

以下是部署過程中使用的完整配置範例。

    Summary
    Password has not been modified.
    Host name: control-converged
    IF.1
        Default interface.
        IPv4 Mode: Manual
        IPv4 Address: 10.32.2.231
        IPv4 Netmask: 255.255.0.0
        IPv4 Gateway: 10.32.0.254
        IPv6 Mode: Automatic
    DNS server 1: 1.1.1.1
    Time Zone: Asia/Taipei
    Date: 05/29/2025
    Time: 14:54:19
    Role: control-converged
    External IP/Domain: N/A
    Management: IF.1
    Provider: IF.1
    Overlay: IF.1
    Storage: IF.1
    Domain/Region: default/RegionOne
    Cube Secret Seed: bigstack
    Management CIDR: 10.254.0.0/16
    High Availability: enabled
    Control Virtual Hostname: ccvip
    Control Virtual IP: 10.32.2.230
    Control Group: cc1(10.32.2.231),cc2(10.32.2.232),cc3(10.32.2.233)
    High Availability: disabled
    1: Accept the configuration
    2: Cancel the configuration
    3: Modify the configuration

    Select option: 1

套用設定所需的時間可能因系統硬體效能而異。

監控控制台輸出。 當程序成功完成時，您將看到一則確認訊息。

Verify success in the console

政策變更已成功套用。

以套用政策變更，登出並重新登入​

政策成功套用後，請登出並重新登入控制台，以確保變更生效並反映於介面中。

系統排錯​

修正錯誤的設定。​

若設定有誤，安裝程序將會失敗並顯示錯誤訊息。

:::caution[Reboot [必填]

在重新嘗試前，請重新啟動節點。 重新啟動後，請仔細檢查您的設定，並在再次嘗試安裝前進行必要的修正。

:::

    Policy changes could not be applied. System must be rebooted.
    Press enter to continue:

解決「未找到映像檔」錯誤​

如果 restore 指令回傳以下錯誤，表示安裝程式無法找到安裝媒體：

uefi-installer> restore
hex_install: Error: No images found
Unexpected error
uefi-installer>

要解決此問題，請依照以下步驟手動掛載安裝媒體。

退出安裝程式命令列（CLI）介面，並開啟 root shell​

退出安裝程式命令列（CLI）介面，並以 root 身分登入：

uefi-installer> exit

在登入提示字元處，請輸入以下憑證：

  • 使用者名稱： root
  • 密碼： admin
uefi-installer login: root
Password:
Last login: Mon Jul 11 06:49:03 on ttyS0
Welcome to the Cube Appliance Installer
#

使用 lsblk 驗證區塊裝置​

執行 lsblk 來識別區塊裝置，並確認安裝媒體是否已掛載：

# lsblk
lsblk-command

如果安裝用 USB 隨身碟（例如 sdd1）未列出掛載點，請繼續執行下一步。

手動掛載安裝媒體​

  1. 將安裝分區掛載至 /mnt/install。

    mount /dev/sdd1 /mnt/install

  2. 請確認掛載結果。

    # lsblk
    NAME   MAJ:MIN RM   SIZE RO TYPE MOUNTPOINT
    sda      8:0    0 744.6G  0 disk
    ├─sda1   8:1    0  1000M  0 part
    ├─sda2   8:2    0     2G  0 part
    ├─sda5   8:5    0 357.4G  0 part
    ├─sda6   8:6    0 357.4G  0 part
    └─sda7   8:7    0  26.9G  0 part
    sdb      8:16   0   5.1T  0 disk
    ├─sdb1   8:17   0   400M  0 part
    ├─sdb2   8:18   0   400M  0 part
    ├─sdb3   8:19   0   2.6T  0 part
    └─sdb4   8:20   0   2.6T  0 part
    sdc      8:32   0   5.1T  0 disk
    ├─sdc1   8:33   0   400M  0 part
    ├─sdc2   8:34   0   400M  0 part
    ├─sdc3   8:35   0   2.6T  0 part
    └─sdc4   8:36   0   2.6T  0 part
    sdd      8:48   1  28.7G  0 disk
    └─sdd1   8:49   1   5.7G  0 part /mnt/install
    sr0     11:0    1  1024M  0 rom
    sr1     11:1    1  1024M  0 rom

    請確認 sdd1 目前是否將 /mnt/install 顯示為其掛載點。

返回安裝程式命令列（CLI）介面並繼續安裝​

切換回 admin 使用者以繼續安裝：

# su admin
Welcome to the Cube Appliance Installer
Welcome to the Cube Appliance
Enter "help" for a list of available commands
uefi-installer>

請返回 開始安裝程序 並繼續。