PTK安装部署Mogdb

1、PTK 简介

• PTK (Provisioning Toolkit)是一款针对 MogDB 数据库开发的软件安装和运维工具，旨在帮助用户更便捷地安装部署MogDB数据库。
• 如果用户想要运行 MogDB 或者 MogDB 的相关组件时，仅需要执行一行命令即可实现。

2、离线安装PTK

• 1）根据操作系统版本，下载对应压缩包，上传到服务器，解压后会得到一个名为ptk的二进制文件，该文件即为PTK的可执行文件

[root@raca1 ~]# tar -xzvf ptk_linux_x86_64.tar.gz
[root@raca1 ~]# ll
total 73112
-rwxr-x--- 1 root root 55201792 Jun 16 17:33 ptk
-rw-r--r-- 1 root root 19659690 Jun 27 08:34 ptk_linux_x86_64.tar.gz
-rw-r----- 1 root root      237 Nov 29  2022 README.md

• 2）执行ptk命令后，会在安装目录下生成 .ptk目录下，该目录以后会作为 PTK 工具的工作目录， 其产生的缓存文件、数据文件以及集群的配置信息，备份信息等文件均会存储到该目录下

[root@raca1 ~]# cd .ptk/
[root@raca1 .ptk]# ll
total 4
drwx------ 2 root root   6 Jun 27 08:42 cache
drwx------ 2 root root   6 Jun 27 08:42 data
drwx------ 2 root root   6 Jun 27 08:42 log
-rw-r----- 1 root root 111 Jun 27 08:42 metadata.yml

• 3）将ptk文件移动到合适的目录（推荐 $HOME/.ptk/bin/ 目录，需手动创建），然后将所在所在目录添加到 PATH 环境变量中， 这样在用户登录到服务器后就可以直接使用 ptk 指令了

[root@raca1 .ptk]# mkdir bin
[root@raca1 .ptk]# mv ../ptk bin/
[root@raca1 .ptk]# ll
total 4
drwxr-x--- 2 root root  17 Jun 28 15:10 bin
drwx------ 2 root root   6 Jun 27 08:42 cache
drwx------ 2 root root   6 Jun 27 08:42 data
drwx------ 2 root root   6 Jun 28 15:07 log
-rw-r----- 1 root root 111 Jun 28 15:07 metadata.yml
[root@raca1 .ptk]# cd bin/
[root@raca1 bin]# ll
total 53908
-rwxr-x--- 1 root root 55201792 Jun 16 17:33 ptk
[root@raca1 bin]# vim ~/.bash_profile 
[root@raca1 bin]# source ~/.bash_profile    
[root@raca1 bin]# ptk --version
PTK Version:	v0.8.4 release
Go Version:	go1.19.4
Build Date:	2023-06-16T17:33:00
Git Hash:	c0f0c7b
OS/Arch:	linux/amd64

3、使用PTK安装单节点Mogdb

3.1 准备配置文件

• 编辑配置文件config.yaml

# config.yaml
global:
    cluster_name: mogdb1
    user: omm
    group: omm
    base_dir: /opt/mogdb
db_servers:
    - host: 127.0.0.1
      db_port: 26000

• 如果全部使用默认值，则PTK 执行以下操作：
  • 在本机安装数据库;
  • 运行数据库的操作系统用户为omm ，用户组名称也是omm，该用户没有默认密码；
  • 数据库安装在 /opt/mogdb目录下，在该目录下会创建4个目录：app, data, log, tool，分别用于存储数据库软件、数据文件、数据库日志和数据库相关工具；
  • 数据库监听端口为26000；

3.2检查本机系统

ptk checkos -f config.yaml
ptk checkos -f config.yaml --detail

• 确保输出的检查结果均为 OK 或者 Warning ，如果有 Abnormal 或 ExecuteError出现，需用户根据日志提示先修正系统参数。

• 如果有 Abnormal 检查项，ptk 会自动生成一个 root_fix_***.sh 文件，可用于快速修正系统参数；如果有 ExecuteError 检查项，代表 ptk 执行失败，需要用户根据错误信息调整系统环境。

3.3 离线安装Mogdb

• 下载Mogdb安装包https://www.mogdb.io/downloads/allDownload
• 使用PTK安装

[root@raca1 ~]# ptk install -f config.yaml --pkg ./MogDB-3.1.0-CentOS-x86_64.tar.gz

.....
INFO[2023-06-29T17:19:17.959] time elapsed: 48s                            

  cluste_name |     host     | user | port  |    status     | message  
--------------+--------------+------+-------+---------------+----------
  mogdb1      | 10.62.228.76 | omm  | 26000 | start_success | success  

• 安装成功后，查看实例信息

[root@raca1 ~]# 
[root@raca1 ~]# ptk ls
  cluster_name |  id  |        addr        | user |    data_dir     |          db_version          |     create_time     | comment  
---------------+------+--------------------+------+-----------------+------------------------------+---------------------+----------
  mogdb1       | 6001 | 10.62.228.76:26000 | omm  | /opt/mogdb/data | MogDB 3.1.0 (build 3ddb00f7) | 2023-06-29T17:18:47 | 

4、登录数据库

• 登录mogdb

[root@raca1 ~]# su - omm
[omm@raca1 ~]$ gsql -d postgres -p 26000
gsql ((MogDB 3.1.0 build 3ddb00f7) compiled at 2022-12-28 22:27:13 commit 0 last mr  )
Non-SSL connection (SSL connection is recommended when requiring high-security)
Type "help" for help.

MogDB=# \l
                                 List of databases
   Name    | Owner | Encoding | Collate | Ctype | Access privileges | Compatibility 
-----------+-------+----------+---------+-------+-------------------+---------------
 postgres  | omm   | UTF8     | C       | C     |                   | A
 template0 | omm   | UTF8     | C       | C     | =c/omm           +| A
           |       |          |         |       | omm=CTc/omm       | 
 template1 | omm   | UTF8     | C       | C     | =c/omm           +| A
           |       |          |         |       | omm=CTc/omm       | 
(3 rows)

MogDB=#