Skip to content

Frequently Asked Questions

Jump to bottom
Richard Peach edited this page Aug 2, 2019 · 10 revisions

Can I use it for customer projects?

Yes, please do! Although we don't offer direct support we will attempt to fix any issues on a best effort basis.

Is it free?

Yes! If you like it then please Star or Watch the project, or if you're a SoftwareAG employee then comment on SolutionBook, this allows us to allocate more time to it.

What can I migrate?

  • Applications
  • Dashboards
  • Managed Objects
    • Devices
    • ...
  • Smart Rules
  • Simulators

What can't I migrate? These might be feature requests - If you need them then flag them

  • Measurements
  • Esper
  • Application specific managed objects...
    • Often managedObjects associated with particular applications need to be created by the application that uses them, it is difficult for us to know this so they may not work after migrating

Are there any limitations?

External IDs are not copied for devices

This was a conscious decision, if you are migrating from one tenant with a set of devices to a different tenant with a different set of devices then those devices will already have external IDs that we don't want to overwrite

On a dashboard, HTML widget links to devices/dashboards aren't updated

Currently only IDs that are completely safe to update are replaced (we're considering adding unsafe replacement in the future). Just manually update the dashboards afterwards.

I migrated an application and the deviceIds and dashboards don't seem to have updated...

Applications can contain a template for how dashboards should look, if these contain a deviceId then these aren't (currently, see the unsafe replacement feature) updated. However if these dashboards have already been created (by accessing them on the source tenant) and they are also being migrated then the dashboards will be updated.

User permissions

  • You must have full read access to the tenant being copied from
  • You must have full write access to the tenant being copied to
    • This is more than just the admin access (select everything in the options)

CORS

What is CORS?

Cross Origin Resource Sharing is how the browsers avoid being tricked into sending login Cookies from rogue websites.

Why does this impact this tool?

Different tenants operate on different domains, so to migrate from one tenant to another we have to talk (a)cross origins.

What do I have to do?

The tenant that you run the migration tool is accessible without crossing origins and so no changes have to be made on that tenant. The other tenant (Usually the source tenant) needs to have Access Control, Allowed Domain set so that the migration tool can access it. To do so:

  • Log into the tenant with Admin rights
  • Head to the Administration screen
  • Select Settings -> Application in the navigator (On the left)
  • You should see a section labelled Access Control, with an input labelled Allowed Domain
  • There are various things you could enter into the box but easiest is *
  • Click Save access control
Clone this wiki locally