Cloudera Docs

Running NiFi 2 migrations

  • 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 will be available for NiFi 1.x flows.
    Depending on the selected flow definition, you will 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.



    • The NiFi 2.x flow definition cannot be opened in Flow Designer after migration. You will have to download the migration artifacts after the automated migration steps execute and perform any manual fixes in an external tool of your choice. The downloaded migration report lists all issues that need either manual change or inspection.



  3. Provide the required inputs.
    Target Workspace
    Select the workspace where you want the migration to take place.

    You need to provide this information in all scenarios.

    Target Project
    Select the project where you want the NiFi 2.x flow draft to be created.

    This is only required if the migrated NiFi 2.x flow can be opened in Flow Designer.

    Draft Name
    Specify a draft name that is unique in the selected workspace.

    This is only required if the migrated NiFi 2.x flow can be opened in Flow Designer.

  4. Click Migrate.
  • Proceed to Matching parameter contexts to shared parameter groups if prompted to do so during the migration process.
  • If the migrated flow can be opened in Flow Designer, proceed to review the flow draft, paying close attention to the migration report that we provide as part of this migration process. The key items you would 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 provided as part of the migration report window..
  • If the migrated flow cannot be opened in Flow Designer, proceed with downloading the provided files and view them in your tool of choice.