๐Ÿ”—Upgrading CDAP using Cloudera Manager

๐Ÿ”—Upgrading CDAP

When upgrading an existing CDAP installation from a previous version, you will need run an upgrade tool to make sure the CDAP table definitions in HBase are up-to-date.

To upgrade existing pipeline applications created using the 4.0.x versions of system artifacts, there are separate instructions on doing so. Run these after upgrading CDAP.

These steps will upgrade from CDAP 4.0.x to 4.1.1. If you are on an earlier version of CDAP, please follow the upgrade instructions for the earlier versions and upgrade first to 4.0.x before proceeding.

๐Ÿ”—Upgrading CDAP Patch Release Versions

Upgrading between patch versions of CDAP refers to upgrading from one 4.1.x version to a higher 4.1.x version. When a new compatible CDAP parcel is released, it will be available via the Parcels page in the Cloudera Manager UI.

๐Ÿ”—Upgrading CDAP Major/Minor Release Versions

Upgrading between major versions of CDAP (for example, from a 4.0.x version to 4.1.x) involves the additional step of upgrading the CSD. Upgrades between multiple Major/Minor versions must be done consecutively, and a version cannot be skipped unless otherwise noted.

The following is the generic procedure for all upgrades. These steps will stop CDAP, update the installation, run an upgrade tool for the table definitions, and then restart CDAP:

  1. Stop all flows, services, and other programs in all your applications.
  2. Stop all CDAP services.
  3. Ensure your installed version of the CSD matches the target version of CDAP. For example, CSD version 3.0.* is compatible with CDAP version 3.0.*. Download the latest version of the CSD.
  4. Use the Cloudera Manager UI to download, distribute, and activate the target CDAP parcel version on all cluster hosts.
  5. Before starting services, run the CDAP Upgrade Tool to upgrade CDAP. From the CDAP Service page, select "Run CDAP Upgrade" from the Actions menu. Note that authorization is disabled in the UpgradeTool so that the cdap user can upgrade all users' data.
  6. Start the CDAP services. At this point it may be necessary to correct for any changes in the CSD. For example, if new CDAP services were added or removed, you must add or remove role instances as necessary. Check the release-specific upgrade notes below for any specific instructions.
  7. After CDAP services have started, run the CDAP Post-Upgrade Tasks to perform any necessary upgrade steps against the running services. From the CDAP Service page, select "Run CDAP Post-Upgrade Tasks."
  8. To upgrade existing pipeline applications created using the 4.0.x versions of the system artifacts, there are separate instructions.
  9. You must recompile and then redeploy your applications prior to using them.

๐Ÿ”—Upgrading CDH

These steps cover what to do when upgrading the version of CDH of an existing CDAP installation. As the different versions of CDH can use different versions of HBase, upgrading from one version to the next can require that the HBase coprocessors be upgraded to the correct version. The steps below will, if required, update the coprocessors appropriately.

It is important to perform these steps as described, otherwise the coprocessors may not get upgraded correctly and HBase regionservers may crash. In the case where something goes wrong, see these troubleshooting instructions for problems while upgrading CDH.

Upgrade Steps

  1. Upgrade CDAP to a version that will support the new CDH version, following the usual CDAP-Cloudera Manager upgrade procedure.

  2. After upgrading CDAP, start CDAP and check that it is working correctly.

  3. Using Cloudera Manager (CM), stop all CDAP applications and services.

  4. Disable all CDAP tables; from an HBase shell, run the command:

    > disable_all 'cdap.*'
    
  5. Upgrade to the new version of CDH, following Cloudera's documentation on upgrading.

  6. Stop all CDAP services, as CM may have auto-started CDAP.

  7. Run the Post-CDH Upgrade Tasks to upgrade CDAP for the new version of CDH. From the CDAP Service page, select "Run Post-CDH Upgrade Tasks" from the Actions menu.

  8. Enable all CDAP tables; from an HBase shell, run this command:

    > enable_all 'cdap.*'
    
  9. Start CDAP using Cloudera Manager.