The migration tools are now available in production. When you refresh your SharpTools User Page, you should see a migration banner if you still have a legacy SmartThings connection (indicated by a circle icon to the left of the location name):
This will walk you through the process of authorizing the next-generation connection, then will bring you back to the migration screen to migrate any dashboards, rules, or Super Tiles you might have with legacy-connection content in them.
Step-by-Step Instructions (tap to expand)
- Open your SharpTools.io User Page
- Tap the red migration banner above the list of locations
- Tap the Begin Authorization button
- If you are prompted to login to SmartThings, do so
- When prompted to allow SharpTools access to your things:
- Select your location from the drop-down
- Leave all the boxes checked
- Scroll down and tap the blue Authorize button
- Select your location from the drop-down
- You’ll be redirected back to SharpTools where you’ll see a device synchronization progress bar
- When the device synchronization completes, you’ll be presented with a button to Continue Migration which you can tap to continue
Important: If you had multiple legacy locations authorized, make sure to heed the warning to return to your SharpTools.io User Page and manually authorize your additional locations using the Samsung SmartThings option under the Manage Connections button
When you proceed through the authorization again, when you are prompted to “Allow ‘SharpTools’ access to these things”, make sure to select your other location and tap Authorize. Repeat as needed for multiple locations - After tapping Continue Migration from the previous step, you’ll be redirected to the the Migration Manager where it will check to make sure you’re ready to go
- If everything is good, you’ll see a message indicating that you are ready to migrate. Tap the green Migrate button to continue
- If the analysis identifies any issues, you’ll see an extra link to the right of the ‘Toggle Details’ hyperlink which enables you to view the errors.
- The recommended approach is to review these errors and correct things as necessary - for example, you might have a Placeholder tile on a dashboard that needs to be removed. Or perhaps a rule that is referencing a device that doesn’t exist anymore.
- Alternatively, you can scroll to the bottom and check the box to skip the errors. Generally it’s preferred to resolve the errors first and this option is provided as a last resort.
- If everything is good, you’ll see a message indicating that you are ready to migrate. Tap the green Migrate button to continue
- The migration generally takes less than a minute at which point you’ll see a ‘Migration Complete’ message and the final step is to tap the Disconnect and Finish button which will disconnect your legacy locations
- Upon disconnecting your location, you’re done! You can navigate to your User Page or back to your dashboards to verify that everything is working as expected.
If you have any dashboards with devices that don’t appear to update status as expected, try refreshing your browser (F5 / pull-to-refresh) as that will kick off an automatic health-check in the background that can resolve common. Wait about 60 seconds after refreshing the page and then try controlling your device again to verify if the status is updating as expected.
And as always, if you have any questions, feel free to reach out to support@sharptools.io
–
If your SmartThings location shows a five-spoke icon next to it, the location is already connected using the next generation connection.
