Install the WEKA cluster using the WSA
The WSA (WEKA Software Appliance) is an alternative method to install WEKA software on bare-metal servers. The WSA simplifies and accelerates the installation.
Last updated
The WSA (WEKA Software Appliance) is an alternative method to install WEKA software on bare-metal servers. The WSA simplifies and accelerates the installation.
Last updated
WSA is a package consisting of a base version of Linux (based on Rocky 8.6), network drivers and other required packages, WEKA software, and various diagnostic and configuration tools. Using the WSA facilitates the post-installation administration, security, and other KB updates controlled and distributed by WEKA, following a Long Term Support (LTS) plan.
The WSA generally works like any OS install disk (Linux/Windows).
Do not attempt to install the WSA using PXE boot. The WSA has a specific kickstart methodology only compatible with WMS or manual boot from ISO.
WEKA releases WSA updates addressing critical security issues found in the underlying Linux distribution within five days of discovery and availability. Customers can update their WSA instance from the repository where these updates are provided. WEKA notifies customers when updates are available, enabling timely updates to minimize potential risks. For any questions, contact the Customer Success Team.
For the update procedure, see Update WMS and WSA.
A physical server that meets the following requirements:
Boot drives: One or two identical boot drives as an installation target.
A system with two identical boot drives has the OS installed on mirrored partitions (LVM).
A system with one drive has a simple partition.
Minimum boot drive capacity: 125 GB (to support the pre-defined disk partition map).
Boot type: UEFI.
Before deploying the WSA, adhere to the following:
Download the latest release of the WSA package from get.weka.io dashboard.
The root password is WekaService
The WEKA user password is weka.io123
If errors occur during installation and the installation halts (no error messages appear), use the system console to review the logs in /tmp. The primary log is /tmp/ks-pre.log.
To get a command prompt from the Installation GUI, do one of the following:
On macOS, type ctrl+option+f2
On Windows, type ctrl+alt+f2.
Boot the server from the WSA image. The following are some options to do that:
Copy the WSA image to an appropriate location so that the server’s BMC can mount it to a virtual CDROM/DVD.
Depending on the server manufacturer, consult the documentation for the server’s BMC (for example, iLO, iDRAC, and IPMI) for detailed instructions on mounting and booting from a bootable WSA image, such as:
A workstation or laptop sent to the BMC through the web browser.
An SMB share in a Windows server or a Samba server.
An NFS share.
Once you boot the server, the WSA installs the WEKA OS, drivers, WEKA software. and other packages automatically and unattended (no human interaction required).
Depending on network speed, this can take about 10-60 mins (or more) per server.
Once the WSA installation is complete and the server is rebooted, configure the WSA.
Normally, the WEKA Software Appliance is deployed with the help of the WEKA Management Station (WMS), which can be used to complete the configuration of the servers.
However, if not deployed with the WMS, configure the WEKA cluster manually according to the following steps.
Log-in to the server using one of the following methods:
BMC's Console
Cockpit web interface on port 9090
Username/password: root/WekaService.
Run the OS through the BMC’s Console. See the specific manufacturer’s BMC documentation.
When the server boots for the first time, the WSA automatically installs the WEKA software on the bare metal servers unattended.
Then the server reboots, it runs with WEKA in STEM mode.
Set the following networking details:
Hostname
IP addresses for network interfaces, including:
Server management interface (typically a 1Gb interface on a management network) if not automatically set via DHCP.
Dataplane network interfaces (typically 1 or 2. Can be several up to 8).
DNS settings and/or an /etc/hosts file.
Network gateways and routing table adjustments as necessary.
Timeserver configuration.
For detailed instructions on setting the configuration options, see general Linux documentation for RedHat-based Linux Distributions.
Each server has the WEKA Tools pre-installed in /opt/tools, including:
wekanetperf: This tool runs iperf between the servers to ensure line rate can be achieved.
wekachecker: This tool checks a variety of network settings and more. For details, see #validate-the-system-preparation.
bios_tool: This tool helps you to set the required BIOS settings on the servers.
Verify that the WEKA software is installed and running on the server.
Log-in to the server and run the command weka status.
The server provides a status report indicating the system is in STEM mode, and is ready for the cluster configuration.
