Cloudera Docs

Running a manual migration precheck for standalone NiFi (not managed by Cloudera Manager)

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. Follow these steps to perform the precheck.

  1. Download the pre-upgrade check 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.
    1. Download the NiFi CSD file and unzip it.
    2. 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
  2. After downloading the files, run the pre-upgrade check 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.

  3. Review this report thoroughly to ensure a smooth upgrade process.