活动专区

活动公告

上车！GBase 8a开发者联盟发车了 技术福利、人脉资源全都有！

认证培训专区

认证培训资料

GBase 8s GDCA 认证培训课前准备

GBase 8a

其他

物化视图报错：references invalid table(s) or column(s) or function(s) or definer/invoker of view lack rights to use them

01-GBase 8s 事务型数据库 安装与卸载

GBase 8s

适配迁移

[GBase 8s 教程]GBase 8s 常用函数、表达式

本文专门为小白定制，聚焦 GBase 8a MPP Cluster V9.5.3 Free 版（免授权、适合学习测试），适配 CentOS 7.x 系统（最常用、最易操作），全程 step by step，每一步都说明“做什么”“为什么做”“复制哪个命令”，不用懂复杂原理，不用手动配置复杂依赖，跟着操作就能完成集群部署。


补充说明：GBase 8a V9.5.3 Free 版是官方推出的免费学习版本，和正式版使用方法一致，仅对集群规模、容量等做了限制（最多 4 节点、单节点最大 500G），完全满足小白学习、测试需求，生产环境需购买正式版并获取授权。

## **一、前置说明**

### **1.1 环境要求（最低配置，虚拟机/云服务器都能满足）**

l 操作系统：CentOS 7.6+（优先选 x86 架构，ARM 架构需下载对应版本安装包，本文以 x86+CentOS7 为例）；

l 硬件配置：单节点最低 2 核 4G 内存、20G 空闲磁盘（推荐 4 核 8G，部署更流畅）；

l 集群规模：小白推荐先部署「1 个管理节点（Coordinator）+ 2 个数据节点（Data）」，共 3 台服务器（或 3 台虚拟机），后续可扩容；

l 核心前提：3 台服务器需在同一网段（能互相 ping 通），全程用 **root 用户** 操作，确保能访问外网（用于下载安装包和依赖）。

### **1.2 核心工具说明**

GBase 8a 集群部署核心依赖「gcinstall.py 安装脚本」，该脚本会自动创建 gbase 用户、配置环境、安装集群组件，无需额外配置，全程执行脚本即可，简化部署流程。

## **二、前期准备（所有节点都要执行，3 步搞定）**

这一步是为了关闭系统“拦截功能”、安装必要依赖，避免后续部署报错，​**3 台节点（管理节点 + 数据节点）都要逐行执行以下命令**​，复制即可，不用修改。

### **Step 1：关闭防火墙（避免拦截集群端口）**

Linux 防火墙会拦截 GBase 8a 集群的通信端口，导致节点之间无法连通，执行以下 3 条命令关闭并禁用（永久生效）：

systemctl stop firewalld

systemctl disable firewalld

systemctl status firewalld  # 验证是否关闭，显示 inactive 即成功

### **Step 2：关闭 SELinux（避免权限拦截）**

SELinux 是系统安全组件，会限制软件运行权限，执行以下 2 条命令关闭（临时 + 永久）：

setenforce 0  # 临时关闭，立即生效

sed -i 's/SELINUX=enforcing/SELINUX=disabled/g' /etc/selinux/config  # 永久关闭，重启后生效

提示：执行后无报错，就是关闭成功，无需重启服务器，后续部署完成后重启即可。

### **Step 3：安装基础依赖（安装脚本需要这些工具）**

gcinstall.py 脚本运行需要 bc、bzip2、python 等依赖，执行一条命令安装所有必要依赖，避免部署时卡顿或报错：

yum install -y bc bzip2 python wget openssh-server perl net-tools

执行后出现“Complete!”，说明依赖安装完成；若提示“yum: 未找到命令”，参考文末常见问题解决。

### **Step 4：配置节点间免密登录（关键步骤，必做）**

集群部署时，管理节点需要远程操作数据节点，免密登录可以避免反复输入密码，​**仅在管理节点执行以下命令**​（替换命令中的IP 为你的数据节点 IP）：

