作者： xuexiaogang 原文来源：https://tidb.net/blog/98afe959

以前学习的时候还是 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 tidbpasswd tidb

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

在操作系统命令行执行 visudo

加入以下内容：

tidb ALL=(ALL) NOPASSWD: ALL

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

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

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

将下载完的 tidb-community-server-v8.5.1-linux-amd64.tar.gztidb-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.gztar -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.shDisable telemetry success

Successfully set mirror to /setup/tidb-community-server-v8.5.1-linux-amd64Detected shell: bashShell profile: /home/tidb/.bash_profile/home/tidb/.bash_profile has been modified to to add tiup to PATHopen a new terminal or source /home/tidb/.bash_profile to use itInstalled path: /home/tidb/.tiup/bin/tiup

\===============================================

1. source /home/tidb/.bash_profile

2. Have a try: tiup playground===============================================

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

source /home/tidb/.bash_profile

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

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

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

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

这点上官方文档上倒是可以参考。global:user: “tidb”ssh_port: 22deploy_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.6tidb_servers:

• host: 10.0.1.7

• host: 10.0.1.8

• host: 10.0.1.9tikv_servers:

• host: 10.0.1.1

• host: 10.0.1.2

• host: 10.0.1.3monitoring_servers:

• host: 10.0.1.4grafana_servers:

• host: 10.0.1.4alertmanager_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 的客户端进行登录验证就可以了。