1. Resonate RFID Reader Management 2.1 User Guide
  2. Migrating from MotionWorks RFID Reader Management
  3. Resonate Device Initializer Utility in Adoption Mode
  • Resonate RFID Reader Management 2.1 User Guide
Resonate Device Initializer Utility in Adoption Mode

Resonate Device Initializer
 Utility in Adoption Mode

The
Resonate Device Initializer
 utility has different operation modes. In adoption mode, it reads the list of not-fully migrated RFID readers that the Device Migration utility added to
Resonate RFID Reader Management
; then, it transfers their management from MotionWorks RFID Reader Management to
Resonate
 software.

Command Syntax 

.\rm-device-initializer-<VERSION>.exe [options]
Note: Replace <VERSION> with the version of the initializer.

Options

Option
Description
--url https://<RESONATE SERVER FQDN>/
Specifies the base URL of the
Resonate server
. For example: 
--url https://my.resonate.server.com/
Default: N/A
Required: Yes to operate in adoption mode. Note that in discovery mode, the utility retrieves the
Resonate server
 's FQDN from the
settings.yaml
 file instead.
--no-ws
Specifies to operate in adoption mode.
Default: N/A
Required: Yes to operate in adoption mode.
--metadata <* | SITE ID, SITE ID, ...>
Specifies which readers to import (adopt) based on zero or more, comma-separated site IDs. If you specify
*
, all readers are imported.
Default: N/A
Required: Yes to operate in adoption mode.
--log-level debug
Species how much detail to report in the log file. When operating in adoption mode, set
--log-level
 to
debug
.
Default: N/A
Required: Yes to operate in adoption mode.

Additional Information

  • Migration is a two-stage process: run the Device Migration utility and then run the
    Resonate Device Initializer
     utility in adoption mode (
    --no-ws
    ). The Device Migration utility adds the readers listed in the spreadsheet to
    Resonate RFID Reader Management
     in a not-fully-migrated state; those successfully added are displayed on the
    Infrastructure
    Discovered
     page. After running this utility, run the
    Resonate Device Initializer
     utility in adoption mode (
    --no-ws
    ) to transfer their management from MotionWorks RFID Reader Management to
    Resonate
     software.
  • When
    Resonate Device Initializer
     is run with
    --no-ws
    , it logs in to the
    Resonate
     instance to get the list of not-fully-migrated readers. Then, one by one, it loads
    Resonate Agent
     on each reader, taking over the reader's management connection. It disconnects its ZIoTC’s Control and Management interfaces, removing it from MotionWorks RFID Reader Management 1.0 if applicable. It securely connects each reader to
    Resonate RFID Reader Management
    , and turns over control to
    Resonate Agent
    .
    The
    Resonate Device Initializer
     utility prompts for a password to access the readers. All readers must use the same password, or they must all still use their factory-default password. You can change all reader passwords to match, or reset the readers to their factory-default state before running the utility. Otherwise, the utility cannot access the readers. This reset removes the reader's configuration even before migration.
  • Resonate Agent
     automatically upgrades the reader's firmware if it is below the
    Resonate
     software's minimum required version.
  • When the
    Resonate Device Initializer
     utility is run using
    --metadata
     with one or more site IDs, you can specify to adopt readers from a single site or a limited number of sites at a time. This is useful for adopting readers from one site, verifying that everything is working correctly, and then proceeding with additional sites. When run with
    --metadata *
    , the utility adopts all (non-fully) migrated readers.
  • When you run
    Resonate Device Initializer
     with
    --no-ws
    , you are running the utility in adoption mode (also known as file-based mode). In this mode, you can run the utility from any Windows machine with network access to the RFID readers.
    If you do not specify
    --no-ws
    , you are running the utility in device-discovery mode, so you must run the utility from a Windows machine located onsite and on the same subnet as your RFID readers. Each subnet that has readers to manage must use the same DNS domain and requires its own instance of Resonate Device Initializer. For more information on device-discovery mode, refer to Resonate Device Initializer and Initializing the RFID Readers
  • To run the utility, the
    settings.yaml
     file that was configured during
    Resonate
     installation must be in the same folder as the executable. The
    settings.yaml
     file includes information such as your
    Resonate server
    's FQDN.
  • The
    Resonate Device Initializer
     utility is a self-contained executable (
    rm-device-initializer-<VERSION>.exe
    ) without an installer. It is distributed in the
    resonate-<VERSION>.tar.gz
     file that you received from Zebra.