文档中心MogDBMogDB StackUqbar
生态工具
文档工具
EN
v3.1

文档:v3.1

支持的版本:
最新(v5.0)/
v3.1/
v3.0

其他版本:
v2.1/
v2.0/
v1.1

PTK方式安装

本文介绍如何使用PTK安装 MogDB 数据库。

PTK (Provisioning Toolkit)是一款针对 MogDB 数据库开发的软件安装和运维工具，旨在帮助用户更便捷地安装部署MogDB数据库。

可执行如下命令查看PTK支持安装MogDB的操作系统。

[root@hostname ~]# ptk candidate os
  software |               version                
-----------+--------------------------------------
  OS       | CentOS Linux 7 (Core) (x86_64)                     
           | CentOS 8 (x86_64)
           | CentOS 8 (arm64)                     
           | openEuler 20 (x86_64)                 
           | openEuler 20 (arm64)           
           | openEuler 22 (x86_64)                 
           | openEuler 22 (arm64)                    
           | Kylin V10 (x86_64)                  
           | Kylin V10 (arm64)                   
           | UOS 20 A (x86_64)              
           | UOS 20 A (arm64)                
           | UOS 20 D/E (x86_64)             
           | UOS 20 D/E (arm64)              
           | Ubuntu 18.04.6 LTS (x86_64) 
           | Ubuntu 18.04.6 LTS (arm64)
           | Ubuntu 20 (x86_64)        
           | Ubuntu 20.04.5 LTS (arm64)
           | Ubuntu 22 (x86_64)
           | Ubuntu 22.04.1 LTS (arm64)
           | Red Hat Enterprise Linux 7 (x86_64)
           | Red Hat Enterprise Linux 8 (x86_64)
           | Red Hat Enterprise Linux 8.2 (Ootpa) (arm64)
           | Red Hat Enterprise Linux 9.0 (Plow) (x86_64)
           | Red Hat Enterprise Linux 9.0 (Plow) (arm64)
           | EulerOS 2 (x86_64)
           | EulerOS 2 (arm64)
           | SLES 12SP5 (x86_64)
           | SUSE Linux Enterprise Server 15 SP4 (x86_64)
           | Oracle Linux 7 (x86_64)
           | Oracle Linux 8 (x86_64) 
           | Rocky Linux 8 (x86_64) 
           | NeoKylin V7 (x86_64) 
           | FusionOS 22 (x86_64) 
           | FusionOS 22 (arm64)  
           | Debian GNU/Linux 10 (buster) (x86_64)
           | Debian GNU/Linux 10 (buster) (arm64)
           | Debian GNU/Linux 11 (bullseye) (x86_64)
           | Debian GNU/Linux 11 (bullseye) (arm64)

注意：PTK工具本身可以在多种操作系统中运行，支持Linux，macOS，Windows，但是由于 MogDB 目前仅支持在Linux 系统中运行，因此需确保要运行MogDB数据库的服务器为 Linux 操作系统。

安装准备

有关环境要求和操作系统配置详情，请参见环境要求和操作系统配置。

下载安装 PTK

有关PTK安装，请访问安装PTK。

通过PTK安装MogDB

准备拓扑配置文件

PTK安装需要用户提供配置文件config.yaml，PTK支持单节点安装以及多节点安装。下面以单节点安装和一主一备节点安装为例。

单节点安装

# 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；

主备节点安装

# config.yaml
global:
    cluster_name: mogdb_cluster1
    user: omm
    group: omm
    base_dir: /opt/mogdb
db_servers:
    - host: 192.168.0.1
      db_port: 26000
      role: primary
      ssh_option:
        port: 22
        user: root
        password: [此处填写SSH登录密码，密码需要通过 ptk encrypt 加密后填写]
    - host: 192.168.0.2
      db_port: 26000
      role: standby
      ssh_option:
        port: 22
        user: root
        password: [此处填写SSH登录密码，密码需要通过 ptk encrypt 加密后填写]

检查本机系统

ptk checkos -f config.yaml

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

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

执行安装

ptk install -f config.yaml

默认会安装当前已经正式发布的 MogDB 最新版本，版本号可以在 MogDB 官网下载页面查询。安装过程中会提示用户输入数据库初始用户的密码，请用户自行记录并安全保存。PTK 自动完成所有安装操作后，会启动数据库实例。

PTK 也支持自定义安装包，可以通过手工下载安装包，指定安装。例如执行以下命令，将使用当前目录下的该安装包进行数据库安装。

ptk install -f config.yaml --pkg ./MogDB-3.1.0-openEuler-arm64.tar.gz

安装成功后，可以通过 ptk ls 来查看安装的实例信息。

[root@hostname]# ptk ls
  cluster_name |     instances      | user |    data_dir     | db_version   
---------------+--------------------+------+-----------------+--------------
  mogdb1       | 172.16.0.127:26000 | omm  | /opt/mogdb/data | MogDB-3.1.0

访问数据库

su - omm
gsql -d postgres -p 26000

通过PTK卸载MogDB

注意：数据库卸载后无法恢复，请谨慎操作。

执行如下命令卸载数据库：

ptk uninstall (-f CONFIG.YAML|--name CLUSTER_NAME)

在卸载前，PTK 会交互式的询问用户，以确认要删除的数据库信息，确认是否要连带删除系统用户，以及确认是否要连带删除数据库数据。请在回答每一个问题时，确认你的回答，避免由于误操作导致不可恢复的数据丢失！

在 PTK 执行数据库卸载操作时，如果用户指定了删除数据目录，PTK 仅会删除数据目录，不会删除数据目录所在的父目录，需用户手动清理父目录。

卸载成功后，将提示如下信息：

[root@hostname]# ptk uninstall -n mogdb1
=============================
global:
  cluster_name: mogdb1
  user: omm
  group: omm
  app_dir: /opt/mogdb/app
  data_dir: /opt/mogdb/data
  log_dir: /opt/mogdb/log
  tool_dir: /opt/mogdb/tool
  tmp_dir: /opt/mogdb/tmp
db_servers:
- host: 172.16.0.127
  db_port: 26000
  role: primary
  az_name: AZ1
  az_priority: 1

=============================
Do you really want to uninstall this cluster? Please confirm carefully[Y|Yes](default=N) y
Do you want to delete db data '/opt/mogdb/data'?[Y|Yes](default=N) y
Do you want to delete user 'omm'?[Y|Yes](default=N) y
INFO[2022-07-08T10:27:42.820] check db dirs owner                           host=172.16.0.127
INFO[2022-07-08T10:27:42.828] clean crontab                                 host=172.16.0.127
INFO[2022-07-08T10:27:42.894] kill omm's processes                          host=172.16.0.127
INFO[2022-07-08T10:27:42.970] remove files /opt/mogdb/app,/opt/mogdb/tool,/opt/mogdb/cm,/opt/mogdb/tmp,/opt/mogdb/data,/opt/mogdb/log  host=172.16.0.127
INFO[2022-07-08T10:27:43.073] delete os user omm                            host=172.16.0.127
INFO[2022-07-08T10:27:43.213] clearing /etc/cron.allow                      host=172.16.0.127
INFO[2022-07-08T10:27:43.217] clearing /etc/security/limits.conf            host=172.16.0.127

注意：使用配置文件来卸载的前提是配置文件还存在。使用集群名称来指定的前提是 ptk ls 可以正常查询到该集群。

相关页面

有关PTK工具详细使用手册，请访问关于PTK。

首页

反馈
Copyright © 2011-2024 www.enmotech.com All rights reserved.