NiFi Ingest 25.3
NiFi Ingest

# Upgrade NiFi Ingest Components

When you build a dataflow, the processors and controller services that you use have their own version numbers, and are not automatically upgraded. This topic explains how to upgrade your processors and controller services when new versions of the Knowledge Discovery components are released.

## Upgrade an Entire DataFlow

This section describes how to upgrade an entire dataflow, but requires you to stop and restart the Apache NiFi instance.

To upgrade NiFi Ingest components

1. Stop the Apache NiFi instance.

2. Navigate to `InstallDir/extensions/`, where `InstallDir` is the path where you installed Apache NiFi.

3. Replace any NiFi Ingest `*.nar` files with new versions. For example, you might replace the following components:

       idol-nifi-framework-api-nar-12.7.0.nar
       idol-nifi-framework-nar-12.7.0.nar
       idol-nifi-connector-filesystem-nar-12.7.0.nar
       idol-nifi-connector-web-nar-12.7.0.nar

   ...with the following:

       idol-nifi-framework-api-nar-25.3.0.nar
       idol-nifi-framework-nar-25.3.0.nar
       idol-nifi-connector-filesystem-nar-25.3.0.nar
       idol-nifi-connector-web-nar-25.3.0.nar

   IMPORTANT: Ensure that you only have one version of each component. Delete the old `*.nar` files or move them outside of the NiFi installation. The only exception is that you can have multiple versions of the `idol-nifi-framework-api-nar*` file, so that you can use different connectors with different version numbers in the same dataflow.

4. Start Apache NiFi.
5. Open the NiFi user interface in your web browser.
6. Check the dataflow for any errors or warnings.

## Upgrade Individual Components

This section describes how to upgrade individual components in a dataflow. You can do this without having to restart the Apache NiFi instance.

IMPORTANT: Do not use this procedure to upgrade NiFi Ingest components from IDOL 12.7.x or earlier. A known issue, resolved in IDOL 12.8.0, means that configuration settings, resource files, or data can be lost when NiFi Ingest components released before version 12.8 are updated using this method.

To upgrade NiFi Ingest components

1. Add the new NiFi Ingest components or Connectors into your Apache NiFi installation by copying the `*.nar` files into the `InstallDir/extensions/` directory, where `InstallDir` is the path where you installed Apache NiFi.

   IMPORTANT: Add any API components first, and wait for Apache NiFi to extract them, before adding other components. For example, you must add the `idol-nifi-framework-api-nar-VERSION.nar` before adding any other components.

   IMPORTANT: Do not remove the older NiFi Ingest and Connector `*.nar` files. (You can do this after updating all of the components on your dataflow, as described in the following steps).

2. Open the NiFi user interface in your web browser.

3. In the Operate Palette, click Configuration to open the NiFi Flow Configuration dialog box. Then, click the Controller Services tab and complete the following steps for each controller service that you want to upgrade:

   1. Stop the service (click Disable to open the Disable Controller Service dialog box. Disable the service and then close the Disable Controller Service dialog box to return to the NiFi Flow Configuration dialog box).

   2. In the row for the service, click Change Version .

      The Component Version dialog box opens.

   3. In the Version list, select the version of the service that you want to upgrade to.

   4. Click APPLY.

      The service is upgraded and the Type column shows the new version number.

4. Return to the canvas and complete the following steps for each processor that you want to upgrade:

   1. Stop the processor (right-click the processor and click Stop).

   2. Right-click the processor and click Change version .

      The Component Version dialog box opens.

   3. In the Version list, select the version of the processor that you want to upgrade to.

   4. Click APPLY.

      The processor is upgraded. You might need to make some configuration changes. For example, version 25.3 processors must be configured to use version 25.3 controller services.

Copyright 2018-2025 Open Text
Version 25.3 | Last updated July 2025

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 25.3

Topic Title: Upgrade NiFi Ingest Components