Skip to main content
Version: 2.3

Control node Installation Guide

What is a Control#

Control node included Control, which required compute node & storage node to ensure the full functional of CubeOS

Dependency#

  • Compute node (HCI)
  • [optional] Storage node

Hardware recommendation#

  1. Processor:

    • Any x86 CPU with a minimum of 6 Cores and 12 Threads (equivalent to 12 vCPUs) or better.

  2. Memory:

    • At least 32GB of RAM.

  3. System Drive:

    • 1x 500GB SSD for the system drive (RAID1 configuration recommended for redundancy).

  4. Storage (Optional):

    • Additional SSD/HDD for a storage pool, configured as JBOD (Just a Bunch Of Disks) or single-disk RAID0 for increased storage capacity.

Installation#

Choose a setup options - Wizard#

First Time Setup Options:1: Wizard2: AdvancedEnter index: 1

Accept the 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: English1: Select language for license display2: Read Bigstack terms3: Read non-Bigstack terms4: Proceed to acceptance
Select option: 4
By choosing 'I agree,' you agree that (1) you have had the opportunity toreview the terms of licenses presented above and (2) such terms govern thistransaction. If you do not agree, choose 'I do not agree'.1: I agree2: I do not agree
Select option: 1

[Optional]Change the password#

(default : admin)#

-- Appliance Password --Password changes are applied immediately.Password has not been modified.1: Change passwordx: Exitp: Previous screenn: Next screen
Select option: 1
- Change Password -Enter old password: adminEnter new password:Confirm new password:Password successfully changed.

Configure hostname#

-- Host Name Configuration --Host name: unconfigured1: Change the host namex: Exitp: Previous screenn: Next screen
Select option: 1
- Change the Host Name -Enter the new host name: control
-- Host Name Configuration --Host name: control1: Change the host namex: Exitp: Previous screenn: Next screen
Select option: n

[Optional] Configure network bonding#

if cable is connected, column [Speed] will present the status else N/A, WARNING: do not use bond0, bond1, bondx as bonding name#

-- Network Bonding Settings ----------------------------------------------------Label          BusID   Driver  State    Speed--------------------------------------------------    IF.1   0000:04:00.0    r8169     UP    1000F--------------------------------------------------1: Display policy2: Configure network bondingx: Exitp: Previous screenn: Next screen
Select option: n

[Optional] Create VLAN#

-- VLAN Settings ----------------------------------------------------Label          BusID   Driver  State    Speed--------------------------------------------------    IF.1   0000:04:00.0    r8169     UP    1000F--------------------------------------------------1: Display policy2: Configure vlan networkx: Exitp: Previous screenn: Next screen
Select option: n

Configuare the IP address - IF.1#

-- Networking Settings ----------------------------------------------------Label          BusID   Driver  State    Speed--------------------------------------------------    IF.1   0000:04:00.0    r8169     UP    1000F--------------------------------------------------1: Display device status2: Display policy3: Configure IF.1x: Exitp: Previous screenn: Next screen
Select option: 3
- Configure IF.1 -Enter the IPv4 address: 10.32.2.240Enter the IPv4 subnet mask: 255.255.0.0Enter 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 status2: Display policy3: Configure IF.1x: Exitp: Previous screenn: Next screen
Select option: n

Setting DNS#

-- DNS Configuration --No DNS servers configured.1: Set DNS server 12: Set DNS server 23: Set DNS server 3x: Exitp: Previous screenn: 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.81: Set DNS server 12: Set DNS server 23: Set DNS server 3x: Exitp: Previous screenn: Next screen
Select option: n

Setting the timezone#

[IMPORTANT] all nodes must be on the same zone and make sure all the clock/time are sync'ed

-- Time Configuration --Time configuration changes are applied immediately.Time Zone: America/New_YorkDate: 01/02/2023Time: 14:00:371: Change the time zone2: Change the date3: Change the timex: Exitp: Previous screenn: Next screen
Select option: 1
- Change the Time Zone -Select a continent or ocean:1: Africa2: Americas3: Asia4: Atlantic Ocean5: Australia6: Europe7: Pacific Ocean8: EtcEnter index: 3Select a timezone:1: (UTC+02:00) Asia/Jerusalem2: (UTC+03:00) Asia/Kuwait3: (UTC+03:00) Asia/Riyadh~~~~~~30: (UTC+08:00) Asia/Taipei~~~~~~39: (UTC+12:00) Asia/KamchatkaEnter index: 30



-- Time Configuration --Time configuration changes are applied immediately.Time Zone: Asia/TaipeiDate: 07/23/2020Time: 17:17:361: Change the time zone2: Change the date3: Change the timex: Exitp: Previous screenn: Next screen
Select option: n

Configure the role - Option 5: control-network#

-- Cube Role --Current role: undefCurrent Management: IF.1Current Domain/Region: default/RegionOneCurrent Cube Secret Seed: N/A1: Change rolex: Exitp: Previous screenn: Next screen
Select option: 1
- Change Role -Select a role:1: control2: compute3: storage4: control-converged5: edge-core6: moderatorEnter index: 1Specify external IP/domain [optional]:Specify management interface: IF.1Specify storage interface [frontend(,backend)]: IF.1Specify region ("RegionOne"):Specify cluster secret seed: bigstackSpecify management CIDR ("10.254.0.0/16"):
-- Cube Role --Current role: controlCurrent External IP/Domain: N/ACurrent Management: IF.1Current Storage: IF.1Current Domain/Region: default/RegionOneCurrent Cube Secret Seed: bigstackCurrent Management CIDR: 10.254.0.0/161: Change rolex: Exitp: Previous screenn: Next screen
Select option: n

[Optional] High Availability setting#

-- Cube High Availability --Current HA setting: disabled1: Change HAx: Exitp: Previous screenn: Next screen
Select option: n

Summary#

SummaryPassword has not been modified.Host name: controlIF.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:  AutomaticDNS server 1: 8.8.8.8Time Zone: Asia/TaipeiDate: 01/02/2023Time: 14:00:53Role: controlExternal IP/Domain: N/AManagement: IF.1Storage: IF.1Domain/Region: default/RegionOneCube Secret Seed: bigstackManagement CIDR: 10.254.0.0/16High Availability: disabled1: Accept the configuration2: Cancel the configuration3: Modify the configuration
Select option: 1

IMPORTANT: Please wait for the first control node apply policy complete before you continue to next node#

Error message:#

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

Please RE-image the nodes, if the error message above is presented and start over the installation progress#

After all nodes installation are completed:#

Instruct the cluster to initialise the system accordingly by running the CLI : cluster set_ready. Reminder this action only required to run once on one of the control roles (control,control-converged,edge-core,moderator)

# ssh admin@IPADDRESSWelcome to the Cube ApplianceEnter "help" for a list of available commandscontroller>cluster set_readyCreate a shared external network?Enter 'YES' to confirm: YESInput public network in CIDR: 10.32.0.0/16Input gateway of public network: 10.32.0.254Enter 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
Last updated on by Roy Tan