An HBase connection stores the information that Oracle GoldenGate uses to connect to an Apache HBase deployment. After the connection is created and validated, you can reuse it when configuring Replicat processes that write transactional data to HBase.

The connection stores the HBase configuration independently of the Replicat configuration. A validated connection can be reused by multiple Replicat processes. Oracle GoldenGate uses the HBase client configuration to establish communication with the target HBase cluster.

Before creating an HBase connection, ensure that you have the following:

• An Oracle GoldenGate deployment.
• Network connectivity between the Oracle GoldenGate deployment and the HBase cluster.
• The hbase-site.xml configuration file for the target HBase cluster.
• Required HBase client libraries installed if additional runtime dependencies are required.
• Common runtime settings, such as the runtime classpath, if required by your deployment.
• Proxy information if the Oracle GoldenGate deployment accesses HBase through an HTTP proxy.

Use the Add Connection page to create an HBase connection.

Procedure

1. In the navigation menu, select DB Connections.
2. Click Add Connection.
3. In Connection Alias, enter a unique name for the connection.
4. From Technology Type, select HBase.
5. In the Technology Settings section, provide the HBase connection information.

   Configure the following technology settings:

   HBase Site XML: Upload the hbase-site.xml configuration file for the target HBase cluster. Oracle GoldenGate for Distributed Applications and Analytics uses the contents of this file to obtain the HBase client configuration required to establish the connection.

   Note:

   Ensure that the uploaded hbase-site.xml file matches the configuration of the target HBase cluster.
6. Configure Common Settings, if additional runtime configuration is required.

   Configure the following common settings:

   Classpath: Specifies the runtime classpath used to load the required HBase client libraries. You can use Dependency Downloader to download supported client libraries.

7. Note:

   • Download the supported HBase client libraries by using the Dependency Downloader for HBase.
   • Configure the runtime classpath to reference the downloaded client libraries before starting the Replicat process.
8. (Optional) Configure Proxy Settings if the Oracle GoldenGate for Distributed Applications and Analytics deployment accesses the HBase cluster through an HTTP proxy.

   Configure the following proxy settings:

   • Proxy URL – Specifies the URL or host name of the proxy server used to access the HBase cluster.
   • Proxy Port – Specifies the port number of the proxy server.
   • Proxy Username – Specifies the user name for proxy authentication, if required.
   • Proxy Password – Specifies the password for proxy authentication. This field is treated as sensitive information.
   • Truststore – Specifies the Java truststore file that contains the certificate authority (CA) certificates used to validate the proxy server certificate, when required.
   • Truststore Password – Specifies the password associated with the truststore.
   • Keystore – Specifies the Java keystore file containing the client certificate and private key used for client authentication, when required.
   • Keystore Password – Specifies the password associated with the keystore.
   • SSL Key Password – Specifies the password protecting the private key stored in the keystore when it differs from the keystore password.

     Note:

     Configure the proxy and SSL settings only if the Oracle GoldenGate for Distributed Applications and Analytics deployment accesses the HBase cluster through a proxy that requires authentication or TLS. If the deployment has direct network connectivity to the HBase cluster, leave the Proxy Settings blank.
9. Click Submit.
10. On the DB Connections page, click DBLOGIN to validate the connection.

    Note:

    A successful DBLOGIN validates only the saved connection information. It does not validate the Replicat configuration or HBase Handler configuration. After successful validation, the connection is available for selection during Replicat creation.

After the HBase connection has been successfully validated:

1. Create or edit a Replicat.
2. Select HBase as the target technology.
3. Select the validated HBase connection.
4. Complete the remaining Replicat configuration.
5. Create the Replicat.
6. Configure any remaining HBase Handler properties before starting the Replicat.