1.Base基础/3.Icon图标/操作/search备份
1.Base基础/3.Icon图标/操作/search备份
EN
文档
关于AntDB
快速入门
使用教程
运维
调优
工具和插件
高级服务
数据安全
参考
  • 文档首页 /
  • 部署与升级 /
  • 分布式安装部署 /
  • 独立模式数据库安装

独立模式数据库安装

更新时间:2024-07-01 14:39:42

分布式数据库安装分两步:

  • 安装数据库(二进制文件)

  • 初始化数据库

安装数据库

以 AntDB 7.2 版本安装包 antdb-t-ee-release-7.2.generic.* 举例。

将安装包(antdb-t-ee-release-7.2.generic.*)拷贝到 AntDB 用户(如:antdb)的目录下,并修改该安装包的权限。

chown -R antdb:antdb antdb-t-ee-release-7.2.generic.*        #将安装包的用户权限更改为antdb

登陆新建的用户进行 AntDB 的安装。

su - antdb                                                   #登陆新建的AntDB用户
tar -xzvf antdb-t-ee-release-7.2.generic.*                   #解压改安装包
cd antdb-t-ee-release-7.2.generic.*                          #通过cd命令进入解压后目录

在 antdb-t-ee-release-7.2.generic.* 目录下执行 sh antdb_install.sh 进行 AntDB 的交互形式安装。

sh antdb_install.sh

交互式安装有五处交互,如下所示。可以选择默认值,也可以自定义。但是需要注意的是,第二处一定要选择 “d”,代表安装的是分布式数据库。

# 第一处交互,默认Y,选择N即放弃本次安装部署
[Info] AntDB install begins
[Info] Checking OS information ... ok
[Info] Checking hardware information ... ok
[Info] Checking SHA256 ... ok
[Attention] What will be shown below is AntDB product use agreement. Ready to read it? [yes/no, Default: yes] yes

Hunan AsiaInfo Anhui Technologies Co., Ltd.
Software End User License Agreement
……
……

# 第二处交互,默认选择Y。选择N即退出本次安装
[Caution] Do you agree to the product agreement? [yes/no]


# 第三处交互,这里需要选择d,代表安装的是分布式,默认的c是集中式版本安装
[Info] Choose AntDB type "(c)entralized" or "(d)istributed" for installation. [Default: centralized]d

# 第四处交互,选择二进制安装路径(确保该路径为空)
# 默认为用户目录/antdb
[Info] Choose an empty directory to install AntDB. [Default: /home/antdb/antdb] /home/antdb/app
[Info] Checking install path ... ok
[Info] Decompressing package ... ok
[Info] Creating setup directory ... ok
[Info] Copying files ... ok
[Info] Install high-availability components ... ok
[Info] Creating file list for uninstall ... ok
[Info] Setting bash environment ... ok
[Attention] For better performance of database, following files can be used as reference to set OS kernel config manually.
  /home/antdb/antdb-t-ee-release-7.2.19.generic.x86_64/setup/common/kernel_limits.conf
  /home/antdb/antdb-t-ee-release-7.2.19.generic.x86_64/setup/common/kernel_sysctl.conf
[Info] AntDB install succeeds!
[Info] AntDB init begins

# 第五处交互,选择是否使用默认配置部署AntDB分布式简易版本,选择no退出安装进程,选择yes继续部署进程
# 一般选择no退出简易版本安装
[Attention] Continue to do AntDB initialization? [yes/no, Default: yes] no
[Info] AntDB init terminates
[Attention] Excute 'source /home/antdb/.bashrc' to make the environment variables take effect.

上述执行完后,根据提示,需要 source 环境变量,source 完后,二进制文件安装完毕。

source /home/antdb/.bashrc

初始化数据库

本章节介绍如何初始化数据库。

编辑部署配置文件

在 antdb-t-ee-release-7.2.generic.* 下对 setup/common/initconf-d.ini 进行配置。各个字段信息参考该文件中的说明,举例如下。

注意: 该配置文件最后的换行符不可全删掉(配置文件最后要有换行符)。

## cluster_info 配置项说明:
##
## cluster_type 分类:
##   D 表示分布式版本:需要配置此文件内所有信息
## cluster_name:数据库集簇的名称
## cluster_user: 数据库的超级用户,一般设定为执行此安装程序的操作系统用户

