版本：3.0

控制節點安裝指南

控制節點概覽

控制節點包含控制功能，需配合運算節點與儲存節點方能確保CubeCOS的完整功能運作

需求

運算節點 (HCI)
[可選] 儲存節點

硬體建議

詳細的硬體需求與建議，請參閱硬體需求

安裝

選擇設定選項 - 安裝精靈

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

接受最終用戶授權協議

    -- 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 有一組在安裝過程中使用的預設登入資訊。

預設的安裝密碼是：

使用者名稱：admin
密碼：admin

為強化叢集安全性，並確保未來擴充節點時無需手動執行開機操作，請在安裝 AIO 和控制節點時手道設定叢集密碼。

若在 AIO/控制節點的 set_ready 操作期間未變更預設密碼，叢集將使用預設密碼進行初始化。當向叢集新增節點時，這可能會導致安全性漏洞及運作問題。預設密碼的格式為：[email protected]，其中 xxx.xxx 對應於叢集 VIP IPv4 位址的最後兩個八位元組。

註解

若叢集 VIP 為 192.168.100.100，預設叢集密碼將設定如下： [email protected]

變更節點密碼

在設定 AIO/控制節點的過程中，系統會提示您變更節點密碼。請依照螢幕上的指示，更新叢集密碼。

請輸入舊密碼。
1. 預設密碼是 admin
請輸入一個專屬於該叢集的新密碼。
請確認新密碼。
請確認成功訊息顯示為「密碼已成功變更」。
請針對所有 AIO/控制節點重複此流程，以確保叢集密碼的一致性。

在設定過程中變更節點密碼的範例

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

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

    Select option: n

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

網路綁定屬可選功能，僅適用於需要網路冗餘的部署情境。欲深入瞭解網路配置選項與部署情境，請參閱網路配置章節。

若無需設定綁定與 VLAN，請跳至設定 IP 位址 - IF.1。

資訊

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

警告

請勿使用 bond0、bond1、bondx 或 bd0 作為綁定介面名稱。這些名稱已被保留或可能與系統預設值衝突。

    -- Network Bonding Settings --
    --------------------------------------------------
    Label          BusID   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 Settings --
    --------------------------------------------------
    Label          BusID   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 位址

    -- Networking Settings --
    --------------------------------------------------
    Label          BusID   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: 10.32.2.240
    Enter the IPv4 subnet mask: 255.255.0.0
    Enter the IPv4 default gateway: 10.32.0.254




    -- Networking Settings --
    --------------------------------------------------
    Label          BusID   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）

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

    -- DNS Configuration --
    DNS server 1: 8.8.8.8
    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: n

設定時區

資訊

在叢集內的所有節點上設定相同的時區，以確保時間記錄的一致性。這對於在叢集範圍內妥善協調服務與日誌同步至關重要。

    -- Time Configuration --
    Time configuration changes are applied immediately.
    Time Zone: America/New_York
    Date: 01/02/2023
    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

    - Change the Time Zone -
    Select a continent or ocean:
    1: Africa
    2: Americas
    3: Asia
    4: Atlantic Ocean
    5: Australia
    6: Europe
    7: Pacific Ocean
    8: Etc
    Enter index: 3
    Select a timezone:
    1: (UTC+02:00) Asia/Jerusalem
    2: (UTC+03:00) Asia/Kuwait
    3: (UTC+03:00) Asia/Riyadh
    ~~~~~~
    30: (UTC+08:00) Asia/Taipei
    ~~~~~~
    39: (UTC+12:00) Asia/Kamchatka
    Enter index: 30




    -- Time Configuration --
    Time configuration changes are applied immediately.
    Time Zone: Asia/Taipei
    Date: 07/23/2020
    Time: 17:17:36
    1: Change the time zone
    2: Change the date
    3: Change the time
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

設定角色

    -- 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: 1
    Specify external IP/domain [optional]:
    Specify management interface: IF.1
    Specify storage interface [frontend(,backend)]: IF.1
    Specify region ("RegionOne"):
    Specify cluster secret seed: bigstack
    Specify management CIDR ("10.254.0.0/16"):

    -- Cube Role --
    Current role: control
    Current External IP/Domain: N/A
    Current Management: IF.1
    Current Storage: IF.1
    Current Domain/Region: default/RegionOne
    Current Cube Secret Seed: bigstack
    Current Management CIDR: 10.254.0.0/16
    1: Change role
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

設定高可用性

    -- 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
    Specify control group hostname [HOST,HOST,...]: cc1,cc2,cc3
    Specify control group address [IP,IP,...]: 10.32.2.241,10.32.2.242,10.32.2.243

    -- Cube High Availability --
    Current HA setting: enabled
    Current Control Group:
    cc1(10.32.2.241),cc2(10.32.2.242),cc3(10.32.2.243)
    1: Change HA
    x: Exit
    p: Previous screen
    n: Next screen

    Select option: n

總結

警告

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

