Centos7安装GBase8a V9.5

Centos7安装GBase8a V9.5

提前了解：
1）官方说明内存如果低于2G无法启动服务，所以安装测试环境的话建议机器内存不低于4G；
2）节点数：MPP集群安装的节点数为奇数；
3）软件包：官网可下载（https://www.gbase.cn/download/gbase-8a?category=INSTALL_PACKAGE）。我选择下载 GBase8a_MPP_Cluster-License-9.5.3.14-redhat7.3-x86_64.tar.bz2 ；
4）手册：官网可下载，官方手册里面有详细的安装和使用说明；
5）client连接工具：官网可下载  gccli-9.5.3.14-redhat7.3-x86_64.tar.bz2 ；
6）部署方式：支持两种部署方式：
a）对称部署：把所有服务（GCWare、GCluster、GNode）全部安装部署在同一个节点上，此时，该节点既是Coordinator节点、同时也是Data节点；
b）非对称部署：将GCware、GCluster 和 GNode 安装在不同的节点上，一个节点只属于Coordinator Cluster 或 Data Cluster，也可以既属于 Coordinator Cluster 又属于 Data Cluster；
7）相关端口：
Gcluster          5258          TCP      Coordinator 集群节点对外提供服务的端口
Gnode             5050          TCP      Data 集群节点对外提供服务的端口
Gcware            5918          TCP/UDP  gcware 节点间通讯端口
gcware            5919          TCP      外部连接 gcware 节点端口
syncServer        5288          TCP      syncServer 服务端口
GcrecoverMonit    6268          TCP      Gcrecover 服务端口
数据远程导出端口  16066-16166   TCP      数据远程导出端口

注意：
1）Coordinator Cluster 中要求在同一个网段，网络互通且通信质量优良。不只是能互通、还必须是同一网段；
2）Data Cluster 中要求网络互通且通信质量优良。能互通即可，不要求必须在同一网段；  
3）所有 Coordinator 集群节点的端口要求一致；所有 Data 集群节点的端口要求一致；所有的 gcware 集群节点的端口要求一致；

   
   
一、准备工作

1.基础依赖安装
yum install -y  psmisc  libcgroup  bc  bzip2

python2：一般Centos7默认最小安装会自动包括python2，所以这里无需单独安装。
执行命令 python --version 可查python的看版本信息。

Redhat8/Centos8 需要单独安装 python2，安装完 python2 后使用的命令为 python2，需要将 python2 命令改为默认的 python 命令：alternatives --set python /usr/bin/python2 （或 ln -s 设置软连接 /usr/bin/python）

2.hostname配置
hostnamectl set-hostname gbase8anode01

vi /etc/hosts
192.168.1.162 www.gbase8anode01.com gbase8anode01

vi /etc/sysconfig/network
NETWORKING=yes
HOSTNAME=gbase8anode01

3.防火墙配置
systemctl  stop firewalld
systemctl  disable firewalld

sed -i "s/SELINUX=enforcing/SELINUX=disabled/g"  /etc/selinux/config
setenforce  0

4.时间&时区配置
timedatectl  set-timezone Asia/Shanghai

timedatectl set-time "2023-10-13 14:00:01"
或者
date -s "2023-10-13 14:00:01"

hwclock -w

5.系统配置：

OS允许的最大进程数设置：
vi /etc/systemd/system.conf
DefaultTasksMax=infinity

虚拟内存设置：

echo "
soft nofile 65535
hard nofile 70000
" >> /etc/security/limits.conf

官方文档时建议设置成无限制：

# ulimit -H -v unlimited
# ulimit -S -v unlimited

或修文件：

#vi /etc/security/limits.conf
* soft as unlimited          
* hard as unlimited

自己根据实际修改，测试环境安装时，此步骤为非必须的步骤。

注意：如果是安装用于生产的环境，则更多的配置优化，可以参考官方的产品手册，我这里只是搭建测试环境，有些官方推荐的其他优化配置这里并未修改。

6.重启
reboot

7.创建OS用户gbase：
adduser gbase
passwd gbase

注意：如果是集群安装，则所有节点都进行上面相关操作，hostname按规划设置。

二、安装数据库

说明：
> 安装成功后会自动生成一个 /home/gbase/.gbase_profile 文件用于设置环境变量。
> GBase 8a MPP Cluster 数据库安装后，会有两个默认数据库用户 root 和 gbase。 
  root 用户密码初始为 “Admin2O11O531”，是数据库的超户。
  gbase 是数据库管理操作（如备份 gcrcman、 gcadmin 等）常用来连接 server 的数据库用户。
  初次登录数据库请使用 root 数据库用户， 在 root 数据库用户下及时更改 root 自己的密码并且给 gbase 数据库用户设置密码，妥善保管 root 数据库用户密码和 gbase 数据库用户密码，以便后续数据库管理操作能够正常连接server。
