How do I upgrade the ApsaraDB for HBase SDK for Java - Lindorm

You can use ApsaraDB for HBase SDK for Java to use all features provided by LindormTable. This topic describes how to install the client of ApsaraDB for HBase SDK for Java.

Usage notes

ApsaraDB for HBase SDK for Java does not support JDK 17 releases.

Prerequisites

Java Development Kit (JDK) V1.8 or later is installed.

Client versions

If you install ApsaraDB for HBase SDK for Java by upgrading a client that uses open source HBase 1.x, you must add the dependency on ApsaraDB for HBase 1.x.
If you install ApsaraDB for HBase SDK for Java by upgrading a client that uses open source HBase 2.x, you must add the dependency on ApsaraDB for HBase 2.x.

Upgrade ApsaraDB for HBase SDK for Java

Note

If you use ApsaraDB for HBase SDK for Java for the first time, we recommend that you select the latest ApsaraDB for HBase version. For example, if your client uses open source HBase 1.1.1 and the latest ApsaraDB for HBase version is 1.8.8, we recommend that you install ApsaraDB for HBase 1.8.8.

If your client uses open source HBase 1.x, add the following Maven dependencies to the pom.xml file to install ApsaraDB for HBase SDK for Java:
```
<dependency>
  <groupId>com.aliyun.hbase</groupId>
  <artifactId>alihbase-client</artifactId>
  <version>1.8.8</version>
</dependency>
```
If your client uses open source HBase 2.x, add the following Maven dependencies to the pom.xml file to install ApsaraDB for HBase SDK for Java:
```
<dependency>
  <groupId>com.aliyun.hbase</groupId>
  <artifactId>alihbase-client</artifactId>
  <version>2.8.7</version>
</dependency>
```

Important

If clients that use ApsaraDB for HBase are not supported in your environment, or you usually use Hive, Spark or open source Flink to connect to LindormTable, we recommend that you use an open source HBase client to connect to and use LindormTable.

Take note of the following items when you use an open source HBase client to connect to and use LindormTable:

If you use an open source HBase client, you can connect to LindormTable only by using VPCs but not the Internet.
Open source HBase clients cannot be used to access Lindorm instances deployed across multiple zones.
If you use an open source HBase client to connect to LindormTable, the performance of LindormTable may be degraded due to protocol conversion.
If you use an open source HBase client to use LindormTable, some features provided by Lindorm cannot be used, such as compressed transmission, request authentication, ACL, end-to-end tracing, and client configuration pushing and optimization.
If you use an open source HBase client to connect to LindormTable, the version of LindormTable must be 2.6.2.8 or later. For more information about how to the upgrade the version of LindormTable, see Upgrade the minor engine version of a Lindorm instance.
The version of open source HBase used by the client must be 0.98 to 2.x.