# 1. 生成密钥（一路按回车，不要输入任何内容）

ssh-keygen -t rsa

# 2. 将密钥分发到所有节点（包括管理节点自身），替换 IP 为你的 3 台节点 IP

ssh-copy-id root@192.168.1.100  # 管理节点 IP（自己）

ssh-copy-id root@192.168.1.101  # 数据节点 1IP

ssh-copy-id root@192.168.1.102  # 数据节点 2IP

操作说明：执行 ssh-copy-id 命令后，会提示输入对应节点的 root 密码，输入后按回车，出现“Number of key(s) added: 1”即成功；后续登录其他节点，无需再输密码。

## **三、下载 GBase 8a 安装包（仅管理节点执行）**

GBase 8a V9.5.3 Free 版需从官方网站下载，步骤简单，小白按以下操作即可，​**仅在管理节点执行**​。

### **Step 1：获取安装包（官方免费下载）**

①、打开浏览器，访问 GBase 官网下载地址：https://www.gbase.cn/download/gbase-8a?category=INSTALL_PACKAGE ；

注册官网账号并完成实名认证（免费，仅用于下载）；

②、登录后，选择 “GBase8a_MPP_Cluster-NoLicense-FREE-9.5.3-redhat7-x86_64.tar.bz2” ③、下载（对应 CentOS7、x86 架构）；

将下载好的安装包，通过 FTP 工具（如 FileZilla）上传到管理节点的 /root 目录下（小白直接上传到 root 目录，不用建其他文件夹，方便查找）。

④、补充提示：若下载速度慢，可换时间段重试；若安装包下载不完整，会导致解压报错，需重新下载。

### **Step 2：解压安装包（管理节点执行）**

进入 /root 目录，执行以下命令解压安装包，解压后会生成 gcinstall 目录（包含安装脚本和配置文件）：

cd /root  # 进入安装包所在目录

tar -jxf GBase8a_MPP_Cluster-NoLicense-FREE-9.5.3-redhat7-x86_64.tar.bz2  # 解压安装包

ls  # 验证解压结果，能看到 gcinstall 目录即成功

报错处理：若提示“tar: 归档中找不到”，说明安装包不完整，删除原安装包，重新下载后再解压。

## **四、配置集群部署文件（仅管理节点执行，关键步骤）**

解压后，进入 gcinstall 目录，修改部署配置文件（demo.options），该文件是集群的“部署说明书”，小白只需修改 3 处 IP 和密码，其他内容默认即可。

### **Step 1：进入 gcinstall 目录**

cd /root/gcinstall  # 进入安装脚本目录

### **Step 2：编辑配置文件（demo.options）**

执行以下命令打开配置文件，按步骤修改（小白严格按以下操作，不要乱改其他内容）：

vi demo.options  # 打开配置文件

操作步骤：

1、按键盘 **i** 键，进入编辑模式（左下角显示“INSERT”）；

2、找到以下3 处，替换为你的节点 IP 和 root 密码（所有节点 root 密码必须一致，否则部署失败）：

coordinateHost=192.168.1.100 # 替换为【管理节点 IP】

dataHost=192.168.1.101,192.168.1.102 # 替换为【2 个数据节点 IP，用逗号分隔】

password=123456 # 替换为【所有节点的 root 密码】

其他内容（如 dbaUser=gbase、installPrefix=/opt/gbase 等）不用改，保持默认即可；

按键盘 **Esc** 键，输入 ​**:wq**​（冒号+wq），按回车保存并退出。

补充说明：dbaUser=gbase 表示脚本会自动创建 gbase 用户，用于后续管理集群，无需手动创建。

## **五、一键部署 GBase 8a 集群（仅管理节点执行，最关键一步）**

配置文件修改完成后，执行安装脚本，全程自动部署，小白只需等待即可，无需手动干预。

### **Step 1：执行部署命令**

