NiFi Ingest 26.1
NiFi Ingest

# 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.

Copyright 2018-2025 Open Text
Version 26.1 | Last updated January 2026

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery NiFi Ingest 26.1

Topic Title: Upgrade NiFi