Skip to content

Commit

Permalink
This is an automated cherry-pick of pingcap#19476
Browse files Browse the repository at this point in the history
Signed-off-by: ti-chi-bot <[email protected]>
  • Loading branch information
yinsustart authored and ti-chi-bot committed Jan 17, 2025
1 parent e5ac631 commit 177ec34
Show file tree
Hide file tree
Showing 2 changed files with 43 additions and 1 deletion.
42 changes: 42 additions & 0 deletions hardware-and-software-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Amazon Linux 2 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Amazon Linux 2023 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Rocky Linux 9.1 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| 麒麟欧拉版 V10 SP1/SP2/SP3(从 v7.5.5 开始支持 SP3) | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| 统信操作系统 (UOS) V20 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| openEuler 22.03 LTS SP1/SP3 | <ul><li>x86_64</li><li>ARM 64</li></ul> |

> **警告:**
>
> - 根据 [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) 及以上的版本 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| Oracle Enterprise Linux 8 及以上的版本 | x86_64 |
| Ubuntu LTS 20.04 及以上的版本 | x86_64 |
| CentOS Stream 8 | <ul><li>x86_64</li><li>ARM 64</li></ul> |
| 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 所依赖的库

Expand Down
2 changes: 1 addition & 1 deletion upgrade-tidb-using-tiup.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 后再进行升级。
Expand Down

0 comments on commit 177ec34

Please sign in to comment.