cd /root/gcinstall  # 确保在 gcinstall 目录下

./gcinstall.py --silent=demo.options  # 一键部署集群

### **Step 2：部署过程说明**

执行命令后，脚本会自动检查环境、分发安装包、安装集群组件，屏幕会滚动很多日志信息；

若提示“Do you want to continue? (y/N)”，输入 **y** 并按回车，继续部署；

部署时间约 5-10 分钟（取决于网速和服务器配置），不要中断命令，耐心等待；

当屏幕出现“GBase 8a MPP Cluster installation completed successfully!”，说明集群部署成功！

### ​**常见部署报错处理**​**：**

1. 报错“permission denied”：确保全程用 root 用户操作，执行 su - root 切换到 root 即可；
2. 报错“tar: 归档文件中异常的 EOF”：安装包下载不完整，删除原安装包重新下载解压；
3. 报错“ping: socket: Operation not permitted”：普通用户无法使用 ping 命令，执行 chmod u+s /bin/ping 赋予权限后，重新部署；
4. 部署卡死在 SSH 连接步骤：修改 /etc/ssh/sshd_config 文件，注释 Banner 相关内容，重启 sshd 服务后重新部署。

## **六、启动集群并验证（所有节点可执行，确认部署成功）**

部署成功后，需要启动集群，然后验证集群状态，确保所有节点正常运行，小白按以下步骤操作即可。

### **Step 1：启动集群（仅管理节点执行）**

执行以下命令启动集群（V9.5.3 版本专用命令，小白直接复制）：

gcluster_services all start  # 启动所有集群服务

提示：若启动失败，执行 gcluster_services all info 查看服务状态，大概率是防火墙未关闭或依赖未安装完整，重新检查前期准备步骤。

### **Step 2：验证集群状态（管理节点执行）**

执行以下命令，查看集群节点状态，确认所有节点正常：

gcadmin  # 查看集群整体状态

正常状态说明：

l 管理节点（Coordinator）状态显示“OPEN”；

l 2 个数据节点（Data）状态显示“OPEN”；

l 无“CLOSE”或“ERROR”状态，说明集群启动成功。

补充命令：查看节点分片信息，执行 gcadmin showdistribution node 即可查看数据分片和备份情况。

### **Step 3：数据库初始化（仅管理节点执行）**

集群启动成功后，需要初始化数据库，执行以下命令（切换到 gbase 用户，默认无密码）：

su - gbase  # 切换到 gbase 用户（脚本自动创建）

gccli -uroot -p  # 连接数据库，默认密码为空，直接按回车

连接成功后，出现“gbase>”提示符，执行以下命令初始化节点数据映射：

initnodedatamap;  # 初始化数据库，执行后提示“Query OK”即成功

执行 exit; 退出数据库连接，完成初始化。

## **七、简易操作（连接数据库，快速上手）**

GBase 8a 兼容 SQL 语法，和 MySQL 操作类似，小白可以执行以下简单命令，熟悉集群使用，​**在管理节点执行**​。

su - gbase  # 切换到 gbase 用户

gccli -uroot -p  # 连接数据库，空密码直接回车

连接成功后，执行以下 SQL 命令（复制即可，感受数据库操作）：

-- 1. 创建数据库（示例：创建 test_db 数据库）

CREATE DATABASE test_db;

-- 2. 使用数据库

USE test_db;

-- 3. 创建表（示例：创建 user 表，存储用户信息）

CREATE TABLE user (

```
id INT PRIMARY KEY,

name VARCHAR(50) NOT NULL,

age INT
```

);

-- 4. 插入数据

INSERT INTO user VALUES (1, '张飞', 20), (2, 'GBase', 5);

-- 5. 查询数据（查看插入的内容）

SELECT * FROM user;

-- 6. 更新数据

UPDATE user SET age = 21 WHERE name = '张飞';

-- 7. 删除数据