> 目录说明：
gcware：该目录在安装目录下，用于存储 gcware 的相关文件，包括配置文件和日志等， coordinator 节点有该目录， gnode 节点没有该目录。
gcluster：该目录在安装目录下，用于存储 gcluster 的相关文件，包括配置文件、日志和元数据等。
gnode：该目录在安装目录下，用于存储 gnode 的相关文件，包括配置文件、日志和用户数据等。
/home/dbaUser/：.gbase_profile 文件是数据库安装用户下的环境变量文件。

1.拷贝&解压安装包（root用户操作）
创建安装目
mkdir -p /opt/gbase8a
cp GBase8a_MPP_Cluster-License-9.5.3.14-redhat7.3-x86_64.tar.bz2 /opt/gbase8a
cd /opt/gbase8a
tar -xvf GBase8a_MPP_Cluster-License-9.5.3.14-redhat7.3-x86_64.tar.bz2
解压后会释放一个安装包目录 gcinstall
设置目录用户&组属性
chown -R gbase:gbase /opt/gbase8a

2.使用 root 用户在集群各个节点执行 gbase 用户的环境部署脚本
安装之前需要在 root 用户下执行安装包中提供的一键部署脚本 SetSysEnv.py
cd gcinstall
scp SetSysEnv.py gbase@集群节点IP:/opt/gbase8a/
./SetSysEnv.py --installPrefix=/opt/gbase8a --dbaUser=gbase

说明：
语法：python SetSysEnv.py --dbaUser=* --installPrefix=* [--cgroup] 
参数：
--installPrefix：用户可配安装目录，必须为 demo.options 中 installPrefix 配置一致。集群日志按归档功能使用该参数。
--dbaUser：必须为 demo.options 中的 dbaUser。
--cgroup：使用资源管理功能时，主要用于修改资源管理配置文件。在使用资源管理前必须执行。

3.修改安装配置文件
chown -R gbase:gbase /opt/gbase8a
su - gbase
vi /opt/gbase8a/gcinstall/demo.options

installPrefix= /opt/gbase8a
coordinateHost = 192.168.151.234,192.168.151.235,192.168.151.237
coordinateHostNodeID = 234,235,237
dataHost = 192.168.151.234,192.168.151.235,192.168.151.237
#existCoordinateHost =
#existDataHost =
dbaUser = gbase
dbaGroup = gbase
dbaPwd = 'gbase'
rootPwd = '111111'
#rootPwdFile = rootPwd.json

根据实际情况修改对应的参数。
注意：dbaPwd配置指定gbase OS用户密码，rootPwd指定root OS用户密码，这里指定的是安装时需要用到的OS用户的密码，而不是数据库用户密码，数据库用户密码时安装完成以后会自动生成默认密码，然后再自行修改。

我修改后的内容如下：
installPrefix= /opt/gbase8a
coordinateHost = 192.168.1.162
coordinateHostNodeID = 162
dataHost = 192.168.1.162
#existCoordinateHost =
#existDataHost =
#existGcwareHost=
gcwareHost = 192.168.1.162
gcwareHostNodeID = 162
dbaUser = gbase
dbaGroup = gbase
dbaPwd = 'gbase.123'
rootPwd = 'root.123'
#rootPwdFile = rootPwd.json
#characterSet = utf8
#dbPort = 5258
#sshPort = 22

4.执行脚本进行安装
以dba用户（gbase）执行安装命令：
cd /opt/gbase8a/gcinstall/
$ ./gcinstall.py --silent=demo.options

语法：./gcinstall.py --silent=demo.options [--passwordInputMode]
参数说明：
--silent：指定集群安装的配置文件；
--passwordInputMode：
gcinstall.py 命令可选参数。用于指定密码获取的方式，通过不同的参数实现不同的获取方式。若指定该参数 ，则demo.options中的密码不必再修改。取值范围为file、pwdsame、pwddiff， 默认值为 file。
取值说明如下：
file : 表示从文件或命令行参数获取，和原有的方式一致，该方式下，文件中的密码是明文的；默认该方式；
pwdsame:表示从终端由用户输入密码，并且所有节点的密码一致情况下使用该参数，对于不同用户密码只输入一次；
pwddiff: 表示从终端由用户输入密码，并且节点间的密码不一致情况下使用该参数，对于不同用户密码每个节点分别输入一次。

安装过程中，shell界面进行交互提示输入和确认：

