【磐维数据库】磐维数据库工具包安装

前言

江西移动省侧4A暂不支持磐维图形化工具，业务系统的开发人员依赖磐维命令行客户端工具访问数据库进行应用开发测试。

在非数据库主机上（如应用服务器）远程连接访问 PanWeiDB，需要在非数据库主机上安装相应平台的磐维工具包。

本文的工具包包括以下工具：

[root@node2 bin]# ls
gs_basebackup  gs_dump  gs_dumpall  gs_probackup  gsql  gs_restore  gs_tar  psql  pw_basebackup  pw_bulkload  pw_dump  pw_dumpall  pw_probackup  pw_restore

为了方便大家在部署业务的过程中快速诊断到底是业务配置的问题，还是远程磐维数据库本身无法正常连接，特写本文章。

安装数据库工具包

文中假设软件包已经下载并上传到主机的/tools目录下。

1、 解压 PanWeiDB 数据库工具包，其中 tools_dir 为解压后的数据包目录

命令：tar -zxvf panweidb-tools-xxxxxxxx.tar.gz -C <tools_dir>

执行过程如下：

[root@node2 tools]# tar -zxf PanWeiDB_V2.0-S2.0.3_B01-tools-bclinux_euler21.10-x86_64.tar.gz -C /tools 

解压后的目录及文件如下：

[root@node2 bin]# cd /tools/
[root@node2 tools]# ls -l
total 4
drwxr-xr-x 2 root root  247 May 25 23:11 bin
drwxr-xr-x 3 root root 4096 May 25 23:11 lib
[root@node2 tools]# ls bin
gs_basebackup  gs_dump  gs_dumpall  gs_probackup  gsql  gs_restore  gs_tar  psql  pw_basebackup  pw_bulkload  pw_dump  pw_dumpall  pw_probackup  pw_restore
[root@node2 tools]# ls lib
libcjson.so              libconfig.so      libcurl.so.4.7.0             libgssrpc_gauss.so        libkrb5_gauss.so             liblz4.so                libpgport_tool.so.1  libpq.so.5      libxml2.so.2       libzstd.so.1
libcjson.so.1            libconfig.so.4    libgauss_cl_jni.so           libgssrpc_gauss.so.4      libkrb5_gauss.so.3           liblz4.so.1              libpq.a              libpq.so.5.5    libxml2.so.2.9.13  libzstd.so.1.5.2
libcjson.so.1.7.15       libcrypto.so      libgcc_s.so.1                libgssrpc_gauss.so.4.2    libkrb5_gauss.so.3.3         liblz4.so.1.9.3          libpq_ce.so          libssl.so       libz.so            postgresql
libcom_err_gauss.so      libcrypto.so.1.1  libgssapi_krb5_gauss.so      libk5crypto_gauss.so      libkrb5support_gauss.so      libpagecompression.so    libpq_ce.so.5        libssl.so.1.1   libz.so.1
libcom_err_gauss.so.3    libcurl.so        libgssapi_krb5_gauss.so.2    libk5crypto_gauss.so.3    libkrb5support_gauss.so.0    libpagecompression.so.1  libpq_ce.so.5.5      libstdc++.so.6  libz.so.1.2.12
libcom_err_gauss.so.3.0  libcurl.so.4      libgssapi_krb5_gauss.so.2.2  libk5crypto_gauss.so.3.1  libkrb5support_gauss.so.0.1  libpgport_tool.so        libpq.so             libxml2.so      libzstd.so
[root@node2 tools]# 

2、 授予解压目录可执行权限

其中 tools_dir 为解压后的数据包目录。

命令：chmod -R 755 ./<tools_dir>

执行过程如下：

[root@node2 tools]# chmod -R 755 /tools 

3、设置环境变量

• 方式一：临时生效方式。
  其中 tools_dir 为解压后的数据包目录。

命令：
export PATH=<tools_dir>/bin:$PATH
export LD_LIBRARY_PATH=<tools_dir>/lib:<tools_dir>/lib/postgresql:$LD_LIBRARY_PATH

执行过程如下：

[root@node2 tools]# export PATH=/tools/bin:$PATH
[root@node2 tools]# export LD_LIBRARY_PATH=/tools/lib:/tools/lib/postgresql:$LD_LIBRARY_PATH

• 方式二：永久生效方式
  修改 .bashrc 文件，添加环境变量，其中 tools_dir为解压后的数据包目录。

命令：

vi .bashrc
export PATH=<tools_dir>/bin:$PATH
export LD_LIBRARY_PATH=<tools_dir>/lib:<tools_dir>/lib/postgresql:$LD_LIBRARY_PATH
环境变量生效： source .bashrc 

执行过程如下：

[root@node2 ~]# vi .bashrc
export PATH=/tools/bin:$PATH
export LD_LIBRARY_PATH=/tools/lib:/tools/lib/postgresql:$LD_LIBRARY_PATH
[root@node2 ~]# source .bashrc

4、检查数据库白名单配置

如果没有配置白名单，在磐维数据库主机上可以参考如下方式配置：

gs_guc reload -N all -I all -h 'host all all <ip段1>.<ip段2>.0.0/16 sha256'

执行过程如下：

[omm@node1 ~]$ gs_guc reload -N all -I all -h 'host all all 192.168.0.0/16 sha256'

5、验证工具可用，其中 tools_dir 为解压后的数据包目录

./<tools_dir>/bin/gsql -h <数据库服务器ip地址> -d <数据库名> -U <数据库用户名> -p <端口> -r 

执行过程如下：

[root@node2 tools]# gsql -h 192.*.*.52 -d postgres -U testuser -p 17700 -r 
Password for user testuser: 
gsql ((PanWeiDB_V2.0-S2.0.2_B01) compiled at 2024-03-29 20:29:01 commit 2b900fc )
SSL connection (cipher: ECDHE-RSA-AES128-GCM-SHA256, bits: 128)
Type "help" for help.

postgres=> 

至此，磐维数据库工具包安装完成。