Skip to main content

Migration tool

The migration tool will help you to migrate your projects from RapidMiner Studio / RapidMiner AI Hub to our new cloud platform. Download the migration tool from here:

Windows: https://releases.rapidminer.com/cloud/migration-tool/v2/rapidminer-cloud-migration-10.3-win64.zip

Linux: https://releases.rapidminer.com/cloud/migration-tool/v2/rapidminer-cloud-migration-10.3-any.zip

MacOS: https://releases.rapidminer.com/cloud/migration-tool/v2/rapidminer-cloud-migration-10.3-osx.dmg

Limitations​

Before proceeding, please understand the new cloud concepts. The new workflows and operators are compatible with the old ones, but the storage framework has fundamentally changed, so be aware of the following limitations:

  • Because the catalog is based on tags, and not folders, all links to data (e.g., Retrieve and Read operators) will break. You will need to reconfigure them in the cloud.
  • In a similar way, all Store operators will need to be reconfigured to point to the catalog or a project location.
  • The most popular extensions will be available, but others, including all custom extensions, will not.

Instructions​

Using the migration tool is very easy. Once you have downloaded and unzipped it, you need to run (or double click) the following script:

  • Windows: RapidMiner-Cloud-Migration.bat
  • Linux: RapidMiner-Cloud-Migration.sh

SSO Login​

When the migration tool has started, you'll see the SSO Login screen:

migration-sso.png

Click Log in with SSO and you'll be redirected to your browser, where you need to log in with your company name, username and password. If everything goes well, you'll see the message Login Successful:

migration-sso-success.png

Select project​

Go back to the migration tool, which detects your existing projects:

migration-select.png

You can now select a project from the drop-down menu. Type the name of the new cloud project and add a description. The tool pre-fills some standard values for you. Once you click on Start Migration, you can follow the progress of the migration.

migration-progress.png

Progress​

The migration tool uploads your artifacts, taking the following actions:

  • Processes, Python code, models, performances and all other RapidMiner objects are added to the new project.
  • Data is stored in the catalog and linked to the project, so it's still usable there. That includes tables, images, text files, Excel sheets, CSV files and, in general, non-RapidMiner objects. The catalog is organized by tags, not folders, so folder names in your RapidMiner Studio or RapidMiner AI Hub project become tags that are assigned to the appropriate files.

When the migration is finished, you'll receive a summary -- with warnings, if the tool was unable to convert or upload some of the files.

Take a look at your cloud project and check that the migration has worked as expected, recalling that there are some limitations.

Data is visible in the Data tab. If data was stored in folders, the folder names appear as tags. All other files are listed in the Content tab.

If you have more projects to migrate, repeat the process.