diff --git a/br/backup-and-restore-use-cases.md b/br/backup-and-restore-use-cases.md index ceea8821f19e..e28539b70d30 100644 --- a/br/backup-and-restore-use-cases.md +++ b/br/backup-and-restore-use-cases.md @@ -16,7 +16,7 @@ summary: 介绍 TiDB 备份与恢复的具体使用示例，包括推荐环境 ## 部署 TiDB 集群和 br 命令行工具 -使用 PITR 功能，需要部署 v6.2.0 或以上版本的 TiDB 集群，并且更新 br 命令行工具到与 TiDB 集群相同的版本，本文假设使用的是 v7.1.0 版本。 +使用 PITR 功能，需要部署 v6.2.0 或以上版本的 TiDB 集群，并且更新 br 命令行工具到与 TiDB 集群相同的版本，本文假设使用的是 v7.2.0 版本。 下表介绍了在 TiDB 集群中使用日志备份功能的推荐配置。 @@ -43,13 +43,13 @@ summary: 介绍 TiDB 备份与恢复的具体使用示例，包括推荐环境 - 安装： ```shell - tiup install br:v7.1.0 + tiup install br:v7.2.0 ``` - 升级： ```shell - tiup update br:v7.1.0 + tiup update br:v7.2.0 ``` ## 配置备份存储 (Amazon S3) diff --git a/dm/maintain-dm-using-tiup.md b/dm/maintain-dm-using-tiup.md index b9c52599da9e..eb39ca760c97 100644 --- a/dm/maintain-dm-using-tiup.md +++ b/dm/maintain-dm-using-tiup.md @@ -389,7 +389,7 @@ tiup dmctl --master-addr master1:8261 operate-source create /tmp/source1.yml 此时可以通过命令行参数 `--native-ssh` 启用系统自带命令行： -- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v7.1.0`），`` 为拓扑文件路径 +- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v7.2.0`），`` 为拓扑文件路径 - 启动集群：`tiup dm start --native-ssh` - 升级集群：`tiup dm upgrade ... --native-ssh` diff --git a/dm/quick-start-create-task.md b/dm/quick-start-create-task.md index 78b6d06224b8..93980f69c764 100644 --- a/dm/quick-start-create-task.md +++ b/dm/quick-start-create-task.md @@ -68,7 +68,7 @@ docker run --rm --name mysql-3307 -p 3307:3307 -e MYSQL_ALLOW_EMPTY_PASSWORD=tru {{< copyable "shell-regular" >}} ```bash -wget https://download.pingcap.org/tidb-community-server-v7.1.0-linux-amd64.tar.gz +wget https://download.pingcap.org/tidb-community-server-v7.2.0-linux-amd64.tar.gz tar -xzvf tidb-latest-linux-amd64.tar.gz mv tidb-latest-linux-amd64/bin/tidb-server ./ ./tidb-server -P 4000 --store mocktikv --log-file "./tidb.log" & diff --git a/information-schema/information-schema-tidb-servers-info.md b/information-schema/information-schema-tidb-servers-info.md index 4b2c49eeca0e..2f2ca5e1ea67 100644 --- a/information-schema/information-schema-tidb-servers-info.md +++ b/information-schema/information-schema-tidb-servers-info.md @@ -46,7 +46,7 @@ SELECT * FROM TIDB_SERVERS_INFO\G PORT: 4000 STATUS_PORT: 10080 LEASE: 45s - VERSION: 5.7.25-TiDB-v7.1.0 + VERSION: 5.7.25-TiDB-v7.2.0 GIT_HASH: 635a4362235e8a3c0043542e629532e3c7bb2756 BINLOG_STATUS: Off LABELS: diff --git a/pd-control.md b/pd-control.md index 55869cc07a01..f82c64c8bc32 100644 --- a/pd-control.md +++ b/pd-control.md @@ -27,7 +27,7 @@ PD Control 是 PD 的命令行工具，用于获取集群状态信息和调整 > **注意：** > -> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v7.1.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v7.1.0-linux-amd64.tar.gz`。 +> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v7.2.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v7.2.0-linux-amd64.tar.gz`。 ### 源码编译 diff --git a/post-installation-check.md b/post-installation-check.md index 352303fc30cc..3ab99f89ba9b 100644 --- a/post-installation-check.md +++ b/post-installation-check.md @@ -62,7 +62,7 @@ mysql -u root -h ${tidb_server_host_IP_address} -P 4000 ```sql Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 3 -Server version: 5.7.25-TiDB-v7.1.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 5.7 compatible +Server version: 5.7.25-TiDB-v7.2.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. diff --git a/production-deployment-using-tiup.md b/production-deployment-using-tiup.md index dfa134d66a55..4071d5cacc28 100644 --- a/production-deployment-using-tiup.md +++ b/production-deployment-using-tiup.md @@ -137,12 +137,12 @@ summary: 了解如何使用 TiUP 部署 TiDB 集群。 如果从官网下载的离线镜像不满足你的具体需求，或者希望对已有的离线镜像内容进行调整，例如增加某个组件的新版本等，可以采取以下步骤进行操作： - 1. 在制作离线镜像时，可通过参数指定具体的组件和版本等信息，获得不完整的离线镜像。例如，要制作一个只包括 v1.11.3 版本 TiUP 和 TiUP Cluster 的离线镜像，可执行如下命令： + 1. 在制作离线镜像时，可通过参数指定具体的组件和版本等信息，获得不完整的离线镜像。例如，要制作一个只包括 v1.12.3 版本 TiUP 和 TiUP Cluster 的离线镜像，可执行如下命令： {{< copyable "shell-regular" >}} ```bash - tiup mirror clone tiup-custom-mirror-v1.11.3 --tiup v1.11.3 --cluster v1.11.3 + tiup mirror clone tiup-custom-mirror-v1.12.3 --tiup v1.12.3 --cluster v1.12.3 ``` 如果只需要某一特定平台的组件，也可以通过 `--os` 和 `--arch` 参数来指定。 @@ -174,10 +174,10 @@ summary: 了解如何使用 TiUP 部署 TiDB 集群。 {{< copyable "shell-regular" >}} ```bash - tiup mirror merge tiup-custom-mirror-v1.11.3 + tiup mirror merge tiup-custom-mirror-v1.12.3 ``` - 5. 上述步骤完成后，通过 `tiup list` 命令检查执行结果。在本文例子中，使用 `tiup list tiup` 和 `tiup list cluster` 均应能看到对应组件的 `v1.11.3` 版本出现在结果中。 + 5. 上述步骤完成后，通过 `tiup list` 命令检查执行结果。在本文例子中，使用 `tiup list tiup` 和 `tiup list cluster` 均应能看到对应组件的 `v1.12.3` 版本出现在结果中。 #### 部署离线环境 TiUP 组件 @@ -340,13 +340,13 @@ alertmanager_servers: {{< copyable "shell-regular" >}} ```shell - tiup cluster deploy tidb-test v7.1.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] + tiup cluster deploy tidb-test v7.2.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] ``` 以上部署示例中： - `tidb-test` 为部署的集群名称。 -- `v7.1.0` 为部署的集群版本，可以通过执行 `tiup list tidb` 来查看 TiUP 支持的最新可用版本。 +- `v7.2.0` 为部署的集群版本，可以通过执行 `tiup list tidb` 来查看 TiUP 支持的最新可用版本。 - 初始化配置文件为 `topology.yaml`。 - `--user root` 表示通过 root 用户登录到目标主机完成集群部署，该用户需要有 ssh 到目标机器的权限，并且在目标机器有 sudo 权限。也可以用其他有 ssh 和 sudo 权限的用户完成部署。 - [-i] 及 [-p] 为可选项，如果已经配置免密登录目标机，则不需填写。否则选择其一即可，[-i] 为可登录到目标机的 root 用户（或 --user 指定的其他用户）的私钥，也可使用 [-p] 交互式输入该用户的密码。 diff --git a/quick-start-with-tidb.md b/quick-start-with-tidb.md index 2806f2bb85c6..0bc750ed573b 100644 --- a/quick-start-with-tidb.md +++ b/quick-start-with-tidb.md @@ -80,10 +80,10 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti {{< copyable "shell-regular" >}} ```shell - tiup playground v7.1.0 --db 2 --pd 3 --kv 3 + tiup playground v7.2.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v7.1.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v7.2.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -197,10 +197,10 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti {{< copyable "shell-regular" >}} ```shell - tiup playground v7.1.0 --db 2 --pd 3 --kv 3 + tiup playground v7.2.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v7.1.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v7.2.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -431,7 +431,7 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti ``` - 参数 `` 表示设置集群名称 - - 参数 `` 表示设置集群版本，例如 `v7.1.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 + - 参数 `` 表示设置集群版本，例如 `v7.2.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 - 参数 `-p` 表示在连接目标机器时使用密码登录 > **注意：** diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md index ba96cd85a6c8..292b533838d0 100644 --- a/scale-tidb-using-tiup.md +++ b/scale-tidb-using-tiup.md @@ -275,11 +275,11 @@ tiup cluster display ``` ``` -Starting /root/.tiup/components/cluster/v1.11.3/cluster display +Starting /root/.tiup/components/cluster/v1.12.3/cluster display TiDB Cluster: -TiDB Version: v7.1.0 +TiDB Version: v7.2.0 ID Role Host Ports Status Data Dir Deploy Dir diff --git a/system-variables.md b/system-variables.md index 908edbb44f9b..e36d9e615d65 100644 --- a/system-variables.md +++ b/system-variables.md @@ -4447,7 +4447,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 作用域：NONE - 默认值：`5.7.25-TiDB-(tidb version)` -- 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '5.7.25-TiDB-v7.1.0'。 +- 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '5.7.25-TiDB-v7.2.0'。 ### `version_comment` diff --git a/ticdc/deploy-ticdc.md b/ticdc/deploy-ticdc.md index 4197bc572c7c..cf86b34a0f3c 100644 --- a/ticdc/deploy-ticdc.md +++ b/ticdc/deploy-ticdc.md @@ -95,7 +95,7 @@ tiup cluster upgrade --transfer-timeout 600 > **注意：** > -> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v7.1.0。 +> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v7.2.0。 ### 升级的注意事项 @@ -152,7 +152,7 @@ tiup cluster upgrade --transfer-timeout 600 ## 使用 TiCDC 命令行工具来查看集群状态 -执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v7.1.0`： +执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v7.2.0`： ```shell tiup ctl:v cdc capture list --server=http://10.0.10.25:8300 diff --git a/ticdc/ticdc-open-api-v2.md b/ticdc/ticdc-open-api-v2.md index 74989712f4c9..a98cbda533f0 100644 --- a/ticdc/ticdc-open-api-v2.md +++ b/ticdc/ticdc-open-api-v2.md @@ -90,7 +90,7 @@ curl -X GET http://127.0.0.1:8300/api/v2/status ```json { - "version": "v7.1.0", + "version": "v7.2.0", "git_hash": "10413bded1bdb2850aa6d7b94eb375102e9c44dc", "id": "d2912e63-3349-447c-90ba-72a4e04b5e9e", "pid": 1447, diff --git a/tidb-binlog/get-started-with-tidb-binlog.md b/tidb-binlog/get-started-with-tidb-binlog.md index 655d3ade4ed8..a6dffaf08732 100644 --- a/tidb-binlog/get-started-with-tidb-binlog.md +++ b/tidb-binlog/get-started-with-tidb-binlog.md @@ -46,7 +46,7 @@ sudo yum install -y mariadb-server {{< copyable "shell-regular" >}} ```bash -curl -LO https://download.pingcap.org/tidb-community-server-v7.1.0-linux-amd64.tar.gz | tar xzf - && +curl -LO https://download.pingcap.org/tidb-community-server-v7.2.0-linux-amd64.tar.gz | tar xzf - && cd tidb-latest-linux-amd64 ``` diff --git a/tidb-monitoring-api.md b/tidb-monitoring-api.md index 87253f684054..beaa7503a876 100644 --- a/tidb-monitoring-api.md +++ b/tidb-monitoring-api.md @@ -31,7 +31,7 @@ curl http://127.0.0.1:10080/status ``` { connections: 0, # 当前 TiDB Server 上的客户端连接数 - version: "5.7.25-TiDB-v7.1.0", # TiDB 版本号 + version: "5.7.25-TiDB-v7.2.0", # TiDB 版本号 git_hash: "7267747ae0ec624dffc3fdedb00f1ed36e10284b" # TiDB 当前代码的 Git Hash } ``` diff --git a/tiflash/create-tiflash-replicas.md b/tiflash/create-tiflash-replicas.md index 93ccfccd2d7d..c08100edc899 100644 --- a/tiflash/create-tiflash-replicas.md +++ b/tiflash/create-tiflash-replicas.md @@ -139,10 +139,10 @@ SELECT TABLE_NAME FROM information_schema.tables where TABLE_SCHEMA = " tiup ctl:v pd -u http://:2379 store limit all engine tiflash 60 add-peer ``` - > 上述命令中，需要将 `v` 替换为该集群版本，例如 `v7.1.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： + > 上述命令中，需要将 `v` 替换为该集群版本，例如 `v7.2.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： > > ```shell - > tiup ctl:v7.1.0 pd -u http://192.168.1.4:2379 store limit all engine tiflash 60 add-peer + > tiup ctl:v7.2.0 pd -u http://192.168.1.4:2379 store limit all engine tiflash 60 add-peer > ``` 执行完毕后，几分钟内，你将观察到 TiFlash 节点的 CPU 及磁盘 IO 资源占用显著提升，TiFlash 将更快地创建副本。同时，TiKV 节点的 CPU 及磁盘 IO 资源占用也将有所上升。 diff --git a/tiup/tiup-cluster.md b/tiup/tiup-cluster.md index 988366c0e1fb..712304fc33d1 100644 --- a/tiup/tiup-cluster.md +++ b/tiup/tiup-cluster.md @@ -15,7 +15,7 @@ tiup cluster ``` ``` -Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.11.3/cluster +Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.12.3/cluster Deploy a TiDB cluster for production Usage: @@ -60,7 +60,7 @@ Flags: tiup cluster deploy [flags] ``` -该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v7.1.0`），以及一个集群的拓扑文件。 +该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v7.2.0`），以及一个集群的拓扑文件。 拓扑文件的编写可参考[示例](https://github.com/pingcap/tiup/blob/master/embed/examples/cluster/topology.example.yaml)。以一个最简单的拓扑为例，将下列文件保存为 `/tmp/topology.yaml`： @@ -117,12 +117,12 @@ tidb_servers: ... ``` -假如我们想要使用 TiDB 的 v7.1.0 版本，集群名字为 `prod-cluster`，则执行以下命令： +假如我们想要使用 TiDB 的 v7.2.0 版本，集群名字为 `prod-cluster`，则执行以下命令： {{< copyable "shell-regular" >}} ```shell -tiup cluster deploy -p prod-cluster v7.1.0 /tmp/topology.yaml +tiup cluster deploy -p prod-cluster v7.2.0 /tmp/topology.yaml ``` 执行过程中会再次确认拓扑结构并提示输入目标机器上的 root 密码（-p 表示使用密码）： @@ -130,7 +130,7 @@ tiup cluster deploy -p prod-cluster v7.1.0 /tmp/topology.yaml ```bash Please confirm your topology: TiDB Cluster: prod-cluster -TiDB Version: v7.1.0 +TiDB Version: v7.2.0 Type Host Ports OS/Arch Directories ---- ---- ----- ------- ----------- pd 172.16.5.134 2379/2380 linux/x86_64 deploy/pd-2379,data/pd-2379 @@ -170,10 +170,10 @@ tiup cluster list ``` ``` -Starting /root/.tiup/components/cluster/v1.11.3/cluster list +Starting /root/.tiup/components/cluster/v1.12.3/cluster list Name User Version Path PrivateKey ---- ---- ------- ---- ---------- -prod-cluster tidb v7.1.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa +prod-cluster tidb v7.2.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa ``` ## 启动集群 @@ -199,9 +199,9 @@ tiup cluster display prod-cluster ``` ``` -Starting /root/.tiup/components/cluster/v1.11.3/cluster display prod-cluster +Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v7.1.0 +TiDB Version: v7.2.0 ID Role Host Ports OS/Arch Status Data Dir Deploy Dir -- ---- ---- ----- ------- ------ -------- ---------- 172.16.5.134:3000 grafana 172.16.5.134 3000 linux/x86_64 Up - deploy/grafana-3000 @@ -267,9 +267,9 @@ tiup cluster display prod-cluster ``` ``` -Starting /root/.tiup/components/cluster/v1.11.3/cluster display prod-cluster +Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v7.1.0 +TiDB Version: v7.2.0 ID Role Host Ports OS/Arch Status Data Dir Deploy Dir -- ---- ---- ----- ------- ------ -------- ---------- 172.16.5.134:3000 grafana 172.16.5.134 3000 linux/x86_64 Up - deploy/grafana-3000 @@ -369,12 +369,12 @@ Global Flags: -y, --yes 跳过所有的确认步骤 ``` -例如，把集群升级到 v7.1.0 的命令为： +例如，把集群升级到 v7.2.0 的命令为： {{< copyable "shell-regular" >}} ```bash -tiup cluster upgrade tidb-test v7.1.0 +tiup cluster upgrade tidb-test v7.2.0 ``` ## 更新配置 @@ -551,14 +551,14 @@ tiup cluster audit ``` ``` -Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.11.3/cluster audit +Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.12.3/cluster audit ID Time Command -- ---- ------- -4BLhr0 2023-05-31T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.11.3/cluster deploy test v7.1.0 /tmp/topology.yaml -4BKWjF 2023-05-31T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.11.3/cluster deploy test v7.1.0 /tmp/topology.yaml -4BKVwH 2023-05-31T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.11.3/cluster deploy test v7.1.0 /tmp/topology.yaml -4BKKH1 2023-05-31T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.11.3/cluster destroy test -4BKKDx 2023-05-31T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.11.3/cluster deploy test v7.1.0 /tmp/topology.yaml +4BLhr0 2023-06-29T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.2.0 /tmp/topology.yaml +4BKWjF 2023-06-29T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.2.0 /tmp/topology.yaml +4BKVwH 2023-06-29T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.2.0 /tmp/topology.yaml +4BKKH1 2023-06-29T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster destroy test +4BKKDx 2023-06-29T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.2.0 /tmp/topology.yaml ``` 第一列为 audit-id，如果想看某个命令的执行日志，则传入这个 audit-id： @@ -672,7 +672,7 @@ tiup cluster check --cluster 此时可以通过命令行参数 `--ssh=system` 启用系统自带命令行： -- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v7.1.0`），`` 为拓扑文件路径 +- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v7.2.0`），`` 为拓扑文件路径 - 启动集群：`tiup cluster start --ssh=system` - 升级集群：`tiup cluster upgrade ... --ssh=system` diff --git a/tiup/tiup-component-cluster-deploy.md b/tiup/tiup-component-cluster-deploy.md index 67d0585179f5..e2aa9029ee8b 100644 --- a/tiup/tiup-component-cluster-deploy.md +++ b/tiup/tiup-component-cluster-deploy.md @@ -13,7 +13,7 @@ tiup cluster deploy [flags] ``` - `` 表示新集群的名字，不能和现有集群同名 -- `` 为要部署的 TiDB 集群版本号，如 `v7.1.0` +- `` 为要部署的 TiDB 集群版本号，如 `v7.2.0` - `` 为事先编写好的[拓扑文件](/tiup/tiup-cluster-topology-reference.md) ## 选项 diff --git a/tiup/tiup-component-cluster-patch.md b/tiup/tiup-component-cluster-patch.md index 703138ec7fa2..b1b467052a33 100644 --- a/tiup/tiup-component-cluster-patch.md +++ b/tiup/tiup-component-cluster-patch.md @@ -28,7 +28,7 @@ tiup cluster patch [flags] 1. 确定以下变量的值： - `${component}`：需要替换的组件名（例如 `tidb`、`tikv`、`pd`）。 - - `${version}`：组件的版本（例如 `v7.1.0`、`v6.5.2`）。 + - `${version}`：组件的版本（例如 `v7.2.0`、`v6.5.2`）。 - `${os}`：操作系统 (`linux`)。 - `${arch}`：组件运行的平台 (`amd64`、`arm64`)。 2. 下载当前的组件包： diff --git a/tiup/tiup-component-cluster-upgrade.md b/tiup/tiup-component-cluster-upgrade.md index 485d0ad3491c..71b3d54fc82d 100644 --- a/tiup/tiup-component-cluster-upgrade.md +++ b/tiup/tiup-component-cluster-upgrade.md @@ -13,7 +13,7 @@ tiup cluster upgrade [flags] ``` - `` 为要操作的集群名字，如果忘记集群名字可通过[集群列表](/tiup/tiup-component-cluster-list.md)查看。 -- `` 为要升级到的目标版本，例如 `v7.1.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v7.2.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-dm-upgrade.md b/tiup/tiup-component-dm-upgrade.md index c0f689efe554..523a66a41b34 100644 --- a/tiup/tiup-component-dm-upgrade.md +++ b/tiup/tiup-component-dm-upgrade.md @@ -13,7 +13,7 @@ tiup dm upgrade [flags] ``` - `` 为要操作的集群名字，如果忘记集群名字可查看[集群列表](/tiup/tiup-component-dm-list.md)。 -- `` 为要升级到的目标版本，例如 `v7.1.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v7.2.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-management.md b/tiup/tiup-component-management.md index d6d0d6359463..2e3146b9092f 100644 --- a/tiup/tiup-component-management.md +++ b/tiup/tiup-component-management.md @@ -68,12 +68,12 @@ tiup install tidb tiup install tidb:nightly ``` -示例三：使用 TiUP 安装 v7.1.0 版本的 TiKV +示例三：使用 TiUP 安装 v7.2.0 版本的 TiKV {{< copyable "shell-regular" >}} ```shell -tiup install tikv:v7.1.0 +tiup install tikv:v7.2.0 ``` ## 升级组件 @@ -126,12 +126,12 @@ Flags: 如果想要多次启动同一个组件并复用之前的工作目录，就可以在启动时用 `--tag` 指定相同的名字。指定 tag 后，在实例终止时就*不会自动删除*工作目录，方便下次启动时复用。 -示例一：运行 v7.1.0 版本的 TiDB +示例一：运行 v7.2.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup tidb:v7.1.0 +tiup tidb:v7.2.0 ``` 示例二：指定 tag 运行 TiKV @@ -217,12 +217,12 @@ component 为要卸载的组件名称，version 为要卸载的版本，这两 - 若省略版本，加 `--all` 表示卸载该组件所有版本 - 若版本和组件都省略，则加 `--all` 表示卸载所有组件及其所有版本 -示例一：卸载 v7.1.0 版本的 TiDB +示例一：卸载 v7.2.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup uninstall tidb:v7.1.0 +tiup uninstall tidb:v7.2.0 ``` 示例二：卸载所有版本的 TiKV diff --git a/tiup/tiup-mirror.md b/tiup/tiup-mirror.md index 3a8efe0db19f..52de0b6ef46a 100644 --- a/tiup/tiup-mirror.md +++ b/tiup/tiup-mirror.md @@ -85,9 +85,9 @@ tiup mirror clone [global-version] [flags] 如果只想克隆某个组件的某一个版本而不是所有版本，则使用 `--=` 来限定，例如： - - 只想克隆 TiDB 的 v7.1.0 版本，则执行 `tiup mirror clone --tidb v7.1.0` - - 只想克隆 TiDB 的 v7.1.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v7.1.0 --tikv all` - - 克隆一个集群的所有组件的 v7.1.0 版本，则执行 `tiup mirror clone v7.1.0` + - 只想克隆 TiDB 的 v7.2.0 版本，则执行 `tiup mirror clone --tidb v7.2.0` + - 只想克隆 TiDB 的 v7.2.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v7.2.0 --tikv all` + - 克隆一个集群的所有组件的 v7.2.0 版本，则执行 `tiup mirror clone v7.2.0` 克隆完成后，签名密钥会自动设置。 diff --git a/tiup/tiup-playground.md b/tiup/tiup-playground.md index 48b46a004264..b8afa7b721bd 100644 --- a/tiup/tiup-playground.md +++ b/tiup/tiup-playground.md @@ -16,9 +16,9 @@ tiup playground ${version} [flags] 如果直接执行 `tiup playground` 命令，则 TiUP playground 会使用本地安装的 TiDB/TiKV/PD 组件或者安装这些组件的稳定版本，来启动一个由 1 个 TiKV、1 个 TiDB、1 个 PD 和 1 个 TiFlash 实例构成的集群。该命令实际做了以下事情： -- 因为该命令没有指定 playground 的版本，TiUP 会先查找已安装的 playground 的最新版本，假设已安装的 playground 最新版为 v1.11.3，则该命令相当于 tiup playground:v1.11.3 +- 因为该命令没有指定 playground 的版本，TiUP 会先查找已安装的 playground 的最新版本，假设已安装的 playground 最新版为 v1.12.3，则该命令相当于 tiup playground:v1.12.3 - 如果 playground 从未安装过任何版本的 TiDB/TiKV/PD 组件，TiUP 会先安装这些组件的最新稳定版，然后再启动运行这些组件的实例 -- 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v7.1.0，则该命令相当于 tiup playground:1.11.3 v7.1.0 +- 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v7.2.0，则该命令相当于 tiup playground:1.12.3 v7.2.0 - 因为该命令也没有指定各组件的个数，默认情况下，它会启动由 1 个 TiDB、1 个 TiKV、1 个 PD 和 1 个 TiFlash 实例构成的最小化集群 - 在依次启动完各个 TiDB 组件后，playground 会提醒集群启动成功，并告诉你一些有用的信息，譬如如何通过 MySQL 客户端连接集群、如何访问 [TiDB Dashboard](/dashboard/dashboard-intro.md) 等 diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index d6bb247f8b37..722e8b0bb30f 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -6,10 +6,10 @@ title: 使用 TiUP 升级 TiDB 本文档适用于以下升级路径： -- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 7.1。 -- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 7.1。 -- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 7.1。 -- 使用 TiUP 从 TiDB 7.0 版本升级至 TiDB 7.1。 +- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 7.2。 +- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 7.2。 +- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 7.2。 +- 使用 TiUP 从 TiDB 7.0-7.1 版本升级至 TiDB 7.2。 > **警告：** > @@ -21,17 +21,17 @@ title: 使用 TiUP 升级 TiDB > **注意：** > -> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.1.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.1.0 及后续修订版本。 +> 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.2.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.2.0 及后续修订版本。 ## 1. 升级兼容性说明 - TiDB 目前暂不支持版本降级或升级后回退。 -- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v7.1.0 版本。 -- 若要将 v3.0 之前的版本升级至 v7.1.0 版本： +- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v7.2.0 版本。 +- 若要将 v3.0 之前的版本升级至 v7.2.0 版本： 1. 首先[通过 TiDB Ansible 升级到 3.0 版本](https://docs.pingcap.com/zh/tidb/v3.0/upgrade-tidb-using-ansible)。 2. 然后按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)，使用 TiUP (`tiup cluster`) 将 TiDB Ansible 配置导入。 3. 将集群升级至 v4.0 版本。 - 4. 按本文档说明将集群升级到 v7.1.0 版本。 + 4. 按本文档说明将集群升级到 v7.2.0 版本。 - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 - 将 v6.3.0 之前的 TiFlash 升级至 v6.3.0 及之后的版本时，需要特别注意：在 Linux AMD64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 AVX2 指令集。而在 Linux ARM64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 ARMv8 架构。具体请参考 [6.3.0 版本 Release Notes](/releases/release-6.3.0.md#其他) 中的描述。 - 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/releases/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 @@ -136,7 +136,7 @@ tiup update cluster > **注意：** > -> 升级到 v7.1.0 版本前，请确认已在 4.0 修改的参数在 v7.1.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 +> 升级到 v7.2.0 版本前，请确认已在 4.0 修改的参数在 v7.2.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 ### 2.4 检查当前集群的健康状况 @@ -173,12 +173,12 @@ tiup cluster check --cluster tiup cluster upgrade ``` -以升级到 v7.1.0 版本为例： +以升级到 v7.2.0 版本为例： {{< copyable "shell-regular" >}} ``` -tiup cluster upgrade v7.1.0 +tiup cluster upgrade v7.2.0 ``` > **注意：** @@ -202,7 +202,7 @@ tiup cluster upgrade v7.1.0 tiup cluster stop ``` -之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v7.1.0`。 +之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v7.2.0`。 {{< copyable "shell-regular" >}} @@ -231,7 +231,7 @@ tiup cluster display ``` Cluster type: tidb Cluster name: -Cluster version: v7.1.0 +Cluster version: v7.2.0 ``` ## 4. 升级 FAQ @@ -262,7 +262,7 @@ Cluster version: v7.1.0 ### 4.2 升级过程中 evict leader 等待时间过长，如何跳过该步骤快速升级 -可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v7.1.0`： +可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v7.2.0`： {{< copyable "shell-regular" >}} @@ -277,5 +277,5 @@ tiup cluster upgrade --force {{< copyable "" >}} ``` -tiup install ctl:v7.1.0 +tiup install ctl:v7.2.0 ```