[cluster_info]
cluster_type = D
cluster_name = antdbcluster
cluster_user = antdb

## mgr_info 配置项说明(mgr 为分布式管理节点):
##
## antdb_apppath:mgr 节点数据库程序目录
## antdb_datapath:mgr 节点数据库的数据目录;需要设定为空目录,且不要和其它配置项中的目录交叉
## antdb_password:数据库的超级用户的初始密码(超级用户名参见 “cluster_user”)
## antdb_port:mgr 节点数据库端口号
## primary_ip:mgr 节点数据库 ip,即执行此安装程序的主机 ip
## primary_sshport:执行此安装程序的主机的 SSH 服务端口号

[mgr_info]
primary_ip = 10.21.10.XXX
primary_sshport = 22
antdb_apppath = /home/antdb/app                 #此处需要与上述二进制安装选择的安装路径保存一致
antdb_datapath = /home/antdb/data/mgr
antdb_password = XXX
antdb_port = 6656


## host_info 配置项说明
##
## host_info 格式:hostname,protocol_port,protocol,antdb_apppath,antdb_agent_port,host_user,host_ip
##   host_name:在 AntDB 内部标识一台主机所用的名称,唯一
##   protocol_port:AntDB 所用的通信协议服务端口号(目前为 SSH 端口)
##   protocol:AntDB 依赖的通信协议(目前为 SSH)
##   antdb_apppath:主机上 AntDB 程序的安装目录;需要指定为空目录,在初始化过程中自动安装
##   antdb_agent_port: 主机上 AntDB Agent 程序使用的端口号
##   host_user: 主机上操作系统用户,一般与 mgr_info 中使用相同用户名
##   host_ip:主机 ip 地址

[host_info]
host =  adb01,22,ssh,/home/antdb/app,60112,antdb,10.21.10.211
host =  adb02,22,ssh,/home/antdb/app,60112,antdb,10.21.10.212
host =  adb03,22,ssh,/home/antdb/app,60112,antdb,10.21.10.213


## node_info 配置项说明
##
## node_info 格式:node_name,node_type,host_name,antdbdb_port,antdb_datapath,role[,master_nodename,sync_mode]
##   node_name:分布式节点名称,作为 AntDB 内部的标识,唯一
##   node_type:分布式节点类型,包括 GC、CN、DN
##   host_name:此节点所在的 host,参加上述 host_info
##   antdbdb_port:此节点使用的端口号
##   antdb_datapath:此节点使用的数据库数据目录;需要指定为空目录
##   role:此节点的角色,包括 master(主节点)、slave(备节点)
##   master_nodename:主节点名称;当节点类型为 slave 时需要填写此项
##   sync_mode:备节点类型,包括 sync(同步)、async(异步);当节点类型为 slave 时需要填写此项

[node_info]
node = cn1,CN,adb01,6658,/home/antdb/data/cn1,master
node = dn1,DN,adb01,60114,/home/antdb/data/dn1,master
node = dn2,DN,adb02,60115,/home/antdb/data/dn2,master
node = dn3,DN,adb03,60116,/home/antdb/data/dn3,master
node = gc_1,GC,adb02,60113,/home/antdb/data/gc_1,master
node = gc_2,GC,adb01,60113,/home/antdb/data/gc_2,slave,gc_1,sync
node = gc_3,GC,adb03,60113,/home/antdb/data/gc_3,slave,gc_1,async

## parameter 配置项说明:
##
## 此配置项用于设定数据库配置选项。
## config 格式:config_name=config_value
##     config_name: 配置项名称
##     config_value:配置项值
##
## 注意:
## 1、‘=’作为名称和值的分隔符,请注意按此格式书写。
## 2、config_value 的格式请按照数据库全局配置时的格式书写(集中式与分布式可能存在区别),安装工具不会对 config_value 的格式进行检查。

# [parameter]
# shared_buffers = '128MB'
# max_locks_per_transaction = 256


## init_option 配置项说明:
##
## 此配置项用于设定数据库初始化选项。
## config initall=init_value
##     initall:为初始化配置项的的固定名称,不需要修改
##     init_value:初始化选项。下面示例的含义为:设置 walsegsize 为 256MB
##
## 注意:
## 1、分布式仅支持设置 walsegsize。
# [init_option]
# initall = walsegsize,256

