Cloudera Flow Migration Tool Release Notes
Learn about the new features, known issues, fixed issues, limitations, and unsupported features in the latest release of the Cloudera Flow Migration Tool.
What's new
The Cloudera Flow Management Migration Tool helps you transition to NiFi 2 more efficiently by simplifying and accelerating the migration of flows from Cloudera Flow Management 2.x (powered by NiFi 1) to Cloudera Flow Management 4.x (powered by NiFi 2).
The latest version available for on premises migration scenarios is Cloudera Flow Management Migration Tool 7.0.1, which enables migrations from Cloudera Flow Management 2.1.7.3000 (including hotfixes) to 4.12.0.1 (including hotfixes), in compliance with the Apache NiFi 1.28.1-to-2.6.0 General Availability (GA) ruleset.
Latest enhacements:
- Support for protected sensitive properties keys
- The Cloudera Flow Migration Tool supports the migration of versioned flows that use
protected sensitive properties keys encrypted with the
NIFI_PBKDF2_AES_GCM_256encryption scheme. This enhancement enables migration of flows with additional security protection applied to sensitive configuration values. - Improved pre-packaged Migration Tool distribution
-
Fixed issues in the standalone Cloudera Flow Migration Tool distribution, which comes pre-configured with the required Cloudera Flow Management 2 and 4 libraries and can be run without additional dependencies.
- Improved component migration support
-
Fixed issues affecting the migration of processors that use CRON-based scheduling and parameter contexts populated by parameter providers.
Support Matrix
Before starting a migration with the Cloudera Flow Migration Tool, review the supported source and target version requirements to ensure a successful migration.
The following diagram provides a high-level overview of the supported migration paths and the required Migration Tool versions for Cloudera Flow Management on premises.
The table below provides detailed information about the supported migration paths and the latest Migration Tool versions for these paths.
| Source Cloudera Flow Management version | Target Cloudera Flow Management version | Required Cloudera Flow Migration Tool version |
|---|---|---|
| 2.1.7.2000 | 4.10.0.0 | 3.0.3 |
| 2.1.7.2000 + 2.1.7.2002 - 2007 | 4.11.0.0 | 5.0.4 |
| 2.1.7.3000 | 4.11.0.0 | 5.1.1 |
| 2.1.7.300x | 4.12.0.x | 7.0.1 |
The migration process does not require the source or target Cloudera Flow Management instances to be running. Only the NAR files for the respective NiFi versions are required to complete the process.
System Requirements
Before using the Cloudera Flow Migration Tool, ensure that your system meets the following requirements.
| Requirement | Details |
|---|---|
| Operating system | Linux, macOS |
| Java version | Java 21 |
| Disk space | At least 25 GB for NiFi distributions and working directories |
Download location
You can download the Cloudera Migration Tool software artifacts from the Cloudera Archive.
- An active Cloudera subscription agreement
- A license key file
- The required authentication credentials (username and password)
Download the version of the tool that matches your requirements. For the exact download URLs, see Cloudera Flow Migration Tool download links.