DELETE FROM user WHERE id = 2;

-- 8. 退出数据库连接

EXIT;

每执行一条命令，出现“Query OK”就说明操作成功，可以多试几次，熟悉 SQL 操作。

## **八、集群常用管理命令**

后续需要停止、重启集群，或查看集群状态，记住以下几条命令即可（均在管理节点执行）：

# 1. 启动所有集群服务

gcluster_services all start

# 2. 停止所有集群服务

gcluster_services all stop

# 3. 重启所有集群服务

gcluster_services all restart

# 4. 查看集群服务状态

gcluster_services all info

# 5. 查看集群节点状态

gcadmin

# 6. 查看集群日志（排查报错用）

cd /opt/gbase/gcluster/log/gcluster/

cat system.log  # 查看启停日志

## **九、常见**​​**FQA**​**（遇到报错不用慌，看这里）**

### **​9.1、​**​**问题：执行 yum 命令提示“yum: 未找到命令”？ **

解决办法：CentOS 7 系统默认自带 yum，若缺失，参考文末补充步骤，手动安装 yum 源即可。

### **9.2**​**问题：部署时提示“节点不可用”？ **

解决办法：

① 检查 3 台节点是否能互相 ping 通；

② 确认免密登录配置成功；

③ 检查防火墙和 SELinux 是否彻底关闭；

④ 确认所有节点 root 密码一致。

### **9.3**​**问题：启动集群后，节点状态为 CLOSE？ **

解决办法：

① 执行 gcluster_services all restart 重启集群；

②  检查 /opt 目录是否正常挂载（需写在 /etc/fstab 中）；

③  查看日志排查原因（/opt/gbase/gcluster/log/gcluster/system.log）。

### **9.4**​**问题：gbase 用户 crontab 权限不足？ **

解决办法：在 /etc/cron.allow 中添加 gbase 用户，执行 echo "gbase" >> /etc/cron.allow 即可。

### **9.5**​**问题：连接数据库时提示“拒绝连接”？ **

解决办法：

① 确认集群已启动（gcluster_services all start）；

②  确认管理节点 IP 正确；

③  检查 5258 端口是否开放（默认端口，无需手动开放，关闭防火墙即可）。

## **十、补充：yum 源缺失解决方法**

若执行 yum 命令报错，说明系统 yum 源缺失，执行以下命令手动安装 yum 源（所有节点执行）：

# 1. 下载 yum 相关安装包

wget http://mirrors.163.com/centos/7/os/x86_64/Packages/python-iniparse-0.4-9.el7.noarch.rpm

wget http://mirrors.163.com/centos/7/os/x86_64/Packages/yum-3.4.3-167.el7.centos.noarch.rpm

wget http://mirrors.163.com/centos/7/os/x86_64/Packages/yum-metadata-parser-1.1.4-10.el7.x86_64.rpm

wget http://mirrors.163.com/centos/7/os/x86_64/Packages/yum-plugin-fastestmirror-1.1.31-53.el7.noarch.rpm

# 2. 安装 yum 组件（按顺序执行）

rpm -ivh python-iniparse-0.4-9.el7.noarch.rpm

rpm -ivh yum-metadata-parser-1.1.4-10.el7.x86_64.rpm

rpm -ivh yum-3.4.3-167.el7.centos.noarch.rpm yum-plugin-fastestmirror-1.1.31-53.el7.noarch.rpm

# 3. 下载 163 yum 源

cd /etc/yum.repos.d/

wget http://mirrors.163.com/.help/CentOS7-Base-163.repo

# 4. 修改 yum 源配置（替换 $releasever 为 7）

sed -i 's/$releasever/7/g' CentOS7-Base-163.repo

# 5. 清理并更新 yum 源

yum clean all

yum makecache

执行完成后，再重新安装依赖即可。



安装配置

GBase 8a 集群安装部署手册

GBase 8a 集群安装部署手册

评论

热门帖子