数据库参数配置(可选)

数据库部署前,可以通过修改自定义参数配置文件 setup/common/postgresql.conf.template 来设置数据库参数。

在 antdb-t-ee-release-7.2.generic.* 目录下编辑 setup/common/postgresql.conf.template,如下所示:

# 下述参数为默认参数配置,可以自定义修改
listen_addresses='*'
superuser_reserved_connections=13
tcp_keepalives_idle=60
tcp_keepalives_interval=5
tcp_keepalives_count=10
work_mem=16MB
min_wal_size=2GB
maintenance_work_mem=1GB
max_stack_depth=7000
wal_sync_method=open_datasync
wal_compression=on
wal_log_hints=on
checkpoint_timeout=15min
checkpoint_completion_target=0.9
archive_mode=on
archive_command='/bin/date'
log_destination='csvlog'
logging_collector=on
log_directory='pg_log'
log_rotation_size=100MB
log_min_messages=error
track_activity_query_size=2048
autovacuum_max_workers=5
autovacuum_vacuum_threshold=500
autovacuum_analyze_threshold=500
idle_in_transaction_session_timeout=3600s
max_locks_per_transaction=256
#log_statement=ddl
#port=6655
#max_connections=100
#max_prepared_transactions=0
#max_worker_processes=108
#shared_buffers=128MB
#effective_cache_size=4GB
#max_wal_size=1GB
#random_page_cost=4.0

# 还可以自己增加相应的参数配置
port=5555        
max_connections=1000

执行部署

执行如下命令进行初始化部署:

sh antdb_init.sh -c setup/common/initconf-d.ini

执行完成后,会输出集群的部署信息以及各结点的运行状态。

antdb=# monitor all;
 nodename |      nodetype      | status | description |     host     | port  | recovery |           boot time           | nodezone
----------+--------------------+--------+-------------+--------------+-------+----------+-------------------------------+----------
 gc_1     | gtmcoord master    | t      | running     | 10.21.10.175 | 60103 | false    | 2024-01-11 17:04:38.870926+08 | local
 gc_2     | gtmcoord slave     | t      | running     | 10.21.10.176 | 60103 | true     | 2024-01-11 17:04:39.897305+08 | local
 gc_3     | gtmcoord slave     | t      | running     | 10.21.10.177 | 60103 | true     | 2024-01-11 17:04:39.911249+08 | local
 cn1      | coordinator master | t      | running     | 10.21.10.175 |  7788 | false    | 2024-01-11 17:04:40.899928+08 | local
 cn2      | coordinator master | t      | running     | 10.21.10.176 |  7788 | false    | 2024-01-11 17:04:40.949381+08 | local
 cn3      | coordinator master | t      | running     | 10.21.10.177 |  7788 | false    | 2024-01-11 17:04:40.939051+08 | local
 dn1      | datanode master    | t      | running     | 10.21.10.175 | 60104 | false    | 2024-01-11 17:04:42.232178+08 | local
 dn2      | datanode master    | t      | running     | 10.21.10.176 | 60105 | false    | 2024-01-11 17:04:42.257425+08 | local
 dn3      | datanode master    | t      | running     | 10.21.10.177 | 60106 | false    | 2024-01-11 17:04:42.271038+08 | local
 ds1a     | datanode slave     | t      | running     | 10.21.10.176 | 60104 | true     | 2024-01-11 17:04:43.441449+08 | local
 ds1b     | datanode slave     | t      | running     | 10.21.10.177 | 60104 | true     | 2024-01-11 17:04:43.448628+08 | local
 ds2a     | datanode slave     | t      | running     | 10.21.10.175 | 60105 | true     | 2024-01-11 17:04:43.488864+08 | local
 ds2b     | datanode slave     | t      | running     | 10.21.10.177 | 60105 | true     | 2024-01-11 17:04:43.528483+08 | local
 ds3a     | datanode slave     | t      | running     | 10.21.10.175 | 60106 | true     | 2024-01-11 17:04:43.541617+08 | local
 ds3b     | datanode slave     | t      | running     | 10.21.10.176 | 60106 | true     | 2024-01-11 17:04:43.579849+08 | local
(15 rows)
问题反馈