Help Center/ CloudTable Service/ User Guide/ HBase User Guide/ HBase Cluster Management/ Using HBase/ Using HBase Shell to Access a Cluster
Updated on 2024-12-24 GMT+08:00
View PDF
Share

Using HBase Shell to Access a Cluster

You can use the HBase shell to access a cluster by deploying a client in one click or manually installing a client on an ECS. You are advised to use the one-click client deployment method. If a secure channel is enabled for the cluster, connect to the cluster by referring to connecting to an HBase cluster in security mode.

Deploying a Client in One Click

  1. Prepare a Linux ECS.

    Using a one-click client deployment tool. The recommended Linux ECS operating systems are EulerOS, CentOS, Ubuntu, and SUSE. For details, see Preparing an ECS.

  2. Download the one-click client deployment tool.

    Use the SSH login tool (such as PuTTY) to remotely log in to the Linux ECS through the EIP and run the following command to obtain the one-click deployment tool.

    curl -O -k "https://cloudtable-publish.obs.myhuaweicloud.com/cloudtable-client/quick_start_hbase_shell.sh"
    • This command applies to HBase 2.x.

  3. Obtain a cluster access address.

    Log in to the CloudTable console and choose Cluster Management. In the cluster list, locate the required cluster and obtain the address in the Access Address (Intranet) column. The parameter value is the cluster access address, as shown in Figure 1.

    Figure 1 Access address

  4. Use the tool to deploy the client.

    Replace $zookeeper_address in the following command with the ZK link you obtained in 3. Then, run the command on the CLI of the ECS to deploy the client in one click.

    1. Commands for one-click client deployment for common clusters: 
      source quick_start_hbase_shell.sh $zookeeper_address

  5. Start the shell to access the cluster.

    After you run the source command to automatically deploy the client, the HBase shell is automatically started. You can also run the bin/hbase shell command to start the HBase shell to access the cluster.

Manually Installing a Client

  1. Prepare a Linux ECS.

    For details, see the following content in Preparing an ECS.

    1. Preparing an ECS
    2. Configuring the DNS Address and hosts File for the Linux ECS

  2. Download the client.

    Log in to the CloudTable management console. In the navigation pane on the left, choose Help. On the right of the page, click Download Client to download the client installation package.

    Figure 2 Downloading the client

  3. Install the client and verify the client.

    1. Use a file transfer tool (such as WinSCP) to upload the client installation package to the Linux ECS.
    2. Use the SSH login tool (such as PuTTY) to log in to the Linux ECS through the EIP.

      For details about how to log in to the Linux ECS, see Logging In to a Linux ECS > Login Using an SSH Password in the Elastic Cloud Server User Guide.

      Run the following command to decompress the client installation package:

      cd <Path of the client installation package>
tar xzvf hbase-1.3.1-bin.tar.gz
      cd <Path of the client installation package>
tar xzvf hbase-2.4.14-bin.tar.gz

      <Path of the client installation package>: Replace it with the actual path.

    3. Configure the ZooKeeper address in a configuration file.

      In the decompression directory of the client installation package, open the hbase/conf/hbase-site.xml file and set the following parameters:

      • hbase.zookeeper.quorum: The value of this parameter is the access address (Intranet) of the cluster found in the cluster list.

        Log in to the CloudTable console and choose Cluster Management. In the cluster list, locate the required cluster and obtain the address in the Access Address (Intranet) column. See the following figure.

        Figure 3 ZK link
      • mapreduce.cluster.local.dir: Check whether the configuration item exists. If the configuration item does not exist, add it.

      The configuration example is as follows:

      <configuration>
<property>
<name>hbase.zookeeper.quorum</name>
<value>xxx-zk1.cloudtable.com,xxx-zk2.cloudtable.com,xxx-zk3.cloudtable.com</value>
</property>

<property>
<name>mapreduce.cluster.local.dir</name>
<value>${hadoop.tmp.dir}/mapred/local</value>
</property>
</configuration>

  4. Start the shell to access the cluster.

    Run the bin/hbase shell command to start the shell to access the cluster.

Parent topic: Using HBase