如何使用PTK一键安装opengaussdb 5.0

1、关于PTK工具

MogDB数据库是云和恩墨基于openGauss开源数据库打造，安稳易用的企业级关系型数据库。

PTK是云和恩墨出品的一款工具，帮助用户更便捷地部署管理MogDB数据库。

1.1 使用场景

开发人员快速启动多个本地 MogDB 环境
用户通过 PTK 快速安装部署 MogDB
DBA 日常运维使用
第三方运维平台集成

1.2 推荐部署架构

PTK 的定位是一个中心化多集群管理软件，作为一个中控软件的角色，通过 SSH 的方式远程管理多个数据库集群，所以，我们推荐您将PTK部署在单独的一台控制服务器上，然后将数据库部署到数据库专属的服务器上，如下图。当然，PTK也支持本地部署，您可以根据您的机器情况自行安排安装位置。

（注：PTK依赖本地元数据来进行集群管理，不同操作系统用户安装的PTK相互独立不可见）

                           +-----------+
                           |    PTK    |
                           +-----------+
                 /---ssh-----/   |    \---ssh----\
                /               ssh               \
               /                 |                 \
        +-----------+      +-----------+      +-----------+
        |   MogDB   |      |   MogDB   |      |   MogDB   |
        +-----------+      +-----------+      +-----------+

1.3 PTK 支持部署 MogDB 的操作系统

最新列表请通过 ptk candidate os 查看

软件下载地址：https://www.mogdb.io/downloads/ptk/all

PTK软件使用说明书：https://docs.mogdb.io/zh/ptk/v2.0/overview

云和恩墨的软件许可看得出，这家软件还是比较宽松的，允许大家进行测试，这点十分的友好。

MogDB: Privacy下面是截取的一段说明：

云和恩墨授予您非排他性、不可转让的、不可再许可、不可分许可且可撤销的有限许可，允许您在遵守本协议所述限制的前提下，**仅出于开发、测试、原型设计和演示您的应用程序的目的，并且仅在您的应用程序未用于任何数据处理、业务、商业或生产目的的情况下，且不得用于任何其他目的。**您可以允许您的承包商使用程序，前提是他们代表您行使本协议中授予的许可权利，并且您及您的承包商有责任在此类使用中遵守本协议。您将与您的承包商签订书面协议，严格限制他们使用程序的权利，并以其他方式保护云和恩墨及【MogDB】软件的知识产权，其程度不得低于本协议。您可以在合理必要的范围内复制程序，以行使本协议中授予的许可权利。若云和恩墨发现您允诺使用程序的承包商有不符合要求或使用限制的，云和恩墨可单方中断承包商的使用权限。

目前最新的PTK版本是V1.7.0，在8月30号刚刚发布。
在这里插入图片描述

2、安装PTK

2.1 在线安装

注：命令行安装方式不支持 Windows 系统

在终端中，执行以下指令即可自动完成安装：

curl --proto '=https' --tlsv1.2 -sSf https://cdn-mogdb.enmotech.com/ptk/install.sh | sh

该指令会自动将 PTK 安装在用户的家目录 $HOME/.ptk 目录下，该目录以后会作为 PTK 工具的工作目录，其产生的缓存文件、数据文件以及集群的配置信息，备份信息等文件均会存储到该目录下。同时，安装指令会自动将 $HOME/.ptk/bin 的路径加入到对应 SHELL Profile 文件（安装日志的末尾会显示）的 PATH 环境变量中，这样在用户登录到服务器后就可以直接使用 ptk 指令了。

执行安装完成后，用户重新打开终端即可激活 ptk 命令。

2.2 离线安装

如果您的服务器无法直接访问互联网或者是需要在 Windows 系统上使用 PTK 工具，此时可以通过手动方式进行安装。

请按照以下操作步骤进行安装：

先从下面链接页面下载对应服务器架构的安装包:

🔗 https://www.mogdb.io/downloads/ptk/all

将安装包上传到目标服务器上解压即可

mkdir -p $HOME/.ptk/bin
tar -xvf ptk_1.7.0_linux_x86_64.tar.gz -C $HOME/.ptk/bin
echo "export PATH=$HOME/.ptk/bin:$PATH" >> $HOME/.bashrc
source $HOME/.bashrc

3、使用PTK一键部署openGauss

3.1 安装前准备

整体安装过程如下：

1、生成模板文件

2、检查操作系统是否满足要求并生成整改文件脚本

3、执行安装

另外说一句，执行之前需要提前配置好主机名及hosts文件，只有这些！

这里示例使用的环境如下：

操作系统：银河麒麟V10

数据库版本：openGauss 5.02 for openEuler 22.03

3.2 生成模板文件

使用ptk template 命令即可，以上是命令帮助

[root@ogserver ~]# ptk template -h
生成配置模板

Usage:
  ptk template [flags]

Available Commands:
  create      交互式创建配置文件
  mogha       生成 MogHA 配置
  scale-out   生成扩容配置

