From 3c530863a2cc5d2764f6ba6bcc105b18cf552274 Mon Sep 17 00:00:00 2001 From: Aolin Date: Fri, 24 May 2024 16:40:18 +0800 Subject: [PATCH] bump TiDB version to v8.1.0 (#17341) --- README.md | 1 + br/backup-and-restore-use-cases.md | 6 +-- ...-guide-sample-application-nodejs-mysql2.md | 2 +- ...guide-sample-application-nodejs-mysqljs.md | 2 +- ...guide-sample-application-nodejs-typeorm.md | 2 +- ...ev-guide-sample-application-ruby-mysql2.md | 2 +- ...dev-guide-sample-application-ruby-rails.md | 2 +- dm/maintain-dm-using-tiup.md | 2 +- dm/quick-start-create-task.md | 2 +- .../information-schema-tidb-servers-info.md | 2 +- pd-control.md | 2 +- post-installation-check.md | 2 +- production-deployment-using-tiup.md | 4 +- quick-start-with-tidb.md | 10 ++--- scale-tidb-using-tiup.md | 2 +- system-variables.md | 2 +- ticdc/deploy-ticdc.md | 4 +- ticdc/ticdc-changefeed-config.md | 2 +- ticdc/ticdc-changefeed-overview.md | 2 +- ticdc/ticdc-manage-changefeed.md | 2 +- ticdc/ticdc-open-api-v2.md | 2 +- ticdc/ticdc-sink-to-cloud-storage.md | 2 +- ticdc/ticdc-sink-to-pulsar.md | 2 +- tidb-binlog/get-started-with-tidb-binlog.md | 2 +- tidb-monitoring-api.md | 2 +- tiflash/create-tiflash-replicas.md | 4 +- tiup/tiup-cluster.md | 30 +++++++-------- tiup/tiup-component-cluster-deploy.md | 2 +- tiup/tiup-component-cluster-patch.md | 2 +- tiup/tiup-component-cluster-upgrade.md | 2 +- tiup/tiup-component-dm-upgrade.md | 2 +- tiup/tiup-component-management.md | 12 +++--- tiup/tiup-mirror.md | 6 +-- tiup/tiup-playground.md | 2 +- upgrade-tidb-using-tiup.md | 37 ++++++++++--------- 35 files changed, 83 insertions(+), 81 deletions(-) diff --git a/README.md b/README.md index f7cfc005eac2..f961962f4633 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ | 文档仓库 branch | 对应 TiDB 文档版本 | |:---------|:----------| | [`master`](https://github.com/pingcap/docs-cn/tree/master) | dev 最新开发版 | +| [`release-8.1`](https://github.com/pingcap/docs-cn/tree/release-8.1) | 8.1 长期支持版 (LTS) | | [`release-8.0`](https://github.com/pingcap/docs-cn/tree/release-8.0) | 8.0 开发里程碑版 (DMR) | | [`release-7.6`](https://github.com/pingcap/docs-cn/tree/release-7.6) | 7.6 开发里程碑版 (DMR) | | [`release-7.5`](https://github.com/pingcap/docs-cn/tree/release-7.5) | 7.5 长期支持版 (LTS) | diff --git a/br/backup-and-restore-use-cases.md b/br/backup-and-restore-use-cases.md index d2f4ff3a0dae..6060095cde56 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 集群相同的版本，本文假设使用的是 v8.0.0 版本。 +使用 PITR 功能，需要部署 v6.2.0 或以上版本的 TiDB 集群，并且更新 br 命令行工具到与 TiDB 集群相同的版本，本文假设使用的是 v8.1.0 版本。 下表介绍了在 TiDB 集群中使用日志备份功能的推荐配置。 @@ -44,13 +44,13 @@ aliases: ['/docs-cn/dev/br/backup-and-restore-use-cases/','/docs-cn/dev/referenc - 安装： ```shell - tiup install br:v8.0.0 + tiup install br:v8.1.0 ``` - 升级： ```shell - tiup update br:v8.0.0 + tiup update br:v8.1.0 ``` ## 配置备份存储 (Amazon S3) diff --git a/develop/dev-guide-sample-application-nodejs-mysql2.md b/develop/dev-guide-sample-application-nodejs-mysql2.md index c1206abd026c..d1c8967b592b 100644 --- a/develop/dev-guide-sample-application-nodejs-mysql2.md +++ b/develop/dev-guide-sample-application-nodejs-mysql2.md @@ -180,7 +180,7 @@ npm run start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.0.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.1.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 ae28d3c36606..6a0b4f0119d3 100644 --- a/develop/dev-guide-sample-application-nodejs-mysqljs.md +++ b/develop/dev-guide-sample-application-nodejs-mysqljs.md @@ -180,7 +180,7 @@ npm run start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.0.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.1.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 55110c02d5fb..75f6855fafde 100644 --- a/develop/dev-guide-sample-application-nodejs-typeorm.md +++ b/develop/dev-guide-sample-application-nodejs-typeorm.md @@ -227,7 +227,7 @@ npm start 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.0.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.1.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 c8bed2df12e6..9fe8c2c49738 100644 --- a/develop/dev-guide-sample-application-ruby-mysql2.md +++ b/develop/dev-guide-sample-application-ruby-mysql2.md @@ -180,7 +180,7 @@ ruby app.rb 如果连接成功，你的终端将会输出所连接集群的版本信息： ``` -🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.0.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.1.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 e066149fd953..d155099d1f69 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-v8.0.0) +🔌 Connected to TiDB cluster! (TiDB version: 8.0.11-TiDB-v8.1.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 c8eda6dd5b81..a1e64d360238 100644 --- a/dm/maintain-dm-using-tiup.md +++ b/dm/maintain-dm-using-tiup.md @@ -394,7 +394,7 @@ tiup dmctl --master-addr master1:8261 operate-source create /tmp/source1.yml 此时可以通过命令行参数 `--native-ssh` 启用系统自带命令行： -- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v8.0.0`），`` 为拓扑文件路径 +- 部署集群：`tiup dm deploy --native-ssh`，其中 `` 为集群名称，`` 为 DM 集群版本（例如 `v8.1.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 67615e819e94..a18d8786e1a1 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-v8.0.0-linux-amd64.tar.gz +wget https://download.pingcap.org/tidb-community-server-v8.1.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 5201b65c0f14..867558434eee 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-v8.0.0 + VERSION: 8.0.11-TiDB-v8.1.0 GIT_HASH: 635a4362235e8a3c0043542e629532e3c7bb2756 BINLOG_STATUS: Off LABELS: diff --git a/pd-control.md b/pd-control.md index 6d35f84d6f3f..ae1eaee151e9 100644 --- a/pd-control.md +++ b/pd-control.md @@ -29,7 +29,7 @@ PD Control 是 PD 的命令行工具，用于获取集群状态信息和调整 > **注意：** > -> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v8.0.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v8.0.0-linux-amd64.tar.gz`。 +> 下载链接中的 `{version}` 为 TiDB 的版本号。例如，amd64 架构的 `v8.1.0` 版本的下载链接为 `https://download.pingcap.org/tidb-community-server-v8.1.0-linux-amd64.tar.gz`。 ### 源码编译 diff --git a/post-installation-check.md b/post-installation-check.md index 275a3da7b59f..a4807bcfe49f 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-v8.0.0 TiDB Server (Apache License 2.0) Community Edition, MySQL 8.0 compatible +Server version: 8.0.11-TiDB-v8.1.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 839164c97826..27e934b285e5 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 v8.0.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] + tiup cluster deploy tidb-test v8.1.0 ./topology.yaml --user root [-p] [-i /home/root/.ssh/gcp_rsa] ``` 以上部署示例中： - `tidb-test` 为部署的集群名称。 -- `v8.0.0` 为部署的集群版本，可以通过执行 `tiup list tidb` 来查看 TiUP 支持的最新可用版本。 +- `v8.1.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 dcea643c06ed..394cac21f53a 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 v8.0.0 --db 2 --pd 3 --kv 3 + tiup playground v8.1.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v8.0.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v8.1.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -198,10 +198,10 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti {{< copyable "shell-regular" >}} ```shell - tiup playground v8.0.0 --db 2 --pd 3 --kv 3 + tiup playground v8.1.0 --db 2 --pd 3 --kv 3 ``` - 上述命令会在本地下载并启动某个版本的集群（例如 v8.0.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： + 上述命令会在本地下载并启动某个版本的集群（例如 v8.1.0）。最新版本可以通过执行 `tiup list tidb` 来查看。运行结果将显示集群的访问方式： ```log CLUSTER START SUCCESSFULLY, Enjoy it ^-^ @@ -432,7 +432,7 @@ TiDB 是一个分布式系统。最基础的 TiDB 测试集群通常由 2 个 Ti ``` - 参数 `` 表示设置集群名称 - - 参数 `` 表示设置集群版本，例如 `v8.0.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 + - 参数 `` 表示设置集群版本，例如 `v8.1.0`。可以通过 `tiup list tidb` 命令来查看当前支持部署的 TiDB 版本 - 参数 `-p` 表示在连接目标机器时使用密码登录 > **注意：** diff --git a/scale-tidb-using-tiup.md b/scale-tidb-using-tiup.md index e75eeeeef258..4c5d4ac6cef3 100644 --- a/scale-tidb-using-tiup.md +++ b/scale-tidb-using-tiup.md @@ -303,7 +303,7 @@ Starting /root/.tiup/components/cluster/v1.12.3/cluster display TiDB Cluster: -TiDB Version: v8.0.0 +TiDB Version: v8.1.0 ID Role Host Ports Status Data Dir Deploy Dir diff --git a/system-variables.md b/system-variables.md index 909404f1d1e8..d3e68a17f9a7 100644 --- a/system-variables.md +++ b/system-variables.md @@ -5346,7 +5346,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-v8.0.0'。 +- 这个变量的值是 MySQL 的版本和 TiDB 的版本，例如 '8.0.11-TiDB-v8.1.0'。 ### `version_comment` diff --git a/ticdc/deploy-ticdc.md b/ticdc/deploy-ticdc.md index 0359b5125631..859f7cf254c9 100644 --- a/ticdc/deploy-ticdc.md +++ b/ticdc/deploy-ticdc.md @@ -95,7 +95,7 @@ tiup cluster upgrade --transfer-timeout 600 > **注意：** > -> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v8.0.0。 +> 命令中的 `` 需要替换为集群名字，`` 需要替换为目标版本号，例如 v8.1.0。 ### 升级的注意事项 @@ -152,7 +152,7 @@ tiup cluster upgrade --transfer-timeout 600 ## 使用 TiCDC 命令行工具来查看集群状态 -执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v8.0.0`： +执行以下命令来查看 TiCDC 集群运行状态，注意需要将 `v` 替换为 TiCDC 集群版本，例如 `v8.1.0`： ```shell tiup cdc:v cli capture list --server=http://10.0.10.25:8300 diff --git a/ticdc/ticdc-changefeed-config.md b/ticdc/ticdc-changefeed-config.md index 331e074f6ed2..ed0c9020adf8 100644 --- a/ticdc/ticdc-changefeed-config.md +++ b/ticdc/ticdc-changefeed-config.md @@ -16,7 +16,7 @@ cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://ro ```shell Create changefeed successfully! ID: simple-replication-task -Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-replication-task","sink_uri":"mysql://root:xxxxx@127.0.0.1:4000/?time-zone=","create_time":"2024-03-28T15:05:46.679218+08:00","start_ts":438156275634929669,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":true,"bdr_mode":false,"sync_point_interval":30000000000,"sync_point_retention":3600000000000,"filter":{"rules":["test.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.0.0"} +Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-replication-task","sink_uri":"mysql://root:xxxxx@127.0.0.1:4000/?time-zone=","create_time":"2024-05-24T15:05:46.679218+08:00","start_ts":438156275634929669,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":true,"bdr_mode":false,"sync_point_interval":30000000000,"sync_point_retention":3600000000000,"filter":{"rules":["test.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.1.0"} ``` - `--changefeed-id`：同步任务的 ID，格式需要符合正则表达式 `^[a-zA-Z0-9]+(\-[a-zA-Z0-9]+)*$`。如果不指定该 ID，TiCDC 会自动生成一个 UUID（version 4 格式）作为 ID。 diff --git a/ticdc/ticdc-changefeed-overview.md b/ticdc/ticdc-changefeed-overview.md index 354b85aa6f9c..2c66cfe2c165 100644 --- a/ticdc/ticdc-changefeed-overview.md +++ b/ticdc/ticdc-changefeed-overview.md @@ -42,4 +42,4 @@ Changefeed 是 TiCDC 中的单个同步任务。Changefeed 将一个 TiDB 集群 通过 TiCDC 提供的命令行工具 `cdc cli`，你可以管理 TiCDC 集群和同步任务，具体可参考[管理 TiCDC Changefeed](/ticdc/ticdc-manage-changefeed.md)。你也可以通过 HTTP 接口，即 TiCDC OpenAPI 来管理 TiCDC 集群和同步任务，详见 [TiCDC OpenAPI](/ticdc/ticdc-open-api-v2.md)。 -如果你使用的 TiCDC 是用 TiUP 部署的，可以通过 `tiup cdc:v cli` 来使用 TiCDC 命令行工具，注意需要将 `v` 替换为 TiCDC 集群版本，例如 v8.0.0。你也可以通过直接执行 `cdc cli` 直接使用命令行工具。 +如果你使用的 TiCDC 是用 TiUP 部署的，可以通过 `tiup cdc:v cli` 来使用 TiCDC 命令行工具，注意需要将 `v` 替换为 TiCDC 集群版本，例如 v8.1.0。你也可以通过直接执行 `cdc cli` 直接使用命令行工具。 diff --git a/ticdc/ticdc-manage-changefeed.md b/ticdc/ticdc-manage-changefeed.md index bd9141246f49..44edf728ad5a 100644 --- a/ticdc/ticdc-manage-changefeed.md +++ b/ticdc/ticdc-manage-changefeed.md @@ -19,7 +19,7 @@ cdc cli changefeed create --server=http://10.0.10.25:8300 --sink-uri="mysql://ro ```shell Create changefeed successfully! ID: simple-replication-task -Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-replication-task","sink_uri":"mysql://root:xxxxx@127.0.0.1:4000/?time-zone=","create_time":"2024-03-28T15:05:46.679218+08:00","start_ts":438156275634929669,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":true,"bdr_mode":false,"sync_point_interval":30000000000,"sync_point_retention":3600000000000,"filter":{"rules":["test.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.0.0"} +Info: {"upstream_id":7178706266519722477,"namespace":"default","id":"simple-replication-task","sink_uri":"mysql://root:xxxxx@127.0.0.1:4000/?time-zone=","create_time":"2024-05-24T15:05:46.679218+08:00","start_ts":438156275634929669,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":true,"bdr_mode":false,"sync_point_interval":30000000000,"sync_point_retention":3600000000000,"filter":{"rules":["test.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.1.0"} ``` ## 查询同步任务列表 diff --git a/ticdc/ticdc-open-api-v2.md b/ticdc/ticdc-open-api-v2.md index 7398b3f476b6..420747396836 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": "v8.0.0", + "version": "v8.1.0", "git_hash": "10413bded1bdb2850aa6d7b94eb375102e9c44dc", "id": "d2912e63-3349-447c-90ba-72a4e04b5e9e", "pid": 1447, diff --git a/ticdc/ticdc-sink-to-cloud-storage.md b/ticdc/ticdc-sink-to-cloud-storage.md index 9c916c8c0232..3bd6f6c10b81 100644 --- a/ticdc/ticdc-sink-to-cloud-storage.md +++ b/ticdc/ticdc-sink-to-cloud-storage.md @@ -24,7 +24,7 @@ cdc cli changefeed create \ 输出结果如下： ```shell -Info: {"upstream_id":7171388873935111376,"namespace":"default","id":"simple-replication-task","sink_uri":"s3://logbucket/storage_test?protocol=canal-json","create_time":"2024-03-28T18:52:05.566016967+08:00","start_ts":437706850431664129,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":false,"sync_point_interval":600000000000,"sync_point_retention":86400000000000,"filter":{"rules":["*.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"canal-json","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.0.0"} +Info: {"upstream_id":7171388873935111376,"namespace":"default","id":"simple-replication-task","sink_uri":"s3://logbucket/storage_test?protocol=canal-json","create_time":"2024-05-24T18:52:05.566016967+08:00","start_ts":437706850431664129,"engine":"unified","config":{"case_sensitive":false,"enable_old_value":true,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":false,"sync_point_interval":600000000000,"sync_point_retention":86400000000000,"filter":{"rules":["*.*"],"event_filters":null},"mounter":{"worker_num":16},"sink":{"protocol":"canal-json","schema_registry":"","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false},"column_selectors":null,"transaction_atomicity":"none","encoder_concurrency":16,"terminator":"\r\n","date_separator":"none","enable_partition_separator":false},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"storage":""}},"state":"normal","creator_version":"v8.1.0"} ``` - `--server`：TiCDC 集群中任意一个 TiCDC 服务器的地址。 diff --git a/ticdc/ticdc-sink-to-pulsar.md b/ticdc/ticdc-sink-to-pulsar.md index b85ad8862d43..f8870ad33355 100644 --- a/ticdc/ticdc-sink-to-pulsar.md +++ b/ticdc/ticdc-sink-to-pulsar.md @@ -23,7 +23,7 @@ cdc cli changefeed create \ Create changefeed successfully! ID: simple-replication-task -Info: {"upstream_id":7277814241002263370,"namespace":"default","id":"simple-replication-task","sink_uri":"pulsar://127.0.0.1:6650/consumer-test?protocol=canal-json","create_time":"2024-03-28T14:42:32.000904+08:00","start_ts":444203257406423044,"config":{"memory_quota":1073741824,"case_sensitive":false,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":false,"bdr_mode":false,"sync_point_interval":600000000000,"sync_point_retention":86400000000000,"filter":{"rules":["pulsar_test.*"]},"mounter":{"worker_num":16},"sink":{"protocol":"canal-json","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false,"binary_encoding_method":"base64"},"dispatchers":[{"matcher":["pulsar_test.*"],"partition":"","topic":"test_{schema}_{table}"}],"encoder_concurrency":16,"terminator":"\r\n","date_separator":"day","enable_partition_separator":true,"only_output_updated_columns":false,"delete_only_output_handle_key_columns":false,"pulsar_config":{"connection-timeout":30,"operation-timeout":30,"batching-max-messages":1000,"batching-max-publish-delay":10,"send-timeout":30},"advance_timeout":150},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"use_file_backend":false},"scheduler":{"enable_table_across_nodes":false,"region_threshold":100000,"write_key_threshold":0},"integrity":{"integrity_check_level":"none","corruption_handle_level":"warn"}},"state":"normal","creator_version":"v8.0.0","resolved_ts":444203257406423044,"checkpoint_ts":444203257406423044,"checkpoint_time":"2024-01-25 14:42:31.410"} +Info: {"upstream_id":7277814241002263370,"namespace":"default","id":"simple-replication-task","sink_uri":"pulsar://127.0.0.1:6650/consumer-test?protocol=canal-json","create_time":"2024-05-24T14:42:32.000904+08:00","start_ts":444203257406423044,"config":{"memory_quota":1073741824,"case_sensitive":false,"force_replicate":false,"ignore_ineligible_table":false,"check_gc_safe_point":true,"enable_sync_point":false,"bdr_mode":false,"sync_point_interval":600000000000,"sync_point_retention":86400000000000,"filter":{"rules":["pulsar_test.*"]},"mounter":{"worker_num":16},"sink":{"protocol":"canal-json","csv":{"delimiter":",","quote":"\"","null":"\\N","include_commit_ts":false,"binary_encoding_method":"base64"},"dispatchers":[{"matcher":["pulsar_test.*"],"partition":"","topic":"test_{schema}_{table}"}],"encoder_concurrency":16,"terminator":"\r\n","date_separator":"day","enable_partition_separator":true,"only_output_updated_columns":false,"delete_only_output_handle_key_columns":false,"pulsar_config":{"connection-timeout":30,"operation-timeout":30,"batching-max-messages":1000,"batching-max-publish-delay":10,"send-timeout":30},"advance_timeout":150},"consistent":{"level":"none","max_log_size":64,"flush_interval":2000,"use_file_backend":false},"scheduler":{"enable_table_across_nodes":false,"region_threshold":100000,"write_key_threshold":0},"integrity":{"integrity_check_level":"none","corruption_handle_level":"warn"}},"state":"normal","creator_version":"v8.1.0","resolved_ts":444203257406423044,"checkpoint_ts":444203257406423044,"checkpoint_time":"2024-05-24 14:42:31.410"} ``` 各参数的含义如下： diff --git a/tidb-binlog/get-started-with-tidb-binlog.md b/tidb-binlog/get-started-with-tidb-binlog.md index 7af7d5ad699e..10602a12d3ca 100644 --- a/tidb-binlog/get-started-with-tidb-binlog.md +++ b/tidb-binlog/get-started-with-tidb-binlog.md @@ -48,7 +48,7 @@ sudo yum install -y mariadb-server {{< copyable "shell-regular" >}} ```bash -curl -LO https://download.pingcap.org/tidb-community-server-v8.0.0-linux-amd64.tar.gz | tar xzf - && +curl -LO https://download.pingcap.org/tidb-community-server-v8.1.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 194acb7a41dc..b856865704eb 100644 --- a/tidb-monitoring-api.md +++ b/tidb-monitoring-api.md @@ -33,7 +33,7 @@ curl http://127.0.0.1:10080/status ``` { connections: 0, # 当前 TiDB Server 上的客户端连接数 - version: "8.0.11-TiDB-v8.0.0", # TiDB 版本号 + version: "8.0.11-TiDB-v8.1.0", # TiDB 版本号 git_hash: "7267747ae0ec624dffc3fdedb00f1ed36e10284b" # TiDB 当前代码的 Git Hash } ``` diff --git a/tiflash/create-tiflash-replicas.md b/tiflash/create-tiflash-replicas.md index aa1d0494978f..16dff75432c0 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` 替换为该集群版本，例如 `v8.0.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： + > 上述命令中，需要将 `v` 替换为该集群版本，例如 `v8.1.0`，`:2379` 替换为任一 PD 节点的地址。替换后样例为： > > ```shell - > tiup ctl:v8.0.0 pd -u http://192.168.1.4:2379 store limit all engine tiflash 60 add-peer + > tiup ctl:v8.1.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 2dcf7748fcce..9a20b899a6e0 100644 --- a/tiup/tiup-cluster.md +++ b/tiup/tiup-cluster.md @@ -62,7 +62,7 @@ Flags: tiup cluster deploy [flags] ``` -该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v8.0.0`），以及一个集群的拓扑文件。 +该命令需要提供集群的名字、集群使用的 TiDB 版本（例如 `v8.1.0`），以及一个集群的拓扑文件。 拓扑文件的编写可参考[示例](https://github.com/pingcap/tiup/blob/master/embed/examples/cluster/topology.example.yaml)。以一个最简单的拓扑为例，将下列文件保存为 `/tmp/topology.yaml`： @@ -122,12 +122,12 @@ tidb_servers: ... ``` -假如我们想要使用 TiDB 的 v8.0.0 版本，集群名字为 `prod-cluster`，则执行以下命令： +假如我们想要使用 TiDB 的 v8.1.0 版本，集群名字为 `prod-cluster`，则执行以下命令： {{< copyable "shell-regular" >}} ```shell -tiup cluster deploy -p prod-cluster v8.0.0 /tmp/topology.yaml +tiup cluster deploy -p prod-cluster v8.1.0 /tmp/topology.yaml ``` 执行过程中会再次确认拓扑结构并提示输入目标机器上的 root 密码（-p 表示使用密码）： @@ -135,7 +135,7 @@ tiup cluster deploy -p prod-cluster v8.0.0 /tmp/topology.yaml ```bash Please confirm your topology: TiDB Cluster: prod-cluster -TiDB Version: v8.0.0 +TiDB Version: v8.1.0 Type Host Ports OS/Arch Directories ---- ---- ----- ------- ----------- pd 172.16.5.134 2379/2380 linux/x86_64 deploy/pd-2379,data/pd-2379 @@ -179,7 +179,7 @@ tiup cluster list Starting /root/.tiup/components/cluster/v1.12.3/cluster list Name User Version Path PrivateKey ---- ---- ------- ---- ---------- -prod-cluster tidb v8.0.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa +prod-cluster tidb v8.1.0 /root/.tiup/storage/cluster/clusters/prod-cluster /root/.tiup/storage/cluster/clusters/prod-cluster/ssh/id_rsa ``` ## 启动集群 @@ -207,7 +207,7 @@ tiup cluster display prod-cluster ``` Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v8.0.0 +TiDB Version: v8.1.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 @@ -276,7 +276,7 @@ tiup cluster display prod-cluster ``` Starting /root/.tiup/components/cluster/v1.12.3/cluster display prod-cluster TiDB Cluster: prod-cluster -TiDB Version: v8.0.0 +TiDB Version: v8.1.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 @@ -377,12 +377,12 @@ Global Flags: -y, --yes 跳过所有的确认步骤 ``` -例如，把集群升级到 v8.0.0 的命令为： +例如，把集群升级到 v8.1.0 的命令为： {{< copyable "shell-regular" >}} ```bash -tiup cluster upgrade tidb-test v8.0.0 +tiup cluster upgrade tidb-test v8.1.0 ``` ## 更新配置 @@ -562,11 +562,11 @@ tiup cluster audit Starting component `cluster`: /home/tidb/.tiup/components/cluster/v1.12.3/cluster audit ID Time Command -- ---- ------- -4BLhr0 2024-03-28T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.0.0 /tmp/topology.yaml -4BKWjF 22024-03-28T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.0.0 /tmp/topology.yaml -4BKVwH 2024-03-28T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.0.0 /tmp/topology.yaml -4BKKH1 2024-03-28T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster destroy test -4BKKDx 2024-03-28T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.0.0 /tmp/topology.yaml +4BLhr0 2024-05-24T23:55:09+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.1.0 /tmp/topology.yaml +4BKWjF 22024-05-24T23:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.1.0 /tmp/topology.yaml +4BKVwH 2024-05-24T23:02:08+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.1.0 /tmp/topology.yaml +4BKKH1 2024-05-24T16:39:04+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster destroy test +4BKKDx 2024-05-24T16:36:57+08:00 /home/tidb/.tiup/components/cluster/v1.12.3/cluster deploy test v8.1.0 /tmp/topology.yaml ``` 第一列为 audit-id，如果想看某个命令的执行日志，则传入这个 audit-id： @@ -680,7 +680,7 @@ tiup cluster check --cluster 此时可以通过命令行参数 `--ssh=system` 启用系统自带命令行： -- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v8.0.0`），`` 为拓扑文件路径 +- 部署集群：`tiup cluster deploy --ssh=system`，其中 `` 为集群名称，`` 为 TiDB 集群版本（例如 `v8.1.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 26b3e880908e..2197a9bab5ed 100644 --- a/tiup/tiup-component-cluster-deploy.md +++ b/tiup/tiup-component-cluster-deploy.md @@ -14,7 +14,7 @@ tiup cluster deploy [flags] ``` - `` 表示新集群的名字，不能和现有集群同名 -- `` 为要部署的 TiDB 集群版本号，如 `v8.0.0` +- `` 为要部署的 TiDB 集群版本号，如 `v8.1.0` - `` 为事先编写好的[拓扑文件](/tiup/tiup-cluster-topology-reference.md) ## 选项 diff --git a/tiup/tiup-component-cluster-patch.md b/tiup/tiup-component-cluster-patch.md index 0044d3104b74..17f585a4950b 100644 --- a/tiup/tiup-component-cluster-patch.md +++ b/tiup/tiup-component-cluster-patch.md @@ -29,7 +29,7 @@ tiup cluster patch [flags] 1. 确定以下变量的值： - `${component}`：需要替换的组件名（例如 `tidb`、`tikv`、`pd`）。 - - `${version}`：组件的版本（例如 `v8.0.0`、`v7.5.1`）。 + - `${version}`：组件的版本（例如 `v8.1.0`、`v7.5.1`）。 - `${os}`：操作系统 (`linux`)。 - `${arch}`：组件运行的平台 (`amd64`、`arm64`)。 2. 下载当前的组件包： diff --git a/tiup/tiup-component-cluster-upgrade.md b/tiup/tiup-component-cluster-upgrade.md index 587c1c075959..7862c6aa00bc 100644 --- a/tiup/tiup-component-cluster-upgrade.md +++ b/tiup/tiup-component-cluster-upgrade.md @@ -14,7 +14,7 @@ tiup cluster upgrade [flags] ``` - `` 为要操作的集群名字，如果忘记集群名字可通过[集群列表](/tiup/tiup-component-cluster-list.md)查看。 -- `` 为要升级到的目标版本，例如 `v8.0.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v8.1.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-dm-upgrade.md b/tiup/tiup-component-dm-upgrade.md index c5648167b633..4d4bb861ddc2 100644 --- a/tiup/tiup-component-dm-upgrade.md +++ b/tiup/tiup-component-dm-upgrade.md @@ -14,7 +14,7 @@ tiup dm upgrade [flags] ``` - `` 为要操作的集群名字，如果忘记集群名字可查看[集群列表](/tiup/tiup-component-dm-list.md)。 -- `` 为要升级到的目标版本，例如 `v8.0.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 +- `` 为要升级到的目标版本，例如 `v8.1.0`。目前仅允许升级到比当前集群更高的版本，不允许升级到比当前集群更低的版本，即不允许降级。同时也不允许升级成 nightly 版本。 ## 选项 diff --git a/tiup/tiup-component-management.md b/tiup/tiup-component-management.md index 780000efa9b6..ff7152d88571 100644 --- a/tiup/tiup-component-management.md +++ b/tiup/tiup-component-management.md @@ -72,12 +72,12 @@ tiup install tidb tiup install tidb:nightly ``` -示例三：使用 TiUP 安装 v8.0.0 版本的 TiKV +示例三：使用 TiUP 安装 v8.1.0 版本的 TiKV {{< copyable "shell-regular" >}} ```shell -tiup install tikv:v8.0.0 +tiup install tikv:v8.1.0 ``` ## 升级组件 @@ -130,12 +130,12 @@ Flags: 如果想要多次启动同一个组件并复用之前的工作目录，就可以在启动时用 `--tag` 指定相同的名字。指定 tag 后，在实例终止时就*不会自动删除*工作目录，方便下次启动时复用。 -示例一：运行 v8.0.0 版本的 TiDB +示例一：运行 v8.1.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup tidb:v8.0.0 +tiup tidb:v8.1.0 ``` 示例二：指定 tag 运行 TiKV @@ -221,12 +221,12 @@ component 为要卸载的组件名称，version 为要卸载的版本，这两 - 若省略版本，加 `--all` 表示卸载该组件所有版本 - 若版本和组件都省略，则加 `--all` 表示卸载所有组件及其所有版本 -示例一：卸载 v8.0.0 版本的 TiDB +示例一：卸载 v8.1.0 版本的 TiDB {{< copyable "shell-regular" >}} ```shell -tiup uninstall tidb:v8.0.0 +tiup uninstall tidb:v8.1.0 ``` 示例二：卸载所有版本的 TiKV diff --git a/tiup/tiup-mirror.md b/tiup/tiup-mirror.md index 83a1ef30d074..a17a6e3768d3 100644 --- a/tiup/tiup-mirror.md +++ b/tiup/tiup-mirror.md @@ -87,9 +87,9 @@ tiup mirror clone [global-version] [flags] 如果只想克隆某个组件的某一个版本而不是所有版本，则使用 `--=` 来限定，例如： - - 只想克隆 TiDB 的 v8.0.0 版本，则执行 `tiup mirror clone --tidb v8.0.0` - - 只想克隆 TiDB 的 v8.0.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v8.0.0 --tikv all` - - 克隆一个集群的所有组件的 v8.0.0 版本，则执行 `tiup mirror clone v8.0.0` + - 只想克隆 TiDB 的 v8.1.0 版本，则执行 `tiup mirror clone --tidb v8.1.0` + - 只想克隆 TiDB 的 v8.1.0 版本，以及 TiKV 的所有版本，则执行 `tiup mirror clone --tidb v8.1.0 --tikv all` + - 克隆一个集群的所有组件的 v8.1.0 版本，则执行 `tiup mirror clone v8.1.0` 克隆完成后，签名密钥会自动设置。 diff --git a/tiup/tiup-playground.md b/tiup/tiup-playground.md index 60e0ab2849a6..4496b6372b07 100644 --- a/tiup/tiup-playground.md +++ b/tiup/tiup-playground.md @@ -20,7 +20,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 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v8.0.0，则该命令相当于 tiup playground:1.12.3 v8.0.0 +- 因为该命令没有指定 TiDB/PD/TiKV 各组件的版本，默认情况下，它会使用各组件的最新发布版本，假设当前为 v8.1.0，则该命令相当于 tiup playground:1.12.3 v8.1.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 b2bf6dcfcf01..a39a01c70b5b 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -1,17 +1,18 @@ --- title: 使用 TiUP 升级 TiDB aliases: ['/docs-cn/dev/upgrade-tidb-using-tiup/','/docs-cn/dev/how-to/upgrade/using-tiup/','/docs-cn/dev/upgrade-tidb-using-tiup-offline/', '/zh/tidb/dev/upgrade-tidb-using-tiup-offline'] -summary: TiUP 可用于将 TiDB 4.0 版本及更高版本升级至 TiDB 8.0。升级过程中需注意不支持 TiFlash 组件从 5.3 之前的老版本在线升级至 5.3 及之后的版本，只能采用停机升级。在升级过程中，不要执行 DDL 语句，避免出现行为未定义的问题。升级前需查看集群中是否有正在进行的 DDL Job，并等待其完成或取消后再进行升级。升级完成后，可使用 TiUP 安装对应版本的 `ctl` 组件来更新相关工具版本。 +summary: TiUP 可用于 TiDB 升级。升级过程中需注意不支持 TiFlash 组件从 5.3 之前的老版本在线升级至 5.3 及之后的版本，只能采用停机升级。在升级过程中，不要执行 DDL 语句，避免出现行为未定义的问题。升级前需查看集群中是否有正在进行的 DDL Job，并等待其完成或取消后再进行升级。升级完成后，可使用 TiUP 安装对应版本的 `ctl` 组件来更新相关工具版本。 --- # 使用 TiUP 升级 TiDB 本文档适用于以下升级路径： -- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 8.0。 -- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 8.0。 -- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 8.0。 -- 使用 TiUP 从 TiDB 7.0-7.6 版本升级至 TiDB 8.0。 +- 使用 TiUP 从 TiDB 4.0 版本升级至 TiDB 8.1。 +- 使用 TiUP 从 TiDB 5.0-5.4 版本升级至 TiDB 8.1。 +- 使用 TiUP 从 TiDB 6.0-6.6 版本升级至 TiDB 8.1。 +- 使用 TiUP 从 TiDB 7.0-7.6 版本升级至 TiDB 8.1。 +- 使用 TiUP 从 TiDB 8.0 版本升级至 TiDB 8.1。 > **警告：** > @@ -23,7 +24,7 @@ summary: TiUP 可用于将 TiDB 4.0 版本及更高版本升级至 TiDB 8.0。 > **注意：** > -> - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v8.0.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v8.0.0 及后续修订版本。 +> - 如果原集群是 3.0 或 3.1 或更早的版本，不支持直接升级到 v8.1.0 及后续修订版本。你需要先从早期版本升级到 4.0 后，再从 4.0 升级到 v8.1.0 及后续修订版本。 > - 如果原集群是 6.2 之前的版本，升级到 6.2 及以上版本时，部分场景会遇到升级卡住的情况，你可以参考[如何解决升级卡住的问题](#42-升级到-v620-及以上版本时如何解决升级卡住的问题)。 > - 配置参数 [`server-version`](/tidb-configuration-file.md#server-version) 的值会被 TiDB 节点用于验证当前 TiDB 的版本。因此在进行 TiDB 集群升级前，请将 `server-version` 的值设置为空或者当前 TiDB 真实的版本值，避免出现非预期行为。 > - 配置项 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 设置为 `ON` 会延长 TiDB 的启动时间，这可能会造成启动超时，升级失败。为避免这种情况，建议为 TiUP 设置更长的等待超时。 @@ -54,12 +55,12 @@ summary: TiUP 可用于将 TiDB 4.0 版本及更高版本升级至 TiDB 8.0。 ## 1. 升级兼容性说明 - TiDB 目前暂不支持版本降级或升级后回退。 -- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v8.0.0 版本。 -- 若要将 v3.0 之前的版本升级至 v8.0.0 版本： +- 使用 TiDB Ansible 管理的 4.0 版本集群，需要先按照 [4.0 版本文档的说明](https://docs.pingcap.com/zh/tidb/v4.0/upgrade-tidb-using-tiup)将集群导入到 TiUP (`tiup cluster`) 管理后，再按本文档说明升级到 v8.1.0 版本。 +- 若要将 v3.0 之前的版本升级至 v8.1.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. 按本文档说明将集群升级到 v8.0.0 版本。 + 4. 按本文档说明将集群升级到 v8.1.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 的兼容性更改调整集群的配置。 @@ -71,7 +72,7 @@ summary: TiUP 可用于将 TiDB 4.0 版本及更高版本升级至 TiDB 8.0。 ### 2.1 查阅兼容性变更 -查阅 TiDB v8.0.0 release notes 中的[兼容性变更](/releases/release-8.0.0.md#兼容性变更)。如果有任何变更影响到了你的升级，请采取相应的措施。 +查阅 TiDB v8.1.0 release notes 中的[兼容性变更](/releases/release-8.1.0.md#兼容性变更)。如果有任何变更影响到了你的升级，请采取相应的措施。 ### 2.2 升级 TiUP 或更新 TiUP 离线镜像 @@ -148,7 +149,7 @@ tiup update cluster > 以下情况可跳过此步骤： > > - 原集群没有修改过配置参数，或通过 tiup cluster 修改过参数但不需要调整。 -> - 升级后对未修改过的配置项希望使用 `8.0.0` 默认参数。 +> - 升级后对未修改过的配置项希望使用 `8.1.0` 默认参数。 1. 进入拓扑文件的 `vi` 编辑模式： @@ -164,7 +165,7 @@ tiup update cluster > **注意：** > -> 升级到 v8.0.0 版本前，请确认已在 4.0 修改的参数在 v8.0.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 +> 升级到 v8.1.0 版本前，请确认已在 4.0 修改的参数在 v8.1.0 版本中是兼容的，可参考 [TiKV 配置文件描述](/tikv-configuration-file.md)。 ### 2.4 检查当前集群的 DDL 和 Backup 情况 @@ -201,12 +202,12 @@ tiup cluster check --cluster tiup cluster upgrade ``` -以升级到 v8.0.0 版本为例： +以升级到 v8.1.0 版本为例： {{< copyable "shell-regular" >}} ``` -tiup cluster upgrade v8.0.0 +tiup cluster upgrade v8.1.0 ``` > **注意：** @@ -250,7 +251,7 @@ tiup cluster upgrade -h | grep "version" tiup cluster stop ``` -之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v8.0.0`。 +之后通过 `upgrade` 命令添加 `--offline` 参数来进行停机升级，其中 `` 为集群名，`` 为升级的目标版本，例如 `v8.1.0`。 {{< copyable "shell-regular" >}} @@ -279,7 +280,7 @@ tiup cluster display ``` Cluster type: tidb Cluster name: -Cluster version: v8.0.0 +Cluster version: v8.1.0 ``` ## 4. 升级 FAQ @@ -334,7 +335,7 @@ Cluster version: v8.0.0 ### 4.3 升级过程中 evict leader 等待时间过长，如何跳过该步骤快速升级 -可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v8.0.0`： +可以指定 `--force`，升级时会跳过 `PD transfer leader` 和 `TiKV evict leader` 过程，直接重启并升级版本，对线上运行的集群性能影响较大。命令如下，其中 `` 为升级的目标版本，例如 `v8.1.0`： {{< copyable "shell-regular" >}} @@ -349,5 +350,5 @@ tiup cluster upgrade --force {{< copyable "" >}} ``` -tiup install ctl:v8.0.0 +tiup install ctl:v8.1.0 ```