在主節點完成設定前初始化其他節點，可能導致服務註冊失敗、配置衝突或叢集狀態不穩定。

    Summary
    Password has not been modified.
    Host name: control
    IF.1
        Default interface.
        IPv4 Mode: Manual
        IPv4 Address: 10.32.2.240
        IPv4 Netmask: 255.255.0.0
        IPv4 Gateway: 10.32.0.254
        IPv6 Mode: Automatic
    DNS server 1: 8.8.8.8
    Time Zone: Asia/Taipei
    Date: 01/02/2023
    Time: 14:00:53
    Role: control
    External IP/Domain: N/A
    Management: 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

應用此策略所需的時間可能因您的硬體效能而異。

監控控制台輸出。政策套用完成後，系統將顯示成功訊息，此時節點已準備就緒，可進行下一步操作。

:::tip[Verify 在控制台中的政策成功

政策變更已成功套用。

:::

錯誤訊息

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

若出現上述錯誤訊息，請重新映像節點並重新開始安裝進程

所有節點安裝完成後

請執行命令列介面，指令 cluster set_ready，指示叢集據此初始化系統。

此指令僅需在每個叢集的其中一個控制節點上執行一次，該節點可為以下任一節點：

控制
管理融合節點
邊緣運算
仲裁節點

警告

在多個節點上執行 set_ready 既非必要，亦可能引發衝突。

# ssh admin@<your-cluster-vip>
Welcome to the Cube Appliance
Enter "help" for a list of available commands
controller>cluster set_ready
Create a shared external network?
Enter 'YES' to confirm: YES
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.150.1-10.32.150.250
[1/6] Updating storage replication rule
[2/6] Checking SDN services
[3/6] Configuring modules
(1/4) processing: cube_last
(2/4) processing: influxdb
(3/4) processing: kibana
(4/4) processing: kafka
[4/6] Starting cluster
[5/6] Strengthening password
[6/6] Cluster check and repair
          Service  Status  Report
      ClusterLink      ok  [ link(v) clock(v) dns(v) ]
       ClusterSys      ok  [ bootstrap(v) license(v) ]
  ClusterSettings      ok  [ etcd(v) ]
        HaCluster      ok  [ hacluster(v) ]
         MsgQueue      ok  [ rabbitmq(v) ]
           IaasDb      ok  [ mysql(v) ]
        VirtualIp      ok  [ vip(v) haproxy_ha(v) ]
          Storage      ok  [ ceph(v) ceph_mon(v) ceph_mgr(v) ceph_mds(v) ceph_osd(v) ceph_rgw(v) rbd_target(v) ]
       ApiService      ok  [ haproxy(v) httpd(v) lmi(v) memcache(v) ]
     SingleSignOn      ok  [ k3s(v) keycloak(v) ]
          Network      ok  [ neutron(v) ]
          Compute      ok  [ nova(v) ]
        Baremetal      ok  [ ironic(v) ]
            Image      ok  [ glance(v) ]
        BlockStor      ok  [ cinder(v) ]
         FileStor      ok  [ manila(v) ]
       ObjectStor      ok  [ swift(v) ]
    Orchestration      ok  [ heat(v) ]
            LBaaS  FIXING  [ octavia(5) ]
                       ok  [ octavia(f1) ]
           DNSaaS      ok  [ designate(v) ]
           K8SaaS      ok  [ rancher(v) ]
       InstanceHa      ok  [ masakari(v) ]
    BusinessLogic      ok  [ senlin(v) watcher(v) ]
         DataPipe      ok  [ zookeeper(v) kafka(v) ]
          Metrics      ok  [ monasca(v) telegraf(v) grafana(v) ]
     LogAnalytics      ok  [ filebeat(v) auditbeat(v) logstash(v) es(v) kibana(v) ]
    Notifications      ok  [ influxdb(v) kapacitor(v) ]
Done

存取管理介面

開啟您選擇的瀏覽器
請導航至 https://<node-ip> 以存取管理介面。
請使用預設憑證 admin/ admin 登入以開始使用！

控制節點概覽​

需求​

硬體建議​

安裝​

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

接受最終用戶授權協議​

變更節點密碼​

變更節點密碼​

在設定過程中變更節點密碼的範例​

設定主機名稱​

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

[可選] 建立 VLAN​

設定 IP 位址​

設定網域名稱系統（DNS）​

設定時區​

設定角色​

設定高可用性​

總結​

錯誤訊息​

若出現上述錯誤訊息，請重新映像節點並重新開始安裝進程​

所有節點安裝完成後​

存取管理介面​

控制節點概覽

需求

硬體建議

安裝

選擇設定選項 - 安裝精靈

接受最終用戶授權協議

變更節點密碼

變更節點密碼

在設定過程中變更節點密碼的範例

設定主機名稱

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

[可選] 建立 VLAN

設定 IP 位址

設定網域名稱系統（DNS）

設定時區

設定角色

設定高可用性

總結

錯誤訊息

若出現上述錯誤訊息，請重新映像節點並重新開始安裝進程

所有節點安裝完成後

存取管理介面