In environments where NiFi is not managed by Cloudera Manager, you
can run a manual migration precheck directly from the command line on NiFi nodes to prepare
for the migration from Cloudera Flow Management 2.1.7 (NiFi 1–based) to Cloudera Flow Management 4.x (NiFi 2–based). Follow the below steps to perform
the precheck.
This task must be performed in Cloudera Flow Management 2.1.7.
-
Download the migration precheck script and the associated CSV files listing the
components deprecated in NiFi 2 and the components with updated Kerberos
properties.
These files are part of the Cloudera Service Descriptor (CSD) package
available behind the paywall.
-
Download the NiFi CSD file and unzip it.
-
Locate the required files.
- scripts/service-commands/pre_upgrade_check.py
- scripts/common-scripts/resources/CFM4-Deprecated-components.csv
- scripts/common-scripts/resources/NiFi-1.x-components-with-legacy-Kerberos-properties.csv
-
After downloading the files, run the migration precheck script using the
following command.
su nifi
python3 [***path_to***]/pre_upgrade_check.py \
"[***path_to***]/flow.json.gz" \
"[***path_to***]/CFM4-Deprecated-components.csv" \
"[***path_to***]/NiFi-1.x-components-with-legacy-Kerberos-properties.csv" \
"[***path_to***]/bootstrap.conf" \
"" \
"[***path_to***]/nifi-framework-nar-<version>.nar" \
"[***path_to***]/nifi.sh"
For example:
su nifi
python3 /tmp/scripts/service-commands/pre_upgrade_check.py \
/var/lib/nifi/flow.json.gz \
"/tmp/scripts/common-scripts/resources/CFM4-Deprecated-components.csv" \
"/tmp/scripts/common-scripts/resources/NiFi-1.x-components-with-legacy-Kerberos-properties.csv" \
"/tmp/nifi-1.26.0.2.1.7.1000-25/conf/bootstrap.conf" \
"" \
"/tmp/nifi-1.26.0.2.1.7.1000-25/lib/nifi-framework-nar-1.26.0.2.1.7.1000-25.nar" \
"/tmp/nifi-1.26.0.2.1.7.1000-25/bin/nifi.sh"
The script generates a detailed report highlighting any issues that need to
be resolved before upgrading to NiFi 2.
-
Review this report thoroughly to ensure a smooth migration process.
