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.properties
with thenifi.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, setnifi.sensitive.props.key
so that the new deployment can read any encrypted parameters that you have set. -
Compare the file
conf/bootstrap.conf
with thebootstrap.conf
file 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
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.
- Copy the
idol_repository
folder from your existing installation to the new deployment. - Copy the file
conf/flow.json.gz
from 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.