Resonate Software Installation Overview

The online installer is lightweight and downloads the Resonate containers from Zebra's Artifactory repository, requiring a direct internet connection during installation; the installer might also download required software from the internet if not already installed.

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 both the Resonate containers and most required software (in case they are missing and require installation).

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

.

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 3 nodes initially; you can add more nodes after installation.

The prerequisites checker and setup tool,

setup.sh

, ensures that the system meets prerequisites, it creates the user

trif-user

, and it 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

(online installation) or the setup tar file (offline installation)

. However, you must install some prerequisite software before you run the script. For prerequisites, refer to Preparing for Installation.

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. This allows the nodes to distribute traffic between themselves.

Resonate RFID Reader Management requires a fresh installation and device initialization.