Flags:
  -d, --base-dir string       指定数据库要安装的基目录 (default "/opt/mogdb")
  -n, --cluster-name string   指定集群名称, 默认会随机生成
  -g, --group string          指定系统用户组 (default "omm")
  -l, --local                 生成安装本地数据库的配置文件
  -p, --port int              指定数据库端口 (default 26000)
  -u, --user string           指定系统用户名 (default "omm")

Global Flags:
      --disable-color         禁用彩色日志
      --disable-debug-log     不生成调试日志文件
      --disable-progressbar   全局不显示进度条
  -h, --help                  打印帮助信息
      --log-file string       指定运行日志文件路径
      --log-format string     指定运行日志的输出格式, 可选项: [text, json] (default "text")
      --log-level string      指定运行日志级别, 可选项: [debug, info, warning, error, panic] (default "info")
      --silence               不打印日志到标准输出
      --skip-fix-ssh          无需通过交互修复 ssh 连接

Examples:
# 生成本地单实例配置模板
ptk template -l > config.yml

# 生成多实例集群的配置模板
ptk template > config.yml

# 自定义部分配置字段的值
ptk template -n <CLUSTER_NAME> -u <OS_USER> -g <OS_USERGROUP> -d <BASE_DIR> -p <DB_PORT> > config.yml

Support from: v0.2

Use "ptk template [command] --help" for more information about a command.

如果你是小白，推荐使用ptk template create 执行交互式创建，下面是示例：

[root@ogserver ~]# ptk template create
✔ 请输入集群名称 (默认: swirles): dbserver
✔ 请输入系统用户名 (默认: omm): omm
✔ 请输入用户组名 (默认: omm): dbgroup
✔ 请输入数据库密码 (8~15 个字符, 3 种类型): **********
✔ 再次输入数据库密码: **********
✔ 请输入数据库端口 (范围 1024~65535) (默认: 26000): 15400
✔ 请输入数据库基础目录 (需为空目录) (默认: /opt/mogdb): /data/openGauss█
✔ 是否要安装CM组件 (默认 n) [y/n]: y
✔ 是否要安装CM组件 (默认 n) [y/n]: y
接下来, 我们来添加一些数据库实例服务器
================db server 1================
✔ 请输入服务器 IP (仅支持 IPv4): 192.168.100.10
✔ 请选择数据库角色: primary        //此处会提示你是primaty 还是standby，可以按光标选择
✔ 请输入可用区的名称 (默认: AZ1): 
✔ 请输入可用区 ("AZ1") 的优先级 (默认: 1): 
================ end ================
✔ 您想添加另一个数据库实例吗 (默认 n) [y/n]: n
Generate /root/config.2024-09-03T15_51_58.yaml successfully

3.3 执行安装前检查

执行ptk checkos -f <模板文件> --detail就会显示出检查情况，并详细列出哪有不符合Abnormal，哪里是告警Warning建议调整。

这里示例执行输出如下，随后会自动生成个修改脚本，只要执行一下，就可以完成abnormal项的修改。

