Skip to content

A Cumulocity webapp to migrate applications, dashboards, groups, devices, simulators, smart rules, images, and managed objects between tenants. Developed by Global Presales.

License

Notifications You must be signed in to change notification settings

Cumulocity-IoT/cumulocity-migration-tool

Repository files navigation

Cumulocity Migration Tool

A Cumulocity webapp to migrate applications, dashboards, groups, devices, simulators, smart rules, images and managed objects between tenants. Migration

Installation

The migration tool can be installed in 2 ways:

  1. Migrated from another tenant
  2. Installed from a release

Installing from another tenant

  1. Find a tenant with the migration tool already installed
  2. Open the migration tool and navigate to Destination
  3. Select Other Tenant
  4. Enter the connection details
  5. Click Check connection - You may need to follow the instructions to fix CORS (Cross Origin Resource Sharing) errors
  6. Click the Deploy to Tenant button

Installing from a release

  1. Grab the Latest Release Zip
  2. Go to the Administration view in your tenant (/apps/administration)
  3. Open the Own applications section in the navigator
  4. Click Add application
  5. Select Upload web application
  6. Select the Zip you downloaded earlier

Quickstart

  1. Open the migration tool on the tenant you want to migrate to (The destination tenant)
  2. Click the Source folder in the navigator
  3. Select Other Tenant, and enter the login details
  4. Select any objects you want to migrate
  5. Click the Destination folder in the navigator
  6. Select Current Tenant, and enter the login details
  7. Click Migrate... in the navigator
  8. Make any edits to the objects
  9. Click Execute Migration in the action bar

The FAQ contains information, limitations, and extra troubleshooting instructions.

Screen Overview

ConnectionDetails

  1. Connection Type
    • Current Tenant - The tenant that the migration tool is currently running on
    • Other Tenant - A remote tenant
    • File - A migration tool export zip file
  2. Tenant URL - The url of the tenant (must start with https://)
  3. Username - The user to connect to the tenant with
    • Must have Reader and Global Reader access for the Source Tenant
    • Must have Administrator access for the Destination Tenant
  4. User's password
  5. Check connection - Checks that the migration tool can access the tenant

Migration

  1. From/To details
  2. Creation Mode - Switch between creating and updating an existing object
  3. Edit the object
  4. Mark all as Create - Changes the creation mode of every item to Create
  5. Reset All - Resets any changes made
  6. Execute Migration - Starts the migration

These tools are provided as-is and without warranty or support. They do not constitute part of the Software AG product suite. Users are free to use, fork and modify them, subject to the license agreement. While Software AG welcomes contributions, we cannot guarantee to include every contribution in the master project.


For more information you can Ask a Question in the TECHcommunity Forums.

You can find additional information in the Software AG TECHcommunity.

About

A Cumulocity webapp to migrate applications, dashboards, groups, devices, simulators, smart rules, images, and managed objects between tenants. Developed by Global Presales.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages