Step by Step 平凯数据库敏捷模式部署

作者： 山佳山佳原文来源：https://tidb.net/blog/59ace784

1、准备机器等相关软硬件配置

【操作系统】Rocky Linux release 8.10 (Green Obsidian)

【部署方式】本地虚拟机 8C 16G

2、部署前准备：

关闭防火墙以及 Selinux

安装 openssh

3、下载对应的安装包

以及敏捷安装包：

4、安装 TEM

#编辑元数据库配置文件[root@shanjiatst tem-package-v3.1.0-linux-amd64]# cp metadb_topology_template.yaml metadb_topology.yaml[root@shanjiatst tem-package-v3.1.0-linux-amd64]# vi metadb_topology.yaml[root@shanjiatst tem-package-v3.1.0-linux-amd64]# cat metadb_topology.yamlglobal:     user: "tidb"     ssh_port: 22     deploy_dir: "/data/TEM/tidb-deploy"     data_dir: "/data/TEM/tidb-data"     arch: "amd64"   pd_servers:       - host: 192.168.40.130   tidb_servers:       - host: 192.168.40.130           port: 4000   tikv_servers:       - host: 192.168.40.130

###TEM 配置参数[root@shanjiatst tem-package-v3.1.0-linux-amd64]# vi config.yaml[root@shanjiatst tem-package-v3.1.0-linux-amd64]# cat config.yamlglobal:     user: "tidb"     group: "tidb"     ssh_port: 22     deploy_dir: "/data/TEM/tem-deploy"     data_dir: "/data/TEM/tem-data"     arch: "amd64"     log_level: "info"     enable_tls: false   server_configs: #这里指定tem 节点的全局配置  tem_servers:       db_addresses: "192.168.40.130:4000"       db_u: "root"       db_pwd: ""       db_name: "test"       log_filename: "/data/TEM/tem-deploy/tem-server-8080/log/tem.log"       log_tem_level: "info"       log_max_size: 300       log_max_days: 30       log_max_backups: 0tem_servers:     - host:  "192.168.40.130"         port: 8080     mirror_repo: true # 是否开启镜像仓库，多个TEM节点时，最多只允许一个节点的开启###config.yaml中的db_addresses字段填写的套接字要加4000端口，否则默认3306#最开始配置配置4000端口是报错如下：

执行部署 TEM 命令；

为了避免部署时出现异常，请确保部署 TEM 的所有主机上没有被部署其他的 TiUP 软件

# 使⽤ root 或者具有 sudo 权限的账户执⾏该脚本。

sudo ./install.sh

安装过程，本次不做展示，有如下信息是说明安装成功。

验证：

5、登录 TEM 验证

登录 TEM：(登录进去会发现后边的内容和上篇TEM on 腾讯云 Step by Step 丝滑体验) 内容相似

默认账号密码：admin/admin

登陆后界面：

![图示

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522906018.png)

二、用 TEM 部署平凯数据库敏捷模式

1. 点击“设置 -> 凭证 -> 主机 -> 添加凭证”

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522906019.png)

1. 填写被控主机 / 中控机的 ssh 登录凭证，点击“确认”添加

![图形用户界面

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522906053.png)

 3、已经创建好凭证

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522906047.png)

二：下载敏捷模式安装包，进行组件管理

前面已经介绍过敏捷模式安装包，现在直接进行配置

1、点击“设置 -> 组件管理 -> 添加组件”

![图形用户界面, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522941969.png)

 2、选择“组件镜像”

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522941969.png)

 3、选择本地上传（上传刚下载的平凯数据库敏捷模式安装包）

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942074.png)

上传后的组件管理界面：

![图形用户界面, 应用程序, Teams

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942069.png)

PS：这个安装包是从 Win 本地上传的，

三、配置中控机

接下来配置集群中控机，配置步骤如下：

1. 点击“主机 -> 集群管理中控机 -> 添加中控机”

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942067.png)

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942075.png)

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522941970.png)

四、配置集群主机

1. 点击“主机 -> 主机 -> 添加共享主机”

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942076.png)

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942112.png)

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942118.png)

五、创建集群

1. 点击“集群 -> 创建集群”

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522942118.png)

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522941974.png)

密码：testroot123

根据需求选择部署模式为“专用”或“共享”，并选择主机规格，选择集群种类: 敏捷模式

其余选项默认配置即可，点击下一步

规划集群节点：

点击添加节点，进行具体规划

选择组件和要部署的主机后，点击确定，进行下一个组件的添加

注意：

PingKaiDB Fusion：必须添加（节点配额限制为 10）

Grafana：必须添加（才能使用监控功能）

Prometheus 以及 Alertmanager：必须添加（才能使用告警功能）

TiFlash：可选（如果需要测试平凯数据库敏捷模式的 HTAP 功能，需要添加）

Pump 和 Drainer 组件：不建议添加

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981253.png)

1. 当添加完需要的组件后，点击“回到规划集群节点页面”按钮

![图形用户界面

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981254.png)

1. 点击“下一步”按钮，进行集群节点的配置修改和预检查

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981254.png)

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981253.png)

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981253.png) ![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981254.png)

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981291.png)

![图片包含 文本

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981309.png)

解决修改方法：调整端口即可

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981319.png)

    如果检查时出现端口冲突的问题， 请将端口号修改为一个未使用过的；一般情况下，端口和目录的名称是保持一致的，但如果只改了端口没有改目录，则会出现“目录已存在”的警告，若想覆盖该目录中的数据，则可勾选下面的“预检查选项”。

配置集群参数和告警

  默认参数模版和告警模版即可，点击下一步

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981256.png)

预览创建配置，确认无误后点击“创建”按钮启动创建任务![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981257.png)

创建过程的具体日志可点击“查看详情”，或在“任务中心”中点击相应的任务进行查看

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981256.png)

集群创建并纳管成功

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981332.png)

![图形用户界面, 文本, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981315.png)

![图形用户界面, 文本, 应用程序, 电子邮件

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981309.png)

![图形用户界面, 应用程序

AI 生成的内容可能不正确。](https://tidb-blog.oss-cn-beijing.aliyuncs.com/media/unnamed-1755522981345.png)

 总结：

本次通过 TiDB 敏捷模式的单机本地部署体验，我对 TiDB 的核心特性和基础操作建立了直观认知，为后续进阶学习生产环境部署奠定了实践基础。这种极简部署方案具有以下显著优势：极致轻量：TEM 单机本地版部署模式，仅需 VMware 虚拟机环境即可快速搭建效率卓越：从安装到可用仅需 10-20 分钟，实现真正的 ” 开箱即用 ” 体验学习友好：零基础也可快速上手，完美适配个人开发测试场景，特别适合初学者快速建立 TiDB 认知这种低门槛的体验方式，有效解决了分布式数据库的学习曲线陡峭问题，是 TiDB 技术入门的最佳起点。建议所有有意向了解分布式数据库的技术人员，都可以从此模式开始探索之旅。