[root@ogserver ~]# ptk checkos -f /root/config.2024-09-03T15_51_58.yaml  --detail
INFO[2024-09-03T16:00:52.374] 预检查依赖工具...                                   
INFO[2024-09-03T16:00:52.434] [192.168.100.10][omm] platform: kylin_V10_64bit 
INFO[2024-09-03T16:00:52.437] [192.168.100.111][omm] 交换内存 4132860kB，总内存 2952948kB 
ERRO[2024-09-03T16:00:52.453] [192.168.100.111][omm] net.core.rmem_default=212992, expect 262144 
ERRO[2024-09-03T16:00:52.460] [192.168.100.111][omm] kernel.sem=32000	1024000000	500	32000, expect 250 6400000 1000 25600 
WARN[2024-09-03T16:00:52.463] [192.168.100.111][omm] net.ipv4.tcp_max_syn_backlog=128, expect 65535 
WARN[2024-09-03T16:00:52.469] [192.168.100.111][omm] net.ipv4.tcp_syn_retries=6, expect 5 
WARN[2024-09-03T16:00:52.472] [192.168.100.111][omm] net.core.somaxconn=128, expect 65535 
ERRO[2024-09-03T16:00:52.475] [192.168.100.111][omm] net.core.wmem_default=212992, expect 262144 
ERRO[2024-09-03T16:00:52.485] [192.168.100.111][omm] net.core.wmem_max=212992, expect 1048576 
WARN[2024-09-03T16:00:52.491] [192.168.100.111][omm] net.ipv4.tcp_keepalive_intvl=75, expect 30 
WARN[2024-09-03T16:00:52.498] [192.168.100.111][omm] net.ipv4.tcp_wmem=4096	16384	4194304, expect 8192 250000 16777216 
WARN[2024-09-03T16:00:52.500] [192.168.100.111][omm] net.ipv4.tcp_keepalive_time=7200, expect 30 
WARN[2024-09-03T16:00:52.503] [192.168.100.111][omm] net.ipv4.tcp_retries1=3, expect 5 
WARN[2024-09-03T16:00:52.505] [192.168.100.111][omm] net.ipv4.tcp_retries2=15, expect 12 
WARN[2024-09-03T16:00:52.507] [192.168.100.111][omm] net.core.netdev_max_backlog=1000, expect 65535 
WARN[2024-09-03T16:00:52.513] [192.168.100.111][omm] vm.min_free_kbytes=67584, expect 147647 
ERRO[2024-09-03T16:00:52.517] [192.168.100.111][omm] net.core.rmem_max=212992, expect 1048576 
WARN[2024-09-03T16:00:52.521] [192.168.100.111][omm] net.ipv4.tcp_tw_reuse=2, expect 1 
WARN[2024-09-03T16:00:52.523] [192.168.100.111][omm] net.ipv4.tcp_rmem=4096	131072	6291456, expect 8192 250000 16777216 
INFO[2024-09-03T16:00:52.530] [192.168.100.111][omm] 检查 kernel.core_pattern 
INFO[2024-09-03T16:00:52.534] [192.168.100.111][omm] 检查 RemoveIPC 的值       
INFO[2024-09-03T16:00:52.541] [192.168.100.111][omm] 检查 KillUserProcesses 的值 
ERRO[2024-09-03T16:00:52.554] [192.168.100.111][omm] selinux mode in /etc/selinux/config is 'enforcing' 
INFO[2024-09-03T16:00:55.427] [192.168.100.111][omm] 内核版本: 4.19.90-52.22.v2207.ky10.x86_64 
WARN[2024-09-03T16:00:55.449] [192.168.100.111][omm] device(/dev/sda) readahead value=8192, expect 16384. 
INFO[2024-09-03T16:00:55.458] [192.168.100.111][omm] 检查端口 15400            
INFO[2024-09-03T16:00:55.467] [192.168.100.111][omm] 端口 15400 空闲           
INFO[2024-09-03T16:00:55.474] [192.168.100.111][omm] 时区: +0800             
WARN[2024-09-03T16:00:55.485] [192.168.100.111][omm] device(sda) 'IO Request'=254, expect 256 
ERRO[2024-09-03T16:00:55.501] [192.168.100.111][omm] firewall status='enabled', expect 'disabled'. 
INFO[2024-09-03T16:00:55.501] 完成所有检查项                                      
INFO[2024-09-03T16:00:55.501] 将修复 OS 脚本写入 root_fix_os.0903.160055.sh 成功    
INFO[2024-09-03T16:00:55.501] 用时: 4s                                       
# Check Results
                Item                |  Level   |                                   Message                                    
------------------------------------+----------+------------------------------------------------------------------------------
  A1.Check_OS_Version               | OK       |                                                                              
  A2.Check_Kernel_Version           | OK       |                                                                              
  A3.Check_Unicode                  | OK       |                                                                              
  A4.Check_TimeZone                 | OK       |                                                                              
  A5.Check_Swap_Memory_Configure    | Warning  | [192.168.100.111]:                                                           
                                    |          | swap memory (4132860 KB) is lager than total memory (2952948 KB)             
  A6.Check_SysCtl_Parameter         | Abnormal | [192.168.100.111]:                                                           
                                    |          | Abnormal: net.core.rmem_default=212992, expect 262144                        
                                    |          | Abnormal: kernel.sem=32000	1024000000	500	32000, expect 250 6400000 1000 25600  
                                    |          | Warning: net.ipv4.tcp_max_syn_backlog=128, expect 65535                      
                                    |          | Warning: net.ipv4.tcp_syn_retries=6, expect 5                                
                                    |          | Warning: net.core.somaxconn=128, expect 65535                                
                                    |          | Abnormal: net.core.wmem_default=212992, expect 262144                        
                                    |          | Abnormal: net.core.wmem_max=212992, expect 1048576                           
                                    |          | Warning: net.ipv4.tcp_keepalive_intvl=75, expect 30                          
                                    |          | Warning: net.ipv4.tcp_wmem=4096	16384	4194304, expect 8192 250000 16777216     
                                    |          | Warning: net.ipv4.tcp_keepalive_time=7200, expect 30                         
                                    |          | Warning: net.ipv4.tcp_retries1=3, expect 5                                   
                                    |          | Warning: net.ipv4.tcp_retries2=15, expect 12                                 
                                    |          | Warning: net.core.netdev_max_backlog=1000, expect 65535                      
                                    |          | Warning: vm.min_free_kbytes=67584, expect 147647                             
                                    |          | Abnormal: net.core.rmem_max=212992, expect 1048576                           
                                    |          | Warning: net.ipv4.tcp_tw_reuse=2, expect 1                                   
                                    |          | Warning: net.ipv4.tcp_rmem=4096	131072	6291456, expect 8192 250000 16777216    
  A7.Check_FileSystem_Configure     | OK       |                                                                              
  A8.Check_Disk_Configure           | OK       |                                                                              
  A9.Check_BlockDev_Configure       | Warning  | [192.168.100.111]:                                                           
                                    |          | device(/dev/sda) readahead value=8192, expect 16384.                         
  A9.Check_Logical_Block            | OK       |                                                                              
  A10.Check_Asynchronous_IO_Request | OK       |                                                                              
  A10.Check_IO_Configure            | OK       |                                                                              
  A10.Check_NR_Request              | Warning  | [192.168.100.111]:                                                           
                                    |          | device(sda) 'IO Request'=254, expect 256                                     
  A11.Check_Network_Configure       | OK       |                                                                              
  A12.Check_Time_Consistency        | OK       |                                                                              
  A13.Check_Firewall_Status         | Abnormal | [192.168.100.111]:                                                           
                                    |          | firewall status='enabled', expect 'disabled'.                                
  A14.Check_THP_Status              | OK       |                                                                              
  A15.Check_Dependent_Package       | Warning  | [192.168.100.111]:                                                           
                                    |          | Warning: not found package: flex                                             
                                    |          | Warning: not found package: bison                                            
                                    |          | Warning: not found package: ncurses-devel                                    
  A16.Check_CPU_Instruction_Set     | OK       |                                                                              
  A17.Check_Port                    | OK       |                                                                              
  A18.Check_Selinux                 | Abnormal | [192.168.100.111]:                                                           
                                    |          | selinux mode in /etc/selinux/config is 'enforcing'                           
  A19.Check_User_Ulimit             | OK       |                                                                              
  A20.Check_Directory               | OK       |                                                                              
