Performing the Migration

Resonate RFID Reader Management 2.1 User Guide

Steps to migrate from MotionWorks RFID Reader Management 1.0 to

Resonate RFID Reader Management

2.x are outlined below.

Install

Resonate

on machines different from those where MotionWorks RFID Reader Management 1.0 is installed. Refer to the

Resonate RFID Reader Management

Software Installation Guide.

Extract

rm-device-migrator-<VERSION>.exe

and

rm-device-initializer-<VERSION>.exe

from the

resonate-<VERSION>.tar.gz

file (which also contains the

Resonate

installer) into a folder on a Windows machine with network access to the RFID readers.

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.

Create the XLSX spreadsheet file containing the required information about your sites and readers.

For spreadsheet information requirements, refer to the Additional Information subsection of Device Migration Utility.

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.

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. A reset removes a reader's configuration even before migration, but if required, refer to the reader's Integration Guide for factory-reset instructions.

On the Windows machine with the executables, open a Command Prompt or PowerShell window, and navigate to the folder containing your extracted executables.

Run the Device Migration utility:

.\rm-device-migrator-<VERSION>.exe --path <XLSX FILENAME> [--sheet <SHEETNAME>] --url https://<RESONATE SERVER FQDN>/ [--skip-tls]

Replace

with the version of the migrator and

with the spreadsheet's path and file name. To specify a sheet name, use the

--sheet

option and replace

with the name in quotes; by default, it uses

"Master"

. Replace

with the FQDN of the

Resonate server

. To ignore HTTP and HTTPS errors, use the

--skip-tls

option.

When prompted, enter your

Resonate

Yes

to allow the Device Migrator (called

device-hub

in the prompt) access to

Resonate

and to add sites and readers.

If you are already logged in, you are not prompted for your login information.

As the script runs, it works through the spreadsheet and adds site and reader information into the

Resonate

instance databases, skipping duplicates and entries with incorrect or misformatted information. You can run Device Migrator again; it will skip existing migrated devices or sites.

If required, review the

device-migrator.log

log file.

The Device Migration utility writes the log file to the same folder as the one from which you ran it. The log file contains more detailed information about each reader added and about each spreadsheet row skipped or declared invalid.

From a browser, access the

Resonate RFID Reader Management web interface

https://<RESONATE SERVER FQDN>/

Replace

with the FQDN of the

Resonate server

Navigate to the

Infrastructure

Discovered Devices

page.

The page lists any migrated readers. Although migrated, they are not fully adopted into or configured to work with

Resonate RFID Reader Management

On the Windows machine with the executables, switch to the Command Prompt or PowerShell window, and ensure you are in the folder containing the extracted executables.

Run the

Resonate Device Initializer

utility as follows to adopt the (not fully) migrated readers into

Resonate

.\rm-device-initializer-<VERSION>.exe --url https://<RESONATE SERVER FQDN>/ --no-ws [--metadata <* | SITE ID, SITE ID, ...>] --log-level debug

Replace

with the version of the initializer,

with the FQDN of the

Resonate server

, and

<* | SITE ID, ...>

with a comma-separated list of the site IDs of the readers to adopt or with * to adopt them all.

Ensure that your RFID readers are powered on.

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 transfers the reader's management from MotionWorks RFID Reader Management 1.0 to

Resonate RFID Reader Management

, installing

Resonate Agent

on the reader.

When

Resonate Device Initializer

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 prompted, enter the readers' password. If the readers are using the factory-default password, simply press

Enter

When

Resonate Device Initializer

completes, you see the fully migrated readers on the

Infrastructure

Devices

page in the web interface. For information on what is migrated, refer to Migration.