qubership‐nifi 2.0.0 Upgrade Notes

qubership-nifi 2.0.0 Upgrade Notes

qubership-nifi 2.0.0 includes upgrade to Apache NiFi 2.5.0 that may affect existing deployments. This document outlines the key upgrade notes to help ensure a smooth transition to the new version.

Notable Changes

• Apache NiFi 2.x requires changes to custom components (processors, controller services, reporting tasks). See this page (TBD) for details on how to update custom components.

• Apache NiFi 2.x support Python-based processors. For this functionality to work, Python must be installed in the Docker image used to run qubership-nifi. See qubership-nifi Dockerfile for reference.

• New directory have been added in Apache NiFi 2.x to support Python, namely ./python_extensions. It contains Python files used by Python-based processors (defined by property nifi.python.extensions.source.directory.default in nifi.properties). If you plan to use Python-based processors, you may need to mount this directory as a volume in the Docker container.

• Vanilla Apache NiFi 2.x Docker image changes NAR autoloader directory from ./extensions to ./nar_extensions. qubership-nifi image keeps ./extensions to maintain backward compatibility with 1.x version.

• New directories have been added in Apache NiFi 2.x for NAR files and assets loaded via NiFi API. If you plan to use NiFi API to load NAR files or assets, you may need to mount these directories as volumes in the Docker container, so that they are kept between restarts. These directories are:

  1. ./nar_repository - contains NAR files for NiFi extensions loaded via NiFi API (defined by property nifi.nar.persistence.provider.properties.directory in nifi.properties).
  2. ./assets - contains assets (various files used within flows) loaded via NiFi API (defined by property nifi.asset.manager.properties.directory in nifi.properties).

• Apache NiFi 2.x prohibits change of key used to encrypt sensitive properties. So NIFI_NEW_SENSITIVE_KEY environment variable cannot be changed after first deploy. NIFI_PREVIOUS_SENSITIVE_KEY environment variable is ignored in qubership-nifi 2.x version.