4.3 PTK方式安装.txt - 墨天轮文档

4.3 PTK方式安装.txt

李宏达

184

4页

0次

2022-10-19

100墨值下载

# 一、通过 PTK 安装数据库

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

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

便捷地安装部署 MogDB 数据库。

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

```s

[root@hostname ~]# ptk candidate os

software | version

-----------+--------------------------------------

OS | CentOS 7 (x86_64)

| CentOS 8 (arm64)

| CentOS 8 (x86_64)

| EulerOS 2 (arm64)

| EulerOS 2 (x86_64)

| Kylin V10 (arm64)

| Kylin V10 (x86_64)

| NeoKylin V7 (x86_64)

| Oracle Linux 7 (x86_64)

| Oracle Linux 8 (x86_64)

| Red Hat Enterprise Linux 7 (x86_64)

| Red Hat Enterprise Linux 8 (x86_64)

| Rocky Linux 7 (x86_64)

| Rocky Linux 8 (x86_64)

| SLES 12 (arm64)

| UOS 20 (arm64)

| UOS 20 (x86_64)

| Ubuntu 18 (x86_64)

| openEuler 20 (arm64)

| openEuler 20 (x86_64)

| openEuler 22 (arm64)

| openEuler 22 (x86_64)

```

> 注意：PTK 工具本身可以在多种操作系统中运行，支持 Linux，macOS，Windows，但是由于 MogDB 目

前仅支持在 Linux 系统中运行，因此需确保要运行 MogDB 数据库的服务器为 Linux 操作系统。

## 1. 安装准备

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

(https://docs.mogdb.io/zh/mogdb/v3.0/environment-requirement)和[操作系统配置]

(https://docs.mogdb.io/zh/mogdb/v3.0/os-configuration)。

下载安装 PTK

有关 PTK 安装，请访问[安装 PTK](https://docs.mogdb.io/zh/ptk/v0.4/install)。

## 2. 通过 PTK 安装 MogDB

**准备拓扑配置文件**

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

一主一备节点安装为例。

- 单节点安装

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

- 主备节点安装

```yaml

# 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 登录密码]

- host: 192.168.0.2

db_port: 26000

role: standby

ssh_option:

port: 22

user: root

password: [此处填写 SSH 登录密码]

```

## 3. 检查本机系统

```s

ptk checkos -f config.yaml

```

确保输出的检查结果均为 OK 或者 Warning ，如果有 Abnormal 或 ExecuteError 出现，需用户根据日

志提示先修正系统参数。

## 4. 执行安装

```s

ptk install -f config.yaml

```

默认会安装当前已经正式发布的 MogDB 最新版本，版本号可以在 MogDB 官网下载页面查询。安装过程中会

提示用户输入数据库初始用户的密码，请用户自行记录并安全保存。PTK 自动完成所有安装操作后，会启动

数据库实例。

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

该安装包进行数据库安装。

```s

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

```

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

```s

[root@hostname]# ptk ls

cluster_name | instances | user | data_dir | db_version

---------------+--------------------+------+-----------------+--------------

mogdb1 | 172.16.0.127:26000 | omm | /opt/mogdb/data | MogDB-3.0.1

```

## 5. 访问数据库

```s

su - omm

gsql -d postgres -p 26000

```

## 6. 通过 PTK 卸载 MogDB

```s

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

```

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

```s

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

```

在卸载前，PTK 会交互式的询问用户，以确认要删除的数据库信息，确认是否要连带删除系统用户，以及确

认是否要连带删除数据库数据。请在回答每一个问题时，确认你的回答，避免由于误操作导致不可恢复的数据

丢失！

在 PTK 执行数据库卸载操作时，如果用户指定了删除数据目录，PTK 仅会删除数据目录，不会删除数据目录

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

```s

[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

of 4

100墨值下载

lession

相关文档

评论