准备离线组件包
在官方下载页面选择对应版本的 TiDB server
离线镜像包(包含 TiUP 离线组件包)。需要同时下载 TiDB-community-server
软件包和 TiDB-community-toolkit
软件包。
部署离线环境TiUP组件
将离线包传至服务器,执行以下命令安装 TiUP 组件:
tar zxvf tidb-community-server-v8.3.0-linux-amd64.tar.gz
cd tidb-community-server-v8.3.0-linux-amd64/
sh local_install.sh
合并离线包
因为是是通过官方下载页面下载的离线软件包,需要将 TiDB-community-server 软件包和 TiDB-community-toolkit 软件包合并到离线镜像中。
tar xf tidb-community-toolkit-v8.3.0-linux-amd64.tar.gz
ls -ld tidb-community-server-v8.3.0-linux-amd64 tidb-community-toolkit-v8.3.0-linux-amd64
cd tidb-community-server-v8.3.0-linux-amd64/
cp -rp keys ~/.tiup/
tiup mirror merge ../tidb-community-toolkit-v8.3.0-linux-amd64
初始化集群拓扑文件
执行如下命令,生成集群初始化配置文件:
tiup cluster template > topology.yaml
可以参考下面内容:
# # Global variables are applied to all deployments and used as the default value of
# # the deployments if a specific deployment value is missing.
global:user: "root"ssh_port: 22deploy_dir: "/tidb-deploy"data_dir: "/tidb-data"
pd_servers:- host: 192.168.33.33
tidb_servers:- host: 192.168.33.33
tikv_servers:- host: 192.168.33.33
monitoring_servers:- host: 192.168.33.33
grafana_servers:- host: 192.168.33.33
alertmanager_servers:- host: 192.168.33.33
配置免密互信
命令行输入:visudo
在文件末尾添加:tidb ALL=(ALL) NOPASSWD:ALL
执行部署命令
检查环境
执行部署命令前,先使用 check 及 check --apply 命令检查和自动修复集群存在的潜在风险:
tiup cluster check ./topology.yaml --user root -p
如果提示潜在风险,可以执行 自动修复潜在风险命令:
tiup cluster check ./topology.yaml --apply --user root -p
注:如果无法自动修复,需要手动一项一项修复。
最终如下图所示:
部署TiDB
其中tidb-test
是集群名称,可修改
tiup cluster deploy tidb-test v8.3.0 ./topology.yaml --user root -p
提示:
查看TiDB管理的集群情况
命令:tiup cluster list
TiUP 支持管理多个 TiDB 集群,该命令会输出当前通过 TiUP cluster 管理的所有集群信息,包括集群名称、部署用户、版本、密钥信息等。
检查部署的 TiDB 集群情况
命令:tiup cluster display tidb-test
预期输出包括 tidb-test 集群中实例 ID、角色、主机、监听端口和状态(由于还未启动,所以状态为 Down/inactive)、目录信息。
启动集群
安全启动是 TiUP cluster 从 v1.9.0 起引入的一种新的启动方式,采用该方式启动数据库可以提高数据库安全性。推荐使用安全启动。安全启动后,TiUP 会自动生成 TiDB root 用户的密码,并在命令行界面返回密码。
注意:使用安全启动方式后,不能通过无密码的 root 用户登录数据库,你需要记录命令行返回的密码进行后续操作。该自动生成的密码只会返回一次,如果没有记录或者忘记该密码,请参照忘记 root 密码修改密码。
安全启动:tiup cluster start tidb-test --init
验证集群运行状态
命令:tiup cluster display tidb-test
预期结果输出:各节点 Status 状态信息为 Up 说明集群状态正常。
使用可视化工具连接数据库
DBeaver
服务器地址:192.168.33.33
端口:4000
用户名:root
密码:***** (该密码是启动集群是输出的密码)
停止集群
命令:tiup cluster stop tidb-test
清理数据
命令:tiup cluster clean tidb-test --all
卸载集群
命令:tiup cluster destroy tidb-test