Cloudera Docs

Running a NiFi 2 migration

You can migrate NiFi 1.x flow definitions in the Catalog and open them in Flow Designer.

  • You have been assigned at least the DFCatalogViewer role granting you access to the Catalog.

  • You have been assigned at least the DFCollectionUser role granting you access to the collection where the flow definition resides.
  • You have been assigned the DFFlowDeveloper role to edit the migrated flow draft in Flow Designer. You do not need this role if your migrated flow cannot be opened in Flow Designer.
  • You have been granted the DFCatalogPublisher role to either publish the NiFi 2.x draft from Flow Designer, or to import it to the Catalog as a NiFi 2.x flow definition.
  1. Go to Data Flow > Catalog.
  2. Select the flow that you want to migrate, then select Actions.
    The Migrate to NiFi 2.x option is available for NiFi 1.x flows.
    Depending on the selected flow definition, you see one of the following options:

    • The NiFi 2.x flow can be opened in Flow Designer as a flow draft where you can manually address any possible remaining issues.



    • The NiFi 2.x flow can be opened in Flow Designer as a flow draft where you can manually address any possible remaining issues. You will be asked to match parameter contexts to shared parameter groups before opening the flow in Flow Designer.



  3. Provide the required inputs.
    Target Workspace
    Select the workspace where you want the migration to take place.
    Target Project
    Select the project where you want the NiFi 2.x flow draft to be created.
    Draft Name
    Specify a draft name that is unique in the selected workspace.
  4. Click Migrate.
  • Proceed to Matching parameter contexts to shared parameter groups if prompted to do so during the migration process.
  • Proceed to review the flow draft, paying close attention to the migration report that the tool provides as part of this migration process. The key items you need to either change or inspect will be surfaced. For a full list of resolved and unresolved issues, you can download the full migration report via the download option.