Basic Installation

Ubuntu Server

The Ubuntu Server LTS (64-bit) download can be found at Download Ubuntu Server.

The version for ARM-based server systems can be found at Ubuntu Server for ARM.

For Raspberry Pi 3 or 4 the downloads can be found at Ubuntu Server for Raspberry Pi. Make sure to select the 64-bit version.

A tutorial for installing on Raspberry Pi is also available.

Flashing the downloaded OS image to an SD card or a USB driver can be done using balenaEtcher.

K3s

You can use the installation script available at https://get.k3s.io to install K3s as a service on systemd and openrc based systems.

The simplest form of this command, with the option to allow writing to the kubeconfig file, is as follows:

curl -sfL https://get.k3s.io | K3S_KUBECONFIG_MODE="644" sh -s -
Note: This command needs to be run from the shell (terminal, command line) of the OS.

If desired, the installation can be customised using installation options listed in the K3s documentation.

This will install a single-node cluster with one master and one worker.

The k3s service is automatically started after installation.

Other utilities installed are:
  • kubectl
  • crictl
  • k3s-killall.sh
  • k3s-uninstall.sh

Management Service

Before installing the ECP Management Service, a new Cluster needs to be created in the Altair SmartWorks Studio. This will generate the unique configuration file needed for the install of the Management Service.

The following command needs to be run on the shell (terminal, command line) of the OS as root.

The command shown here uses placeholders.

The exact commands for your new Cluster can be found in Studio.

To deploy the Management Server on the Cluster and connect to Studio:
kubectl apply -f <full-url-to-yaml-config>