Total count 23, abnormal count 3, warning count 4
Failed to check os, can’t perform installation unless fix all the abnormal items.
You can use 'ptk checkos -i ITEM --detail' to get detail message
Please check root_fix_os.0903.160055.sh for commands to resolve.

这里我们执行一下脚本，修正不符合的参数。

[root@ogserver ~]# sh root_fix_os.0903.160055.sh 
++ ip addr
++ grep -v 'inet6\|127.0.0.1\|grep'
++ awk '{print $2}'
++ awk -F / '{print $1}'
++ grep inet
+ local_ips='192.168.100.111
192.168.233.134
192.168.122.1'
+ for ip in ${local_ips}
+ [[ 192.168.100.111 == \1\9\2\.\1\6\8\.\1\0\0\.\1\1\1 ]]
+ sed -i /net.core.rmem_default/d /etc/sysctl.conf
+ echo net.core.rmem_default = 262144
+ sed -i /kernel.sem/d /etc/sysctl.conf
+ echo kernel.sem = 250 6400000 1000 25600
+ sed -i /net.core.wmem_default/d /etc/sysctl.conf
+ echo net.core.wmem_default = 262144
+ sed -i /net.core.wmem_max/d /etc/sysctl.conf
+ echo net.core.wmem_max = 1048576
+ sed -i /net.core.rmem_max/d /etc/sysctl.conf
+ echo net.core.rmem_max = 1048576
+ sysctl -p
kernel.sysrq = 0
net.ipv4.ip_forward = 0
net.ipv4.conf.all.send_redirects = 0
net.ipv4.conf.default.send_redirects = 0
net.ipv4.conf.all.accept_source_route = 0
net.ipv4.conf.default.accept_source_route = 0
net.ipv4.conf.all.accept_redirects = 0
net.ipv4.conf.default.accept_redirects = 0
net.ipv4.conf.all.secure_redirects = 0
net.ipv4.conf.default.secure_redirects = 0
net.ipv4.icmp_echo_ignore_broadcasts = 1
net.ipv4.icmp_ignore_bogus_error_responses = 1
net.ipv4.conf.all.rp_filter = 1
net.ipv4.conf.default.rp_filter = 1
net.ipv4.tcp_syncookies = 1
net.core.rmem_default = 262144
kernel.sem = 250 6400000 1000 25600
net.core.wmem_default = 262144
net.core.wmem_max = 1048576
net.core.rmem_max = 1048576
+ sudo sed -i s/SELINUX=enforcing/SELINUX=disabled/g /etc/selinux/config
+ systemctl disable firewalld
Removed /etc/systemd/system/multi-user.target.wants/firewalld.service.
Removed /etc/systemd/system/dbus-org.fedoraproject.FirewallD1.service.
+ systemctl stop firewalld
+ for ip in ${local_ips}
+ [[ 192.168.233.134 == \1\9\2\.\1\6\8\.\1\0\0\.\1\1\1 ]]
+ for ip in ${local_ips}
+ [[ 192.168.122.1 == \1\9\2\.\1\6\8\.\1\0\0\.\1\1\1 ]]

改完可以再检查一遍，几乎都修复完了，我就省略一下只显示结果

Total count 23, abnormal count 0, warning count 5

关于warning的选项也可根据提示手动修改。这里就不演示了。

3.4 安装openGauss数据库

执行命令，一键安装

