Cloudera Docs

Enabling Dual-Stack support for HBase

Know how to enable IPv6 support for HBase in a dual-stack cluster.

By default, HBase is configured to use IPv4 as the preferred IP version. If your dual-stack cluster supports IPv6, you can enable this option within Cloudera Manager.

The following are the limitations related to IPv6 support:

  • In dual-stack environments, IPv6 addresses are only supported for clients; however, internal and server-side services (for example, Master, Region Server) that communicate with HDFS require IPv4 addresses.
  • It is advised to be cautious when incorporating network-related properties to override JVM options for any process (server-side or client-side), as this may lead to unexpected behaviour.

    For example, when you add the -Djava.net.preferIPv6Addresses JVM option to HBASE_OPTS, the HBase master process inherits it and prefers to communicate with HDFS over IPv6. As a result, the connection fails, and the master goes down because HDFS does not support IPv6.

  1. Log in to Cloudera Manager as an Administrator
  2. Go to Clusters > HBase > Configuration.
  3. Select Scope > HBASE-1 (Service Wide).
  4. Select Category > Performance.
  5. Set the IP version to DUAL_STACK for the Network IP Version (Default: IPv4) property.
  6. Click Save Changes.
  7. Restart the HBase service