三節點叢集安裝入門指南
管理融合(AIO)叢集概覽
三節點叢集由三個管理融合節點組成,每個節點皆將所有核心角色—控制平面服務、運算、網路及儲存整合於單一機器之中。
此三節點管理融合部署具備高可用性與叢集功能,適用於測試、評估或小型正式環境。
管理融合節點硬體需求
處理器
- CubeCOS 需要配備 x86-64-v2 架構的 CPU,至少具備 8 個核心與 16 個執行緒。
- 所使用的處理器必須支援並啟用硬體虛擬化功能(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 儲存庫 下載安裝檔案。
支援的安裝方式
- UBS 隨身碟:建立可開機的 USB 裝置,直接安裝 CubeCOS。
- ISO 映像檔:透過虛擬媒體掛載 ISO 檔,或將其燒錄至 DVD。
- 透過 PXE 伺服器進行網路開機 (IMG/ISO):使用 PXE 伺服器透過 IMG 或 ISO 格式進行網路安裝。
準備叢集資訊
請利用下列表格準備叢集部署所需的資訊。
CubeCOS 節點 IP 位置和主機名稱
| CubeCOS 節點 | 主機名稱 | IP位址 |
|---|---|---|
| 節點 1 | ||
| 節點 2 | ||
| 節點 3 | ||
| 集群 VIP |
| CubeCOS 節點 | 主機名稱 | IP位址 |
|---|---|---|
| 節點 1 | cc1 | 10.32.2.231 |
| 節點 2 | cc2 | 10.32.2.232 |
| 節點 3 | cc3 | 10.32.2.233 |
| 集群 VIP | ccvip | 10.32.2.230 |
公共網路設定
快速入門指南請使用以下叢集資訊:
- 公共網路:允許存取網際網路或內部資源的網路。
- 平面(Flat)網路:平面網路採用設定為橋接模式的乙太網路介面,使所有節點間能實現無縫的網路流量傳輸。 此配置可透過實體主機上的單一網路介面卡或多個介面卡來實現,具體取決於系統設定。
- DHCP IP 位址池:可用的 DHCP IP 位址池位於同一平面網路中,範圍介於 100 至 200 之間。
在繼續之前,請確認:
- 所選的子網不會與您環境中的其他網路發生重疊。
- 確保可從子網路內存取閘道 IP。
- 此 DHCP 範圍未被其他服務使用,且具備足夠的可用 IP 位址,足以滿足您預期的虛擬機器虛擬機需求。
- CIDR 和閘道已正確設定,可依需求允許外部存取(例如:網際網路、上游路由器等)。
您將在執行 cluster set_ready 程序時設定公共網路。
將公共網路和 DHCP IP 範圍變更為適用於您網路的設定。
| 公共網路 CIDR | 公共網路閘道位址 | DHCP IP 位址池範圍 |
|---|---|---|
| 公共網路 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登入提示符號中,輸入以下憑證資訊。- 使用者名稱:
admin - 密碼:
admin
- 使用者名稱:
-
執行以下指令以開始安裝:
-
出現提示時,請選擇目標分割區
-
請輸入
YES以確認restore
解決「未找到映像檔」錯誤如果安裝程式回傳
hex_install: Error: No映像檔 found錯誤,請依照 解決「No映像檔 found」錯誤 中的步驟來排除此問題。 -
-
安裝完成後,請使用以下指令重新啟動系統:
-
請輸入
YES以確認reboot
-

開始使用 CubeCOS 控制台
完成 restore 程序並重新啟動後,你會看到 CubeCOS 節點初始畫面。
按下 F2 鍵以開始設定程序。

登入以開始安裝
使用預設使用者登入:
- 使用者名稱:管理員
- 密碼:admin
選擇設定選項 - 安裝精靈
輸入 1 以啟動互動式設定精靈。
First Time Setup Options:
1: Wizard
2: Advanced
Enter index: 1
x請使用 n(下一頁)和 p(上一頁)鍵在精靈畫面之間切換。 按下 x 將退出精靈,並捨棄迄今為止所有已暫存的設定(主機名稱、VLAN、IP、角色、高可用性等),迫使您從頭開始。 僅當您打算完全放棄設定程序時,才使用 x。
閱讀並接受最終用戶授權協議(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 IP 的最後兩個八位元組。
若叢集 VIP 為 192.168.100.100,更新後的預設密碼將為:[email protected]。
選擇選項 1 以手動變更密碼。
-- 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個字元
- 在同個環境內不可重複
- 開頭必須為英文字母
- 不可全為數字
請將 <your-host-name> 替換為您 CubeCOS 主機的唯一主機名稱。
-- 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: <your-host-name>
-- Host Name Configuration --
Host name: <your-host-name>
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
若要 建立 VLAN 子介面,請選擇 2:設定 VLAN 網路,而非跳過由 10G 上行鏈路傳輸的標記式覆蓋網路或儲存網路。 接著點選 建立,選擇父介面,並輸入 VLAN ID。
2: Configure vlan network
1: Create
Select interface: IF.5
Enter VLAN ID: 80
針對每個 VLAN,重複執行 Create 指令。 接著,這些新的子介面會以額外的標籤形式出現(例如 IF.5.80、IF.5.95),在下一步中,您需為每個子介面指派一個 IP 位址。
為特定介面設定 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
上方的範例是主要介面,其路徑直接為 IPv4 位址 → 子網路遮罩 → 閘道。 VLAN 子介面(例如 IF.5.80)則會顯示以下提示:
是否啟用此介面?→ 回答是將此設定為預設介面嗎?→ 回答否(僅管理介面應設為預設)- IPv4 位址 → 子網路遮罩
請勿在非預設介面上設定閘道。 請將預設路由保留為管理介面。 僅管理介面 (IF.1) 被指派了閘道。
設定 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 節點角色
在三節點叢集部署中選擇管理融合角色。 此角色將控制平面、運算與儲存功能整合於單一主機之上。
-- 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
設定高可用性
在三節點叢集上啟用高可用性,以提供容錯功能。
請選擇選項 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
請輸入來自Plan CubeCOS 節點 IP 位址與主機名稱 的主機名稱與 IP 位址。 請選擇選項 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
對照組中的主機名稱清單與位址清單必須包含相同數量的項目,且呈一對一對應關係。 如果計數不符(例如因位址提示字元中出現尾隨逗號或多餘空格所致),精靈會顯示「主機名稱與 IP 位址不符」的訊息,並 捨棄整個高可用性 (HA) 設定,因此您必須重新輸入。
請完整輸入這兩組以逗號分隔的清單,並提交;若值為空,請勿按下「Enter」鍵。
開始政策設定與加入叢集
在三節點的 CubeCOS 部署中,第一個初始化的節點將擔任叢集主節點。 此節點負責套用基礎配置,並初始化核心服務,例如身分驗證、網路、儲存及調度服務。
在第一個(主控)節點完全完成策略應用之前,請勿繼續初始化其餘控制節點。
在主節點完成之前啟動其他節點可能導致:
- 服務註冊失敗
- 組態漂移
- 叢集不穩定性或狀態不一致
在主節點完成設定並顯示政策成功套用的訊息後,您即可安全地接受其餘兩個control-converged節點的配置。
以下是部署過程中使用的完整配置範例。
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
套用設定所需的時間可能因系統硬體效能而異。
監控控制台輸出。 當程序成功完成時,您將看到一則確認訊息。
政策變更已成功套用。
請對叢集中的所有三個節點重複安裝程序。
錯誤訊息
若設定檔有錯誤,安裝程序將失敗並顯示錯誤訊息。
Policy changes could not be applied. System must be rebooted.
Press enter to continue:
在重新嘗試前,請重新啟動節點。
重新啟動後,請仔細檢查您的設定項目,並在再次嘗試安裝前進行必要的修正。
在政策成功套用後初始化叢集
初始配置成功套用後,請透過初始化 CubeCOS 叢集來完成設定。
登入叢集
從您的管理工作站或終端機,使用 SSH 連線至 CubeCOS 節點:
ssh admin@<your-cluster-ip-address>
請使用以下憑證:
- 使用者名稱:
admin - 密碼:
- 系統產生的預設值(
Cube@<last-two-octets-of-VIP>) - 或您在設定過程中自訂的密碼
- 系統產生的預設值(
此指令僅需在其中一個控制角色節點上執行一次,該節點可為以下任一節點:
- 控制
- 管理融合節點
- 邊緣運算
- 仲裁節點
叢集初始化
請執行 cluster set_ready 命令列介面指令,指示叢集據此初始化系統。
此指令透過以下方式為叢集進行運作準備:
- 驗證並啟用儲存裝置。
- 套用儲存複製政策。
- 初始化核心平台服務(運算、網路、儲存、身分驗證、監控等)
- 提示進行外部網路設定
僅在一個控制節點上執行一次叢集 set_ready 。 多次執行或從不同節點執行,可能導致配置衝突或服務不穩定。
執行以下指令以啟動初始化程序:
cluster set_ready
請驗證以下輸出中的硬碟狀態與佈局是否正確。 每個實體儲存裝置均劃分為兩個OSD。 固態硬碟儲存裝置能承載所有對延遲敏感的工作負載,或採用混合模式以提升效能。
Welcome to the Cube Appliance
Enter "help" for a list of available commands
controller> cluster set_ready
Storage disk configurations.
============================================================
GROUP: default
ID CLASS WEIGHT TYPE NAME STATUS REWEIGHT PRI-AFF
-1 1.63660 root default
-3 1.63660 host cube1
0 hdd 0.81830 osd.0 up 1.00000 1.00000
1 hdd 0.81830 osd.1 up 1.00000 1.00000
Create a shared external network?
Enter 'YES' to confirm: YES
在提示符下:
- 建立共用外部網路,按下 Enter 鍵
- 輸入
YES以確認
「要建立共用外部網路嗎?」的提示會建立一個 平坦(未標記)的外部網路。 如果您的外部網路是 帶有 VLAN 標籤的,請在此處回答 NO,並稍後透過 Skyline 網頁介面依照 建立帶有 VLAN 的外部/網際網路網路 指南進行設定。 同樣地,您也可以透過使用者介面,依照 建立採用扁平化網路架構的外部/網際網路網路 指南,建立一個扁平化的外部網路。
輸入在規劃公共網路配置中準備的網路配置詳細資訊
Input public network in CIDR: 10.32.0.0/16
Input gateway of public network: 10.32.0.254
Enter public network available IP list [IP,IP-IP]: 10.32.2.100-10.32.2.200
[1/7] Updating storage replication rule
[2/7] Checking SDN services
[3/7] 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/7] Starting cluster
[5/7] Strengthening password
[6/7] Cluster check and repair
Service Status Report
ClusterLink ok [ link(v) clock(v) dns(v) ]
ClusterSys ok [ bootstrap(v) license(v) ]
... # Output abbreviated
Notifications ok [ influxdb(v) kapacitor(v) ]
[7/7] Global Information Tracker
Done
當所有服務皆回報 ok,且控制台顯示 done 時,叢集即準備就緒。
set_ready 會執行背景檢查與修復,但並非總能在首次執行時修復所有服務。 完成後,請執行叢集健康檢查,並修復任何狀態非 ok 的群組:
cluster check
若某個群組回報 NG,請進行修復(例如使用 cluster health<Group> 或相關的單一服務修復指令),並重複執行 cluster check,直到每個群組皆回報 ok 為止。
存取管理介面
- 在您的本地系統上開啟瀏覽器。
- 請前往
https://<your-cluster-ip-address> - 使用預設用戶登入
- 使用者名稱:
admin - 密碼:預設密碼或設定期間設定的密碼
- 使用者名稱:
- 登入後,您可透過網頁使用者介面管理您的 CubeCOS 環境。
啟動您的第一個虛擬機
要在 CubeCOS 中設定你的第一台虛擬機器,請參照 啟動您的第一台虛擬機 指南。
系統排錯
修正錯誤的設定。
若設定有誤,安裝程序將會失敗並顯示錯誤訊息。
在重新嘗試前,請重新啟動節點。 重新啟動後,請仔細檢查您的設定,並在再次嘗試安裝前進行必要的修正。
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 -
請確認掛載結果。
# lsblkNAME MAJ:MIN RM SIZE RO TYPE MOUNTPOINTsda 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 partsdb 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 partsdc 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 partsdd 8:48 1 28.7G 0 disk└─sdd1 8:49 1 5.7G 0 part /mnt/installsr0 11:0 1 1024M 0 romsr1 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>
請返回 開始安裝程序 並繼續。