[root@ogserver ~]#  ptk install -f /root/config.2024-09-03T15_51_58.yaml -p /root/kylinv10sp3_openGauss-5.0.2-openEuler-64bit-all_x86.tar.gz 
INFO[2024-09-03T16:15:04.983] PTK 版本: 1.7.0 release                        
INFO[2024-09-03T16:15:04.983] 从 /root/config.2024-09-03T15_51_58.yaml 加载配置 
如果您选择继续安装软件,
就代表您接受该软件的许可协议。

  [Y]: 接受并继续
  [C]: 显示许可协议内容
  [N]: 中止安装并退出

✔ 请输入 (默认: Y): y
集群名："dbserver"
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
| az(priority) |       ip        | user(group)  | port  |  role   |       data dir       | upstream |
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
| AZ1(1)       | 192.168.100.111 | omm(dbgroup) | 15400 | primary | /data/openGauss/data | -        |
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
✔ 集群配置是否正确 (默认 n) [y/n]: y
INFO[2024-09-03T16:15:15.644] 检查主机名 ...                                    
INFO[2024-09-03T16:15:15.647] 主机名检查成功                                      
INFO[2024-09-03T16:15:15.647] 检查操作系统 ...                                   
INFO[2024-09-03T16:15:15.647] 预检查依赖工具...                                   
INFO[2024-09-03T16:15:15.672] [192.168.100.111][omm] platform: kylin_V10_64bit 
INFO[2024-09-03T16:15:15.674] [192.168.100.111][omm] 内核版本: 4.19.90-52.22.v2207.ky10.x86_64 
INFO[2024-09-03T16:15:15.678] [192.168.100.111][omm] 时区: +0800             
WARN[2024-09-03T16:15:15.685] [192.168.100.111][omm] device(/dev/sda) readahead value=8192, expect 16384. 
INFO[2024-09-03T16:15:15.693] [192.168.100.111][omm] 交换内存 4132860kB，总内存 2952948kB 
WARN[2024-09-03T16:15:15.696] [192.168.100.111][omm] net.ipv4.tcp_max_syn_backlog=128, expect 65535 
WARN[2024-09-03T16:15:15.706] [192.168.100.111][omm] net.ipv4.tcp_retries2=15, expect 12 
WARN[2024-09-03T16:15:15.719] [192.168.100.111][omm] net.ipv4.tcp_keepalive_intvl=75, expect 30 
WARN[2024-09-03T16:15:15.721] [192.168.100.111][omm] net.ipv4.tcp_rmem=4096	131072	6291456, expect 8192 250000 16777216 
WARN[2024-09-03T16:15:15.723] [192.168.100.111][omm] net.core.netdev_max_backlog=1000, expect 65535 
WARN[2024-09-03T16:15:15.784] [192.168.100.111][omm] vm.min_free_kbytes=67584, expect 147647 
WARN[2024-09-03T16:15:15.920] [192.168.100.111][omm] net.ipv4.tcp_keepalive_time=7200, expect 30 
WARN[2024-09-03T16:15:15.994] [192.168.100.111][omm] net.ipv4.tcp_retries1=3, expect 5 
WARN[2024-09-03T16:15:15.998] [192.168.100.111][omm] net.ipv4.tcp_wmem=4096	16384	4194304, expect 8192 250000 16777216 
WARN[2024-09-03T16:15:16.005] [192.168.100.111][omm] net.ipv4.tcp_syn_retries=6, expect 5 
WARN[2024-09-03T16:15:16.011] [192.168.100.111][omm] net.ipv4.tcp_tw_reuse=2, expect 1 
WARN[2024-09-03T16:15:16.018] [192.168.100.111][omm] net.core.somaxconn=128, expect 65535 
INFO[2024-09-03T16:15:16.020] [192.168.100.111][omm] 检查 kernel.core_pattern 
INFO[2024-09-03T16:15:16.024] [192.168.100.111][omm] 检查 RemoveIPC 的值       
INFO[2024-09-03T16:15:16.032] [192.168.100.111][omm] 检查 KillUserProcesses 的值 
INFO[2024-09-03T16:15:18.426] [192.168.100.111][omm] 检查端口 15400            
INFO[2024-09-03T16:15:18.439] [192.168.100.111][omm] 端口 15400 空闲           
WARN[2024-09-03T16:15:18.471] [192.168.100.111][omm] device(sda) 'IO Request'=254, expect 256 
INFO[2024-09-03T16:15:18.509] 完成所有检查项                                      
INFO[2024-09-03T16:15:18.509] 用时: 3s                                       
INFO[2024-09-03T16:15:18.509] 操作系统检查成功                                     
INFO[2024-09-03T16:15:18.509] 检查系统发行版 ...                                  
INFO[2024-09-03T16:15:18.509] 发行版检查成功                                      
INFO[2024-09-03T16:15:18.509] 检查用户 ...                                     
INFO[2024-09-03T16:15:18.518] 检查用户成功                                       
INFO[2024-09-03T16:15:18.518] 检查端口 ...                                     
INFO[2024-09-03T16:15:18.518] checking port 15400 on host 192.168.100.111 (db listen port) ... 
INFO[2024-09-03T16:15:18.526] checking port 15401 on host 192.168.100.111 (db HA port) ... 
INFO[2024-09-03T16:15:18.532] 端口检查成功                                       
INFO[2024-09-03T16:15:18.535] [192.168.100.111][omm] 创建操作系统用户omm, 组dbgroup 
INFO[2024-09-03T16:15:18.560] [192.168.100.111][omm] set ulimit configs    
INFO[2024-09-03T16:15:18.563] 准备安装包 ...                                    
INFO[2024-09-03T16:15:18.563] 安装包已经就绪                                      
INFO[2024-09-03T16:15:18.563] parse installation package ...               
INFO[2024-09-03T16:16:12.448] 数据库产品: openGauss, 版本: 5.0.2, number: 92.861, commit_id: 48a25b11 
INFO[2024-09-03T16:16:12.800] 将 openGauss-5.0.2-openEuler-64bit.tar.bz2 提取到目录/tmp/ptk_tmp_2235563565 
INFO[2024-09-03T16:16:31.188] execute command: gaussdb --version           
INFO[2024-09-03T16:16:31.241] parse installation package success           
INFO[2024-09-03T16:16:31.241] 开始完善配置 ...                                   
INFO[2024-09-03T16:16:31.241] 完善配置成功                                       
INFO[2024-09-03T16:16:31.241] save the topology to metadata                
INFO[2024-09-03T16:16:31.242] 开始分发安装包...                                   
INFO[2024-09-03T16:16:31.420] 安装包分发成功                                      
INFO[2024-09-03T16:16:31.420] 开始安装逻辑节点 ...                                 
INFO[2024-09-03T16:16:31.421] 部署数据库到 omm@192.168.100.111                   
INFO[2024-09-03T16:16:31.422] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss 
INFO[2024-09-03T16:16:31.835] [192.168.100.111][omm] 清除用户 omm 的 IPC 资源     
INFO[2024-09-03T16:16:31.911] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/tool,/data/openGauss/tool/ptk_tool/bin 
INFO[2024-09-03T16:16:33.218] [192.168.100.111][omm] 将 kylinv10sp3_openGauss-5.0.2-openEuler-64bit-all_x86.tar.gz 提取到目录/data/openGauss/tool 
INFO[2024-09-03T16:16:34.078] [192.168.100.111][omm] 将 openGauss-5.0.2-openEuler-64bit-om.tar.gz 提取到目录/data/openGauss/tool 
INFO[2024-09-03T16:16:34.864] [192.168.100.111][omm] 尝试修复psutil Python库    
INFO[2024-09-03T16:16:35.444] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/script/py_pstree.py 
INFO[2024-09-03T16:16:35.588] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/ptk_tool/bin/README.md 
INFO[2024-09-03T16:16:35.838] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/ptk_tool/bin/pscp 
INFO[2024-09-03T16:16:36.123] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/ptk_tool/bin/pssh 
INFO[2024-09-03T16:16:36.262] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/ptk_tool/bin/task_pool.py 
INFO[2024-09-03T16:16:36.682] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/app 
INFO[2024-09-03T16:16:36.914] [192.168.100.111][omm] 将 openGauss-5.0.2-openEuler-64bit.tar.bz2 提取到目录/data/openGauss/app 
INFO[2024-09-03T16:16:57.317] [192.168.100.111][omm] 将 /data/openGauss/app 的权限更改为 700 
INFO[2024-09-03T16:16:57.442] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/app/share/postgresql 
INFO[2024-09-03T16:16:57.793] [192.168.100.111][omm] 将 /data/openGauss/tool/script/gspylib/etc/sql/pmk_schema.sql 复制到 /data/openGauss/app/share/postgresql 
INFO[2024-09-03T16:16:57.866] [192.168.100.111][omm] 将 /data/openGauss/tool/script/gspylib/etc/sql/pmk_schema_single_inst.sql 复制到 /data/openGauss/app/share/postgresql 
INFO[2024-09-03T16:16:57.920] [192.168.100.111][omm] 写入文件 /data/openGauss/app/bin/transfer.py 
INFO[2024-09-03T16:16:58.077] [192.168.100.111][omm] 设置用户omm的配置文件          
INFO[2024-09-03T16:16:58.530] [192.168.100.111][omm] 验证并尝试修复 gs_initdb 的 ld 库 
INFO[2024-09-03T16:16:58.582] [192.168.100.111][omm] 验证并尝试修复 gaussdb 的 ld 库 
INFO[2024-09-03T16:16:58.654] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/log/gs_profile,/data/openGauss/log/pg_log,/data/openGauss/log/pg_audit,/data/openGauss/log/bin,/data/openGauss/log/pg_log/dn_6001,/data/openGauss/log/pg_audit/dn_6001 
INFO[2024-09-03T16:17:01.316] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/tmp 
INFO[2024-09-03T16:17:01.519] [192.168.100.111][omm] 将版本保存为 upgrade_version 
INFO[2024-09-03T16:17:01.868] [192.168.100.111][omm] 创建文件 cluster_manual_start 
INFO[2024-09-03T16:17:01.956] [192.168.100.111][omm] 生成 cluster_static_config 文件 
INFO[2024-09-03T16:17:02.045] [192.168.100.111][omm] 创建用户omm的目录:/data/openGauss/data 
INFO[2024-09-03T16:17:02.302] [192.168.100.111][omm] 写入文件 /data/openGauss/tool/.ptk_deployer 
INFO[2024-09-03T16:17:02.691] 生成认证文件                                       
INFO[2024-09-03T16:17:03.917] 下载认证文件                                       
INFO[2024-09-03T16:17:04.867] 认证文件安装成功                                     
INFO[2024-09-03T16:17:04.867] 在 omm@192.168.100.111 上初始化数据库                
INFO[2024-09-03T16:17:04.867] [192.168.100.111][omm] 数据库正在初始化, 请稍等一会儿      
INFO[2024-09-03T16:17:16.636] [192.168.100.111][omm] 配置 postgresql.conf 文件 
INFO[2024-09-03T16:17:16.739] [192.168.100.111][omm] 配置 pg_hba.conf 文件     
INFO[2024-09-03T16:17:16.808] [192.168.100.111][omm] 将 SSL 文件复制到数据目录       
INFO[2024-09-03T16:17:16.893] 逻辑节点安装成功                                     
INFO[2024-09-03T16:17:16.900] 生成 PTKC ...                                  
INFO[2024-09-03T16:17:17.054] 开始构建 SSH 互信 ...                              
INFO[2024-09-03T16:17:18.154] SSH 互信构建成功                                   
INFO[2024-09-03T16:17:18.154] 启动数据库 ...                                    
INFO[2024-09-03T16:17:18.154] [192.168.100.111][omm] 使用 gs_ctl 启动数据库中 ...  
INFO[2024-09-03T16:17:18.154] [192.168.100.111][omm] 数据库正在启动，请稍等一会儿        
INFO[2024-09-03T16:17:19.245] [192.168.100.111][omm] 数据库启动成功               
INFO[2024-09-03T16:17:19.245] 数据库启动成功                                      
INFO[2024-09-03T16:17:19.245] 正在清理临时目录 ...                                 
INFO[2024-09-03T16:17:19.271] 临时目录清理成功                                     
INFO[2024-09-03T16:17:19.271] 用时: 2m9s                                     

  cluste_name |      host       | user | port  |    status     | message  
