Resonate

Installation Overview

The online installer is lightweight and downloads the

Resonate

containers from Zebra's Artifactory repository, requiring a direct internet connection during installation. If you need to install in a protected environment behind a corporate firewall, use the offline installer, which runs without access to the internet or Artifactory; it contains the

Resonate

containers.

In an offline installation, there is no internet access after installation. In an online installation, you probably will not need internet access again; however, if necessary, the

Resonate server

will access the internet to pull new

Resonate

images. For example, this could happen if there is a

Resonate

update, or if one of the server's machines runs out of space and deletes unused images.

The installer comes in a setup tar file in the

resonate-<VERSION>.tar.gz

that you receive from Zebra:

You must extract its files:

setup.sh

,

trifecta.tar

, and

lb.yml

. From the offline tar file, the

base-images.tar

file is also extracted.

You must install

Resonate RFID Reader Management

according to the required configuration mode: single-node or multi-node.

For a single-node configuration, you run the

setup.sh

script. The setup script creates an installer script, which you then run.

For a multi-node configuration, you run the

setup.sh

script on the primary node, specifying the number of nodes in the cluster and the block device to use for storage. You run the

setup.sh

script on the secondary nodes to prepare them for integration into the cluster, run microk8s on the primary node to get a token for each secondary node, and then run microk8s on the secondary nodes, passing each a different token. After the nodes have joined the cluster, you run

setup.sh

on each of the secondary nodes to set up their block storage device, and run

setup.sh

on the primary node to finalize the cluster. Finally, you run the installer on the primary node.

Multi-node configuration requires at least three nodes initially; you can add more nodes after installation.

Both the online and offline installers come with the

setup.sh

script. The script ensures that the system meets prerequisites and installs other required software (for example, the MicroK8s distribution of Kubernetes). The script also creates the user

trif-user

, extracts the installation files (including

install.sh

) from the

trifecta.tar

file, and saves them in the trif-user's home directory (/opt/zebra/trifecta). The

setup.sh

script can fetch and install most required software from the internet. After using the script, use the online or offline installer to install

Resonate

; the offline installer will not use the internet.

To manually perform the setup tasks that the script performs, refer to Manually Setting Up a Resonate Kubernetes Cluster. Use the manual process only for educational purposes or when you need to understand each step in detail. The automated script is recommended for production deployments because it is efficient and reduces the likelihood of errors. The manual process also requires internet access to install required software.

Run the

setup.sh

script as root or with sudo. It is typical for

setup.sh

to request that you reboot the system to apply updates. After the reboot, you must run

setup.sh

again, with the exact same options, to continue and complete the setup.

If you are installing a multi-node configuration and you do not have an actual load balancer, run

setup.sh

with the option

--external-ip

(or

-i

) to enable the metalLB load balancer, the load balancer included with

Resonate

. This allows the nodes to distribute traffic between themselves.

To upgrade from a previous version of

Resonate RFID Reader Management

, refer to Upgrading the Software.

To upgrade from MotionWorks RFID Reader Management to

Resonate RFID Reader Management

, you must perform a fresh installation and device initialization. Prepare different machines on which to install

Resonate

, install

Resonate

on these machines, and then migrate the data and RFID readers from MotionWorks RFID Reader Management to

Resonate

. Refer to the migration section in the

Resonate RFID Reader Management

User Guide for information.