文档用途

本文档用于指导运维人员快速配置瀚高 V4.5、V9.0 单机及 HGHAC 集群的操作系统环境变量，解决数据库命令无法识别、客户端默认连接异常、定时脚本变量不生效问题。

详细信息

说明：根据数据库运行用户选择环境变量配置哪个用户下（root或highgo，示例以highgo用户为例），统一配置在~/.bashrc文件，同时兼容登录 Shell、非登录 Shell（su 切换、crontab 定时任务、脚本执行）。

1、配置环境变量

# 1. 打开配置文件
vi ~/.bashrc

# 2. 在文件末尾添加以下配置（根据实际环境修改值）
########## 基础环境变量（所有版本通用）##########
export HGDB_HOME=/home/highgo/hgdb-enterprise-9.1.1  # 【参数说明】数据库安装根路径
export PGUSER=highgo         # 【参数说明】默认登录数据库的用户，HGDB默认highgo
export PGDATABASE=highgo     # 【参数说明】默认连接的数据库名
export PGPORT=5866           # 【参数说明】数据库监听端口，HGDB默认5866，需与postgresql.auto.conf中port一致
export PGDATA=$HGDB_HOME/data   # 【参数说明】数据库数据目录，需与实际初始化路径一致

########## PATH配置（二选一，版本/部署模式差异标注）##########
# 模式1：单机版
export PATH=$HGDB_HOME/bin:$PATH

# 模式2：瀚高集群版
export PATH=$HGDB_HOME/bin:$PATH:/usr/local/hghac/etcd:/usr/local/hghac/hac:/usr/local/hghac/hac/hghactl

########## 可选配置（按需添加）##########
# 若使用pgbackrest备份（HGDB全版本通用）
export PATH=$PATH:/hgdata/highgo/hgdb-v9.0/tools/pgbackrest/bin  # 【参数说明】pgbackrest的bin目录路径，需对应实际安装路径

# 瀚高集群专属
export PATRONICTL_CONFIG_FILE=/usr/local/hghac/hac/hghac.yml  # 【参数说明】集群配置文件路径
export ETCDCTL_ENDPOINTS=http://10.21.132.201:2379,http://10.21.132.204:2379,http://10.21.132.208:2379  # 【参数说明】ETCD集群所有节点地址（IP:端口）
export ETCDCTL_API=3  # 【参数说明】ETCD API版本，HGHAC集群需指定为3

# 3. 保存退出（按Esc，输入:wq回车）

# 4. 环境变量生效
source ~/.bashrc  # 【参数说明】强制加载~/.bashrc配置，新打开的终端会自动加载，无需重复执行

2、验证环境变量是否生效

# 1. 验证环境变量值是否正确
echo $HGDB_HOME && echo $PGPORT && echo $PATH | grep $HGDB_HOME/bin

# 2. 验证命令是否可识别
which psql && which pg_ctl

# 3. 验证数据库连接（无需手动指定参数）
psql -c "select version();"  # 成功返回版本信息则连接正常

# 4. 检查ETCD是否正常
etcdctl member list   
etcdctl endpoint status  --write-out=table
etcdctl endpoint health  --write-out=table
# 5. 检查集群状态是否正常
hghactl list

# 6. 备份工具验证（pgbackrest）
pgbackrest --version  # 成功输出版本则PATH配置正常

相关文档