GBase 8a MPP Cluster（以下简称“8a集群”）是南大通用公司自主研发、国内领先的大规模分布式并行数据库集群系统，具有满足各个数据密集型行业日益增大的数据分析、数据挖掘、数据备份和即席查询等需求的能力。已在银监会、农总行、中移动、海关总署等数百家用户形成规模化应用，目前部署节点总数超过35000个，管理数据超过400PB。

客户端独立安装的意义

当安装好GBase 8a MPP Cluster后，gcluster管理节点上自动安装了gccli命令行客户端工具，执行gccli命令即可连接到8a数据库。在实际的生产环境中，操作人员不直接连接到服务器上，而是通过连接堡垒机上面的客户端工具，然后通过该客户端工具再连接到GBase集群管理服务器上，这样比较安全。

GBase 8a提供了两种客户端工具，一种命令行gccli工具，一种是图形化的企业管理器工具，这里给大家介绍在非8a集群管理节点上安装gccli命令行客户端的方法。

客户端独立安装包的获取

在gbase官网(www.gbase.cn)可以下载GBase 8a最新版免费的gccli客户端工具安装包
具体方法：官网–>服务与下载–>下载中心–>GBase 8a–> GBase 8a MPP Cluster V9 ，选择"工具"下面的“gccli_MPP_Cluster-NoLicense-FREE-9.5.3.28.12-redhat7-x86_64.tar.bz2”进行下载

GBase 8a最新版免费的gccli客户端工具安装包下载地址：
https://www.gbase.cn/download/gbase-8a?category=TOOLKIT

将安装包gccli_MPP_Cluster-NoLicense-FREE-9.5.3.28.12-redhat7-x86_64.tar.bz2 安装包上传到一个非8a集群的节点上/tmp 目录下。

8a集群环境

GBase 8a集群环境为3个节点服务器IP：
查看集群信息如下：

[gbase@peixun-0058 ~]$ gcadmin
CLUSTER STATE:         ACTIVE
VIRTUAL CLUSTER MODE:  NORMAL

=====================================
| GBASE GCWARE CLUSTER INFORMATION  |
=====================================
| NodeName |   IpAddress   | gcware |
-------------------------------------
| gcware1  | 172.168.10.9  |  OPEN  |
-------------------------------------
| gcware2  | 172.168.10.29 |  OPEN  |
-------------------------------------
| gcware3  | 172.168.10.53 |  OPEN  |
-------------------------------------
=======================================================
|        GBASE COORDINATOR CLUSTER INFORMATION        |
=======================================================
|   NodeName   |   IpAddress   | gcluster | DataState |
-------------------------------------------------------
| coordinator1 | 172.168.10.9  |   OPEN   |     0     |
-------------------------------------------------------
| coordinator2 | 172.168.10.53 |   OPEN   |     0     |
-------------------------------------------------------
| coordinator3 | 172.168.10.29 |   OPEN   |     0     |
-------------------------------------------------------
=========================================================================================================
|                                    GBASE DATA CLUSTER INFORMATION                                     |
=========================================================================================================
| NodeName |                IpAddress                 | DistributionId | gnode | syncserver | DataState |
---------------------------------------------------------------------------------------------------------
|  node1   |               172.168.10.9               |       1        | OPEN  |    OPEN    |     0     |
---------------------------------------------------------------------------------------------------------
|  node2   |              172.168.10.53               |       1        | OPEN  |    OPEN    |     0     |
---------------------------------------------------------------------------------------------------------
|  node3   |              172.168.10.29               |       1        | OPEN  |    OPEN    |     0     |
---------------------------------------------------------------------------------------------------------
复制

安装客户端

准备在非8a集群环境的 172.168.10.61 服务器上安装能访问GBase 8a的gccli客户端，172.168.10.61服务器使用的CentOS 7.9操作系统。

以下所有操作都在 172.168.10.61 服务器上进行

1、创建DBA用户gbase（如果已设置，则跳过）

[root@peixun-0057 tmp]# useradd gbase
[root@peixun-0057 tmp]# passwd gbase

复制

2、解压缩安装包，生成安装目录（使用DBA账户gbase进行操作）

安装包gccli_MPP_Cluster-NoLicense-FREE-9.5.3.28.8-centos7-x86_64.tar.bz2 已经上传达到/tmp目录，使用tar xfj …解压缩

[gbase@peixun-0057 opt]$ cd ~
[gbase@peixun-0057 ~]$ ll /tmp
total 6348
-rw-r--r-- 1 root root 6494589 Apr 17 15:19 gccli_MPP_Cluster-NoLicense-FREE-9.5.3.28.8-centos7-x86_64.tar.bz2

