1. Resonate RFID Reader Management 2.1 Installation Guide
  2. Installing the Software
  3. Installing Resonate RFID Reader Management
  • Resonate RFID Reader Management 2.1 Software Installation Guide
Installing Resonate RFID Reader Management

Installing
Resonate RFID Reader Management

The following steps describe how to install
Resonate RFID Reader Management
 using the online or offline installer. You should perform the steps as
root
 or a user with
sudo
 privileges.
When running the online installer, you are prompted for your username and password to access the Zebra Artifactory Repository. As your password, pass the identity token that you generated in Creating an Identity Token.
  1. Set up the machines as described in Setting Up a Single-Node Cluster or Setting Up a Multi-Node Cluster, depending on the required configuration.
  2. On the primary node, switch users to the created user
    trif-user
    : 
    sudo su - trif-user
  3. Run one of the following commands to begin the installation, depending on the required configuration.
    For a single-node cluster: 
    ./install.sh -h <RESONATE SERVER FQDN> -m prod-single-node --smtp-server <SMTP SERVER FQDN/IP> --admin-email <EMAIL ADDRESS> [--customer-label-value <CUSTOMER LABEL VALUE>]
    For a multi-node cluster: 
    ./install.sh -h <RESONATE SERVER FQDN> -m prod-multi-node --smtp-server <SMTP SERVER FQDN/IP> --admin-email <EMAIL ADDRESS> [--customer-label-value <CUSTOMER LABEL VALUE>]
    Replace
    <RESONATE SERVER FQDN>
     with the FQDN of the server,
    <SMTP SERVER FQDN/IP>
     with the FQDN or IP address of the SMTP server, and <EMAIL ADDRESS> with the administrator's email address for receiving notifications. In the case of a multi-node cluster, the FQDN of the server is the external hostname (FQDN) of the server (cluster); if using your own load balancer, set the FQDN of the Resonate server to the FQDN of the load balancer. If you are using Zebra's alert monitoring service, OpsRamp, specify the
    --customer-label-value
     option and replace
    <CUSTOMER LABEL VALUE>
     with your customer name.
    For additional script information and options, refer to install.sh. For example, options exist for assigning your own certificate to the
    Resonate server
    .
    The installation sets up the necessary Kubernetes resources (such as pods, services, and deployments) required for
    Resonate RFID Reader Management
     to operate. It can take anywhere from 10 to 20 minutes. It displays
    Installation complete
     when it completes successfully and
    Resonate RFID Reader Management
     is operational.
  4. Verify that
    Resonate RFID Reader Management
     is operational. Refer to Validating That Resonate Is Operational.
When
Resonate
 is installed and operational, its services are running; you can now access and use the software through the
Resonate
 web interface. You should receive an email at the specified administrator address with a web link to the newly installed
Resonate RFID Reader Management
 platform (at the FQDN that you provided during installation), requesting you to set the administrator’s password.
If your SMTP server uses a custom Certificate Authority (CA), you must first configure Keycloak to trust the certificate on your SMTP server before you can receive the email; for information, refer to Keycloak and Using a SMTP Server with Custom CA.
Specifying your customer name for Zebra's OpsRamp alert monitoring service only adds this information to your alerts; you must still set Zebra's OpsRamp instance as an alerting target after configuring
Resonate
. For information, refer to the Alerting Targets section of the
Resonate RFID Reader Management
 User Guide.
For future upgrades, save the install command that you ran, including all settings; you will need to specify the exact same settings when upgrading. Although the command should be retrievable from your command history (
history | grep install.sh
), it is good to save it separately as a backup.