Do you accept the above licence agreement ([Y,y]/[N,n])? y
Cgconfig service is not exist on host ['192.168.1.162'], resource manangement can not be used, continue ([Y,y]/[N,n])? y    # 操作系统没cgroup（资源管理）组件，输入 Y 回车忽略、继续安装
Are you sure to install GCluster on these nodes ([Y,y]/[N,n])? y

安装完成：
192.168.1.162         install gcware and cluster on host 192.168.1.162 successfully.

5.查看集群状态
安装成功后，通过 gcadmin 可以查看集群状态。
要先退出后重新进入gbase用户shell先执行，否则安装后直接执行会报命令不存在（环境变量未生效的原因）：

$ exit
# su - gbase
$ gcadmin
CLUSTER STATE:         ACTIVE

=======================================
|  GBASE GCWARE CLUSTER INFORMATION   |
=======================================
| NodeName |    IpAddress    | gcware |
---------------------------------------
| gcware1  | 192.168.1.162 |  OPEN  |
---------------------------------------
=========================================================
|         GBASE COORDINATOR CLUSTER INFORMATION         |
=========================================================
|   NodeName   |    IpAddress    | gcluster | DataState |
---------------------------------------------------------
| coordinator1 | 192.168.1.162 |  CLOSE   |     0     |
---------------------------------------------------------
================================================================
|           GBASE CLUSTER FREE DATA NODE INFORMATION           |
================================================================
| NodeName  |    IpAddress    | gnode | syncserver | DataState |
----------------------------------------------------------------
| FreeNode1 | 192.168.1.162 | CLOSE |    OPEN    |     0     |
----------------------------------------------------------------

由于License文件还没有申请和导入，所以 gcluster 状态、gnode 状态目前都是 CLOSE 状态。

6.生成License指纹、用于申请License用途：
# su - gbase
$ cd /opt/gbase8a/gcinstall
$ ./gethostsid -n 192.168.1.162 -f fingerprint -u gbase -p gbase.123

语法：./gethostid -n IP1，IP2…… IPn -f fingerprint -u gbase -p pwd; 
-n 指定集群IP地址。注意：如果集群多节点的话，需要指定所有节点的IP地址，逗号分割。
-f 指定采集指纹保存（输出）的文件。
-u 指定OS用户 gbase
-p 指定OS用户 gbase 的密码

然后发邮件给官方申请 License，申请邮件描述 OS版本（Centos7.8-x86-64）和这里生成的指纹文件 fingerprint。

7.安装客户端连接工具 gccli （非必须的步骤，为了导入License后能够进行数据库连接测试，所以我先安装 gccli 工具）

为了方便后续导入License后登录数据库、先安装客户端连接工具 gccli

解压gccli、然后拷贝解压后的文件夹gccli_install内的内容到安装路径，在安装路径下执行安装程序：