--------------+-----------------+------+-------+---------------+----------
  dbserver    | 192.168.100.111 | omm  | 15400 | start_success | success

只用时2m9s安装完毕。

4、使用PTK管理数据库

这里简单演示一下简单的管理命令

4.1 启停集群

主要是通过ptk cluster命令来管理集群

[root@ogserver ~]# ptk cluster -h
管理集群

Usage:
  ptk cluster [flags]

Available Commands:
  start                     启动数据库实例或集群
  stop                      停止数据库实例或集群
  restart                   重启数据库实例或集群
  status                    显示集群或实例的状态信息
  build                     重建数据库数据
  switchover                主备切换，升级备库为主库，降主库为备库
  failover                  提升一个备库为主库
  inspect                   返回关于集群的内部信息
  install-plugin            安装 MogDB 插件
  list-plugins              列出集群中的插件
  install-mogha             为 MogDB 安装 MogHA
  uninstall-mogha           卸载 MogHA
  scale-in                  对一个MogDB集群进行缩容
  scale-out                 对一个MogDB集群进行扩容
  show-hba                  打印数据库 pg_hba.conf 内容
  set-hba                   设置并重新加载数据库的 pg_hba.conf
  show-guc                  打印数据库参数
  set-guc                   设置并重新加载数据库参数
  show-config               打印集群拓扑配置文件
  modify-comment            修改指定集群的备注
  shell                     执行 shell 命令或脚本
  refresh                   更新集群配置
  promote                   将一个数据库实例从备库提升为主库, 或从级联备库提升为备库
  demote                    将数据库角色从 Primary 降级为 Standby，或从 Standby 降级为 Cascade Standby
  upgrade                   升级集群的数据库版本
  upgrade-commit            确认提交升级操作(!提交后不能回滚)
  upgrade-rollback          回滚升级操作
  is-in-upgrade             查看集群是否处于升级过程中
  install-kerberos-server   安装 kerberos 服务器
  uninstall-kerberos-server 卸载 kerberos 服务
  add-kerberos-auth         添加 kerberos 认证
  del-kerberos-auth         删除 kerberos 认证
  load-cm-vip               管理 CM 的虚拟IP (仅 Mogdb v5.0.4+ 支持)
  gen-cert-files            生成ssl证书文件
  install-cm                安装 CM 组件
  uninstall-cm              卸载 CM 组件
  takeover                  添加一个新的实例到PTK的元数据
  throwout                  从PTK的元数据中移除实例
  rename                    重命名集群
  install-mogila            安装mogila示例数据
  install-compat-tools      安装compat-tools
  uninstall-compat-tools    Uninstall compat-tools
  createdb                  创建Database

