pingcap · yikeke · May 25, 2020 · May 19, 2020 · May 19, 2020 · May 19, 2020
diff --git a/command-line-flags-for-tidb-configuration.md b/command-line-flags-for-tidb-configuration.md
@@ -37,6 +37,11 @@ aliases: ['/docs-cn/dev/reference/configuration/tidb-server/configuration/']
 + 默认："0.0.0.0"
 + 0.0.0.0 默认会监听所有的网卡地址。如果有多块网卡，可以指定对外提供服务的网卡，如 192.168.100.113
 
+## `--enable-binlog`
+
++ 是否产生 TiDB binlog
++ 默认：false
+
 ## `-L`
 
 + Log 级别
@@ -149,3 +154,33 @@ aliases: ['/docs-cn/dev/reference/configuration/tidb-server/configuration/']
 
 + 输出 TiDB 的版本
 + 默认：""
+
+## `--plugin-dir`
+
++ plugin 存放目录
++ 默认："/data/deploy/plugin"
+
+## `--plugin-load`
+
++ 需要加载的 plugin 名称，多个 plugin 以 "," 逗号分隔
++ 默认：""
+
+## `--affinity-cpus`
+
++ 设置 TiDB server CPU 亲和性，以 "," 逗号分隔，例如 "1,2,3"
++ 默认：""
+
+## `--repair-mode`
+
++ 是否开启修复模式，仅用于数据修复场景
++ 默认：false
+
+## `--repair-list`
+
++ 修复模式下需要修复的表名
++ 默认：""
+
+## `--require-secure-transport`
+
++ 是否要求客户端使用安全传输模式
++ 默认：false
diff --git a/tidb-configuration-file.md b/tidb-configuration-file.md
@@ -16,9 +16,14 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 + 默认值：true
 + 如果需要创建大量的表，我们建议把这个参数设置为 false。
 
+### `token-limit`
+
++ 可以同时执行请求的 session 个数
++ 默认值：1000
+
 ### `mem-quota-query`
 
-+ 单条 SQL 语句可以占用的最大内存阈值。
++ 单条 SQL 语句可以占用的最大内存阈值，单位为字节。
 + 默认值：1073741824
 + 超过该值的请求会被 `oom-action` 定义的行为所处理。
 + 该值作为系统变量 [`tidb_mem_quota_query`](/tidb-specific-system-variables.md#tidb_mem_quota_query) 的初始值。
@@ -168,6 +173,12 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 + 默认值：300ms
 + 当查询大于这个值，就会当做是一个慢查询，输出到慢查询日志。
 
+### `record-plan-in-slow-log`
+
++ 在慢日志中记录执行计划
++ 默认值：1
++ 0 表示关闭，1 表示开启，默认开启，该值作为系统变量 [`tidb_record_plan_in_slow_log`](/tidb-specific-system-variables.md#tidb_record_plan_in_slow_log) 的初始值。
+
 ### `expensive-threshold`
 
 + 输出 `expensive` 操作的行数阈值。
@@ -208,12 +219,6 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 + 默认值：0
 + 默认全部保存；如果设置为 7，会最多保留 7 个老的日志文件。
 
-#### `log-rotate`
-
-+ 是否每日创建一个新的日志文件。
-+ 默认值：true
-+ 如果设置为 true，每天会新建新的日志文件，如果设置为 false，那么只会输出到一个日志文件。
-
 ## security
 
 安全相关配置。
@@ -253,11 +258,6 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 + ssl 私钥文件路径，用于用 tls 连接 TiKV/PD
 + 默认值：""
 
-### `skip-grant-table`
-
-+ 是否跳过权限检查
-+ 默认值：false
-
 ## performance
 
 性能相关配置。
@@ -270,19 +270,19 @@ TiDB 配置文件比命令行参数支持更多的选项。你可以在 [config/
 
 ### `max-memory`
 
-+ Prepare cache LRU 使用的最大内存限制，超过 performance.max-memory * (1 - prepared-plan-cache.memory-guard-ratio) 会剔除 LRU 中的元素。
++ TiDB 最大使用内存，单位为字节
 + 默认值：0
-+ 这个配置只有在 prepared-plan-cache.enabled 为 true 的情况才会生效。在 LRU 的 size 大于 prepared-plan-cache.capacity 的情况下，也会剔除 LRU 中的元素。
++ 默认值 0 表示不受限制
 
 ### `txn-total-size-limit`
 
-+ TiDB 事务大小限制
++ TiDB 单个事务大小限制
 + 默认值：104857600 (Byte)
 + 单个事务中，所有 key-value 记录的总大小不能超过该限制。该配置项的最大值不超过 `10737418240`（表示 10GB）。注意，如果使用了以 `Kafka` 为下游消费者的 `binlog`，如：`arbiter` 集群，该配置项的值不能超过 `1073741824`（表示 1GB），因为这是 `Kafka` 的处理单条消息的最大限制，超过该限制 `Kafka` 将会报错。
 
 ### `stmt-count-limit`
 
-+ TiDB 一个事务允许的最大语句条数限制。
++ TiDB 单个事务允许的最大语句条数限制。
 + 默认值：5000
 + 在一个事务中，超过 `stmt-count-limit` 条语句后还没有 rollback 或者 commit，TiDB 将会返回 `statement count 5001 exceeds the transaction limitation, autocommit = false` 错误。该限制只在可重试的乐观事务中生效，如果使用悲观事务或者关闭了[事务重试](/optimistic-transaction.md#事务的重试)，事务中的语句数将不受此限制。
 
@@ -391,11 +391,12 @@ prepare 语句的 Plan cache 设置。
 + 默认值：41s
 + 这个值必须是大于两倍 Raft 选举的超时时间。
 
-### `max-txn-time-use`
+### `max-txn-ttl`
 
-+ 单个事务允许的最大执行时间。
-+ 默认值：590
-+ 单位：秒
++ 单个事务持锁的最长时间，超过该时间，该事务的锁可能会被其他事务清除，导致该事务无法成功提交。
++ 默认值：600000
++ 单位：毫秒
++ 超过此时间的事务只能执行提交或者回滚，提交不一定能够成功。
 
 ### `max-batch-size`
 
@@ -528,7 +529,7 @@ TiDB 服务状态相关配置。
 
 ### max-retry-count
 
-+ 悲观事务中每个语句最大重试次数，超出该限制将会报错。
++ 悲观事务中单个语句最大重试次数，重试次数超过该限制，语句执行将会报错。
 + 默认值：256
 
 ## experimental

diff --git a/tiup/tiup-troubleshooting-guide.md b/tiup/tiup-troubleshooting-guide.md
@@ -38,7 +38,7 @@ TiUP 并不会每次都从镜像服务器更新最新的组件列表，可以通
 2. 如果指定了 `-i` 参数，可能是由于指定的私钥不能登录，可以通过手动执行 `ssh -i identity_file user@remote` 命令来验证。
 3. 如果是通过密码登录远程主机，请确保指定了 `-p` 参数，同时输入了正确的登录密码。
 
-### 2.3 使用 TiUP Cluster 升级中断
+### 2.2 使用 TiUP Cluster 升级中断
 
 为了避免用户误用，TiUP Cluster 不支持指定部分节点升级，所以升级失败之后，需要重新进行升级操作，包括升级过程中的幂等操作。