# su - gbase
$ mkdir -p /opt/gbase8a/gccli
$ cp gccli-9.5.3.14-redhat7.3-x86_64.tar.bz2 /opt/gbase8a/gccli
$ cd /opt/gbase8a/gccli
$ tar -xvf gccli-9.5.3.14-redhat7.3-x86_64.tar.bz2
$ chmod u+x ./gccli_install/gccli_install.sh
$ cp /opt/gbase8a/gccli/gccli_install/*  /opt/gbase8a/   # 把解压后的目录下的所有文件（gccli_install.sh 和 gccli_standalone.tar.bz2）拷贝到我的gbase数据库的安装路径 /opt/gbase8a 后再执行安装脚本
$ cd /opt/gbase8a
$ ./gccli_install.sh gccli_standalone.tar.bz2    # 安装 gccli 工具

安装 gccli 以后，会在 /opt/gbase8a/gcluster/server/bin 目录下生成 gccli 软连接：
$ whereis gccli
gccli: /opt/gbase8a/gcluster/server/bin/gccli

安装 gccli 以后，就可以使用 gccli 工具连接 gbase8a 数据库：

帮助：
$ gccli  --help
gccli ver 9.5.3.14.121230, for unknown-linux-gnu (x86_64) using readline 6.3
Copyright 2004-2023 General Data Technology Co.Ltd.
Usage: gccli [OPTIONS] [database]

语法：
gccli –u -p [-h] [-P] [-D] [--nice_time_format] [-c] [-f] [-v[v][v]] [-e] [<]

–u 连接数据库的用户名称；
-p 连接数据库的用户密码；
-h 登录集群节点的IP 地址，默认127.0.0.1，可选参数。如果指定多个IP地址，则启动 gccli 的高可用功能，IP 地址之间采用英文逗号分隔，例如：192.168.1.101,192.168.1.102,192.168.1.103；
-P 可选参数，指定连接的数据库服务端口，默认端口5258；
-D  可选参数，指定登录时默认的数据库（数据库必须存在）；
--nice_time_forma 指定用户操作耗时的最小精度，使用此参数，精确到毫秒，不使用，精确到秒。可选参数；
-c 使用此参数，用于使用 hint 优化方式。可选参数；
--force，-f 批量执行SQL文件时，如果中间有SQL执行报错，强制执行后续SQL，可选参数；
--verbose，-v 冗长模式。产生更多的输出。可以多次使用该选项以产生更多的输出。(例如，-v -v -v甚至可以在批处理模式产生表输出格式）。
--version，-V 显示版本信息并退出。
--vertical，-E 垂直输出查询输出的行。没有该选项，可以用\G结尾来指定单个语句的垂直输出。
--execute=statement, -e statement 执行语句并退出，可以是多个语句，多个SQL以“;”隔开，可选参数；
--silent，-s 沉默模式。产生少的输出。可以多次使用该选项以产生更少的输出。
--skip-column-names，-N 在结果中不写列名；
--skip-line-numbers，-L 在错误信息中不写行号。当你想要比较包括错误消息的结果文件时有用；
--html，-H 产生HTML输出；
< EOF接收输入的方式，可用于批量执行SQL文件，可选参数。

8.导入License文件

导入License文件之前，先说一下关于账号密码：
默认情况下，在gbase8a集群安装完毕后，集群会创建两个默认的数据库超级帐号 root 账号和 gbase 账号。
初次登录请使用 root 数据库用户登录， 首次登录 GBase 8a MPP Cluster 后，管理员必须为 root 帐号和 gbase 账号设置一个安全的数据库账号密码。
操作系统OS用户 root，密码为手工设置的
操作系统OS用户 gbase，密码为手工设置的
数据库超级帐号 root，默认密码为 Admin2O11O531（官方文档这样介绍的，但实际安装后不符，实际数据库root连接账号无密码，本地首次登录时不指定-p参数）
数据库超级用户 gbase，密码为root登录数据库以后手工设置的

申请拿到License文件以后，使用License工具导入License到集群的每个节点，语法如下：
License -n IP1, IP2, ……, IPn <-f /path/name.lic> <-u username> <-p password> License --hosts=demo.hosts <-f /path/name.lic> <-u username> <-p password>

参数说明：
-n 用于导入单个节点或少数几个节点 License。
--hosts 用于导入多个节点 License。
-f 待导入的 LICENSE 文件路径及文件名称。
-u 指定集群的 DBA 用户。
-p 指定集群 DBA 用户的密码。==> 官方手册虽然描述如此，但实测为：这里指定的密码必须是OS用户密码、不能是数据库用户连接密码，否则导入License时会提示登录login失败；

注意：
1）--hosts=demo.hosts 指定的 demo.hosts 文件中包含需要进行指纹采集的 IP 列表（逗号分割）：
vi demo.hosts
Hosts = 192.168.1.162
如果集群多节点则需要逗号分割指定所有IP：
Hosts = 192.168.1.162,192.168.1.163,192.168.1.164
2）License导入工具在 gcinstall 安装目录，执行License导入时，需要进入对应工具目录执行导入操作；

拷贝License文件&执行License导入：

# su - gbase
$ cp 20231016-01.lic /opt/gbase8a/
$ cd /opt/gbase8a/gcinstall
$ ./License -n 192.168.1.162 -u gbase -p gbase.123 -f /opt/gbase8a/20231016-01.lic
======================================================================
Successful node nums:   1
======================================================================

或者指定配置文件的方式执行License导入：

$ ./License --hosts=demo.hosts -u gbase -p gbase.123 -f /opt/gbase8a/20231016-01.lic

注意：
1）如果是集群多节点，需要 -n 指定所有IP，逗号分割；
2）这里指定的密码必须是OS用户密码、不能是数据库用户连接密码，否则导入License时会提示登录login失败：
[('192.168.1.162', 'Fail to login 192.168.1.162. errno: -1, errmsg: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).')]
Node:   192.168.1.162
Information:    Fail to login 192.168.1.162. errno: -1, errmsg: Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).

导入成功后，可使用 LICENSE 检测工具获取 license 状态信息，包括集群节点是否全部具备 LICENSE 文件， LICENSE 为试用版还是商用版，如果是试用版 LICENSE， 会显示 LICENSE 到期日期：
语法：
chkLicense <-n IP1,IP2,……IPn | --hosts=demo.hosts > -u username -p password chkLicense -f /path /filename -u username -p password

$ ./chkLicense -n 192.168.1.162 -u gbase -p gbase.123
======================================================================
192.168.1.162
is_exist:yes
version:trial
expire_time:20240116
is_valid:yes

9.重启集群服务 & 查看集群状态
gcluster_services

语法：
gcluster_services help
gcluster_services

重启集群服务：
$ gcluster_services all restart
Stopping GCMonit success!
Stopping gcrecover :                                       [  OK  ]
Stopping gcluster :                                        [  OK  ]
Stopping gbase :                                           [  OK  ]
Stopping syncserver :                                      [  OK  ]
Starting gcluster :                                        [  OK  ]
Starting gcrecover :                                       [  OK  ]
Starting gbase :                                           [  OK  ]
Starting syncserver :                                      [  OK  ]

查看集群服务状态：
$ gcluster_services all info
gcluster is running
gcrecover is running
gbase is running
syncserver is running

$ gcadmin
CLUSTER STATE:         ACTIVE

=======================================
|  GBASE GCWARE CLUSTER INFORMATION   |
=======================================
| NodeName |    IpAddress    | gcware |
---------------------------------------
| gcware1  | 192.168.1.162 |  OPEN  |
---------------------------------------
=========================================================
|         GBASE COORDINATOR CLUSTER INFORMATION         |
=========================================================
|   NodeName   |    IpAddress    | gcluster | DataState |
---------------------------------------------------------
| coordinator1 | 192.168.1.162 |   OPEN   |     0     |
---------------------------------------------------------
================================================================
|           GBASE CLUSTER FREE DATA NODE INFORMATION           |
================================================================
| NodeName  |    IpAddress    | gnode | syncserver | DataState |
----------------------------------------------------------------
| FreeNode1 | 192.168.1.162 | OPEN  |    OPEN    |     0     |
----------------------------------------------------------------

0 virtual cluster
1 coordinator node
1 free data node

这里显示的 0 virtual cluster，部署完后还没有初始化，后面会进行初始化操作。

使用 gccli 首次以root数据库账号登录，修改数据库连接的root密码和gbase用户密码：
注意：官方文档介绍数据库安装后的默认root密码为 Admin2O11O531 ，但我安装后实际 root 数据库连接密码为空，不指定 -p 参数登录并查看版本信息：
$ gccli -uroot
$ gbase> select version();
+-----------------+
| version()       |
+-----------------+
| 9.5.3.14.121230 |
+-----------------+
1 row in set (Elapsed: 00:00:00.00)

10.初始化配置

GBase8a集群安装完成以后，必须进行初始化配置，才能使用。

说明：
1）单 VC 时建议使用兼容模式，需要进行初始配置，官方产品手册--3.2.3.1 单 VC 模式（兼容模式）初始配置中有纤细介绍；
2）多 VC 时，参考官方产品手册--3.2.3.2 多 VC 模式初始配置；
3）单 VC 模式是跳过手动创建 VC 步骤，直接创建 distribution 的模式。单 VC 模式下如果手动创建增加 VC， 则集群自动转换为多 VC 模式；
   多 VC 模式不支持回退为单 VC 模式，如果删除新增的 VC 只保留最初的一个 VC，集群的模式仍然是多 VC 模式。

初始化时，两种模式二选一，进行对应的初始化操作。

模式1：单 VC 模式（兼容模式）初始配置（对应官方产品手册--3.2.3.1 单 VC 模式（兼容模式）初始配置）

"兼容模式" 是为了兼容 GBase 8a MPP Cluster V86 版本的使用习惯，由 GBase 8a MPP Cluster V9.5.2 之前的版本升级的集群，或者安装 GBase 8a MPP Cluster V9.5.2 后不创建 VC，直接创建 distribution 后的集群。
此时 GBase 8a MPP Cluster 集群会生成一个默认 VC， vcname 为 vcname000001。
在兼容模式下，集群使用习惯 GBase 8a MPP Cluster V86 版本相同， 使用 gcadmin showcluster 命令看不到 VC 的相关信息。

1）创建 distribution

使用 dbaUser 用户（即 demo.options 中的 dbaUser 用户）配置 gcChangeInfo.xml。在集群安装成功后，在安装包目录下会生成一个 gcChangeInfo.xml 文件。
$ cat /opt/gbase8a/gcinstall/gcChangeInfo.xml

 
 
 

创建 distribution

语法：
gcadmin distribution

[d num] [pattern 1|2] [db_user user_name] [db_pwd password] [dba_os_password password]

参数说明：
gcChangeInfo.xml 指定生成 distribution 规则的配置文件。
p number 每个数据节点存放的分片数量，最小值为 1。
d number 每个分片的备份数量，取值为 0， 1 或 2。若不输入参数 d，默认值为 1。
pattern number 生成 distribution 所使用模式，取值为 1 或 2， pattern 1 为负载均衡模式， pattern 2 为高可用模式。若不输入参数 pattern，默认使用 pattern 1 生成 distribution。
db_user 数据库用户名，扩容生成新的 distribution 时需指定。
db_pwd 数据库密码，扩容生成新的 distribution 时需指定。
dba_os_password DBA 用户操作系统密码，扩容生成新的 distribution，或在新的 vc 中创建 distribution 时需指定。

执行创建 distribution 命令：
$ gcadmin distribution gcChangeInfo.xml p 1 d 0

注意：rack data server number >= segment + duplicate segment number，否则执行会报错。例如，我单节点，如果执行 p 1 d 1 就会报错。

查看 distribution
创建 distribution 以后，查看主备数据分片分布信息，可以执行下面命令查看：
gcadmin showdistribution [node | f] [vc vc_name]

$ gcadmin showdistribution
$ gcadmin showdistribution node

其他相关命令介绍：

删除 distribution

语法：
gcadmin rmdistribution [ID] [vc vc_name]
从集群中删除指定 id 的 distribution。若不输入 distribution id， 则默认删除创建时间较早的 distribution， 集群中只有一个 distribution 时则默认删除该 distribution。

参数说明：
ID distribution id。
vc vc_name 指定删除的 distribution 的 vc 的名称。如果集群只有一个 vc，不需要指定 vcname。

例如：
$ gcadmin rmdistribution 1 vc vc1

保存 distribution到指定的xml文件：
getdistribution（将指定 ID 的 distribution 信息保存到指定的文件中）：

将指定 ID 的 distribution 信息保存到指定的文件中， 生成的文件为 xml 文件， 用户可修改该文件中的分片信息， 然后使用该文件重新生成 distribution。
gcadmin getdistribution [vc vc_name]

gcadmin addnodes gcChangeInfo.xml [vc_name | single_vc_add_to_rc]
gcadmin addnodes gcChangeInfo.xml vc1
gcadmin showcluster vc vc1  #查看集群状态

gcadmin rmnodes gcChangeInfo.xml [vc_name | single_vc_rm_to_rc]
cp gcChangeInfo.xml gcRm_vc1.xml
vi gcRm_vc1.xml  #修改 gcRm_vc1.xml 其中对应 nodeip 内容为待删除的节点 IP
gcadmin rmnodes gcRm_vc1.xml vc1
gcadmin  #查看删除效果

2）集群初始化
集群安装完毕、且创建了 distribution 之后，在首次执行 SQL 命令之前，需要对数据库系统做初始化操作（initnodedatamap），才能正确执行所有的 SQL 操作。

使用数据库用户 root/gbase 登录，执行 initnodedatamap 初始化命令：
$ gccli –uroot
gbase> initnodedatamap;

注意：
1）我初始安装后数据库root用户的密码为空，所以不需要指定-p，官方手册说是会生成一个默认密码，请根据实际情况来操作；
2）此命令只需执行一次，如果重复执行，会报告如下信息:
ERROR 1707 (HY000): gcluster command error: (GBA-02CO-0004) nodedatamap is already initialized.

如果不进行初始化，直接执行SQL的话，会报错，例如，直接执行下面建库 SQL 则会报错：
gbase> create database test;
ERROR 1707 (HY000): gcluster command error: (GBA-02CO-0003)
nodedatamap is not initialized.

3）安装后的检查
集群安装完成后，管理员可以通过 gcadmin 查看集群的运行状态。
a）查看集群各节点状态是否正常（是否OPEN状态）
  $ gcadmin
  
  
  CLUSTER STATE:         ACTIVE
VIRTUAL CLUSTER MODE:  NORMAL

=======================================
|  GBASE GCWARE CLUSTER INFORMATION   |
=======================================
| NodeName |    IpAddress    | gcware |
---------------------------------------
| gcware1  | 192.168.1.162   |  OPEN  |
---------------------------------------
=========================================================
|         GBASE COORDINATOR CLUSTER INFORMATION         |
=========================================================
|   NodeName   |    IpAddress    | gcluster | DataState |
---------------------------------------------------------
| coordinator1 | 192.168.1.162   |   OPEN   |     0     |
---------------------------------------------------------
=========================================================================================================
|                                    GBASE DATA CLUSTER INFORMATION                                     |
=========================================================================================================
| NodeName |                IpAddress                 | DistributionId | gnode | syncserver | DataState |
---------------------------------------------------------------------------------------------------------
|  node1   |             192.168.1.162                |       1        | OPEN  |    OPEN    |     0     |
---------------------------------------------------------------------------------------------------------

[gbase@gbase8av95 gcinstall]$ 

b）查看集群数据分片分布相关信息
  $ gcadmin showdistribution
  
  $ gcadmin showdistribution

                                 Distribution ID: 1 | State: new | Total segment num: 1

             Primary Segment Node IP                   Segment ID                 Duplicate Segment node IP
========================================================================================================================
|                192.168.1.162                   |         1          |                                                |
========================================================================================================================
[gbase@gbase8av95 gcinstall]$ 
  

模式2：多 VC 模式初始配置（对应官方产品手册--3.2.3.2 多 VC 模式初始配置）

“多 VC 模式”是指安装集群后，使用 gcadmin createvc 命令将数据节点划分为多个 VC 的集群模式。此时使用 gcadmin 命令可看到多个 VC 的相关信息。
多 VC 模式，需要首先创建 VC，之后在每个 VC 上再创建 distribution。

例如，假设部署了5节点的集群，free node 4 个节点，则可以创建2个vc，将4个 free node 节点中的2个节点给vc1、另外2个分给vc2。

1）创建多VC和每个VC的distribution（多个VC间不能共享）

a）创建vc1和vc1的distribution

i）创建vc1
生成创建 VC1 的配置示范文件
$ cd /opt/gbase8a/gcinstall
$ gcadmin createvc e create_vc1.xml

$ vi create_vc1.xml

执行vc1创建命令：
$ gcadmin createvc create_vc1.xml

语法说明：
gcadmin createvc

用配置文件中指定的数据节点生成虚拟集群。
注意：
1）用户创建虚拟集群需使用安装集群时 demo.options 中填写的 dbaUser 用户；
2）gcadmin createvc 命令一次只能创建一个 vc，即配置文件中只能有一个要创建 vc 的信息。

参数说明：
create_vc.xml 生成 vc 所使用的配置文件， 包含所有生成指定 vc 的数据节点的 IP 和可选参数 vc name 及 comment 信息。
e 生成创建 vc 的配置示范文件，使用该参数时将不会生成 vc。
example_file_name 生成的创建 vc 的配置时反问句的名称。
注意：安装脚本会自动生成包含所有 data node 节点 ip 信息的配置文件gcChangeInfo.xml，用户可根据自己需求修改。

ii）在 VC1 上创建 distribution
多 VC 模式，需要在每个 VC 下创建 distribution。

$ cd /opt/gbase8a/gcinstall
$ vi gcChangeInfo_vc1.xml

创建vc1下的distribution
$ gcadmin distribution gcChangeInfo_vc1.xml p 1 d 1 vc vc1

b）创建vc2和vc2的distribution

i）创建vc2
生成创建 VC2 的配置示范文件
$ cd /opt/gbase8a/gcinstall
$ cp create_vc1.xml create_vc2.xml
也可以：
$ gcadmin createvc e create_vc2.xml

$ vi create_vc2.xml

执行创建vc1命令：
$ gcadmin createvc create_vc2.xml

ii）在 VC2 上创建 distribution

$ cd /opt/gbase8a/gcinstall
$ cp gcChangeInfo_vc1.xml  gcChangeInfo_vc2.xml
$ vi gcChangeInfo_vc2.xml

创建vc2下的distribution
$ gcadmin distribution gcChangeInfo_vc2.xml p 1 d 1 db_user user_name db_pwd password dba_os_password password vc vc2

2）集群初始化
每个 VC 在创建完 distribution 后必须先执行 initnodedatamap。
使用数据库用户 root/gbase 登录，执行 initnodedatamap 命令。
$ gccli –uroot –p******
gbase> use vc vc1;
gbase> initnodedatamap;

gbase> use vc vc2;
gbase> initnodedatamap;

3）安装后的检查
集群安装完成后，管理员可以通过 gcadmin 查看集群的运行状态。
a）查看集群各节点状态是否正常（是否OPEN状态）
  $ gcadmin
b）查看集群数据分片分布相关信息
  $ gcadmin showdistribution vc vc1
  $ gcadmin showdistribution vc vc2

到此为止GBase8a安装配置 & License导入 & 初始化都已经完成。

接下来，修改数据库账号密码。

初始安装默认生成的数据库账号 root 账号无密码，修改root密码、并设置 gbase 数据库用户的密码：
$ gccli -uroot
gbase> SET PASSWORD = PASSWORD('admin.1q2w3e');
gbase> SET PASSWORD FOR gbase = PASSWORD('1q2w3e');

创建测试库：
gbase> CREATE DATABASE testdb01;

远程连接测试：
$ quit;
$ gccli -ugbase -p -h127.0.0.1 -Dtestdb01
$ gccli -ugbase -p -h127.0.0.1 -P5258 -Dtestdb01
$ gccli -ugbase -p -h192.168.1.162 -P5258 -Dtestdb01

如果端口不是默认的5258，则-P指定端口，数据库连接端口配置文件为：$GBASE_BASE/gcluster/config/gbase_8a_gcluster.cnf

其他相关命令参考：

查看数据库：
SHOW DATABASES;

创建数据库：
CREATE DATABASE testdb01;

创建用户：
CREATE USER test_user IDENTIFIED BY '1q2w3e';

用户重命名：
RENAME USER old_user TO new_user;

删除用户：
DROP USER user_name;

修改密码：
SET PASSWORD [FOR user] = PASSWORD('newpassword')
SET PASSWORD FOR gbase = PASSWORD('1q2w3e')

修改当前登录用户的密码：
SET PASSWORD = PASSWORD('1q2w3e');

授权SELECT权限：
GRANT SELECT ON *.* TO test_user;

授予超级用户权限（全部权限）：
GRANT ALL ON *.* TO user_test;

JDBC连接：
jdbc:gbase://[host][,failoverhost...][:port]/[database][?propertyName1][=propertyValue1][&propertyName2][=propertyValue2]...

user 用户名
password 密码
hostList 一组调度节点 coordinator 的IP列表，用逗号分割
failoverEnable 故障转移。连接集群时，如果当前IP（比如jdbc的最前面的IP）无法连接，则自动从 hostlist 里面挨个尝试连接，直到连接成功返回，或者均不可用报错退出。下一次连接，同样从第一个IP开始。默认为 false
gclusterId 负载均衡。和 falioverEnable、hostList 组合成负载均衡模式（循环轮询模式 round-robin）。要求 failoverEnable=true 且 hostList 参数不为空。每次获取连接时，将从所有IP列表（包括最前面的第一个IP和hostList里指定的IP）里，按顺序检查IP能否连接。下一次连接，将从下一个IP开始，如果到达末尾，则返回第一个IP。
gclusterId 以 a-z 任意字符开头的字符串，长度最大20。注意：在同一应用程序中(JVM)， 如果有多个不同用途的URL，则gclusterId必须唯一，否则会导致访问了不属于本服务负责的集群。
useUnicode 处理字符串时指定驱动是否使用Unicode编码。是否只在驱动无法决定字符集映射的时候使用，或者在不考虑 GBase 是否有本地化支持的情况 下，尝试驱动使用该字符集（例如 UTF-8）。默认为false。
characterEncoding 如果 useUnicode 设置为 true，驱动在处理字符串时使用的编码。默认为 autodetect。
connectTimeout 在socket连接时的超时时间。
socketTimeout socket读写操作时的超时参数。一般和connectTimeout参数一起配置。
allowMultiQueries 允许多个SQL语句，通过默认的分号分割后，一次下发执行。默认为 false。
useSSL 启用SSL连接功能。默认 false。详情请参考 GBase 8a集群SSL配置-JDBC。
rewriteBatchedStatements 针对 insert values 方式的快速批量写入方式优化参数。
useOldAliasMetadataBehavior 返回的是别名还是列名。涉及功能 ResultSetMetaData.getColumnName( )，ResultSetMetaData.getTableName()。当 useOldAliasMetadataBehavior = true 时，返回值为别名，否则默认 false ，返回列名。
autoReconnect 自动重连。

===============================

vc的其他相关常用操作命令

删除虚拟集群

gcadmin rmvc

注意：
1）删除虚拟集群前需要先删除 vc 下的所有用户库表及其他数据库对象，删除镜像关系，删除拓扑信息。
2）删除 VC 前需要将 gbase 库中对应的表（
  gbase.consumer_group，
  gbase.consumer_group_user， 
  gbase.resource_plan， 
  gbase.resource_pool，
  gbase.resource_plan_directive， 
  gbase.resource_config，
  gbase.cluster_resource_pool_usage_history， 
  gbase.resource_pool_events 等）中该 VC 的资源管理信息删除掉，否则将无法删除 VC；
3）gcadmin rmvc 命令一次只能删除一个 VC；如果指定删除的 VC 不存在，执行会报错。

导入虚拟集群
将已有集群的所有数据节点导入到当前集群，成为当前集群的一个 VC。
gcadmin importvc

import_vc.xml 导入 vc 所使用的配置文件。
e 生成导入 vc 的配置示范文件，使用该参数时将不会导入 vc。
example_file_name 生成导入 vc 的配置示范文件名称。

生成创建 VC 的配置示范文件：
$ gcadmin importvc e import_vc.xml
$ vi import_vc.xml

启动虚拟集群
gcadmin startvc

停止虚拟集群
gcadmin stopvc

重命名虚拟集群
gcadmin renamevc

如果要卸载GBase8a数据库：
gcluster_services all stop

su - gbase
cd /opt/gbase8a/gcinstall
./unInstall.py --silent=demo.options