antdb-AntDB快速入门——快速部署

快速部署
单机版安装

安装RPM包

将交付人员提供的RPM包上传到服务器上，然后在root或者具有sudo权限的用户下安装。

安装到默认路径/opt/app/antdb：

sudo rpm -ivh antdb-xxx.rpm

如果想安装到其他路径，可以通过如下方式：

sudo rpm -ivh antdb-xxx.rpm --relocate=/opt/app/antdb=$ADBHOME

$ADBHOME 为自定义目录，名称最好做到见名知意，比如：

/home/antdb/app/antdb

RPM包安装完成后，ADB_HOME这个变量的值要么是/opt/app/antdb,要么是您自定义的目录。接下来需要修改目录权限：

sudo chown -R antdb:antdb $ADBHOME

sudo chmod -R 755 $ADBHOME

配置环境变量

安装完RPM包之后，会在指定目录（即$ADBHOME目录）的bin目录下产生initdb和adb_ctl等可执行文件。要想初始化数据库还需要配置PATH变量才行。向当前用户下的隐藏文件.bashrc中（执行vim ~/.bashrc打开文件）追加如下内容：

export ADBHOME=/opt/app/antdb

export PATH=$ADBHOME/bin:$PATH

export LD_LIBRARY_PATH=$ADBHOME/lib:$LD_LIBRARY_PATH

export PGDATABASE=postgres

注意：ADBHOME需要根据RPM包的安装路径设置。

然后执行一下命令使其生效即可。

source ~/.bashrc

初始化数据目录

在初始化之前，需要先确定AntDB的数据存放目录，在本文档中，假设为：/data/antdb/data。

通过initdb命令来进行初始化，具体如下：

initdb -D /data/uat/data --wal-segsize=1024

数据目录不要求存在，如果已经存在，确保目录为空。

antdb 操作系统用户需要对数据目录有读写权限。

初始化完成后，在/data/antdb/data目录下会生成一系列文件和目录。

修改数据库参数

在数据目录中，文件名是postgresql.conf的文件是数据库参数的配置文件，用户可以修改此文件，改变数据库参数。可以将配置追加在文件的末尾。

cat >> /data/uat/data/postgresql.conf <<EOF

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’

wal_keep_segments=64

log_destination=‘csvlog’

logging_collector=on

log_directory=‘pg_log’

log_rotation_size=100MB

log_min_messages=error

log_statement=ddl

track_activity_query_size=2048

autovacuum_max_workers=5

autovacuum_vacuum_threshold=500

autovacuum_analyze_threshold=500

max_locks_per_transaction=256

下面这些参数，需要根据实际需求来确定，替换掉加粗斜体部分：

port=自定义数据库端口号，如果没有要求，建议设为15432；

max_connections=自定义最大连接数；

max_prepared_transactions=等于最大连接数；

max_worker_processes=cpu * 2；

shared_buffers=物理内存 * 25%GB；

effective_cache_size=物理内存 * 75%GB；

max_wal_size=2 * shared_buffersGB；

random_page_cost=如果是SSD磁盘，设置为1；如果是SATA磁盘，保持默认值4；

配置AntDB白名单

在AntDB的数据目录中有一个文件名是pg_hba.conf，此文件是配置访问白名单的文件，配置格式如下：

TYPE DATABASE USER ADDRESS METHOD

ADDRESS由IP网段/子网掩码组成，请根据实际的情况自行配置。

例如，在hba中添加允许连接到数据库的IP网段，通过md5认证访问所有数据库的配置：

cat >> /data/uat/data/pg_hba.conf << EOF

host all all 10.0.0.0/8 md5

EOF

注：host 中可以指定 IPV4 或 IPV6 的地址，但指定的时候需要统一。即：要么统一指定为 IPV4 地址，要么统一为 IPV6 地址。

启动数据库

初始化完成后，可以用adb_ctl命令启动数据库，-D指的是初始化时指定的数据目录：

adb_ctl start -D /data/antdb/data

启动完成后，可以用psql命令登录数据库：

psql -d postgres -p 5432

至此，AntDB数据库安装启动完成。

集群版请参考安装部署。