diff --git a/check-before-deployment.md b/check-before-deployment.md
index e273210b7b8f..8b5ccd985a50 100644
--- a/check-before-deployment.md
+++ b/check-before-deployment.md
@@ -12,10 +12,6 @@ category: how-to
生产环境部署,建议使用 EXT4 类型文件系统的 NVME 类型的 SSD 磁盘存储 TiKV 数据文件。这个配置方案为最佳实施方案,其可靠性、安全性、稳定性已经在大量线上场景中得到证实。
-> **注意:**
->
-> 推荐 TiKV 部署目标机器的数据目录使用 EXT4 文件系统格式。相比于 XFS 文件系统格式,EXT4 文件系统格式在 TiDB 集群部署案例较多,生产环境优先选择使用 EXT4 文件系统格式。
-
使用 `root` 用户登录目标机器,将部署目标机器数据盘格式化成 ext4 文件系统,挂载时添加 `nodelalloc` 和 `noatime` 挂载参数。`nodelalloc` 是必选参数,否则 TiUP 安装时检测无法通过;`noatime` 是可选建议参数。
> **注意:**
@@ -126,7 +122,7 @@ sysctl -p
## 检测及关闭目标部署机器的防火墙
-本段介绍如何关闭目标主机防火墙配置,因为在 TiDB 集群中,需要将节点间的访问端口打通才可以保证读写请求、数据心跳等信息的正常的传输。在普遍线上场景中,数据库到业务服务和数据库节点的网络联通都是在安全域内完成数据交互。如果没有特殊安全的要求,建议将目标节点的防火墙进行关闭。否则建议[按照端口使用规则](/hardware-and-software-requirements.md),将端口信息配置到防火墙服务的白名单中。
+本段介绍如何关闭目标主机防火墙配置,因为在 TiDB 集群中,需要将节点间的访问端口打通才可以保证读写请求、数据心跳等信息的正常的传输。在普遍线上场景中,数据库到业务服务和数据库节点的网络联通都是在安全域内完成数据交互。如果没有特殊安全的要求,建议将目标节点的防火墙进行关闭。否则建议[按照端口使用规则](/hardware-and-software-requirements.md#网络要求),将端口信息配置到防火墙服务的白名单中。
1. 检查防火墙状态(以 CentOS Linux release 7.7.1908 (Core) 为例)
@@ -165,6 +161,8 @@ sysctl -p
TiDB 是一套分布式数据库系统,需要节点间保证时间的同步,从而确保 ACID 模型的事务线性一致性。目前解决授时的普遍方案是采用 NTP 服务,可以通过互联网中的 `pool.ntp.org` 授时服务来保证节点的时间同步,也可以使用离线环境自己搭建的 NTP 服务来解决授时。
+采用如下步骤检查是否安装 NTP 服务以及与 NTP 服务器正常同步:
+
1. 执行以下命令,如果输出 `running` 表示 NTP 服务正在运行:
{{< copyable "shell-regular" >}}
@@ -179,67 +177,57 @@ TiDB 是一套分布式数据库系统,需要节点间保证时间的同步,
Active: active (running) since 一 2017-12-18 13:13:19 CST; 3s ago
```
-2. 执行 `ntpstat` 命令,如果输出 `synchronised to NTP server`(正在与 NTP server 同步),表示在正常同步:
-
- {{< copyable "shell-regular" >}}
-
- ```bash
- ntpstat
- ```
-
- ```
- synchronised to NTP server (85.199.214.101) at stratum 2
- time correct to within 91 ms
- polling server every 1024 s
- ```
+2. 执行 `ntpstat` 命令检测是否与 NTP 服务器同步:
> **注意:**
>
> Ubuntu 系统需安装 `ntpstat` 软件包。
-- 以下情况表示 NTP 服务未正常同步:
-
{{< copyable "shell-regular" >}}
```bash
ntpstat
```
- ```
- unsynchronised
- ```
+ - 如果输出 `synchronised to NTP server`,表示正在与 NTP 服务器正常同步:
-- 以下情况表示 NTP 服务未正常运行:
+ ```
+ synchronised to NTP server (85.199.214.101) at stratum 2
+ time correct to within 91 ms
+ polling server every 1024 s
+ ```
- {{< copyable "shell-regular" >}}
+ - 以下情况表示 NTP 服务未正常同步:
- ```bash
- ntpstat
- ```
+ ```
+ unsynchronised
+ ```
- ```
- Unable to talk to NTP daemon. Is it running?
- ```
+ - 以下情况表示 NTP 服务未正常运行:
-- 如果要使 NTP 服务尽快开始同步,执行以下命令。可以将 `pool.ntp.org` 替换为你的 NTP server:
+ ```
+ Unable to talk to NTP daemon. Is it running?
+ ```
- {{< copyable "shell-regular" >}}
+如果要使 NTP 服务尽快开始同步,执行以下命令。可以将 `pool.ntp.org` 替换为你的 NTP 服务器:
- ```bash
- sudo systemctl stop ntpd.service && \
- sudo ntpdate pool.ntp.org && \
- sudo systemctl start ntpd.service
- ```
+{{< copyable "shell-regular" >}}
-- 如果要在 CentOS 7 系统上手动安装 NTP 服务,可执行以下命令:
+```bash
+sudo systemctl stop ntpd.service && \
+sudo ntpdate pool.ntp.org && \
+sudo systemctl start ntpd.service
+```
- {{< copyable "shell-regular" >}}
+如果要在 CentOS 7 系统上手动安装 NTP 服务,可执行以下命令:
- ```bash
- sudo yum install ntp ntpdate && \
- sudo systemctl start ntpd.service && \
- sudo systemctl enable ntpd.service
- ```
+{{< copyable "shell-regular" >}}
+
+```bash
+sudo yum install ntp ntpdate && \
+sudo systemctl start ntpd.service && \
+sudo systemctl enable ntpd.service
+```
## 手动配置 SSH 互信及 sudo 免密码
@@ -300,7 +288,7 @@ TiDB 是一套分布式数据库系统,需要节点间保证时间的同步,
## 安装 numactl 工具
-本段主要介绍如果安装 NUMA 工具。在线上环境中,因为硬件采购机器配置较高,为了更合理规划资源,会考虑单机多实例部署 TiDB 或者 TiKV。NUMA 绑核工具的使用,主要为了防止 CPU 资源的争抢,引发性能衰退。
+本段主要介绍如果安装 NUMA 工具。在线上环境中,因为硬件机器配置往往高于需求,为了更合理规划资源,会考虑单机多实例部署 TiDB 或者 TiKV。NUMA 绑核工具的使用,主要为了防止 CPU 资源的争抢,引发性能衰退。
> **注意:**
>
diff --git a/geo-distributed-deployment-topology.md b/geo-distributed-deployment-topology.md
index de0fdb6a664f..22df849936bb 100644
--- a/geo-distributed-deployment-topology.md
+++ b/geo-distributed-deployment-topology.md
@@ -71,7 +71,7 @@ category: how-to
replication.max-replicas: 5
```
-- 拒绝异地机房 TiKV 的 Raft 副本拒绝选举为 leader。
+- 拒绝异地机房 TiKV 的 Raft 副本选举为 Leader。
```yaml
label-property:
diff --git a/hardware-and-software-requirements.md b/hardware-and-software-requirements.md
index 89464f4a500c..3c1d1028ca53 100644
--- a/hardware-and-software-requirements.md
+++ b/hardware-and-software-requirements.md
@@ -34,7 +34,7 @@ TiDB 作为一款开源分布式 NewSQL 数据库,可以很好的部署和运
> **注意:**
>
-> 中控机需要[部署 TiUP 软件](/tiup/tiup-cluster.md)完成 TiDB 集群运维管理。
+> 中控机需要部署 [TiUP 软件](/tiup/tiup-documentation-guide.md)来完成 TiDB 集群运维管理。
### 目标主机建议配置软件
diff --git a/hybrid-deployment-topology.md b/hybrid-deployment-topology.md
index 4ee3a71dd58a..810fdcaf4cfc 100644
--- a/hybrid-deployment-topology.md
+++ b/hybrid-deployment-topology.md
@@ -14,7 +14,7 @@ category: how-to
| :-- | :-- | :-- | :-- | :-- |
| TiDB | 6 | 32 VCore 64GB | 10.0.1.1
10.0.1.2
10.0.1.3 | 配置 numa 绑核操作 |
| PD | 3 | 16 VCore 32 GB | 10.0.1.4
10.0.1.5
10.0.1.6 | 配置 location_lables 参数 |
-| TiKV | 6 | 32 VCore 64GB | 10.0.1.7
10.0.1.8
10.0.1.9 | 1. 区分实例级别的 port、status_port;
2. 配置全局参数 readpool、storage 以及 raftstore 参数;
3. 配置实例级别 host 维度的 labels;
4. 配置 numa 绑核操作|
+| TiKV | 6 | 32 VCore 64GB | 10.0.1.7
10.0.1.8
10.0.1.9 | 1. 区分实例级别的 port、status_port;
2. 配置全局参数 readpool、storage 以及 raftstore;
3. 配置实例级别 host 维度的 labels;
4. 配置 numa 绑核操作|
| Monitoring & Grafana | 1 | 4 VCore 8GB * 1 500GB (ssd) | 10.0.1.10 | 默认配置 |
### 拓扑模版
diff --git a/post-installation-check.md b/post-installation-check.md
index 63366e1c38ac..6caaf2d8719c 100644
--- a/post-installation-check.md
+++ b/post-installation-check.md
@@ -46,25 +46,23 @@ category: how-to
mysql -u root -h 10.0.1.4 -P 4000
```
-### 数据库操作
-
-+ 登录成功
+输出下列信息表示登录成功:
- {{< copyable "sql" >}}
+```sql
+Welcome to the MySQL monitor. Commands end with ; or \g.
+Your MySQL connection id is 3
+Server version: 5.7.25-TiDB-v4.0.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible
- ```sql
- Welcome to the MySQL monitor. Commands end with ; or \g.
- Your MySQL connection id is 3
- Server version: 5.7.25-TiDB-v4.0.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible
+Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
- Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
+Oracle is a registered trademark of Oracle Corporation and/or its
+affiliates. Other names may be trademarks of their respective
+owners.
- Oracle is a registered trademark of Oracle Corporation and/or its
- affiliates. Other names may be trademarks of their respective
- owners.
+Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
+```
- Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
- ```
+### 数据库操作
+ 检查 TiDB 版本