diff --git a/README.md b/README.md index ad8cb1928e15..791287c23adc 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ | 文档仓库 branch | 对应 TiDB 文档版本 | |:---------|:----------| | [`master`](https://github.com/pingcap/docs-cn/tree/master) | dev 最新开发版 | +| [`release-7.5`](https://github.com/pingcap/docs-cn/tree/release-7.5) | 7.5 长期支持版 (LTS) | | [`release-7.4`](https://github.com/pingcap/docs-cn/tree/release-7.4) | 7.4 开发里程碑版 (DMR) | | [`release-7.3`](https://github.com/pingcap/docs-cn/tree/release-7.3) | 7.3 开发里程碑版 (DMR) | | [`release-7.2`](https://github.com/pingcap/docs-cn/tree/release-7.2) | 7.2 开发里程碑版 (DMR) | diff --git a/br/backup-and-restore-use-cases.md b/br/backup-and-restore-use-cases.md index e3833f6c7116..3e0d727f7e59 100644 --- a/br/backup-and-restore-use-cases.md +++ b/br/backup-and-restore-use-cases.md @@ -17,7 +17,7 @@ aliases: ['/docs-cn/dev/br/backup-and-restore-use-cases/','/docs-cn/dev/referenc ## 部署 TiDB 集群和 br 命令行工具 -使用 PITR 功能，需要部署 v6.2.0 或以上版本的 TiDB 集群，并且更新 br 命令行工具到与 TiDB 集群相同的版本，本文假设使用的是 v7.4.0 版本。 +使用 PITR 功能，需要部署 v6.2.0 或以上版本的 TiDB 集群，并且更新 br 命令行工具到与 TiDB 集群相同的版本，本文假设使用的是 v7.5.0 版本。 下表介绍了在 TiDB 集群中使用日志备份功能的推荐配置。 @@ -44,13 +44,13 @@ aliases: ['/docs-cn/dev/br/backup-and-restore-use-cases/','/docs-cn/dev/referenc - 安装： ```shell - tiup install br:v7.4.0 + tiup install br:v7.5.0 ``` - 升级： ```shell - tiup update br:v7.4.0 + tiup update br:v7.5.0 ``` ## 配置备份存储 (Amazon S3) diff --git a/develop/dev-guide-proxysql-integration.md b/develop/dev-guide-proxysql-integration.md index 882cc737826d..e17a3d1f80f1 100644 --- a/develop/dev-guide-proxysql-integration.md +++ b/develop/dev-guide-proxysql-integration.md @@ -241,7 +241,7 @@ mysql -u root -h 127.0.0.1 -P 6033 -e "SELECT VERSION()" +--------------------+ | VERSION() | +--------------------+ -| 8.0.11-TiDB-v7.4.0 | +| 8.0.11-TiDB-v7.5.0 | +--------------------+ ``` diff --git a/develop/dev-guide-sample-application-nodejs-mysql2.md b/develop/dev-guide-sample-application-nodejs-mysql2.md index e49a7502b92f..491083d39abc 100644 --- a/develop/dev-guide-sample-application-nodejs-mysql2.md +++ b/develop/dev-guide-sample-application-nodejs-mysql2.md @@ -179,7 +179,7 @@ npm run start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.4.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.5.0) ⏳ Loading sample game data... ✅ Loaded sample game data. diff --git a/develop/dev-guide-sample-application-nodejs-mysqljs.md b/develop/dev-guide-sample-application-nodejs-mysqljs.md index b2693a49f201..9030d8a53437 100644 --- a/develop/dev-guide-sample-application-nodejs-mysqljs.md +++ b/develop/dev-guide-sample-application-nodejs-mysqljs.md @@ -179,7 +179,7 @@ npm run start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.4.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.5.0) ⏳ Loading sample game data... ✅ Loaded sample game data. diff --git a/develop/dev-guide-sample-application-nodejs-typeorm.md b/develop/dev-guide-sample-application-nodejs-typeorm.md index e55660130908..1e4ed764dd2d 100644 --- a/develop/dev-guide-sample-application-nodejs-typeorm.md +++ b/develop/dev-guide-sample-application-nodejs-typeorm.md @@ -226,7 +226,7 @@ npm start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.4.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.5.0) 🆕 Created a new player with ID 2. ℹ️ Got Player 2: Player { id: 2, coins: 100, goods: 100 } 🔢 Added 50 coins and 50 goods to player 2, now player 2 has 100 coins and 150 goods. diff --git a/develop/dev-guide-sample-application-ruby-mysql2.md b/develop/dev-guide-sample-application-ruby-mysql2.md index 2950a49836a5..a0af8768c8e7 100644 --- a/develop/dev-guide-sample-application-ruby-mysql2.md +++ b/develop/dev-guide-sample-application-ruby-mysql2.md @@ -179,7 +179,7 @@ ruby app.rb 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.4.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.5.0) ⏳ Loading sample game data... ✅ Loaded sample game data. diff --git a/develop/dev-guide-sample-application-ruby-rails.md b/develop/dev-guide-sample-application-ruby-rails.md index 898fae33925e..104be557ec7f 100644 --- a/develop/dev-guide-sample-application-ruby-rails.md +++ b/develop/dev-guide-sample-application-ruby-rails.md @@ -173,7 +173,7 @@ bundle add mysql2 dotenv 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.4.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v7.5.0) ⏳ Loading sample game data... ✅ Loaded sample game data. diff --git a/dm/maintain-dm-using-tiup.md b/dm/maintain-dm-using-tiup.md index 0b10ff535ef8..1bfa244b5716 100644 --- a/dm/maintain-dm-using-tiup.md +++ b/dm/maintain-dm-using-tiup.md @@ -390,7 +390,7 @@ tiup dmctl --master-addr master1:8261 operate-source create /tmp/source1.yml 此时可以通过命令行参数 `--native-ssh` 启用系统自带命令行： -- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v7.4.0`），`` 为拓扑文件路径 +- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v7.5.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 20783cbb4435..4c6e197d8718 100644 --- a/dm/quick-start-create-task.md +++ b/dm/quick-start-create-task.md @@ -69,7 +69,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.4.0-linux-amd64.tar.gz +wget https://download.pingcap.org/tidb-community-server-v7.5.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 06e080df5c5c..beeb5c7c5a6b 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: 8.0.11-TiDB-v7.4.0 + VERSION: 8.0.11-TiDB-v7.5.0 GIT_HASH: 635a4362235e8a3c0043542e629532e3c7bb2756 BINLOG_STATUS: Off LABELS: diff --git a/pd-control.md b/pd-control.md index 3d5e9d97a57c..a4dec20da12a 100644 --- a/pd-control.md +++ b/pd-control.md @@ -28,7 +28,7 @@ PD Control 是 PD 的命令行工具，用于获取集群状态信息和调整 > **注意：** > -> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v7.4.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v7.4.0-linux-amd64.tar.gz`。 +> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v7.5.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v7.5.0-linux-amd64.tar.gz`。 ### 源码编译 diff --git a/post-installation-check.md b/post-installation-check.md index 3e04f744611d..641207e97c0c 100644 --- a/post-installation-check.md +++ b/post-installation-check.md @@ -63,7 +63,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: 8.0.11-TiDB-v7.4.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 8.0 compatible +Server version: 8.0.11-TiDB-v7.5.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 8.0 compatible Copyright (c) 2000, 2023, Oracle and/or its affiliates. All rights reserved. diff --git a/production-deployment-using-tiup.md b/production-deployment-using-tiup.md index 1ffa10c9f94b..7cafbaeb1a02 100644 --- a/production-deployment-using-tiup.md +++ b/production-deployment-using-tiup.md @@ -341,13 +341,13 @@ alertmanager_servers: {{< copyable "shell-regular" >}} ```shell - tiup cluster deploy tidb-test v7.4.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] + tiup cluster deploy tidb-test v7.5.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] ``` 以上部署示例中： - `tidb-test` 为部署的集群名称。 -- `v7.4.0` 为部署的集群版本，可以通过执行 `tiup list tidb` 来查看 TiUP 支持的最新可用版本。 +- `v7.5.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 d21be50f9cc3..160a80844763 100644 --- a/quick-start-with-tidb.md +++ b/quick-start-with-tidb.md @@ -81,10 +81,10 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti {{< copyable "shell-regular" >}} ```shell - tiup playground v7.4.0 --db 2 --pd 3 --kv 3 + tiup playground v7.5.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v7.4.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v7.5.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -198,10 +198,10 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti {{< copyable "shell-regular" >}} ```shell - tiup playground v7.4.0 --db 2 --pd 3 --kv 3 + tiup playground v7.5.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v7.4.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v7.5.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -432,7 +432,7 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti ``` - 参数 `` 表示设置集群名称 - - 参数 `` 表示设置集群版本，例如 `v7.4.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 + - 参数 `` 表示设置集群版本，例如 `v7.5.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 - 参数 `-p` 表示在连接目标机器时使用密码登录 > **注意：** diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md index 337d05a0ee9a..26eb94509f31 100644 --- a/scale-tidb-using-tiup.md +++ b/scale-tidb-using-tiup.md @@ -280,7 +280,7 @@ Starting /root/.tiup/components/cluster/v1.12.3/cluster display TiDB Cluster: -TiDB Version: v7.4.0 +TiDB Version: v7.5.0 ID Role Host Ports Status Data Dir Deploy Dir diff --git a/system-variables.md b/system-variables.md index 60fa15cac27d..f972a025eabc 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5037,7 +5037,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec) - 作用域：NONE - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否 - 默认值：`8.0.11-TiDB-(tidb version)` -- 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '8.0.11-TiDB-v7.4.0'。 +- 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '8.0.11-TiDB-v7.5.0'。 ### `version_comment` diff --git a/ticdc/deploy-ticdc.md b/ticdc/deploy-ticdc.md index faa86d25301d..fc097ed8ba83 100644 --- a/ticdc/deploy-ticdc.md +++ b/ticdc/deploy-ticdc.md @@ -95,7 +95,7 @@ tiup cluster upgrade --transfer-timeout 600 > **注意：** > -> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v7.4.0。 +> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v7.5.0。 ### 升级的注意事项 @@ -152,7 +152,7 @@ tiup cluster upgrade --transfer-timeout 600 ## 使用 TiCDC 命令行工具来查看集群状态 -执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v7.4.0`： +执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v7.5.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 f7da3c39c430..9f01c8f7b422 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.4.0", + "version": "v7.5.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 a5480b727f3e..e770eca871a0 100644 --- a/tidb-binlog/get-started-with-tidb-binlog.md +++ b/tidb-binlog/get-started-with-tidb-binlog.md @@ -47,7 +47,7 @@ sudo yum install -y mariadb-server {{< copyable "shell-regular" >}} ```bash -curl -LO https://download.pingcap.org/tidb-community-server-v7.4.0-linux-amd64.tar.gz | tar xzf - && +curl -LO https://download.pingcap.org/tidb-community-server-v7.5.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 313aabc25ba6..9da321ebbd56 100644 --- a/tidb-monitoring-api.md +++ b/tidb-monitoring-api.md @@ -32,7 +32,7 @@ curl http://127.0.0.1:10080/status ``` { connections: 0, # 当前 TiDB Server 上的客户端连接数 - version: "8.0.11-TiDB-v7.4.0", # TiDB 版本号 + version: "8.0.11-TiDB-v7.5.0", # TiDB 版本号 git_hash: "7267747ae0ec624dffc3fdedb00f1ed36e10284b" # TiDB 当前代码的 Git Hash } ``` diff --git a/tiflash/create-tiflash-replicas.md b/tiflash/create-tiflash-replicas.md index 93986be56506..eac99100ec62 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.4.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： + > 上述命令中，需要将 `v` 替换为该集群版本，例如 `v7.5.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： > > ```shell - > tiup ctl:v7.4.0 pd -u http://192.168.1.4:2379 store limit all engine tiflash 60 add-peer + > tiup ctl:v7.5.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 316d3950b7dd..0f624cc3e432 100644 --- a/tiup/tiup-cluster.md +++ b/tiup/tiup-cluster.md @@ -61,7 +61,7 @@ Flags: tiup cluster deploy [flags] ``` -该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v7.4.0`），以及一个集群的拓扑文件。 +该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v7.5.0`），以及一个集群的拓扑文件。 拓扑文件的编写可参考[示例](https://github.com/pingcap/tiup/blob/master/embed/examples/cluster/topology.example.yaml)。以一个最简单的拓扑为例，将下列文件保存为 `/tmp/topology.yaml`： @@ -118,12 +118,12 @@ tidb_servers: ... ``` -假如我们想要使用 TiDB 的 v7.4.0 版本，集群名字为 `prod-cluster`，则执行以下命令： +假如我们想要使用 TiDB 的 v7.5.0 版本，集群名字为 `prod-cluster`，则执行以下命令： {{< copyable "shell-regular" >}} ```shell -tiup cluster deploy -p prod-cluster v7.4.0 /tmp/topology.yaml +tiup cluster deploy -p prod-cluster v7.5.0 /tmp/topology.yaml ``` 执行过程中会再次确认拓扑结构并提示输入目标机器上的 root 密码（-p 表示使用密码）： @@ -131,7 +131,7 @@ tiup cluster deploy -p prod-cluster v7.4.0 /tmp/topology.yaml ```bash Please confirm your topology: TiDB Cluster: prod-cluster -TiDB Version: v7.4.0 +TiDB Version: v7.5.0 Type Host Ports OS/Arch Directories ---- ---- ----- ------- ----------- pd 172.16.5.134 2379/2380 linux/x86_64 deploy/pd-2379,data/pd-2379 @@ -174,7 +174,7 @@ tiup cluster list Starting /root/.tiup/components/cluster/v1.12.3/cluster list Name User Version Path PrivateKey ---- ---- ------- ---- ---------- -prod-cluster tidb v7.4.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa +prod-cluster tidb v7.5.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa ``` ## 启动集群 @@ -202,7 +202,7 @@ tiup cluster display prod-cluster ``` Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v7.4.0 +TiDB Version: v7.5.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 @@ -270,7 +270,7 @@ tiup cluster display prod-cluster ``` Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v7.4.0 +TiDB Version: v7.5.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 @@ -370,12 +370,12 @@ Global Flags: -y, --yes 跳过所有的确认步骤 ``` -例如，把集群升级到 v7.4.0 的命令为： +例如，把集群升级到 v7.5.0 的命令为： {{< copyable "shell-regular" >}} ```bash -tiup cluster upgrade tidb-test v7.4.0 +tiup cluster upgrade tidb-test v7.5.0 ``` ## 更新配置 @@ -555,11 +555,11 @@ tiup cluster audit Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.12.3/cluster audit ID Time Command -- ---- ------- -4BLhr0 2023-10-12T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.4.0 /tmp/topology.yaml -4BKWjF 2023-10-12T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.4.0 /tmp/topology.yaml -4BKVwH 2023-10-12T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.4.0 /tmp/topology.yaml -4BKKH1 2023-10-12T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster destroy test -4BKKDx 2023-10-12T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.4.0 /tmp/topology.yaml +4BLhr0 2023-12-01T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.5.0 /tmp/topology.yaml +4BKWjF 2023-12-01T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.5.0 /tmp/topology.yaml +4BKVwH 2023-12-01T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.5.0 /tmp/topology.yaml +4BKKH1 2023-12-01T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster destroy test +4BKKDx 2023-12-01T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v7.5.0 /tmp/topology.yaml ``` 第一列为 audit-id，如果想看某个命令的执行日志，则传入这个 audit-id： @@ -673,7 +673,7 @@ tiup cluster check --cluster 此时可以通过命令行参数 `--ssh=system` 启用系统自带命令行： -- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v7.4.0`），`` 为拓扑文件路径 +- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v7.5.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 2642d3fa9051..6e9f01956e06 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.4.0` +- `` 为要部署的 TiDB 集群版本号，如 `v7.5.0` - `` 为事先编写好的[拓扑文件](/tiup/tiup-cluster-topology-reference.md) ## 选项 diff --git a/tiup/tiup-component-cluster-patch.md b/tiup/tiup-component-cluster-patch.md index 19465138c179..0748ba887c03 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.4.0`、`v6.5.3`）。 + - `${version}`：组件的版本（例如 `v7.5.0`、`v6.5.3`）。 - `${os}`：操作系统 (`linux`)。 - `${arch}`：组件运行的平台 (`amd64`、`arm64`)。 2. 下载当前的组件包： diff --git a/tiup/tiup-component-cluster-upgrade.md b/tiup/tiup-component-cluster-upgrade.md index a7b5f008c307..d091dbccb529 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.4.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v7.5.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-dm-upgrade.md b/tiup/tiup-component-dm-upgrade.md index 35c4340e0db7..ccc69a7a3d9f 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.4.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v7.5.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-management.md b/tiup/tiup-component-management.md index bc46e1ebdeb0..6558bb5b232d 100644 --- a/tiup/tiup-component-management.md +++ b/tiup/tiup-component-management.md @@ -71,12 +71,12 @@ tiup install tidb tiup install tidb:nightly ``` -示例三：使用 TiUP 安装 v7.4.0 版本的 TiKV +示例三：使用 TiUP 安装 v7.5.0 版本的 TiKV {{< copyable "shell-regular" >}} ```shell -tiup install tikv:v7.4.0 +tiup install tikv:v7.5.0 ``` ## 升级组件 @@ -129,12 +129,12 @@ Flags: 如果想要多次启动同一个组件并复用之前的工作目录，就可以在启动时用 `--tag` 指定相同的名字。指定 tag 后，在实例终止时就*不会自动删除*工作目录，方便下次启动时复用。 -示例一：运行 v7.4.0 版本的 TiDB +示例一：运行 v7.5.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup tidb:v7.4.0 +tiup tidb:v7.5.0 ``` 示例二：指定 tag 运行 TiKV @@ -220,12 +220,12 @@ component 为要卸载的组件名称，version 为要卸载的版本，这两 - 若省略版本，加 `--all` 表示卸载该组件所有版本 - 若版本和组件都省略，则加 `--all` 表示卸载所有组件及其所有版本 -示例一：卸载 v7.4.0 版本的 TiDB +示例一：卸载 v7.5.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup uninstall tidb:v7.4.0 +tiup uninstall tidb:v7.5.0 ``` 示例二：卸载所有版本的 TiKV diff --git a/tiup/tiup-mirror.md b/tiup/tiup-mirror.md index 0fb8a9d3747f..78e7e5abb3ed 100644 --- a/tiup/tiup-mirror.md +++ b/tiup/tiup-mirror.md @@ -86,9 +86,9 @@ tiup mirror clone [global-version] [flags] 如果只想克隆某个组件的某一个版本而不是所有版本，则使用 `--=` 来限定，例如： - - 只想克隆 TiDB 的 v7.4.0 版本，则执行 `tiup mirror clone --tidb v7.4.0` - - 只想克隆 TiDB 的 v7.4.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v7.4.0 --tikv all` - - 克隆一个集群的所有组件的 v7.4.0 版本，则执行 `tiup mirror clone v7.4.0` + - 只想克隆 TiDB 的 v7.5.0 版本，则执行 `tiup mirror clone --tidb v7.5.0` + - 只想克隆 TiDB 的 v7.5.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v7.5.0 --tikv all` + - 克隆一个集群的所有组件的 v7.5.0 版本，则执行 `tiup mirror clone v7.5.0` 克隆完成后，签名密钥会自动设置。 diff --git a/tiup/tiup-playground.md b/tiup/tiup-playground.md index 8ae033bb9eeb..890c55756dba 100644 --- a/tiup/tiup-playground.md +++ b/tiup/tiup-playground.md @@ -19,7 +19,7 @@ tiup playground ${version} [flags] - 因为该命令没有指定 playground 的版本，TiUP 会先查找已安装的 playground 的最新版本，假设已安装的 playground 最新版为 v1.12.3，则该命令相当于 tiup playground:v1.12.3 - 如果 playground 从未安装过任何版本的 TiDB/TiKV/PD 组件，TiUP 会先安装这些组件的最新稳定版，然后再启动运行这些组件的实例 -- 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v7.4.0，则该命令相当于 tiup playground:1.12.3 v7.4.0 +- 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v7.5.0，则该命令相当于 tiup playground:1.12.3 v7.5.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 af7569245504..21bacb13d958 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -7,10 +7,10 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u 本文档适用于以下升级路径： -- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 7.4。 -- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 7.4。 -- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 7.4。 -- 使用 TiUP 从 TiDB 7.0-7.3 版本升级至 TiDB 7.4。 +- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 7.5。 +- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 7.5。 +- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 7.5。 +- 使用 TiUP 从 TiDB 7.0-7.4 版本升级至 TiDB 7.5。 > **警告：** > @@ -22,19 +22,19 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u > **注意：** > -> - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.4.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.4.0 及后续修订版本。 +> - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v7.5.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v7.5.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 ## 1. 升级兼容性说明 - TiDB 目前暂不支持版本降级或升级后回退。 -- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v7.4.0 版本。 -- 若要将 v3.0 之前的版本升级至 v7.4.0 版本： +- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v7.5.0 版本。 +- 若要将 v3.0 之前的版本升级至 v7.5.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.4.0 版本。 + 4. 按本文档说明将集群升级到 v7.5.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 的兼容性更改调整集群的配置。 @@ -46,7 +46,7 @@ aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/u ### 2.1 查阅兼容性变更 -查阅 TiDB v7.4.0 release notes 中的[兼容性变更](/releases/release-7.4.0.md#兼容性变更)。如果有任何变更影响到了你的升级，请采取相应的措施。 +查阅 TiDB v7.5.0 release notes 中的[兼容性变更](/releases/release-7.5.0.md#兼容性变更)。如果有任何变更影响到了你的升级，请采取相应的措施。 ### 2.2 升级 TiUP 或更新 TiUP 离线镜像 @@ -123,7 +123,7 @@ tiup update cluster > 以下情况可跳过此步骤： > > - 原集群没有修改过配置参数，或通过 tiup cluster 修改过参数但不需要调整。 -> - 升级后对未修改过的配置项希望使用 `7.4.0` 默认参数。 +> - 升级后对未修改过的配置项希望使用 `7.5.0` 默认参数。 1. 进入拓扑文件的 `vi` 编辑模式： @@ -139,7 +139,7 @@ tiup update cluster > **注意：** > -> 升级到 v7.4.0 版本前，请确认已在 4.0 修改的参数在 v7.4.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 +> 升级到 v7.5.0 版本前，请确认已在 4.0 修改的参数在 v7.5.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 ### 2.4 检查当前集群的健康状况 @@ -176,12 +176,12 @@ tiup cluster check --cluster tiup cluster upgrade ``` -以升级到 v7.4.0 版本为例： +以升级到 v7.5.0 版本为例： {{< copyable "shell-regular" >}} ``` -tiup cluster upgrade v7.4.0 +tiup cluster upgrade v7.5.0 ``` > **注意：** @@ -228,7 +228,7 @@ tiup cluster upgrade -h | grep "version string" tiup cluster stop ``` -之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v7.4.0`。 +之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v7.5.0`。 {{< copyable "shell-regular" >}} @@ -257,7 +257,7 @@ tiup cluster display ``` Cluster type: tidb Cluster name: -Cluster version: v7.4.0 +Cluster version: v7.5.0 ``` ## 4. 升级 FAQ @@ -312,7 +312,7 @@ Cluster version: v7.4.0 ### 4.3 升级过程中 evict leader 等待时间过长，如何跳过该步骤快速升级 -可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v7.4.0`： +可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v7.5.0`： {{< copyable "shell-regular" >}} @@ -327,5 +327,5 @@ tiup cluster upgrade --force {{< copyable "" >}} ``` -tiup install ctl:v7.4.0 +tiup install ctl:v7.5.0 ```