版本：3.0

單節點安裝入門指南

管理融合 (AIO) 節點概覽

AIO 節點將所有核心角色整合至單一節點，包含控制平面服務、運算、網路及儲存功能。此全功能整合部署方案可在單一機器上完整運行CubeCOS，非常適合用於測試、評估或小型環境。

AIO 節點硬體需求

處理器

CubeCOS 需要配備 x86-64-v2 架構至少具備 8 個核心與 16 個執行緒的 CPU。
所使用的處理器必須支援並啟用硬體虛擬化功能（Intel VT-x 或 AMD-V）。
必須為64位元版本，且發佈日期在2017年後。

記憶體

CubeCOS 叢集節點至少配備 128GB 記憶體。
每1TB可用軟體定義儲存容量，需額外預留1.7GB記憶體。

系統碟 (Solid State Drive)

最低要求：1 顆 500GB 固態硬碟 (SSD) 作為系統磁碟。
生產環境：使用兩顆 SSD 配置 RAID-1，以確保生產環境中的資料冗餘與容錯能力。

儲存

CubeCOS 需要額外的儲存裝置（例如 SSD、HDD 或 NVMe）來建立儲存池。
CubeCOS 支援以下儲存配置：
- JBOD 磁碟櫃
- 主機匯流排介面卡 (HBA)
Kubernetes 工作需要固態硬碟（SSD）的儲存裝置。

下載安裝檔案

請根據您偏好的安裝方式，從 CubeCOS GitHub 儲存庫下載安裝檔案。

支援的安裝方式

USB隨身碟：建立可開機的USB映像檔，直接安裝CubeCOS。
虛擬媒體或DVD的ISO檔：使用虛擬媒體掛載ISO檔，或燒錄至DVD以進行安裝。
透過 PXE 伺服器進行網路開機 (IMG/ISO)：使用 PXE 伺服器透過 IMG 或 ISO 格式進行網路安裝。

準備叢集資訊

請利用下列表格準備叢集部署所需的資訊。

CubeCOS 節點 IP 位置和主機名稱

CubeCOS 節點主機名稱	管理 IP 位址

A sample planner

CubeCOS 節點主機名稱	管理 IP 位址
管理融合節點	10.32.2.230

公共網路設定

快速入門指南請使用以下叢集資訊：

公共網路：允許存取網際網路或內部資源的網路。
Flat 網路：平面網路採用設定為橋接模式的乙太網路介面，使所有節點間能實現無縫的網路流量傳輸。此配置可透過實體主機上的單一網路介面卡或多個介面卡來實現，具體取決於系統設定。
DHCP IP 位址池：可用的 DHCP IP 位址池位於同一平面網路中，範圍介於 100 至 200 之間。

在繼續之前，請確認：

所選的子網不會與您環境中的其他網路發生重疊。
確保可從子網路內存取閘道 IP。
此 DHCP 範圍未被其他服務使用，且具備足夠的可用 IP 位址，足以滿足您預期的虛擬機器虛擬機需求。
CIDR 和閘道已正確設定，可依需求允許外部存取（例如：網際網路、上游路由器等）。

您將在執行 cluster set_ready 程序時設定公共網路。

警告

將公共網路和 DHCP IP 範圍變更為適用於您網路的設定。

公共網路 CIDR	公共網路閘道位址	DHCP IP 位址池範圍

Sample public network configuration

公共網路 CIDR	公共網路閘道位址	DHCP IP 位址池範圍
10.32.0.0/16	10.32.0.254	10.32.2.100-10.32.2.200

開始安裝流程

在準備安裝媒體並啟動目標機器之後。開始安裝程序。

登入並開始還原流程

資訊

在開始設定之前，請先確認網路設定：

請確保所分配的 IP 位址位於正確的子網範圍內。
請確認CIDR表示法是否正確反映預期的網路遮罩（例如，/24 對應 255.255.255.0）。
請確保目標網路內不存在IP位址衝突。

危險

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

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

在 uefi-installer 登入提示符號中，輸入以下憑證資訊。
1. 使用者名稱：admin
2. 密碼：admin
執行 restore 以開始安裝。安裝程式會列出可用的硬碟。請輸入目標硬碟的 索引號，然後輸入 YES 以確認。
```
uefi-installer> restore
 1: sda   238.5G   INTEL
 2: sdb   476.9G   SQF-S25V2-512GDSDC
Enter index: 1
Restoring CUBE_<version> on /dev/sda
Enter 'YES' to confirm: YES
```
資訊
在具有多個硬碟的節點上，請選擇用於安裝作業系統的硬碟。任何額外的硬碟均用於儲存池。

解決「未找到映像檔」錯誤
如果安裝程式回傳 hex_install: Error: No映像檔 found 錯誤，請依照解決「No映像檔 found」錯誤中的步驟來排除此問題。
安裝完成後，請使用以下指令重新啟動系統：
1. 請輸入 YES 以確認
```
reboot
```

開始使用 CubeCOS 控制台

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

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

使用預設使用者登入：

使用者名稱：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，請跳至為特定介面設定 IP 位址。

    -- 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 位址

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

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

CubeCOS 管理 IP 的靜態 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-management-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: <your-dns-server>