[gbase@peixun-0057 ~]$ tar xfj /tmp/gccli_MPP_Cluster-NoLicense-FREE-9.5.3.28.8-centos7-x86_64.tar.bz2 
[gbase@peixun-0057 ~]$ ll
total 4
drwxr-xr-x 2 gbase gbase 4096 Aug 23  2023 gccli_install
复制

3、设置安装程序gccli_install.sh有执行权限。

base@peixun-0057 ~]$ cd gccli_install/
[gbase@peixun-0057 gccli_install]$ ll
total 6320
-rw-r--r-- 1 gbase gbase    1847 Aug 23  2023 gccli_install.sh
-rw-r--r-- 1 gbase gbase 6463968 Aug 23  2023 gccli_standalone.tar.bz2
[gbase@peixun-0057 gccli_install]$ chmod 744 gccli_install.sh
[gbase@peixun-0057 gccli_install]$ ll
total 6320
-rwxr--r-- 1 gbase gbase    1847 Aug 23  2023 gccli_install.sh
-rw-r--r-- 1 gbase gbase 6463968 Aug 23  2023 gccli_standalone.tar.bz2

复制

4、执行安装。

[gbase@peixun-0057 gccli_install]$ ./gccli_install.sh gccli_standalone.tar.bz2 
./gcluster/
./gcluster/server/
./gcluster/server/lib/
./gcluster/server/lib/gbase/
./gcluster/server/bin/
./gcluster/server/bin/dump
./gcluster/server/bin/gbase
./gcluster/config/
./gcluster/config/gbase_8a_gcluster.cnf
Installation finished. 
Please run "/home/gbase/gccli_install/gcluster/server/bin/gccli -uUSER -pPASSWORD -hGCLUSTER_NODE_IP" for checking.

复制

显示 Installation finished. 表示安装成功了！

客户端gccli安装在 /home/gbase/gccli_install/gcluster/server/bin/目录下

5、使用gccli客户端连接8a

执行gccli -u -p -h 命令，连接到8a集群的一个gcluster节点，就能连接8a集群了。

• u：8a数据库用户名称
• p：8a数据库用户密码
• h：连接8a集群的一个gcluster节点IP；如果写多个IP，用逗号分割，实现连接高可用

[gbase@peixun-0057 gccli_install]$ ./gccli -uguest -ppeixun -h172.168.10.9
-bash: ./gccli: No such file or directory
[gbase@peixun-0057 gccli_install]$ gccli -uguest -ppeixun -h172.168.10.9
-bash: gccli: command not found
[gbase@peixun-0057 gccli_install]$ /home/gbase/gccli_install/gcluster/server/bin/gccli -uguest -ppeixun -h172.168.10.9

GBase client 9.5.3.28.84c16ae5. Copyright (c) 2004-2024, GBase.  All Rights Reserved.

gbase>
复制

出现gbase> 表示连接8a成功了。
下面可以使用show 命令查询库、表等操作。

gbase> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| performance_schema |
| courseware         |
| gclusterdb         |
| school             |
| ssbm               |
| test               |
+--------------------+
7 rows in set (Elapsed: 00:00:00.00)

gbase> use ssbm;
Query OK, 0 rows affected (Elapsed: 00:00:00.00)

gbase> show tables;
+----------------+
| Tables_in_ssbm |
+----------------+
| customer       |
| customer_hx    |
| dwdate         |
| lineorder      |
| part           |
| supplier       |
+----------------+
6 rows in set (Elapsed: 00:00:00.00)

gbase> \q                            
Bye
复制

为方便操作，可以把客户端的目录/home/gbase/gccli_install/gcluster/server/bin/写入到PATH环境变量中

[gbase@peixun-0057 gccli_install]$ vi ~/.bash_profile
# .bash_profile

# Get the aliases and functions
if [ -f ~/.bashrc ]; then
        . ~/.bashrc
fi

# User specific environment and startup programs

PATH=/home/gbase/gccli_install/gcluster/server/bin/:$PATH:$HOME/.local/bin:$HOME/bin

export PATH
[gbase@peixun-0057 gccli_install]$ 
复制

让环境变量生效，再次执行gccli时，直接写命令即可。

[gbase@peixun-0057 gccli_install]$ source ~/.bash_profile
[gbase@peixun-0057 gccli_install]$ gccli -uguest -ppeixun -h172.168.10.9

GBase client 9.5.3.28.84c16ae5. Copyright (c) 2004-2024, GBase.  All Rights Reserved.

gbase> \q
Bye
复制

6、卸载GBase 8a的客户端工具

如果不再使用客户端工具了，没提供卸载命令，直接删除安装目录gccli_install即可。

总结

本文详细介绍了如何独立安装8a客户端工具的全过程，希望对大家有所帮助。