Skip to content

You are viewing documentation for Immuta version 2023.1.

For the latest version, view our documentation for Immuta SaaS or the latest self-hosted version.

Upgrade the Immuta HDFS Plugin on CDH

Audience: System Administrators

Content Summary: This page details how to upgrade the Immuta Parcel and Service on your CDH cluster.

Prerequisites: Follow the Immuta CDH Integration Prerequisites to prepare for upgrading.

Upgrade the Parcel

Transfer the Immuta .parcel and its associated .parcel.sha to your Cloudera Manager node and place them in /opt/cloudera/parcel-repo. Once copied, ensure files must have ownership cloudera-scm and group cloudera-scm.

Once the Immuta parcel and its SHA (hash) file are in the parcel repo, you can distribute and activate the updated parcel. (Activating the new parcel will automatically deactivate an older version.) To do so,

  1. In Cloudera Manager, select the Parcels icon in the upper right corner.
  2. Click Check for New Parcels.
  3. Make sure the location filter has your on-cluster parcel repo selected.
  4. Locate the IMMUTA parcel, and then find the row corresponding to the version you are upgrading to. Click Distribute.
  5. Wait for the parcel to finish distribution. Once finished, the action button for that row should say Activate.
  6. Click the Activate button to activate the parcel.

You have successfully upgraded your Immuta parcel.

Upgrade the Immuta Partition Service

The first step in upgrading your Immuta Partition Service CSD is copying the .jar file to your Cloudera Manager node, placing it in /opt/cloudera/csd. The file must have ownership cloudera-scm and group cloudera-scm.

You will need to restart Cloudera Manager in order for the CSD to be picked up:

systemctl restart cloudera-scm-server
service cloudera-scm-server restart

Finally, restart the IMMUTA service in Cloudera Manager.