Cloudera Docs

Migrating HBase tables

During the HBase migration, the HBase tables with their related metadata are migrated from a CDH or Cloudera Private Cloud Base cluster to an Cloudera Operational Database Data Hub cluster.

Before the migration, the source cluster is scanned to collect the HBase tables. During the migration process, the tables are not affected on the source cluster and can remain part of running jobs.
  • Ensure that Cloudera Migration Assistant is set up correctly using the steps in Setting up Cloudera Migration Assistant server.
  • Ensure that you have met the requirements detailed in Reviewing prerequisites before migration.
  • Ensure that you have a CDH 5, CDH 6 or Cloudera Private Cloud Base cluster registered as a source from which you want to migrate your HBase tables. If you do not have a source cluster yet, complete the steps in Registering source clusters.
  • Ensure that you have an Cloudera Operational Database Data Hub cluster registered as a destination cluster to which you want to migrate your HBase tables. If you do not have a destination cluster yet, complete the steps in Registering destination clusters.
  • Ensure that you have one of the following parcels (together with its corresponding .sha files) procured from Cloudera Support based on which CDH version you use:
      • CLOUDERA_OPDB_REPLICATION-1.0-1.CLOUDERA_OPDB_REPLICATION5.14.4.p0.31473501-el7.parcel
      • CLOUDERA_OPDB_REPLICATION-1.0-1.CLOUDERA_OPDB_REPLICATION6.3.3.p0.8959316-el7.parcel
      • Copy the OpDB Replication Manager parcels to the following directories based on the CDH version:
        • [***CMA ROOT FOLDER***]/parcels/hbase/cdh5/
        • [***CMA ROOT FOLDER***]/parcels/hbase/cdh6/
  1. Click on the CDH or Cloudera Private Cloud Base cluster you want to use for the migration on the Clusters page.
  2. Click Start Scanning to open the Scan Settings.
  3. Select HBase table scan.
  4. Click Scan selected.
    You will be redirected to the scanning progress, where you can monitor if the scanning process was successful or encountered any error.
  5. Click on HBase table to view the collected tables when the scan is finished.
  6. Add the needed HBase tables to Collections.

    Collections serve as an organization method to sort and bundle the tables into groups for the migration. You can create more collections beside the Default collection based on your requirements.

    After you are finished with sorting the tables to collections, you can start the migration process by creating the migration plan.

  7. Click Create Migration or select Migrations > Start Your First Migration.
    1. Select the source cluster, and click Next.
    2. Select the destination cluster, and click Next.
    3. Select the type of migration, and click Next.
    4. Select the collections that you want to migrate, and click Next.
    5. Provide the Knox token to access Cloudera Manager of the Cloudera Data Hub cluster in Cloudera Public Cloud.
      1. Navigate to the destination Cloudera Data Hub cluster.
      2. Select Knox Token from the list of services.
      3. Click Token generation, and provide the name and life of the token.
      4. Click Generate Token.
      5. Copy the generated token, and navigate back to the migration plan. Paste the token to the Knox Token field.
    6. Click Next.
      An overview of the migration plan is displayed. At this point, you can go back and change any configuration if the information is not correct. If the information is correct, click Create.
  8. Click Go to Migrations when the migration plan is successfully created.
  9. Click on the Cloudera Public Cloud or Cloudera Private Cloud Base to Cloudera Public Cloud migration to start the migration.
    The steps are displayed that are going to be completed during the migration.
  10. Click to start migration.
    During the HBase table migration, the source cluster is prepared with the HBase Replication Manager parcel. When the replication policy is submitted, click to finalize the replication policies.
When all of the steps are successfully completed, the migration of HBase tables from CDH or Cloudera Private Cloud Base to Cloudera Public Cloud is finished. You can start using the HBase tables on the destination Cloudera Operational Database Data Hub cluster with the available services.