Skip to main content

Migration tool

info

As an alternative to the migration tool, for those of you using Rapidminer® AI Studio software version 10.3 or later, we offer the Rapidminer® AI Cloud Migration extension from the marketplace. This extension will help you to migrate your projects from Rapidminer AI Studio / Rapidminer® AI Hub software to our new cloud platform. It is directly integrated into Rapidminer AI Studio instead of being a separate tool.

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

Windows: https://releases.rapidminer.com/cloud/migration-tool/v3/ai-cloud-migration-2024.0.3-win64.zip

Linux: https://releases.rapidminer.com/cloud/migration-tool/v3/ai-cloud-migration-2024.0.3-any.zip

MacOS: https://releases.rapidminer.com/cloud/migration-tool/v3/ai-cloud-migration-2024.0.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 data assets are 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 Files or a project location.
  • The most popular extensions will be available, but others, including all custom extensions, will not.

Instructions​

Using the Rapidminer AI Cloud migration tool is very easy. Once you have downloaded and unzipped it, you can run the executable or double-click the script.

  • Windows(EXE): Rapidminer AI Cloud Migration.exe

  • Windows (Batch): AI-Cloud-Migration.bat

  • Linux(EXE): AI-Cloud-Migration.sh

Select the Rapidminer AI Studio installation​

Before you start, select the Rapidminer AI Studio installation from the dropdown. The list will contain all the Rapidminer AI Studio versions installed on the system.

Studio versions dropdown

SSO Login​

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

SSO login

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.

Select project​

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

Projects dropdown

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.

Progress​

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

  • Processes, Python code, models, performances and all other Rapidminer AI Studio objects are added to the new project.
  • Data is stored 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 AI Studio objects. Files are organized by tags, not folders, so folder names in your Rapidminer AI 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.