Flags:
  -n, --name string   集群名称

Global Flags:
      --disable-color         禁用彩色日志
      --disable-debug-log     不生成调试日志文件
      --disable-progressbar   全局不显示进度条
  -h, --help                  打印帮助信息
      --log-file string       指定运行日志文件路径
      --log-format string     指定运行日志的输出格式, 可选项: [text, json] (default "text")
      --log-level string      指定运行日志级别, 可选项: [debug, info, warning, error, panic] (default "info")
      --silence               不打印日志到标准输出
      --skip-fix-ssh          无需通过交互修复 ssh 连接

Support from: v0.1

Use "ptk cluster [command] --help" for more information about a command.

PTK可以代替gs_om命令来启停集群，示例如下

[root@ogserver ~]# ptk cluster -n dbserver  status
[   Cluster State   ]
cluster_name                   : dbserver
cluster_state                  : Normal
database_version               : openGauss 5.0.2 (build 48a25b11)

[  Datanode State   ]
  cluster_name |  id  |       ip        | port  | user | nodename | db_role | state  |  uptime  | upstream  
---------------+------+-----------------+-------+------+----------+---------+--------+----------+-----------
  dbserver     | 6001 | 192.168.100.111 | 15400 | omm  | dn_6001  | primary | Normal | 00:02:29 | -         
