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 IDOL components are released.

To upgrade NiFi Ingest components

  1. Add the new IDOL NiFi Ingest components or IDOL 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 IDOL NiFi Ingest and IDOL Connector *.nar files. (You can do this after updating all of the components on your dataflow, as described in the following steps).

    NOTE: For Apache NiFi versions earlier than 1.9.0, you must stop NiFi and copy the new components into the folder InstallDir/lib/.

  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 12.6 processors must be configured to use version 12.6 controller services.


_FT_HTML5_bannerTitle.htm