Cloudera Docs

Moving highly available NameNode, failover controller, and JournalNode roles using the Migrate Roles wizard

The Migrate Roles wizard allows you to move roles of a highly available HDFS service from one host to another. You can use it to move NameNode, JournalNode, and Failover Controller roles.

  • This procedure requires cluster downtime, not a shutdown. The services discussed in this list must be running for the migration to complete.
  • The configuration of HDFS and services that depend on it must be valid.
  • The destination host must be commissioned and healthy.
  • The NameNode must be highly available using quorum-based storage.
  • HDFS automatic failover must be enabled, and the cluster must have a running ZooKeeper service.
  • If a Hue service is present in the cluster, its HDFS Web Interface Role property must refer to an HttpFS role, not to a NameNode role.
  • A majority of configured JournalNode roles must be running.
  • The Failover Controller role that is not located on the source host must be running.
  • On hosts running active and standby NameNodes, back up the data directories.
  • On hosts running JournalNodes, back up the JournalNode edits directory.
  • If the source host is not functioning properly, or is not reliably reachable, decommission the host.
  • If Cloudera Data Platform and HDFS metadata was recently upgraded, and the metadata upgrade was not finalized, finalize the metadata upgrade.
  • Ensure all Kerberos principals for old and new hosts are available before launching the wizard. If the Kerberos principals are missing, you have to start over the wizard from the beginning after fixing the Kerberos issue. Currently, there are no prechecks available for this HDFS role migration wizard tool.
  1. If the host to which you want to move the NameNode is not in the cluster, add the required host.
  2. Go to the HDFS service.
  3. Click the Instances tab.
  4. Click the Migrate Roles button.
  5. Click the Source Host text field and specify the host running the roles to migrate.
    In the Search field optionally enter hostnames to filter the list of hosts and click Search.
    Select the checkboxes next to the desired host. The list of available roles to migrate displays. Clear any roles you do not want to migrate. When migrating a NameNode, the co-located Failover Controller must be migrated as well.
  6. Click the Destination Host text field and specify the host to which the roles will be migrated.
    On destination hosts, indicate whether to delete data in the NameNode data directories and JournalNode edits directory. If you choose not to delete data and such role data exists, the Migrate Roles command will not complete successfully.
  7. Acknowledge that the migration process incurs service unavailability by selecting the Yes, I am ready to restart the cluster now checkbox.
  8. Click Continue. The Command Progress screen displays listing each step in the migration process.
  9. When the migration completes, click Finish.
After moving a NameNode, if you have a Hive or Impala service, perform the following steps:
  1. Go to the Hive service.
  2. Stop the Hive service.
  3. Select Actions > Update Hive Metastore NameNodes.
  4. If you have an Impala service, restart the Impala service or run an INVALIDATE METADATA query.