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

## 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 the following directory, where `InstallDir` is the path where you installed Apache NiFi.

   - Apache NiFi 1.9.0 or later

     `InstallDir/extensions/`

   - Apache NiFi 1.7.x or 1.8.0

     `InstallDir/lib/`

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-12.8.0.nar
       idol-nifi-framework-nar-12.8.0.nar
       idol-nifi-connector-filesystem-nar-12.8.0.nar
       idol-nifi-connector-web-nar-12.8.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. If you are using Apache NiFi version 1.9.0 or later, you can do this without having to restart the Apache NiFi instance.

IMPORTANT: Do not use this procedure to upgrade IDOL 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 IDOL NiFi Ingest components released before version 12.8 are updated using this method.

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

_FT_HTML5_bannerTitle.htm