Upgrade NiFi

This section describes how to upgrade to a new version of the Apache NiFi application.

To upgrade NiFi

  1. With your existing NiFi deployment:

    1. Stop all connectors and data ingestion.
    2. Wait until the FlowFiles already in the dataflow have been processed, so that all queues are empty.
    3. Stop all of the processors.
    4. Stop the NiFi application.
  2. Download and extract the new version of NiFi. Then customize the installation by following these steps:

    1. Compare the file conf/nifi.properties with the nifi.properties file in your existing installation. Identify any settings you have customized, and set those that you want to keep in the new deployment. For example, set nifi.sensitive.props.key so that the new deployment can read any encrypted parameters that you have set.

    2. Compare the file conf/bootstrap.conf with the bootstrap.conf file in your existing installation. Identify any settings you have customized, and set those that you want to keep in the new deployment.

    3. Deploy the Knowledge Discovery components to the extensions folder.

      NOTE: The Knowledge Discovery components for NiFi 1.x are not compatible with NiFi 2.x, so if you are upgrading from NiFi 1.x to NiFi 2.x, you must download and deploy new .NAR files.

    4. Copy the idol_repository folder from your existing installation to the new deployment.
    5. Copy the file conf/flow.json.gz from your existing installation to the new deployment. This file describes the dataflow that you have constructed.
  3. Start the new version of Apache NiFi and verify that the dataflow has been migrated successfully.

  4. Start the processors to resume ingesting and processing your data.