Using Resonate Device Initializer in Device-Discovery Mode
View content for :
Platform:

Using
Resonate Device Initializer
in Device-Discovery Mode

The following steps describe how to run
Resonate Device Initializer
in device-discovery mode.
To initialize your RFID readers, you must have
device_create
and
device_edit
roles.
  1. Ensure that your RFID readers are powered on and that their passwords either all match or all are still set to the factory-default password.
    If necessary, change all reader passwords to match or restore all readers to their factory-default state. For details on performing a factory reset, refer to the reader's Integration Guide.
  2. Extract
    rm-device-initializer-<VERSION>.exe
    from the
    resonate-<VERSION>.tar.gz
    file, into a folder on a Windows machine located onsite and on the same subnet as your RFID readers.
    You can connect remotely to the Windows machine to place the utility and run it.
    Each subnet with readers to manage must use the same DNS domain and requires its own instance of
    Resonate Device Initializer
    .
  3. Copy the
    settings.yaml
    file that was configured during
    Resonate
    installation into the same folder.
    The file contains your
    Resonate server
    's FQDN, besides other information.
  4. On the Windows machine with the executable, open a Command Prompt or PowerShell window, navigate to the folder, and run the following command:
    .\rm-device-initializer-<VERSION>.exe --id <SITE ID>
    Replace
    <SITE ID>
    with the ID of a site that you have set up in the
    Site Manager
    page of the
    web interface
    . For example, if the site ID is 1, run:
    .\rm-device-initializer-<VERSION>.exe --id 1
  5. When prompted, enter the readers' password. If the readers are using the factory-default password, simply press
    Enter
    .
    Screenshot of Resonate Device Initializer prompting for the readers' password.
  6. Accept or reject the certificate message if it appears.
    Resonate Device Initializer
    performs a validation check to ensure the
    Resonate RFID Reader Management
    certificate is both valid and signed by a user-trusted certificate authority (CA). If the certificate is trusted,
    Resonate Device Initializer
    proceeds without interruption. If not trusted, it opens a web page, prompting you to grant permission to use the certificate with the RFID readers.
    Screenshot of the error that occurs if the Resonate RFID Reader Management certificate is not valid or signed.
    If you obtain this certificate error, perform one of the following:
    • Click
      Reject
      . This rejects the certificate and stops
      Resonate Device Initializer
      . Replace your
      Resonate RFID Reader Management
      certificate with the one provided by your certificate authority (CA); then, restart the steps in this topic.
    • Click
      Accept
      . This accepts the certificate and
      Resonate Device Initializer
      continues its process.
    You have 30 seconds to click an option, after which
    Resonate Device Initializer
    stops and displays a timed-out message.
    After the certificate is accepted,
    Resonate Device Initializer
    prompts you to grant it access to communicate with
    Resonate RFID Reader Management
    . It opens the default browser and takes you to the
    Resonate
    login page.
  7. Log in.
    Log in window.
    After you successfully log in, the utility prompts you to grant it access permission.
  8. Click
    Yes
    .
    Resonate Device Initializer
    receives authorization to proceed with RFID reader discovery and initialization.
    For the utility to proceed, you must allow certain firewall rules; Windows Defender Firewall displays a message, prompting you to grant it access to open the necessary firewall ports.
  9. Click
    Allow Access
    .
    Screenshot of Windows Defender Firewall dialog requesting to allow access to some ports.
    This grants the application listed in the warning access to all ports for the specific networks selected.
    If this alert is not prompted for some reason, and the firewall is turned on, a firewall rule is required to allow UDP ports 3702 and 12345 inbound to this application for the
    Resonate Device Initializer
    to work.
    Upon successful authentication and port access,
    Resonate Device Initializer
    starts to scan the current subnet for supported RFID readers. If a discovered RFID reader's make, model, and part number are compatible with
    Resonate
    , the utility initializes the reader and installs the
    Resonate Agent
    on it. The reader is then visible in the
    web interface
    . The utility ignores other RFID readers, listing them with an unsupported message in the console.
  10. Open the
    web interface
    , and navigate to
    Infrastructure
    Discovered Devices
    .
  11. In the Command Prompt or PowerShell window, press
    CTRL+C
    when all readers are listed in the
    web interface
    .
Although discovered, you must now select the readers that
Resonate RFID Reader Management
should manage. Refer to Selecting from Discovered Devices.