Cloudera Docs

Upgrading to CFM 2.1.7 from CFM 2.1.6

This procedure describes how to upgrade Cloudera Flow Management (CFM) from version 2.1.6 to 2.1.7.

This procedure applies only to upgrades from CFM 2.1.6 to CFM 2.1.7. If you want to upgrade from another CFM 2.x version, you must follow the supported upgrade sequence shown in the Upgrade and migration paths diagram and complete any required intermediate upgrades before upgrading to CFM 2.1.7.

  • Review the possible upgrade paths.

    Before starting your CFM upgrade, it is crucial that you review the available upgrade paths to ensure that you are performing the right upgrade for your use case.

    If you want to use CFM 2.1.7, you have the following options:
    • Upgrade from CFM 2.1.6 on CDP 7.1.7 to CFM 2.1.7 on CDP 7.1.7
    • Upgrade from CFM 2.1.6 on CDP 7.1.8 to CFM 2.1.7 on CDP 7.1.8
    • Upgrade from CFM 2.1.7 on CDP 7.1.7 to CFM 2.1.7 on CDP 7.1.8
    • Upgrade from CFM 2.1.7 on CDP 7.1.8 to CFM 2.1.7 on CDP 7.1.9

    For an overview of all available paths, see Upgrade and migration paths.

  • Upgrade Cloudera Manager and CDP Private Cloud Base, if needed.

To upgrade to CFM 2.1.7 from an earlier version of CFM on CDP Private Cloud Base, you must stop the CFM services, update the CSD files, restart the SCM Server, activate the new CFM parcel, and then restart your CFM services.
  1. Stop the NiFi and NiFi Registry services, in this order.
  2. Delete the old CSD files.
  3. Download the new CSD files for NiFi and NiFi Registry.
    For example: Use the following wget commands to download the required CSD files for CFM 2.1.7 SP2 on RHEL7/CentOS7.
    wget https://<username>:<password>@archive.cloudera.com/p/cfm2/2.1.7.2000/redhat7/yum/tars/parcel/NIFI-1.28.1.2.1.7.2000-69.jar
wget https://<username>:<password>@archive.cloudera.com/p/cfm2/2.1.7.2000/redhat7/yum/tars/parcel/NIFIREGISTRY-1.28.1.2.1.7.2000-69.jar

    By default, Cloudera Manager stores CSD files in /opt/cloudera/csd. To change this location, go to Administration > Settings > Local Descriptor Repository Path.

    Make sure the files have appropriate ownership, access attributes, and SELinux permissions if applicable.

  4. Download the new CFM parcel and .sha checksums file appropriate for your operating system.
    The default parcel location is /opt/cloudera/parcel-repo/.

    Ensure that you maintain the appropriate file ownership and access attributes and SELinux permissions if needed.

  5. Restart the cloudera-scm-server service: 
    systemctl restart cloudera-scm-server
  6. In Cloudera Manager, from the Parcels page, distribute and activate the CFM 2.1.7.2000 parcel.
    After clicking Activate, the Activate CFM <version> on <cluster-name> pop-up displays. Click Activate Only, and then OK.
  7. Restart Cloudera Management Service.
  8. Restart NiFi and NiFi Registry and deploy the client configurations.
  9. Optionally, to clean up, remove the previous parcels from the host.
    1. From the Parcel menu, go to the older CFM parcel.
    2. Select Remove From Host.
    3. Select Delete.
  10. From the Ranger UI, NiFi service controller policy:
    1. Add the nifi user to the policy with READ permissions.
    2. Verify the nifi group is set in the policy.