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数据库安装启动完成。

集群版请参考安装部署。