Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

*: add a restriction for smooth-upgrade-tidb #16628

Merged
merged 5 commits into from
Mar 1, 2024
+4 −1
Merged

*: add a restriction for smooth-upgrade-tidb #16628

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8a389a6
*: add a restriction for smooth-upgrade-tidb
Oreoxmt Feb 28, 2024
e9178d5
make ci happy
Oreoxmt Feb 28, 2024
88b9527
Apply suggestions from code review
Oreoxmt Feb 29, 2024
67e1084
update
Oreoxmt Feb 29, 2024
c0379e8
Apply suggestions from code review
Oreoxmt Mar 1, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions smooth-upgrade-tidb.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,10 @@ When using the smooth upgrade feature, note the following limitations.
* Run DDL operations on system tables (`mysql.*`, `information_schema.*`, `performance_schema.*`, and `metrics_schema.*`).
* Manually cancel DDL jobs: `ADMIN CANCEL DDL JOBS job_id [, job_id] ...;`.
* Import data.
* If the TiDB Distributed eXecution Framework (DXF) is enabled before the smooth upgrade, and there are ongoing `ADD INDEX` or `IMPORT INTO` tasks during the upgrade, perform the following steps to mitigate potential issues:
Oreoxmt marked this conversation as resolved.
Show resolved Hide resolved
1. Disable the DXF by setting [`tidb_enable_dist_task`](/system-variables.md#tidb_enable_dist_task-span-classversion-marknew-in-v710span) to `OFF` (its default value).
Oreoxmt marked this conversation as resolved.
Show resolved Hide resolved
2. Ensure that all ongoing distributed `ADD INDEX` and `IMPORT INTO` tasks are completed before the upgrade starts. Alternatively, you can cancel these tasks and wait until the upgrade is complete to restart them.
3. After completing the preceding two steps, you can proceed with the smooth upgrade.

### Limitations on tools

Expand Down
Loading