設定時區

資訊

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

要設定時區，請選擇選項 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 節點角色

在單節點部署中，請選擇control-converged角色。此角色將控制平面、運算與儲存功能整合於單一主機之上。

    -- 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 control-converged role
    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 bridge
    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 跳過此步驟：

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

開始套用設定

請仔細檢視配置摘要後再繼續。如有需要，您可以修改設定。

準備開始安裝時，請選擇選項 1 以套用設定：

    Summary
    Password has not been modified.
    Host name: control-converged
    IF.1
        Default interface.
        IPv4 Mode: Manual
        IPv4 Address: 10.32.2.230
        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: disabled
    1: Accept the configuration
    2: Cancel the configuration
    3: Modify the configuration

    Select option: 1

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

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

Verify success in the console

政策變更已成功套用。

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

重新登入後，主控台狀態畫面顯示該節點處於 服務就緒 狀態，角色數量分別為 1 個控制節點、1 個運算節點 及 1 個儲存節點。

初始化叢集

請執行 cluster set_ready 命令列（CLI）介面指令來初始化系統。此步驟是將單一節點置於運作狀態所必需的。

此指令透過以下方式為叢集進行運作準備：

驗證並啟用儲存裝置。
套用儲存複製政策（已針對單節點拓撲進行調整）。
正在初始化核心平台服務（運算、網路、儲存、身分識別、監控等）。
設定共用外部網路。

警告

請僅執行一次 cluster set_ready 指令。至少必須有一個 Ceph OSD 先處於 up 狀態，否則該指令會因「集群儲存中沒有任何正在運行的 OSD，導致 set_ready 操作中止」而中止。

請提供在公共網路設定中所準備的公共網路設定。您可以將其作為參數傳入：set_ready [<CIDR>] [<gateway>] [<IP,IP-IP>]，或在系統提示時以互動方式輸入數值。

    control-converged> cluster
    control-converged:cluster> set_ready 10.32.0.0/16 10.32.0.254 10.32.1.100-10.32.1.110
    Storage disk configurations.
    ============================================================
    GROUP: default
    ID  CLASS  WEIGHT   TYPE NAME                   STATUS  REWEIGHT  PRI-AFF
    -1         0.46500  root default
    -3         0.46500      host control-converged
     0    ssd  0.23250          osd.0                   up   1.00000  1.00000
     1    ssd  0.23250          osd.1                   up   1.00000  1.00000
    [1/6] Updating storage replication rule
    [2/6] Checking SDN services
    [3/6] Configuring modules
    (1/5) processing: cube_last
    (2/5) processing: octavia
    (3/5) processing: influxdb
    (4/5) processing: opensearch-dashboards
    (5/5) processing: kafka
    [4/6] Starting cluster
    [5/6] Strengthening password
    [6/6] Cluster check and repair
    Done

當顯示 Done 且所有服務皆回報 ok 時，叢集即已就緒。

註解

在 [5/6] 強化密碼 步驟中，CubeCOS 會將預設的 admin 密碼替換為 [email protected] 格式的密碼，其中 xxx.xxx 代表叢集 VIP 的最後兩個八位元組。例如，若 VIP 為 10.32.1.200，則密碼即為 [email protected]。後續登入時請使用此密碼。

驗證部署

確認節點狀態正常：

主控台狀態畫面顯示 服務已就緒 以及 1 個控制節點 / 1 個運算節點 / 1 個儲存節點。
儲存裝置狀態良好：在 root shell 中執行 ceph -s 會顯示 health: HEALTH_OK（在執行 set_ready 之前，步驟 [1/6] 更新儲存複製規則 會清除單一主機上預期會出現的 undersized/degraded 警告）。

存取管理介面

在您的本地系統上開啟瀏覽器。
請瀏覽至 https://<your-management-ip-address>（例如：https://10.32.1.200）。
請使用以下帳號登入：
1. 使用者名稱：admin
2. 密碼：設定時所設定的密碼，或是由 set_ready 生成的預設值 [email protected]。
登入後，您可透過網頁使用者介面管理您的 CubeCOS 環境。

系統排錯

修正錯誤的設定。

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

:::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

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

手動掛載安裝媒體

將安裝分區掛載至 /mnt/install。
```
mount /dev/sdd1 /mnt/install
```

請確認掛載結果。

# 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>

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

管理融合 (AIO) 節點概覽​

AIO 節點硬體需求​

處理器​

記憶體​

系統碟 (Solid State Drive)​

儲存​

下載安裝檔案​

支援的安裝方式​

準備叢集資訊​

CubeCOS 節點 IP 位置和主機名稱​

公共網路設定​

開始安裝流程​

登入並開始還原流程​

開始使用 CubeCOS 控制台​

登入以開始安裝​

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

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

變更密碼​

設定主機名稱​

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

[可選] 設定 VLAN​

為特定介面設定 IP 位址​

設定 DNS 伺服器​

設定時區​

設定 CubeCOS 節點角色​

設定高可用性​

開始套用設定​

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

初始化叢集​

驗證部署​

存取管理介面​

系統排錯​

修正錯誤的設定。​

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

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

使用 lsblk 驗證區塊裝置​

手動掛載安裝媒體​

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