Cloudera Docs

Cloudera Flow Management Migration Tool Release Notes

Learn about the new features, known and fixed issues, limitations, and unsupported features in the latest release 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.

You can use this command-line tool to transform templates, variables, and components to align with NiFi 2 features.

Cloudera Flow Management Migration Tool 3.0 supports on-premises environments and facilitates migrations from Cloudera Flow Management 2.1.7.2000 to Cloudera Flow Management 4.10.0, in compliance with the NiFi 1.28-to-2.3 General Availability (GA) ruleset.

Latest enhancements:

  1. Added support for using flow definitions and templates as input.

  2. Output format now matches the input format (for example: flow definition input produces flow definition output).

  3. Added automatic recognition of input format.

  4. Added support for flow.json.gz files.

  5. Improved automatic component migration with broader coverage and handling of invalid components.

  6. Activity Log now provides more detailed insights into component transformations.

Support Matrix

Before using the Cloudera Flow Management Migration Tool, review the following compatibility and system requirements to ensure your system aligns with these specifications and to avoid migration issues.

Cloudera Flow Management Migration Tool 3.0 supports on-premises usage only. A given Migration Tool version always supports exactly one pair of Cloudera Flow Management versions. Using different versions than those specified may lead to incorrect migration results or failure of the process.

Requirement Details
Operating system Linux
Java version Java 21
Source version Cloudera Flow Management 2.1.7.2000
Apache NiFi 1.28.1
Target version Cloudera Flow Management 4.10.0
Apache NiFi 2.3.0
Disk space At least 25 GB for NiFi distributions and working directories

Download location

The Cloudera Flow Management Migration Tool software artifacts can be downloaded from the Cloudera Archive.

To access the artifacts, you must have:
  • An active Cloudera subscription agreement
  • A license key file
  • The required authentication credentials (username and password).

Download the Migration Tool from the following location: Cloudera Flow Management Migration Tool Repository.