当前位置：首页 > article >正文

保姆级离线TiDB V8+解释

article 2026/3/5 8:57:30

以前学习的时候还是3版本，如今已经是8版本了

https://cn.pingcap.com/product-community/?_gl=1ujh2l9_gcl_auMTI3MTI3NTM3NC4xNzM5MjU3ODE2_gaMTYwNzE2NTI4OC4xNzMzOTA1MjUz_ga_3JVXJ41175MTc0MTk1NTc1OC4xMS4xLjE3NDE5NTU3NjIuNTYuMC41NDk4MTMxNTM._ga_CPG2VW1Y41*MTc0MTk1NTc2MC4xMS4xLjE3NDE5NTU3NjMuMC4wLjA.

不过现在这个版本为长期支持版本 (Long-Term Support Release, LTS)那么就不用担心迭代太快的问题了。而且现在的安装应该比较友好（事实也是如此）一天安装了两套总结了一下过程。有些问题（主要是注释）在文档中没有解释，我来解释一下。

顺便说一下，我这里是麒麟的操作系统，TiDB这个是适配的。整个过程中没有因为操作系统的问题出现问题。
将这两个下载后上传到一台（注意是一台就够了，即使你的TiDB是满配置的十几台机器，只要上传一台剩下的交给TiUP）

第一步修改密码复杂度并创建用户

用vim修改/etc/pam.d/system-auth文件

找到 password requisite pam_cracklib.so这么一行替换成如下：
password requisite pam_cracklib.so retry=5 difok=3 minlen=10 ucredit=-1 lcredit=-3 dcredit=-3 dictpath=/usr/share/cracklib/pw_dict

之所以把这步加进来是因为免得复杂密码影响心情以及后续维护工作量增加。

useradd tidb
passwd tidb

创建tidb用户，并且设置密码。（现在知道上面那步的用意了吧）
（注意是一台就够了，即使你的TiDB是满配置的十几台机器，只要设置一台剩下的交给TiUP）

在操作系统命令行执行visudo

加入以下内容：

tidb ALL=(ALL) NOPASSWD: ALL

在主控机上生成密钥，为了和其他机器做免密登录
ssh-keygen -t rsa

执行复制发送密码（主控机自己给自己的IP也要发一遍）
ssh-copy-id root@10.60.143.154
ssh-copy-id root@10.60.143.155
ssh-copy-id root@10.60.143.156

第二步上传安装介质并解压执行命令

将下载完的
tidb-community-server-v8.5.1-linux-amd64.tar.gz
tidb-community-toolkit-v8.5.1-linux-amd64.tar.gz
上传到主控机（TiDB集群中的一台机器上，可以任意选择。我一般选择IP地址最靠前的那个）

在主控机上用root用户建立一个目录，我通常叫/setup。集中管理。
建立好以后要执行

chown tidb:tidb -R /setup
这是为了等下tidb用户可以在这个目录中大有可为。
将文件上传到这个目录一下。
su - tidb
在tidb用户下执行
tar -zxvf tidb-community-server-v8.5.1-linux-amd64.tar.gz
tar -zxvf tidb-community-toolkit-v8.5.1-linux-amd64.tar.gz

解压完成后。切换到tidb-community-server-v8.5.1-linux-amd64目录。
cd tidb-community-server-v8.5.1-linux-amd64

执行下面的命令，并且得到下面的结果。
sh local_install.sh
Disable telemetry success

Successfully set mirror to /setup/tidb-community-server-v8.5.1-linux-amd64
Detected shell: bash
Shell profile: /home/tidb/.bash_profile
/home/tidb/.bash_profile has been modified to to add tiup to PATH
open a new terminal or source /home/tidb/.bash_profile to use it
Installed path: /home/tidb/.tiup/bin/tiup

===============================================

source /home/tidb/.bash_profile
Have a try: tiup playground
===============================================

官方的工具也算是保姆级了，让用户执行一下上面的命令。

source /home/tidb/.bash_profile

不过我觉得是不是如果工具能顺便也做了就更好了。

第三步生成配置模版预安装

执行下面命令获得模板
tiup cluster template > topology.yaml

然后vim 这个yaml文件。里面主要是配置各个组件的地址。

这点上官方文档上倒是可以参考。
global:
user: “tidb”
ssh_port: 22
deploy_dir: “/tidb-deploy”
data_dir: “/tidb-data”
server_configs: {}
pd_servers:

host: 10.0.1.4
host: 10.0.1.5
host: 10.0.1.6
tidb_servers:
host: 10.0.1.7
host: 10.0.1.8
host: 10.0.1.9
tikv_servers:
host: 10.0.1.1
host: 10.0.1.2
host: 10.0.1.3
monitoring_servers:
host: 10.0.1.4
grafana_servers:
host: 10.0.1.4
alertmanager_servers:
host: 10.0.1.4

每个host写自己的规划IP。如果这个组件只打算安装一个，那么就写一个地址。其他的注释掉。
如果注释不干净，在安装时候还有问题。所以推荐大家不用的就删除吧。

预安装检查
tiup cluster check /setup/tidb-community-server-v8.5.1-linux-amd64/topology.yaml --user tidb -p

然后让你输入tidb的密码

实际上这里user后面官网是root，其实也应该是root。他会给你创建tidb用户。

他会告诉你，还有哪些问题影响安装的。

看着有问题不用害怕。下面是一个亮点
tiup cluster check /setup/tidb-community-server-v8.5.1-linux-amd64/topology.yaml --apply --user tidb -p

执行这个命令后，遇到的问题tiup帮你修复，不用我们干预。这个就非常友好了。最后剩下numactl的错误无法修复但是不影响安装。

第四步安装和测试

前面的准备工作做完了，就可以执行安装了。注意deploy 后面一定是两个字符串，一个是集群名字（自定义）还有一个是版本号。这是为了日后维护好。请如实填写。

tiup cluster deploy tidbtest v8.5.1 /setup/tidb-community-server-v8.5.1-linux-amd64/topology.yaml --user tidb -p

最后经过一些操作，出现了sccuess的字样说明安装成功。并且随机生成了一个管理员密码。相比较之前都是空密码登录，在安全上多了一步。

执行下面两个命令检查集群状况

tiup cluster list

tiup cluster display tidbtest

至此完成。找一个MySQL的客户端进行登录验证就可以了。