Serverless Shell Access

Updated at:

This topic describes how to use the HBase Serverless Shell tool to access an ApsaraDB for HBase serverless cluster.

Prerequisites

When you connect over an internal network, make sure that you have an ECS instance in the same virtual private cloud (VPC) as your HBase serverless cluster. If you have not created an ECS instance, see How to create an ECS instance.
Note New purchases for HBase serverless clusters are not supported.

Procedure

  1. Download the HBase Serverless Shell package.
    1. Log on to the ApsaraDB for HBase console.
    2. On the Clusters page, click the name of the cluster instance.
    3. In the navigation pane on the left, click Database Connection.
    4. Click HBase Serverless Shell Download.
  2. Copy the client connection configuration.
    1. Log on to the ApsaraDB for HBase console.
    2. On the Clusters page, click the name of the cluster instance.
    3. In the navigation pane on the left, click Database Connection. Click One-click Generation of Configuration Items. In the Client Connection Configuration section, copy the XML Configuration.
  3. Add the copied XML Configuration to the hbase-site.xml
    <configuration>
          <!--
        The endpoint of the cluster. You can obtain the endpoint from the Database Connection page in the console. Note the public endpoint and the VPC endpoint.
        -->
        <property>
            <name>hbase.zookeeper.quorum</name>
            <value>ld-xxxx-proxy-hbaseue.hbaseue.xxx.rds.aliyuncs.com:30020</value>
        </property>
        <!--
      Set the username and password. The default format is AccessKey ID:AccessKey secret. You can change them as needed.
      -->
      <property>
          <name>hbase.client.username</name>
          <value>AccessKey ID</value>
      </property>
      <property>
          <name>hbase.client.password</name>
          <value>AccessKey secret</value>
      </property>
        <!--
        If you directly depend on the Alibaba Cloud HBase client, you do not need to configure the connection.impl parameter. If you depend on alihbase-connector, you must configure this parameter.
        -->
        <!--property>
            <name>hbase.client.connection.impl</name>
            <value>org.apache.hadoop.hbase.client.AliHBaseUEClusterConnection</value>
        </property-->
    </configuration>
  4. On the ECS instance, run the .bin/hbase command to connect to the HBase serverless cluster.