Cloudera Docs

Upgrading from CFM 1.0.0

To upgrade from CFM 1.0.0 to CFM 1.1.0, you must make note of and update some security password values, update the CSD files, restart the SCM Server, deactivate your old parcel and activate the new CFM parcel, and then restart your CFM services.

If you plan to upgrade from CFM version 1.0.0 to 1.1.0, Cloudera recommends that you first upgrade to CFM 1.0.1 and then to CFM 1.1.0. However, if you must upgrade directly from CFM version 1.0.0 to 1.1.0, follow the steps here.

  1. Stop NiFi, NiFi Registry, and NIFI CA Service in this order.
  2. Delete the old CSD files.
  3. Download the new CSD files.
    The default CSD location is /opt/cloudera/csd, but you can configure that location from Cloudera Manager Admnistration | Settings | Local Descriptor Repository Path.

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

  4. Download the new CFM parcel and .sha checksome 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. Get the nifi.sensitive.props.key value from one of the NiFi nodes you have installed: 
    cd /var/run/cloudera-scm-agent/process/ \
&& find . -name config.zip \
| grep "NIFI_NODE" \
| cut -c 3- \
| sort -n \
| tail -1 \
| xargs unzip -p \
| grep -A1 "<name>random.nifi.sensitive.props.key" \
| grep -Po "(?<=<value>)[^<]+"
  6. Remove flow.xml.gz from all nodes except the one from which you obtained the nifi.sensitive.props.key value.
    The var/lib/nifi/ path is the default location for flow.xml.gz, but file location is configurable using the nifi.working.directory property in the NiFi configuration file.
  7. In Cloudera Manager, select the cluster, then select NiFi from drop down, and then select the Configuration tab.
    Then use the search box to find the Sensitive Properties Key value. Copy the sensitive properties key value that you got from step 5 and paste into this box. The minimum length is 12 digits.
  8. Set the following additional NiFi passwords to randomly generated values:
    • nifi.master.key.password
    • nifi.security.truststorePasswd
    • nifi.security.keystorePasswd
    • nifi.security.keyPasswd
  9. Update the following NiFi Registry configurations with random values for the following fields:
    • nifi.registry.master.key.password
    • nifi.registry.security.truststorePasswd
    • nifi.registry.security.keyPasswd
    • nifi.registry.security.keystorePasswd

    You must use the same value for nifi.registry.security.keyPasswd and nifi.registry.security.keystorePasswd.

  10. Restart the cloudera-scm-server service: 
    service cloudera-scm-server restart
  11. In Cloudera Manager, from the Parcels page, distribute and activate the CFM 1.1.0 parcel.
    After clicking Activate, the Activate CFM 1.1.0.0 on <cluster-name> pop-up displays. Click Activate Only, and then OK.
  12. Restart the NiFi CA Service, NiFi Registry and NiFi, and deploy the client configurations.
  13. Optionally, to clean up, remove the old parcels from the host.
    1. From the Parcel menu, go to the CFM 1.0.0.0 parcel.
    2. Select Remove From Host.
    3. Select Delete.