From 111e379eea19de0c78de619b9a3846b53e55d05a Mon Sep 17 00:00:00 2001
From: Wish <breezewish@outlook.com>
Date: Tue, 22 Nov 2022 14:04:17 +0800
Subject: [PATCH] Add example about how to fill the <cluster_version>

Signed-off-by: Wish <breezewish@outlook.com>
---
 tiflash/create-tiflash-replicas.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/tiflash/create-tiflash-replicas.md b/tiflash/create-tiflash-replicas.md
index 8ac39042adfa..5857d0f4ae74 100644
--- a/tiflash/create-tiflash-replicas.md
+++ b/tiflash/create-tiflash-replicas.md
@@ -150,15 +150,21 @@ SELECT TABLE_NAME FROM information_schema.tables where TABLE_SCHEMA = "<db_name>
    TiFlash 默认新增副本速度是 30（每分钟大约 30 个 Region 将会新增 TiFlash 副本）。执行以下命令将调整所有 TiFlash 实例的新增副本速度到 60，即原来的 2 倍速度：
 
    ```shell
-   tiup ctl:<cluster-version> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 60 add-peer
+   tiup ctl:v<CLUSTER_VERSION> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 60 add-peer
    ```
 
+   > 上述命令中，需要将 `<CLUSTER_VERSION>` 替换为该集群版本，`<PD_ADDRESS>:2379` 替换为任一 PD 节点的地址。替换后样例为：
+   >
+   > ```shell
+   > tiup ctl:v6.1.1 pd -u http://192.168.1.4:2379 store limit all engine tiflash 60 add-peer
+   > ```
+
    执行完毕后，几分钟内，你将观察到 TiFlash 节点的 CPU 及磁盘 IO 资源占用显著提升，TiFlash 将更快地创建副本。同时，TiKV 节点的 CPU 及磁盘 IO 资源占用也将有所上升。
 
    如果此时 TiKV 及 TiFlash 节点的资源仍有富余，且线上业务的延迟没有显著上升，则可以考虑进一步放开调度速度，例如将新增副本的速度增加为原来的 3 倍：
 
    ```shell
-   tiup ctl:<cluster-version> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 90 add-peer
+   tiup ctl:v<CLUSTER_VERSION> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 90 add-peer
    ```
 
 3. 在副本同步完毕后，恢复到默认配置，减少在线业务受到的影响。
@@ -166,7 +172,7 @@ SELECT TABLE_NAME FROM information_schema.tables where TABLE_SCHEMA = "<db_name>
    执行以下 PD Control 命令可恢复默认的新增副本速度：
 
    ```shell
-   tiup ctl:<cluster-version> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 30 add-peer
+   tiup ctl:v<CLUSTER_VERSION> pd -u http://<PD_ADDRESS>:2379 store limit all engine tiflash 30 add-peer
    ```
 
    执行以下 SQL 语句可恢复默认的数据快照写入速度：
@@ -225,7 +231,7 @@ SELECT TABLE_NAME FROM information_schema.tables where TABLE_SCHEMA = "<db_name>
 3. 此时 PD 会根据设置的 label 进行调度，将表 `t` 的两个副本分别调度到两个可用区中。可以通过监控或 pd-ctl 来验证这一点：
 
     ```shell
-    > tiup ctl:<version> pd -u<pd-host>:<pd-port> store
+    > tiup ctl:v<CLUSTER_VERSION> pd -u http://<PD_ADDRESS>:2379 store
 
         ...