[root@ogserver ~]# ptk cluster -n dbserver  stop 
INFO[2024-09-03T16:19:52.916] 操作: stop                                     
INFO[2024-09-03T16:19:52.916] ========================================     
INFO[2024-09-03T16:19:53.643] 数据库[192.168.100.111:15400]停止中 ...            
INFO[2024-09-03T16:19:54.807] 数据库[192.168.100.111:15400]停止成功               
INFO[2024-09-03T16:19:54.807] ========================================     
INFO[2024-09-03T16:19:54.807] 停止成功                                         
[root@ogserver ~]# ptk cluster -n dbserver  start
INFO[2024-09-03T16:20:02.251] checking cluster state before start          
INFO[2024-09-03T16:20:02.699] 操作: start                                    
INFO[2024-09-03T16:20:02.699] ========================================     
INFO[2024-09-03T16:20:02.699] 数据库[192.168.100.111:15400]启动中 ...            
INFO[2024-09-03T16:20:03.993] 数据库[192.168.100.111:15400]启动成功               
INFO[2024-09-03T16:20:04.245] ========================================     
INFO[2024-09-03T16:20:04.245] 集群启动成功

4.2 卸载集群

卸载前需要先停止停群，然后执行ptk uninstall -n <集群名>

[root@ogserver ~]# ptk uninstall -n dbserver
INFO[2024-09-03T16:23:05.516] PTK 版本: 1.7.0 release                        
集群名："dbserver"
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
| az(priority) |       ip        | user(group)  | port  |  role   |       data dir       | upstream |
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
| AZ1(1)       | 192.168.100.111 | omm(dbgroup) | 15400 | primary | /data/openGauss/data | -        |
+--------------+-----------------+--------------+-------+---------+----------------------+----------+
✔ 您确实要卸载该集群吗? 请仔细确认 (默认 n) [y/n]: y
✔ 是否要删除数据库数据 (默认 n) [y/n]: y
✔ 是否要删除操作系统用户 (默认 n) [y/n]: y
INFO[2024-09-03T16:23:08.856] [192.168.100.111][omm] 检查数据库目录属主             
INFO[2024-09-03T16:23:09.217] [192.168.100.111][omm] 检查数据进程状态              
INFO[2024-09-03T16:23:09.376] [192.168.100.111][omm] 删除文件: /data/openGauss/app,/data/openGauss/tool,/data/openGauss/tmp,/data/openGauss/data,/data/openGauss/log 
INFO[2024-09-03T16:23:09.739] [192.168.100.111][omm] 终止用户 "omm" 现有的进程: [krb5kdc] 
INFO[2024-09-03T16:23:10.142] [192.168.100.111][omm] 从cron.allow中移除用户"omm" 
INFO[2024-09-03T16:23:10.148] [192.168.100.111][omm] 移除用户"omm"的ulimits设置   
INFO[2024-09-03T16:23:10.176] [192.168.100.111][omm] 如果 "/data/openGauss" 为空，则删除 
INFO[2024-09-03T16:23:10.189] [192.168.100.111][omm] 终止用户 "omm" 的所有进程      
INFO[2024-09-03T16:23:10.222] [192.168.100.111][omm] 删除用户"omm"             
INFO[2024-09-03T16:23:10.255] 卸载成功