From 177ec34a28105eff1b15008b12609fe91e67eb65 Mon Sep 17 00:00:00 2001 From: yinsustart Date: Fri, 17 Jan 2025 17:35:07 +0800 Subject: [PATCH] This is an automated cherry-pick of #19476 Signed-off-by: ti-chi-bot --- hardware-and-software-requirements.md | 42 +++++++++++++++++++++++++++ upgrade-tidb-using-tiup.md | 2 +- 2 files changed, 43 insertions(+), 1 deletion(-) diff --git a/hardware-and-software-requirements.md b/hardware-and-software-requirements.md index e7d0a22c78bc..32535b264ffd 100644 --- a/hardware-and-software-requirements.md +++ b/hardware-and-software-requirements.md @@ -43,12 +43,54 @@ summary: TiDB 是一款开源的一站式实时 HTAP 数据库，支持部署在 > - 对于以上表格中所列操作系统的 32 位版本，TiDB 在这些 32 位操作系统以及对应的 CPU 架构上**不保障**可编译、可构建以及可部署，或 TiDB 不主动适配这些 32 位的操作系统。 > - 以上未提及的操作系统版本**也许可以**运行 TiDB，但尚未得到 TiDB 官方支持。 +<<<<<<< HEAD > **注意：** > > - TiDB 只支持 Red Hat 兼容内核 (RHCK) 的 Oracle Enterprise Linux，不支持 Oracle Enterprise Linux 提供的 Unbreakable Enterprise Kernel。 > - CentOS Linux 8 的上游支持已于 2021 年 12 月 31 日终止，但 CentOS 将继续提供对 CentOS Stream 8 的支持。 > - TiDB 将不再支持 Ubuntu 16.04。强烈建议升级到 Ubuntu 18.04 或更高版本。 > - 从 v8.4.0 开始，TiDB 依赖 glibc 2.28。如果 glibc 版本不满足要求，建议使用上述表格中支持的操作系统，或将操作系统升级到支持 glibc 2.28 的版本。 +======= + | 操作系统 | 支持的 CPU 架构 | + |:-----------------------------------------------|:----------------------------------------| + | Red Hat Enterprise Linux 8.4 及以上的 8.x 版本 | | + | Amazon Linux 2 | | + | Amazon Linux 2023 | | + | Rocky Linux 9.1 及以上的版本 | | + | 麒麟欧拉版 V10 SP1/SP2/SP3（从 v7.5.5 开始支持 SP3） | | + | 统信操作系统 (UOS) V20 | | + | openEuler 22.03 LTS SP1/SP3 | | + + > **警告：** + > + > - 根据 [CentOS Linux EOL](https://www.redhat.com/en/blog/centos-linux-has-reached-its-end-life-eol)，CentOS Linux 7 的上游支持已于 2024 年 6 月 30 日终止。 + > - 升级 TiDB 前，请务必检查你的操作系统版本。TiDB 在 v8.4.0 DMR 和 v8.5.0 版本中移除了对 glibc 2.17 的适配，以及对 CentOS Linux 7 的兼容性测试和支持，建议使用 Rocky Linux 9.1 及以上的版本。如果在使用 CentOS Linux 7 的情况下将 TiDB 升级到 v8.4.0 DMR 或 v8.5.0 版本，将存在导致集群不可用的风险。 + > - 为了更好地服务仍在使用 CentOS Linux 7 的用户，TiDB 从 v8.5.1 版本起重新适配 glibc 2.17，恢复了对 CentOS Linux 7 的兼容性支持和测试。然而，由于 CentOS Linux 7 已到达 EOL，强烈建议用户参考该系统的[官方声明和安全建议](https://www.redhat.com/en/blog/centos-linux-has-reached-its-end-life-eol)，将生产环境迁移到 TiDB 支持的操作系统版本，如 Rocky Linux 9.1 及以上版本。 + > - 根据 [Red Hat Enterprise Linux Life Cycle](https://access.redhat.com/support/policy/updates/errata/#Life_Cycle_Dates)，Red Hat Enterprise Linux 7 的 Maintenance Support 于 2024 年 6 月 30 日终止。从 8.4 DMR 版本开始，TiDB 已结束对 Red Hat Enterprise Linux 7 的支持，建议使用 Rocky Linux 9.1 及以上的版本。如果将运行在 Red Hat Enterprise Linux 7 上的 TiDB 集群升级到 v8.4.0 或之后版本，将存在导致集群不可用的风险。升级 TiDB 前，请务必检查你的操作系统版本。 + ++ 在以下操作系统以及对应的 CPU 架构组合上，你可以编译、构建和部署 TiDB，可使用 OLTP 和 OLAP 以及数据工具的基本功能。但是 TiDB **不保障企业级生产质量要求**： + + | 操作系统 | 支持的 CPU 架构 | + | :--- | :--- | + | macOS 12 (Monterey) 及以上的版本 | | + | Oracle Enterprise Linux 8 及以上的版本 | x86_64 | + | Ubuntu LTS 20.04 及以上的版本 | x86_64 | + | CentOS Stream 8 | | + | Debian 10 (Buster) 及以上的版本 | x86_64 | + | Fedora 38 及以上的版本 | x86_64 | + | openSUSE Leap 15.5 以上的版本（不包含 Tumbleweed） | x86_64 | + | SUSE Linux Enterprise Server 15 | x86_64 | + + > **注意：** + > + > - TiDB 只支持 Red Hat 兼容内核 (RHCK) 的 Oracle Enterprise Linux，不支持 Oracle Enterprise Linux 提供的 Unbreakable Enterprise Kernel。 + > - TiDB 将不再支持 Ubuntu 16.04。强烈建议升级到 Ubuntu 18.04 或更高版本。 + > - CentOS Stream 8 已于 2024 年 5 月 31 日 [End of Builds](https://blog.centos.org/2023/04/end-dates-are-coming-for-centos-stream-8-and-centos-linux-7/)。 + ++ 对于以上两个表格中所列操作系统的 32 位版本，TiDB 在这些 32 位操作系统以及对应的 CPU 架构上**不保障**可编译、可构建以及可部署，或 TiDB 不主动适配这些 32 位的操作系统。 + ++ 以上未提及的操作系统版本**也许可以**运行 TiDB，但尚未得到 TiDB 官方支持。 +>>>>>>> 742e7bce67 (Update centos 7 on hardware-and-software-requirements.md (#19476)) ### 编译和运行 TiDB 所依赖的库 diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index e418f746da10..8bed60bdfc5d 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -10,7 +10,7 @@ summary: TiUP 可用于 TiDB 升级。升级过程中需注意不支持 TiFlash > **警告：** > -> 1. 从 v8.4.0 版本开始，TiDB 已结束对 CentOS 7 和 Red Hat Enterprise Linux 7 的支持，建议使用 Rocky Linux 9.1 及以上的版本。如果将运行在 CentOS 7 或 Red Hat Enterprise Linux 7 上的 TiDB 集群升级到 v8.4.0 或之后版本，将导致集群不可用。升级 TiDB 前，请务必确保你的操作系统版本符合[操作系统及平台要求](/hardware-and-software-requirements.md#操作系统及平台要求)。 +> 1. 升级 TiDB 前，请务必确保你的操作系统版本符合[操作系统及平台要求](/hardware-and-software-requirements.md#操作系统及平台要求)。如需将运行在 CentOS Linux 7 上的集群升级到 TiDB v8.5 版本，请选择升级至 TiDB v8.5.1 或以上版本，以避免集群不可用的风险。详情参考 [TiDB 8.5.1 Release Notes](/releases/release-8.5.1.md)。 > 2. 不支持将 TiFlash 组件从 5.3 之前的老版本在线升级至 5.3 及之后的版本，只能采用停机升级。如果集群中其他组件（如 tidb，tikv）不能停机升级，参考[不停机升级](#不停机升级)中的注意事项。 > 3. 在升级 TiDB 集群的过程中，**请勿执行** DDL 语句，否则可能会出现行为未定义的问题。 > 4. 集群中有 DDL 语句正在被执行时（通常为 `ADD INDEX` 和列类型变更等耗时较久的 DDL 语句），**请勿进行**升级操作。在升级前，建议使用 [`ADMIN SHOW DDL`](/sql-statements/sql-statement-admin-show-ddl.md) 命令查看集群中是否有正在进行的 DDL Job。如需升级，请等待 DDL 执行完成或使用 [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) 命令取消该 DDL Job 后再进行升级。