GaiaDB Lite安装指南

更新时间：2024-10-08

背景

GaiaDB Lite 是云数据库 GaiaDB 的本地部署版本，您可以在自己的服务器、笔记本上快速部署并体验 GaiaDB。如下介绍 GaiaDB Lite 的部署方式。

注意事项

GaiaDB Lite 目前仅支持 Linux（CentOS、Ubuntu）_x86_64版本，需要在 root 的权限下执行。已支持Mac(Intel)_x86_64版本，无需在root权限下执行。
GaiaDB Lite 仅用于体验集群的 SQL 兼容性、基本架构以及各个组件的运行，请勿用在生产环境。
部署 GaiaDB Lite 需要的资源，CPU >= 4C 、内存 >= 16GB、系统盘 >= 100GB，部署过程中会通过公网下载安装依赖包。
在 Mac 环境下执行，需要提前安装 Docker Desktop。
部署过程中需关闭VPN。

说明：如您在安装或者试用中遇到任何问题，可以提交工单并备注 GaiaDB Lite，产品专家将为您提供服务。

下载并安装

执行以下命令，在指定的安装目录下载并部署 GaiaDB Lite（以 Linux 环境为例）

cd <install_path>
bash -c "$( curl -s -L -k https://gaiadb-deploy.bj.bcebos.com/install-1.0.9.sh )"

安装完成后会提示如下信息：（Mac 环境中 Detected shell、Shell profile 会根据不同环境得到不同的内容）

Detected shell: bash
Shell profile:  /root/.bash_profile
/root/.bash_profile has been modified to add gaiadb-deploy to PATH

******************************************************************
open a new terminal or source /root/.bash_profile to use it
******************************************************************

***********************************************
GaidDB Deployer is installed.
***********************************************
work dir is /root/.gaiadb-deploy
***********************************************
Have a try:     gaiadb tryout
***********************************************

安装后的文件可以在 ~/.gaiadb-deploy 路径下查看。

声明全局环境变量，便于在任何路径下执行 gaiadb命令（下面路径是以 Linux 为例，Mac 环境中根据提示执行）

source /root/.bash_profile

单机模式创建 GaiaDB 集群，运行如下命令

gaiadb tryout

创建成功后提示如下信息：

Gaiadb Cluster create successfully!
Connect Gaiadb using the following command:
        gaiadb connect -n gdc-tryout
     or mysql -hIP -PPORT -uroot -pPASSWORD

连接 GaiaDB 集群

方式一：通过集群名称快速连接

gaiadb connect -n gdc-tryout

使用 MySQL 客户端连接 GaiaDB

mysql -hIP -PPORT -uroot -pPASSWORD

提示：IP、PORT、PASSWORD会替换成真实值

查看GaiaDB集群拓扑和状态信息

执行以下命令查看集群信息

gaiadb check -n gdc-tryout -t

输出集群拓扑信息，如下：

Cluster Status:
+--------+
| health |
+--------+
| good   |
+--------+
Each module Status:
Gaiadb-Manager Status:
+--------------------------------------------+
| addr              | status      | isLeader |
+--------------------------------------------+
| IP:PORT| NODE_ACTIVE | False    |
| IP:PORT | NODE_ACTIVE | False    |
| IP:PORT | NODE_ACTIVE | True     |
+--------------------------------------------+
Compute-Node Status:
+----------------------------------------------------------------------------+
| addr              | applyLsn          | status                 | isPrimary |
+----------------------------------------------------------------------------+
| IP:PORT | 28293379 | NODE_ACTIVE            | False     |
| IP:PORT | 28293379 | NODE_INACTIVE | True      |
+----------------------------------------------------------------------------+
Log-Service Status:
+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| addr              | writeLsn | vdl      | parseLsn | dispatchLsn | archiveLsn | gcLsn                | psLwm    | cmpLwm   | inGossip | status      | isLeader |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
| IP:PORT | 28293379 | 28293379 | 28293379 | 28293379    | 28293379   | 28293379(0) | 28293379 | 28293379 | False    | NODE_ACTIVE | False    |
| IP:PORT | 28293379 | 28293379 | 28293379 | 28293379    | 28293379   | 28293379(0) | 28293379 | 28293379 | False    | NODE_ACTIVE | False    |
| IP:PORT | 28293379 | 28293379 | 28293379 | 28293379    | 28293379   | 28293379(0) | 28293379 | 28293379 | False    | NODE_ACTIVE | True     |
+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
LogService Water Level:
+-------------------------------------------------------------------------------------------------+
| writeLsn      | vdl      | parseLsn | dispatchLsn | archiveLsn | gcLsn    | psLwm    | cmpLwm   |
+-------------------------------------------------------------------------------------------------+
| 28293379      | 28293379 | 28293379 | 28293379    | 28293379   | 28293379 | 28293379 | 28293379 |
| diff writeLsn | 0        | 0        | 0           | 0          | 0        | 0        | 0        |
|               | diff vdl | 0        | 0           | 0          | 0        | 0        | 0        |
+-------------------------------------------------------------------------------------------------+
Page-Server Status:
+-------------------------------------------------------------------------------------------+
| segmentId | replicaId | addr              | applyLsn | checkpointLsn        | status      |
+-------------------------------------------------------------------------------------------+
| 1         | 0         | IP:PORT | 28293379 | 28293379(0) | NODE_ACTIVE |
| 1         | 1         | IP:PORT | 28293379 | 28293379(0) | NODE_ACTIVE |
+-------------------------------------------------------------------------------------------+

产品的架构和模块组成，可参见产品架构页面。

集群清理

测试完成之后，可以通过以下命令清理集群

gaiadb clean -a

如需重新创建集群，可以执行以下命令。