Cloudera Flow Management Migration Tool Release Notes
Learn about the new features, known and fixed issues, limitations, and unsupported features in the latest compatible version of the Cloudera Flow Management Migration Tool.
What's new
The Cloudera Flow Management Migration Tool helps you transition to NiFi 2 more efficiently. It simplifies and accelerates 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 tool automates complex and repetitive tasks in updating flow configurations, reducing manual effort and ensuring compatibility with NiFi 2 features.
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).
Cloudera Flow Management Migration Tool 3.0.3 supports migrations from Cloudera Flow Management 2.1.7.2000 to Cloudera Flow Management 4.10.0.0, in compliance with the NiFi 1.28-to-2.3 General Availability (GA) ruleset.
Latest enhancements:
- Added support for using flow definitions and templates as input.
- Output format now matches the input format (for example: flow definition input produces flow definition output).
- Added automatic recognition of input format.
- Added support for flow.json.gz files.
- Improved automatic component migration with broader coverage and handling of invalid components.
- Activity Log now provides more detailed insights into component transformations.
Support Matrix
Before starting a migration with the 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 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.0 |
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 Management Migration Tool, ensure that your system meets the following requirements.
| Requirement | Details | |
|---|---|---|
| Operating system | Linux | |
| Java version | Java 21 | |
| Disk space | At least 25 GB for NiFi distributions and working directories | |
Download location
You can download the Cloudera Flow Management 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 from the Cloudera Flow Management Migration Tool Repository.
