Setting Up a Single-Node Cluster

Setting Up a Single-Node Cluster

The following steps describe how to automatically set up and configure a single-node Kubernetes cluster for
Resonate RFID Reader Management
installation. You should perform the steps as
root
or a user with
sudo
privileges.
These steps use the
setup.sh
script. To manually perform the setup tasks that the
setup.sh
script performs, refer to Manually Setting Up a Resonate Kubernetes Cluster. The
setup.sh
script is recommended for production deployments because it is efficient and reduces the likelihood of errors. Use the manual process only for educational purposes or when you need to understand each step in detail. Both the automated script and the manual process require internet access.
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 the setup fails during a wait for the system to be ready, it might be due to network speed. Rerun the
setup.sh
script using the same settings to continue with the setup process.
  1. Ensure that your system meets the prerequisites. Refer to Preparing for Installation.
  2. Extract the files from the appropriate tar file.
    • For the online installer:
      tar xvf trifecta-installer-k8s-<VERSION>.<BUILD NUMBER>.tar.gz
    • For the offline installer:
      tar xvf trifecta-installer-k8s-<VERSION>.<BUILD NUMBER>-offline.tar.gz
    This extracts
    setup.sh
    ,
    trifecta.tar
    , and
    lb.yml
    . From the offline tar file, this also extracts the
    base-images.tar
    file.
  3. Run the following command as
    root
    or a user with
    sudo
    privileges:
    sudo -E ./setup.sh
    This command ensures that the system meets prerequisites, it creates the user
    trif-user
    , and it extracts the installation files (including
    install.sh
    ) from
    trifecta.tar
    into the
    trif-user
    's home directory (
    /opt/zebra/trifecta
    ). It displays a success message when it completes successfully.
When the setup completes successfully, install
Resonate RFID Reader Management
. Refer to Installing Resonate RFID Reader Management.