Quick Install Guide

Prerequisites

For a complete prerequisite list, refer to Prerequisites for Installation section.
We'll consider an example of architecture with 8 identical hosts (named weka01 to weka08). Each host has more than 20 cores, 6 NVME drives, and a single Mellanox NIC.
Using Mellanox NICs simplifies the installation commands (e.g., only single IP for data is required, no need to expose VFs, identification of the interface netmask, and default routing gateway).
If the architecture is different, the installation commands should be slightly changed accordingly.
For a full command set, refer to Weka System Installation Process Using the CLI section.

Installation

Install Weka software on each host:
1
# deploy the software on all hosts
2
pdsh -w weka0[1-8] "curl https://[GET.WEKA.IO-TOKEN]@get.weka.io/dist/v1/install/3.8.0/3.8.0 | sudo sh"
3
Copied!

Configuration

From one of the servers, form the cluster, set the cluster name, stripe width, and protection scheme, and enable cloud monitoring (DNS is assumed to be set up, otherwise explicit IPs should be used in the cluster create command):
1
# connect to one of the servers and run the rest of the configuration from there
2
ssh weka01
3
4
# form the cluster and set basic stuff
5
# using bash, you can provide a compact list of hosts; otherwise, a full list of all hosts should be supplied
6
# weka cluster create weka01 weka02 weka03 weka04 weka05 weka06 weka07 weka08
7
weka cluster create weka0{1..8}
8
weka cluster update --cluster-name=WekaProd
9
weka cloud enable
10
Copied!
Configure the network, drives, and CPUs per host:
1
# configure network, drives, and cores per host
2
# replace network, drives, and cores configuration with your actual data
3
4
for i in {0..7}
5
do
6
weka cluster host dedicate $i on
7
8
# add network NICs
9
# e.g., weka cluster host net add $i eth1
10
weka cluster host net add $i NETDEV
11
12
# add the nvme drives; e.g., /dev/nvme0n1, etc.
13
weka cluster drive add $i /dev/nvme0n1 /dev/nvme1n1 /dev/nvme2n1 /dev/nvme3n1 /dev/nvme4n1 /dev/nvme5n1
14
15
# set host cores
16
weka cluster host cores $i 19 --frontend-dedicated-cores 1 --drives-dedicated-cores 6
17
done
18
Copied!
Check the configuration:
1
# show hosts info (net, cores, etc.)
2
for i in {0..7}
3
do
4
weka cluster host resources $i
5
done
6
7
# show drives info
8
weka cluster drive
9
10
# show configuration status
11
weka status
12
Copied!
If satisfied, start the cluster:
1
# initialize the hosts
2
weka cluster host apply --all --force
3
4
# start the cluster
5
weka cluster start-io
6
Copied!
Check the status:
1
# show cluster info and status
2
weka status
3
Copied!
You would see a similar output to the following example:
1
WekaIO v3.10.0 (CLI build 3.10.0)
2
3
cluster: WekaProd (00569cef-5679-4e1d-afe5-7e82748887de)
4
status: OK (8 backends UP, 48 drives UP)
5
protection: 6+2
6
hot spare: 1 failure domains
7
drive storage: 82.94 TiB total, 82.94 TiB unprovisioned
8
cloud: connected
9
license: Unlicensed
10
11
io status: STARTED 7 seconds ago (96 io-nodes UP, 750 buckets UP)
12
link layer: Ethernet
13
clients: 0 connected
14
reads: 0 B/s (0 IO/s)
15
writes: 0 B/s (0 IO/s)
16
operations: 0 ops/s
17
alerts: 2 active alerts, use `weka alerts` to list them
18
Copied!
Lastly, install a license, change the default admin password, and make sure there are no other alerts in the system.
The Weka system is now installed. Now let's learn how to view, manage, and operate it using either the CLI or the GUI and perform the first IO to a WekaFS filesystem.
Last modified 10mo ago