Migrating HDFS data to Ozone

Copy curated HDFS directories from a source cluster to Apache Ozone on a target cluster without altering source data, using Cloudera Replication Manager-backed executions.

Planning completes with Cloudera Replication Manager replication policies copying every selected directory into deployed Ozone layout targets. The source HDFS data remains intact.

  • Both source (HDFS) and target (Ozone) clusters must be displayed on the Clusters page. For instructions, see Registering clusters.

  • The target cluster must host Apache Ozone with the service running.

  • You must model and deploy Ozone volumes, buckets, and folders in the Storage Layout Editor. Without deployed layout destinations, executions have nowhere to persist data. For instructions, see Managing Ozone storage.

  • CMA Agents must operate on source and target clusters.

  • Cloudera Replication Manager must be reachable. Cloudera Migration Assistant submits policies through Cloudera Replication Manager APIs.

  • Secure clusters authenticate with Kerberos, so you must confirm that the migration user principal works for filesystem access.

Whenever Discovery trees look stale before mapping, rerun the steps in Scanning clusters. Collections exported from scans help bound execution scopes . For more information, see Creating collections for migration if you segregate phased cutovers.

Step 1 — Scan the source cluster (HDFS)

  1. Open Clusters, then select the source cluster.
  2. Click Start Scanning.
  3. Select Hdfs data scan.
  4. Optional: Constrain the scan path, for example, /tmp or /user, to shorten runs on massive namespaces.
  5. Click Scan selected and watch the progress drawer until completion.

    After success, Discovery lists HDFS trees with sizing and ownership snapshots.

Step 2 — Scan the target cluster (Ozone)

  1. Confirm Apache Ozone is healthy in Cloudera Manager before scanning.
  2. From Clusters, open the target cluster.
  3. Click Start Scanning.
  4. Select Ozone data scan.
  5. Click Scan selected and wait until the status turns green.

    Ozone hierarchies populate inside Discovery afterward.

Step 3 — Create a migration plan

  1. Go to Plans.
  2. Click Create Plan.
  3. Set Name, select the source HDFS cluster, and the target Ozone cluster.
  4. Complete the wizard (Create) and land on the plan detail surface.

Step 4 — Map HDFS directories to Ozone paths on the Data tab

The Data tab displays source HDFS on the left and target storage on the right.

  1. Go to Plan > Data.
  2. Switch the target browser mode from HDFS to Ozone using the service picker.
  3. Go to your target volume, bucket, and folder staging area.
  4. On the source side, go to the parent directory that contains data you want to migrate.
  5. Hover the directory and click Copy. Cloudera Migration Assistant persists a structural mapping.
  6. Switch to the Review view any time to view a list of your current structure mappings.
  7. Optional: When Ozone misses a folder UI-side, create it before copying structures.
    1. In the target browser, go to the parent bucket or folder.
    2. Click Create Folder.
    3. Provide the folder name and confirm creation.

    Cloudera Migration Assistant updates its metadata immediately and executions push the filesystem change during processing.

  8. Repeat the mapping workflow for additional directories whenever you broaden scope.

    You can map each directory to separate buckets or combine them into shared buckets. The layout must meet the Cloudera Replication Manager requirements for your tenancy model.

Step 5 — Create and run an execution

  1. Open Execution.
  2. Select Create Execution.
  3. Complete the steps in the configuration wizard (General, Scope, Review), and then click Finish.
  4. Open the execution dashboard and trigger Run All.

    During execution the following stages occur:

    • Policy creationCloudera Migration Assistant registers Cloudera Replication Manager policies mapping HDFS prefixes to destination Ozone keys.

    • Data replicationCloudera Replication Manager invokes DistCp-style transfers governed by Cloudera Replication Manager settings.

    • Verification – CMA Master tracks step health until completion (COMPLETED or FAILED statuses per step).

Step 6 — Verify the migration

  1. Confirm that the execution steps display COMPLETED.
  2. Inspect Ozone hierarchies inside Discovery.
  3. Optional: Validate migrated objects using the Ozone CLI.
    ozone fs -ls ofs://<service-id>/<volume>/<bucket>/<path>