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
Processor:
- Any x86 CPU with a minimum of 6 Cores and 12 Threads (equivalent to 12 vCPUs) or better.
Memory:
- At least 32GB of RAM.
System Drive:
- 1x 500GB SSD for the system drive (RAID1 configuration recommended for redundancy).
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: Wizard
2: Advanced
Enter 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: 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
[Optional]Change the password
(default : admin)
-- 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.
Configure hostname
-- 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
[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 policy
2: Configure network bonding
x: Exit
p: Previous screen
n: 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 policy
2: Configure vlan network
x: Exit
p: Previous screen
n: 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 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
Setting 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
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_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
Configure the role - Option 5: control-network
-- 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
[Optional] High Availability setting
-- Cube High Availability --
Current HA setting: disabled
1: Change HA
x: Exit
p: Previous screen
n: Next screen
Select option: n
Summary
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
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@IPADDRESS
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