Upgrade NiFi
This section describes how to upgrade to a new version of the Apache NiFi application.
To upgrade NiFi
-
With your existing NiFi deployment:
- Stop all connectors and data ingestion.
- Wait until the FlowFiles already in the dataflow have been processed, so that all queues are empty.
- Stop all of the processors.
- Stop the NiFi application.
-
Download and extract the new version of NiFi. Then customize the installation by following these steps:
-
Compare the file
conf/nifi.propertieswith thenifi.propertiesfile in your existing installation. Identify any settings you have customized, and set those that you want to keep in the new deployment. For example, setnifi.sensitive.props.keyso that the new deployment can read any encrypted parameters that you have set. -
Compare the file
conf/bootstrap.confwith thebootstrap.conffile in your existing installation. Identify any settings you have customized, and set those that you want to keep in the new deployment. -
Deploy the Knowledge Discovery components to the
extensionsfolder.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.
- Copy the
idol_repositoryfolder from your existing installation to the new deployment. - Copy the file
conf/flow.json.gzfrom your existing installation to the new deployment. This file describes the dataflow that you have constructed.
-
-
Start the new version of Apache NiFi and verify that the dataflow has been migrated successfully.
-
Start the processors to resume ingesting and processing your data.