Cloudera Docs

Upgrading to CFM 2.1.5 from CFM 2.x

To upgrade to CFM 2.1.5 from a lower 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.

  • You have upgraded Cloudera Manager and CDP Private Cloud Base if needed.

  • You have reviewed the Upgrade and migration paths to make sure you are performing the right upgrade for your use case.

  • You have reviewed the Before you upgrade information to make sure you meet the prerequisites.

  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.5 SP3 on RHEL7/CentOS7.
    wget https://<username>:<password>@archive.cloudera.com/p/cfm2/2.1.5.3000/redhat7/yum/tars/parcel/NIFI-1.18.0.2.1.5.3000-3.jar 

wget https://<username>:<password>@archive.cloudera.com/p/cfm2/2.1.5.3000/redhat7/yum/tars/parcel/NIFIREGISTRY-1.18.0.2.1.5.3000-3.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: 
    service cloudera-scm-server restart
  6. In Cloudera Manager, from the Parcels page, distribute and activate the CFM 2.1.5 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.