diff --git a/product/zh/docs-mogdb/v5.0/_index.md b/product/zh/docs-mogdb/v5.0/_index.md
index aa31e410266d80984fc36fbc041ef70d50818715..b480405c504af2911cf2b72e3fd32f390a31706b 100644
--- a/product/zh/docs-mogdb/v5.0/_index.md
+++ b/product/zh/docs-mogdb/v5.0/_index.md
@@ -47,7 +47,7 @@ date: 2022-08-07
 
 [备份与恢复](./administrator-guide/backup-and-restoration/backup-and-restoration.md)
 
-[升级指南](./administrator-guide/upgrade-guide.md)
+[升级指南](./upgrade-guide/upgrade-guide.md)
 
 [故障诊断指南](./common-faults-and-identification/common-fault-locating-methods.md)
 
diff --git a/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md b/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md
index 51941745edbcbd41d417688d1572a9351f791356..db0d0b7c4d81f899c0ad0eab85f0e61fe2a5be16 100644
--- a/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md
+++ b/product/zh/docs-mogdb/v5.0/about-mogdb/mogdb-new-feature/5.0.6.md
@@ -170,4 +170,4 @@ MogDB对读写请求的处理全部放在事务机制下，这与Oracle读不启
 
 ## 4. 升级指南
 
-查看最新版本的[升级指南](../../administrator-guide/upgrade-guide.md)，或点此下载[适用于MogDB V5.0.6的升级指南](https://cdn-mogdb.enmotech.com/mogdb-media/5.0.6/MogDBV5.0.6升级指南.docx)。
\ No newline at end of file
+查看最新版本的[升级指南](../../upgrade-guide/upgrade-guide.md)，或点此下载[适用于MogDB V5.0.6的升级指南](https://cdn-mogdb.enmotech.com/mogdb-media/5.0.6/MogDBV5.0.6升级指南.docx)。
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/administrator-guide/administrator-guide.md b/product/zh/docs-mogdb/v5.0/administrator-guide/administrator-guide.md
index a957510edb5685effc686d520e27e07773d43ddf..9f1d5bc0b4dc6b7690ad045a2252948a58599f4f 100644
--- a/product/zh/docs-mogdb/v5.0/administrator-guide/administrator-guide.md
+++ b/product/zh/docs-mogdb/v5.0/administrator-guide/administrator-guide.md
@@ -14,5 +14,4 @@ date: 2023-05-22
 - **[列存表管理](column-store-tables-management.md)**
 - **[备份与恢复](backup-and-restoration/backup-and-restoration.md)**
 - **[数据库部署方案](database-deployment-scenario/database-deployment-scenario.md)**
-- **[数据导出导入](importing-and-exporting-data/importing-and-exporting-data.md)**
-- **[升级指南](upgrade-guide.md)**
\ No newline at end of file
+- **[数据导出导入](importing-and-exporting-data/importing-and-exporting-data.md)**
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/administrator-guide/upgrade-guide.md b/product/zh/docs-mogdb/v5.0/administrator-guide/upgrade-guide.md
deleted file mode 100644
index 9f358d4aad46c77a988d20d52692f10eafa4a9d9..0000000000000000000000000000000000000000
--- a/product/zh/docs-mogdb/v5.0/administrator-guide/upgrade-guide.md
+++ /dev/null
@@ -1,488 +0,0 @@
----
-title: 升级指南
-summary: 升级指南
-author: 郭欢 候宗田
-date: 2024-03-26
----
-
-# 升级指南
-
-## 升级概述
-
-当数据库发布的新的版本，用户根据发布信息决定使用新版本数据库时，需要做升级操作。集群升级是指在现有集群的基础上，无需导出数据的情况下，直接将数据库二进制文件及元数据升级到更高的版本。
-
-本文档主要适用于升级操作人员。操作人员必须具备以下经验和技能：
-
-- 熟悉当前网络的组网和相关网元的版本信息。
-
-- 有该设备维护经验，熟悉设备的操作维护方式。
-
-<br/>
-
-## 升级方案
-
-MogDB支持的升级方式有三种：就地升级、临时升级和灰度升级。升级策略需要考虑版本间是否发生元数据变更。当元数据的版本不发生变化时可以使用临时升级和灰度升级（如V5.0.0升级至V5.0.1），发生变化时只能通过PTK升级（如V3.0.0升级至V5.0.0）。
-
-**就地升级**（推荐）：使用MogDB配套的部署运维工具PTK升级，是最方便常用的升级方式，升级过程简单易操作，只需将新版压缩包放在指定目录，然后执行对应的PTK命令，PTK就会自动完成所有检查（包括系统、磁盘、数据库状态等）、执行备份操作，然后进行升级或回滚。
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-note.gif) 说明：MogDB V5.0.6支持通过PTK对**V3.0.0-V3.0.7**和**V5.0.0-V5.0.5**版本的数据库进行集群升级，用户操作简单，使用场景限制最小。
-
-**临时升级**：当用户遇到严重问题时，研发工程师定位该问题并进行修复，发出新的补丁版本进行替换，将采用临时升级。该升级方式只进行二进制文件替换，不需要额外操作，主要用于替换版本和原版本之间代码更新非常少的场景。该升级方式的优点是轻量化、操作灵活。缺点在于使用场景仅限问题修复，版本之间不能有任何的元数据或者存储文件格式变更。临时升级仅支持小版本升级，升级操作需要停止业务进行，一次性升级所有节点。
-
-**灰度升级**：该升级方式面向集群模式，对于集群中的节点逐个进行升级。优点在于始终有节点能够对外提供服务，保证业务不中断。缺点在于主备节点上不同版本数据库同时运行，元数据的版本和日志存储文件的版本都不能有任何变更。灰度升级仅支持元数据无变更的版本之间升级。
-
-请根据业务情况做好方案选择，如有疑问请联系云和恩墨工程师提供支持。
-
-<br/>
-
-## 升级影响和约束
-
-升级包含以下影响和约束，在升级前应该做好充分检查和了解，确保条件都能满足的情况下再进行升级，如果有任何疑问需联系原厂工程师。
-
-- 升级操作不能和扩容、缩容同时执行。
-- 不支持虚拟IP。
-- 升级过程中，不允许对wal_level，max_connections，max_prepared_transactions，max_locks_per_transaction这四个GUC参数的值进行修改。如果修改，会导致回滚后实例启动异常。
-- 建议在数据库系统空闲情况下进行升级，尽量避开业务繁忙的时间段（可按照经验判断，如节假日等）。
-- 升级前尽可能保证数据库状态正常。通过PTK安装的版本可通过`ptk cluster -n <CLUSTER_NAME> status`命令查看集群状态，Normal代表集群所有实例正常可用。通过OM安装的版本可以通过`gs_om -t status`查询，查询结果的cluster_state为Normal代表数据库正常可用。
-- 升级前保证数据库互信正常，可以在任意节点上，通过`ssh hostname`命令，连接另外一个节点进行验证。如果各机器间互连不用输入密码，说明互信正常（通常数据库状态正常时，互信一般都是正常的）。
-- 升级前后，数据库的部署方式（配置文件）不能发生变化。升级前PTK会对部署方式进行校验，如果改变会报错。
-- 数据库运行正常且主DN的数据完全同步到备DN。
-- 升级过程中不允许打开kerberos开关。
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) **注意**：
->
-> 如果原数据库版本为3.0.X，需要额外检查是否存在包含rownum和connect by语法的视图。
->
-> 可以通过如下语句来获取视图定义，检查其是否存在rownum或者connect by语法：
->
-> ```sql
-> select pg_get_viewdef('viewname') def where def like '%ROWNUM%' or def like '%CONNECT BY%' ;
-> ```
->
-> 如果存在这样的视图，需执行以下操作：
->
-> 1. 获取视图定义
->
->    ```sql
->    Select pg_get_viewdef('v1'); 
->    ```
->
->    v1代表存在rownum或者connectby语法的视图名称。
->
-> 2. 删除相关视图
->
->    ```sql
->    Drop view v1;
->    ```
->
-> 3. 升级完成后使用原视图定义重建这些视图
->
->    ```sql
->    Create view as viewdef;
->    ```
->
->    viewdef代表第一步中获取的视图定义。
-
-<br/>
-
-## 就地升级
-
-### 安装升级PTK
-
-PTK作为一个部署管理工具，并不需要和数据库实例安装到一起。我们推荐使用一个中控管理机器来安装PTK，然后通过该中控机去部署管理数据库实例到其他服务器，这样的话，可以避免数据库实例机器的故障造成PTK不可用。
-
-**在线安装**
-
-> 注意：命令行安装方式不支持 Windows 系统
-
-在 MacOS 或 Linux 系统的终端中，执行以下指令即可自动完成安装：
-
-```bash
-curl --proto '=https' --tlsv1.2 -sSf https://cdn-mogdb.enmotech.com/ptk/install.sh | sh
-```
-
-该指令会自动将 PTK 安装在用户的家目录 `$HOME/.ptk` 目录下，该目录以后会作为 PTK 工具的工作目录，
-其产生的缓存文件、数据文件以及集群的配置信息，备份信息等文件均会存储到该目录下。
-同时，安装指令会自动将 `$HOME/.ptk/bin` 的路径加入到对应 SHELL Profile 文件的 PATH 环境变量中，
-这样在用户登录到服务器后就可以直接使用 `ptk` 指令了。
-
-**离线安装**
-
-如果你需要安装的服务器无法直接访问外网或者是需要在 Windows 系统上使用 PTK 工具，此时可以通过手动方式进行安装。
-
-请按照以下操作步骤进行安装：
-
-第一步：先在个人电脑上下载你所要安装的机器的对应安装包，以下是不同系统架构的最新版的安装包:
-
-| 文件                                                         | 操作系统 | 架构   |
-| :----------------------------------------------------------- | -------- | ------ |
-| [ptk_darwin_arm64.tar.gz](https://cdn-mogdb.enmotech.com/ptk/latest/ptk_darwin_arm64.tar.gz) | Darwin   | arm64  |
-| [ptk_darwin_x86_64.tar.gz](https://cdn-mogdb.enmotech.com/ptk/latest/ptk_darwin_x86_64.tar.gz) | Darwin   | x86_64 |
-| [ptk_linux_arm64.tar.gz](https://cdn-mogdb.enmotech.com/ptk/latest/ptk_linux_arm64.tar.gz) | Linux    | arm64  |
-| [ptk_linux_x86_64.tar.gz](https://cdn-mogdb.enmotech.com/ptk/latest/ptk_linux_x86_64.tar.gz) | Linux    | x86_64 |
-| [ptk_windows_x86_64.tar.gz](https://cdn-mogdb.enmotech.com/ptk/latest/ptk_windows_x86_64.tar.gz) | Windows  | x86_64 |
-
-第二步：下载好安装包以后，通过内网将安装包发送到目标服务器上解压；
-
-第三步：解压后会得到一个名为 `ptk` 的二进制文件，该文件即为 PTK 的可执行文件，可以根据个人偏好，将该文件移动到合适的目录（推荐 `$HOME/.ptk/bin/` 目录，需手动创建），然后将所在所在目录添加到 PATH 环境变量中即可；
-
-**升级PTK**
-
-如果是离线方式安装的，重新下载最新的安装包后替换覆盖服务器上的二进制文件即可升级到最新版。
-
-如果是在线方式安装的，执行以下指令即可自动将 PTK 升级到最新版：
-
-```bash
-ptk self upgrade
-```
-
-### 备份数据
-
-在升级过程中，为避免执行错误出现升级异常，导致原版本数据库文件或数据被意外修改，而无法执行回滚操作的情况，升级前须做好数据备份和完整性保护，方便在升级发生错误时使用已备份的数据恢复到升级前状态，避免因操作失误导致业务无法恢复的情况出现。
-
-在使用PTK升级过程中，工具会自动完成原版本数据库软件的备份，如果需要备份全部的数据文件，可以使用gs_basebackup进行基础的物理备份，示例如下：
-
-1. 使用数据库用户（如omm）创建备份目录
-
-   ```shell
-   mkdir /home/omm/mogdb_data_bak
-   ```
-
-2. 通过gs_basebackup进行备份
-
-   ```shell
-   gs_basebackup -D /home/omm/mogdb_data_bak -h 127.0.0.1 -p 26000
-   ```
-
-   需根据实际情况替换主机名、端口号。
-
-### 集群升级
-
-#### 升级前检查
-
-我们需要先通过以下命令来确认当前数据库集群是否有创建过插件：
-
-```shell
-ptk cluster -n <CLUSTER_NAME> list-plugins
-```
-
-执行后会输出两个表格，第一个表格代表安装过的插件列表，安装过并不意味着数据库里使用了。第二个表格代表具体的每个数据库中创建过的插件，如果没有创建过任何插件，Extension(s)字段会为空。我们需要确认第二个表格中Extension(s)字段下是否有值，不同的情况升级的方式有些许差别。
-
-#### 未创建插件的集群升级
-
-如果升级前的数据库内没有创建过任何插件，可以直接指定新版本的安装包进行升级：
-
-```shell
-ptk cluster -n <CLUSTER_NAME> upgrade [-y] -p <PACKAGE_PATH>
-```
-
-#### 含有插件的集群升级
-
-如果数据库中使用了插件的话，由于升级后数据库元数据会发生改变，可能会导致升级后插件不可用或者升级失败。所以对于使用了插件的集群，需要额外指定以下参数来升级：
-
---plugin-dir: 本地目录，该目录下存放提前下载的新版本插件包（下载的插件包请勿变更文件名）
-
-升级命令如下：
-
-```shell
-ptk cluster -n <CLUSTER_NAME> upgrade [-y] -p <PACKAGE_PATH> --plugin-dir <PLUGIN_DIR>
-```
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) 注意：插件版本必须和数据库版本进行匹配，如果包含插件，在数据库升级时必须对插件也进行升级。
-
-#### 升级提交
-
-执行上述命令后，PTK会完成升级的完整操作，升级后集群以新版本运行，此时您可以在数据库上进行验证操作，当升级后检查集群状态为正常的情况下，可以通过以下命令提交升级，开启集群读写状态，删除旧版本的备份文件。注意，提交后集群无法再回滚，请确认正确后再提交。
-
-```shell
-ptk cluster -n <cluster_name> upgrade-commit
-```
-
-确认提交升级后，可以通过以下命令查看集群状态：
-
-```shell
-ptk cluster -n <cluster_name> status
-```
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) 注意：
->
-> MogDB 5.0.6新增并行导入导出功能（详见[逻辑备份恢复效率增强](../characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)），该功能依赖于新增内置插件tidrangescan。升级完成后，如需使用gs_dump、gs_restore并行导入导出功能，需在要进行导入导出的库里手动创建tidrangescan插件：
->
-> ```sql
-> create extension tidrangescan;
-> ```
-
-#### 升级回滚和数据恢复
-
-如果升级过程中存在报错中断，您可以通过人为介入来解决，当解决了问题后，可以通过重新执行升级指令继续完成升级。
-
-如果升级后验证发现问题可以通过upgrade-rollback命令进行回滚，PTK会将集群回滚为旧版本的状态。
-
-```shell
-ptk cluster -n <cluster_name> upgrade-rollback
-```
-
-如果升级过程发生异常，需要从备份数据进行恢复，可执行以下操作：
-
-1. 停止数据库服务器
-
-   ```shell
-   gs_ctl stop -D $PGDATA
-   ```
-
-2. 清理原库中的所有或部分数据文件
-
-   ```shell
-   rm -rf $PGDATA/*
-   ```
-
-3. 使用数据库系统用户权限从备份中还原需要的数据库文件
-
-   ```shell
-   cp -r /home/omm/mogdb_data_bak/* $PGDATA/
-   ```
-
-4. 若数据库中存在链接文件，需要修改使其链接到正确的文件
-
-5. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态
-
-   ```shell
-   gs_ctl start -D $PGDATA
-   ```
-
-### 注意事项
-
-在执行以上升级操作的过程中，如果发现未能按照预期正常进行，例如展示集群状态时，状态信息为异常等，需要联系原厂工程师进行解决。
-
-请在升级后所有数据库状态都验证正确以后，再执行升级提交操作，如果状态不正确，需进行回滚操作，确保数据库恢复到升级前的正确状态，然后联系原厂工程师对升级中遇到的问题进行确认。
-
-<br/>
-
-## 临时升级
-
-### 升级前检查
-
-升级前需要检查的所有内容在[升级影响和约束](#升级影响和约束)章节已经列出。请在对所有内容进行充分检查和了解后再进行升级操作。在升级过程中如遇到任何问题，请及时联系原厂工程师进行处理。
-
-### 备份数据
-
-在升级过程中，为避免执行错误出现升级异常，导致原版本数据库文件或数据被意外修改，而无法执行回滚操作的情况，升级前须做好数据备份和完整性保护，方便在升级发生错误时使用已备份的数据恢复到升级前状态，避免因操作失误导致业务无法恢复的情况出现。
-
-采用临时升级方式时，在升级前，请务必手动完成备份，具体操作示例如下：
-
-1. 备份原版本可执行文件
-
-   ```shell
-   mkdir -p /home/omm/mogdb_app_bak
-   cp -r $GAUSSHOME/* /home/omm/mogdb_app_bak/*
-   ```
-
-2. 备份用户数据
-
-   ```shell
-   mkdir /home/omm/mogdb_data_bak
-   gs_basebackup -D /home/omm/mogdb_data_bak -h 127.0.0.1 -p 26000
-   ```
-
-   需根据实际情况替换主机名、端口号。
-
-### 升级步骤
-
-临时升级的具体操作步骤如下：
-
-1. 关停数据库
-
-   ```shell
-   gs_ctl stop -D $PGDATA
-   ```
-
-2. 解压目标版本安装包，如：
-
-   ```shell
-   tar -xvf MogDB-5.0.6-Kylin-x86_64-all.tar.gz
-   ```
-
-3. 进入解压后的目录
-
-   ```shell
-   cd MogDB-5.0.6-Kylin-x86_64-all/
-   ```
-
-4. 解压内核包，覆盖原始的app文件夹
-
-   ```shell
-   tar -xvf MogDB-5.0.6-Kylin-64bit.tar.gz -C $GAUSSHOME --strip-components=1
-   ```
-
-5. 启动数据库进行功能验证
-
-   ```shell
-   gs_ctl start -D $PGDATA
-   ```
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) 注意：
->
-> MogDB 5.0.6新增并行导入导出功能（详见[逻辑备份恢复效率增强](../characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)），该功能依赖于新增内置插件tidrangescan。升级完成后，如需使用gs_dump、gs_restore并行导入导出功能，需在要进行导入导出的库里手动创建tidrangescan插件：
->
-> ```sql
-> create extension tidrangescan;
-> ```
-
-### 升级回滚
-
-使用临时升级操作无需进行额外的提交动作，如果启动后检查发现有异常，可通过原有的备份文件恢复到升级前状态。
-
-```shell
-cp -r /home/omm/mogdb_app_bak/*  $GAUSSHOME/*
-rm -r $PGDATA
-mv /home/omm/mogdb_data_bak  $PGDATA
-```
-
-### 注意事项
-
-在执行以上升级操作的过程中，如果发现未能按照预期正常进行，例如替换新版本后，数据库启动异常等，需要联系原厂工程师进行解决。
-
-请确保在升级之前进行原数据库文件的备份，在升级过程中如果遇到任何问题，先通过备份进行恢复，然后联系原厂工程师提供支持。
-
-<br/>
-
-## 灰度升级
-
-灰度升级不同于前面的升级方式，不需要将所有节点全部停机，升级后重新启动，而是可以实现对外服务的同时进行升级操作。
-
-### 升级前检查
-
-请在对以下所有内容进行充分检查和了解后再进行升级操作。在升级过程中如遇到任何问题，及时联系原厂工程师进行处理。
-
-1. 收集节点信息
-
-   联系数据库系统管理员，获取数据库涉及节点的节点名称、节点IP地址。节点的root、omm用户密码等环境信息，设置root用户远程登录。
-
-2. 备份数据
-
-   升级一旦失败，有可能会影响到业务的正常开展。提前备份数据，就可以在风险发生后，尽快的恢复业务。
-
-3. 获取升级包
-
-   访问[MogDB官网下载页面](https://www.mogdb.io/downloads/mogdb)获取想要升级的升级包。
-
-4. 检查数据库节点磁盘使用率
-
-   建议数据库节点磁盘使用率低于80%时再执行升级操作。
-
-> 注意事项：
->
-> - 在灰度升级方式中，升级版本之间一定不能有元数据的变动，需确保满足该条件，才可进行灰度升级。
-> - 灰度升级必须是对包含主备的集群进行升级。
-
-### 备份数据
-
-在升级过程中，为避免执行错误出现升级异常，导致原版本数据库文件或数据被意外修改，而无法执行回滚操作的情况，升级前须做好数据备份和完整性保护，方便在升级发生错误时使用已备份的数据恢复到升级前状态，避免因操作失误导致业务无法恢复的情况出现。
-
-采用灰度升级方式时，在升级前，请务必手动完成备份，具体操作示例如下：
-
-1. 备份原版本可执行文件
-
-   ```shell
-   mkdir -p /home/omm/mogdb_app_bak
-   cp -r $GAUSSHOME/* /home/omm/mogdb_app_bak/*
-   ```
-
-2. 备份用户数据
-
-   ```shell
-   mkdir /home/omm/mogdb_data_bak
-   gs_basebackup -D /home/omm/mogdb_data_bak -h 127.0.0.1 -p 26000
-   ```
-
-   需根据实际情况替换主机名、端口号。
-
-### 升级步骤
-
-灰度升级的具体操作步骤如下：
-
-1. 关闭备机
-
-   ```shell
-   gs_ctl stop -D $PGDATA
-   ```
-
-2. 升级备机，解压新版本的压缩包覆盖备机的app文件夹，例如：
-
-   ```shell
-   tar -xvf MogDB-5.0.6-Kylin-x86_64-all.tar.gz
-   cd MogDB-5.0.6-Kylin-x86_64-all
-   tar -xvf MogDB-5.0.6-Kylin-64bit.tar.gz -C $GAUSSHOME --strip-components=1
-   ```
-
-3. 启动备机
-
-   ```shell
-   gs_ctl start -D $PGDATA -M standby
-   ```
-
-4. 在备机上执行以下命令，进行主备机器切换
-
-   ```shell
-   gs_ctl switchover -D $PGDATA
-   ```
-
-5. 关闭原主机
-
-   ```shell
-   gs_ctl stop -D $PGDATA
-   ```
-
-6. 升级原主机，解压新版本的压缩包覆盖备机的app文件夹，例如：
-
-   ```shell
-   tar -xvf MogDB-5.0.6-Kylin-x86_64-all.tar.gz
-   cd MogDB-5.0.6-Kylin-x86_64-all
-   tar -xvf MogDB-5.0.6-Kylin-64bit.tar.gz -C $GAUSSHOME --strip-components=1
-   ```
-
-7. 以备机模式启动原主机
-
-   ```shell
-   gs_ctl start -D $PGDATA -M standby
-   ```
-
-8. 查询集群状态
-
-   ```shell
-   gs_om -t status --detail
-   ```
-
-9. 升级版本查询
-
-   ```shell
-   mogdb --version
-   ```
-
-10. 升级后功能验证
-
-    对新版本包含的bug fix或者功能进行验证
-
-> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) 注意：
->
-> MogDB 5.0.6新增并行导入导出功能（详见[逻辑备份恢复效率增强](../characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)），该功能依赖于新增内置插件tidrangescan。升级完成后，如需使用gs_dump、gs_restore并行导入导出功能，需在要进行导入导出的库里手动创建tidrangescan插件：
->
-> ```sql
-> create extension tidrangescan;
-> ```
-
-### 升级回滚
-
-使用灰度升级操作无需进行额外的提交动作，如果启动后检查发现有异常，可通过原有的备份文件将主备节点都恢复到升级前状态。
-
-```shell
-cp -r /home/omm/mogdb_app_bak/*  $GAUSSHOME/*
-rm -r $PGDATA
-mv /home/omm/mogdb_data_bak  $PGDATA
-```
-
-### 注意事项
-
-灰度升级会存在不同版本的主备同时运行的场景，因此在使用灰度升级时应确保新旧版本之间不存在元数据和日志文件格式的变更。
-
-请提前做好数据备份，在遇到问题时可以回退到升级前状态，然后将遇到的问题反馈给原厂工程师。
diff --git a/product/zh/docs-mogdb/v5.0/characteristic-description/characteristic-description-overview.md b/product/zh/docs-mogdb/v5.0/characteristic-description/characteristic-description-overview.md
index 27efbcd0a96af0a279264d8b5cf64a0e48596106..9af1149d16f8cf41f023173c7fe2f4b5021a7bee 100644
--- a/product/zh/docs-mogdb/v5.0/characteristic-description/characteristic-description-overview.md
+++ b/product/zh/docs-mogdb/v5.0/characteristic-description/characteristic-description-overview.md
@@ -55,7 +55,6 @@ MogDB 5.0版本具有以下特性：
   + [逻辑备份恢复效率增强](./high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)
   
 + 维护性
-  + [灰度升级](./maintainability/1-gray-upgrade.md)
   + [支持WDR诊断报告](./maintainability/2-workload-diagnosis-report.md)
   + [慢SQL诊断](./maintainability/3-slow-sql-diagnosis.md)
   + [Session性能诊断](./maintainability/4-session-performance-diagnosis.md)
@@ -64,7 +63,6 @@ MogDB 5.0版本具有以下特性：
   + [插件拆分](./maintainability/extension-splitting.md)
   + [内置stack工具](./maintainability/built-in-stack-tool.md)
   + [支持SQL PATCH](./maintainability/sql-patch.md)
-  
   + [轻量级锁导出与分析](./maintainability/light-lock-export-and-analysis.md)
   + [DCF模块追踪](./maintainability/dcf-module-tracing.md)
   + [写入不合法字符报错](./maintainability/error-when-writing-illegal-characters.md)
diff --git a/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/1-gray-upgrade.md b/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/1-gray-upgrade.md
deleted file mode 100644
index 9edd4cc9a3e4758d51cd8a6b083876409cc64ecd..0000000000000000000000000000000000000000
--- a/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/1-gray-upgrade.md
+++ /dev/null
@@ -1,40 +0,0 @@
----
-title: 灰度升级
-summary: 灰度升级
-author: Guo Huan
-date: 2022-05-07
----
-
-# 灰度升级
-
-## 可获得性
-
-本特性自MogDB 2.0.0版本开始引入。
-
-## 特性简介
-
-灰度升级支持全业务操作，一次性升级所有节点。
-
-## 客户价值
-
-灰度升级提供了一种在线升级的方式，保证在不中断业务的情况下，对所有的节点进行升级。
-
-## 特性描述
-
-灰度升级是一种支持所有节点升级的在线升级方式。目前灰度升级只涉及数据库二进制的替换，为了尽可能降低对于业务的影响，采用同一节点两套二进制同时存在的方式，使用软连接切换的方式来进行进程版本的切换升级（闪断一次，10秒以内）。
-
-## 特性增强
-
-无。
-
-## 特性约束
-
-灰度升级的约束条件请参见《管理指南》中的[升级指南](../../administrator-guide/upgrade-guide.md)章节。
-
-## 依赖关系
-
-无。
-
-## 相关页面
-
-[升级指南](../../administrator-guide/upgrade-guide.md)
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/maintainability.md b/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/maintainability.md
index 9975976595a466e50ba583543bcf240195ba97aa..b138d097bf368ce932513b984ccfb7e9461fcffa 100644
--- a/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/maintainability.md
+++ b/product/zh/docs-mogdb/v5.0/characteristic-description/maintainability/maintainability.md
@@ -7,7 +7,6 @@ date: 2023-05-22
 
 # 维护性
 
-+ **[灰度升级](1-gray-upgrade.md)**
 + **[支持WDR诊断报告](2-workload-diagnosis-report.md)**
 + **[慢SQL诊断](3-slow-sql-diagnosis.md)**
 + **[Session性能诊断](4-session-performance-diagnosis.md)**
diff --git a/product/zh/docs-mogdb/v5.0/toc.md b/product/zh/docs-mogdb/v5.0/toc.md
index 6cccc32ce716fa09f1eb6ca5100846d13e16f390..0576bd5a534a5a6ed8280c3e391919bec2a60ba0 100644
--- a/product/zh/docs-mogdb/v5.0/toc.md
+++ b/product/zh/docs-mogdb/v5.0/toc.md
@@ -95,7 +95,6 @@
     + [MogDB/CM/PTK支持双网段](/characteristic-description/high-availability/cm-dual-network-segment-deployment.md)
     + [逻辑备份恢复效率增强](/characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)
   + [维护性](/characteristic-description/maintainability/maintainability.md)
-    + [灰度升级](/characteristic-description/maintainability/1-gray-upgrade.md)
     + [支持WDR诊断报告](/characteristic-description/maintainability/2-workload-diagnosis-report.md)
     + [慢SQL诊断](/characteristic-description/maintainability/3-slow-sql-diagnosis.md)
     + [Session性能诊断](/characteristic-description/maintainability/4-session-performance-diagnosis.md)
@@ -218,6 +217,11 @@
   + [PTK方式安装](/installation-guide/ptk-based-installation.md)
   + [手动安装](/installation-guide/manual-installation.md)
   + [推荐参数设置及新建测试库](/installation-guide/recommended-parameter-settings.md)
++ [升级指南](/upgrade-guide/upgrade-guide.md)
+  + [升级概述](/upgrade-guide/1-upgrade-overview.md)
+  + [升级前必读](/upgrade-guide/2-read-before-upgrade.md)
+  + [就地升级](/upgrade-guide/3-in-place-upgrade.md)
+  + [滚动升级](/upgrade-guide/4-rolling-upgrade.md)
 + [管理指南](/administrator-guide/administrator-guide.md)
   + [本地化](/administrator-guide/localization/localization.md)
     + [区域支持](/administrator-guide/localization/locale-support.md)
@@ -296,7 +300,6 @@
       + [导出单个数据库](/administrator-guide/importing-and-exporting-data/exporting-data/2-exporting-a-single-database.md)
       + [导出所有数据库](/administrator-guide/importing-and-exporting-data/exporting-data/3-exporting-all-databases.md)
       + [无权限角色导出数据](/administrator-guide/importing-and-exporting-data/exporting-data/4-data-export-by-a-user-without-required-permissions.md)
-  + [升级指南](/administrator-guide/upgrade-guide.md)
 + [高可用指南](./high-available-guide/high-available-guide.md)
   + [DCF(Distributed Consensus Framework)](./high-available-guide/high-available-dcf.md)
   + [CM(Cluster Manager)](./high-available-guide/cluster-management/cluster-management.md)
diff --git a/product/zh/docs-mogdb/v5.0/toc_characteristic_description.md b/product/zh/docs-mogdb/v5.0/toc_characteristic_description.md
index 35fe6fc03906e741623479f7899a8e04a68eafc3..ef6af988f0f858912d4f81ff6b02a09e4f92cd74 100644
--- a/product/zh/docs-mogdb/v5.0/toc_characteristic_description.md
+++ b/product/zh/docs-mogdb/v5.0/toc_characteristic_description.md
@@ -52,7 +52,6 @@
   + [MogDB/CM/PTK支持双网段](/characteristic-description/high-availability/cm-dual-network-segment-deployment.md)
   + [逻辑备份恢复效率增强](/characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)
 + [维护性](/characteristic-description/maintainability/maintainability.md)
-  + [灰度升级](/characteristic-description/maintainability/1-gray-upgrade.md)
   + [支持WDR诊断报告](/characteristic-description/maintainability/2-workload-diagnosis-report.md)
   + [慢SQL诊断](/characteristic-description/maintainability/3-slow-sql-diagnosis.md)
   + [Session性能诊断](/characteristic-description/maintainability/4-session-performance-diagnosis.md)
diff --git a/product/zh/docs-mogdb/v5.0/toc_manage.md b/product/zh/docs-mogdb/v5.0/toc_manage.md
index a75dde9024deb8f6e1d389e539b694712161c34a..8ab7dfc54e33d62bcb5f5744b40dc5055c6ccabe 100644
--- a/product/zh/docs-mogdb/v5.0/toc_manage.md
+++ b/product/zh/docs-mogdb/v5.0/toc_manage.md
@@ -81,4 +81,3 @@
     + [导出单个数据库](/administrator-guide/importing-and-exporting-data/exporting-data/2-exporting-a-single-database.md)
     + [导出所有数据库](/administrator-guide/importing-and-exporting-data/exporting-data/3-exporting-all-databases.md)
     + [无权限角色导出数据](/administrator-guide/importing-and-exporting-data/exporting-data/4-data-export-by-a-user-without-required-permissions.md)
-+ [升级指南](/administrator-guide/upgrade-guide.md)
diff --git a/product/zh/docs-mogdb/v5.0/toc_upgrade.md b/product/zh/docs-mogdb/v5.0/toc_upgrade.md
new file mode 100644
index 0000000000000000000000000000000000000000..869a7c99503b11e4557417db7769cd6e0dbfd9b0
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/toc_upgrade.md
@@ -0,0 +1,10 @@
+<!-- markdownlint-disable MD007 -->
+<!-- markdownlint-disable MD041 -->
+# MogDB Documentation 5.0
+
+## 升级指南
+
++ [升级概述](./upgrade-guide/1-upgrade-overview.md)
++ [升级前必读](./upgrade-guide/2-read-before-upgrade.md)
++ [就地升级](./upgrade-guide/3-in-place-upgrade.md)
++ [滚动升级](./upgrade-guide/4-rolling-upgrade.md)
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/upgrade-guide/1-upgrade-overview.md b/product/zh/docs-mogdb/v5.0/upgrade-guide/1-upgrade-overview.md
new file mode 100644
index 0000000000000000000000000000000000000000..7990838fc8a2d31b444e7641014eca40b89f53a4
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/upgrade-guide/1-upgrade-overview.md
@@ -0,0 +1,30 @@
+---
+title: 升级概述
+summary: 升级概述
+author: 郭欢
+date: 2024-05-17
+---
+
+# 升级概述
+
+当数据库发布的新的版本，用户根据发布信息决定使用新版本数据库时，需要做升级操作。集群升级是指在现有集群的基础上，无需导出数据的情况下，直接将数据库二进制文件及元数据升级到更高的版本。
+
+本文档主要适用于升级操作人员。操作人员必须具备以下经验和技能：
+
+- 熟悉当前网络的组网和相关网元的版本信息。
+
+- 有该设备维护经验，熟悉设备的操作维护方式。
+
+<br/>
+
+## 升级方案
+
+MogDB支持的升级方案有两种：就地升级和滚动升级。
+
+**就地升级**（推荐）：升级期间需停止业务进行，一次性升级集群内所有节点。支持带元数据变更的版本升级，支持带插件升级。就地升级是最方便常用的升级方式，过程简单易操作。
+
+**滚动升级**：对于集群内的节点逐个进行升级。优点在于始终有节点能够对外提供服务，保证业务不中断。缺点在于主备节点上不同版本数据库同时运行，元数据的版本和日志存储文件的版本都不能有任何变更。不支持带插件升级。
+
+以上两种升级方式均需使用MogDB配套的部署运维工具PTK进行操作，有关PTK工具的安装升级，请参考[PTK文档](https://docs.mogdb.io/zh/ptk/v1.1/install)。
+
+请根据业务情况做好方案选择，如有疑问请联系云和恩墨工程师提供支持。
diff --git a/product/zh/docs-mogdb/v5.0/upgrade-guide/2-read-before-upgrade.md b/product/zh/docs-mogdb/v5.0/upgrade-guide/2-read-before-upgrade.md
new file mode 100644
index 0000000000000000000000000000000000000000..d21651400a51596ea636512a1947d906e3f5a4fc
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/upgrade-guide/2-read-before-upgrade.md
@@ -0,0 +1,72 @@
+---
+title: 升级前必读
+summary: 升级前必读
+author: 郭欢
+date: 2024-05-17
+---
+
+# 升级前必读
+
+## 升级影响和约束
+
+升级包含以下影响和约束，在升级前应该做好充分检查和了解，确保条件都能满足的情况下再进行升级，如果有任何疑问需联系原厂工程师。
+
+- 升级操作不能和扩容、缩容同时执行。
+- 不支持虚拟IP。
+- 升级过程中，不允许对wal_level，max_connections，max_prepared_transactions，max_locks_per_transaction这四个GUC参数的值进行修改。如果修改，会导致回滚后实例启动异常。
+- 建议在数据库系统空闲情况下进行升级，尽量避开业务繁忙的时间段（可按照经验判断，如节假日等）。
+- 升级前尽可能保证数据库状态正常。通过PTK安装的版本可通过`ptk cluster -n <CLUSTER_NAME> status`命令查看集群状态，Normal代表集群所有实例正常可用。通过OM安装的版本可以通过`gs_om -t status`查询，查询结果的cluster_state为Normal代表数据库正常可用。
+- 升级前保证数据库互信正常，可以在任意节点上，通过`ssh hostname`命令，连接另外一个节点进行验证。如果各机器间互连不用输入密码，说明互信正常（通常数据库状态正常时，互信一般都是正常的）。
+- 升级前后，数据库的部署方式（配置文件）不能发生变化。升级前PTK会对部署方式进行校验，如果改变会报错。
+- 数据库运行正常且主DN的数据完全同步到备DN。
+- 升级过程中不允许打开kerberos开关。
+- 暂不支持部署了CM的集群升级，可通过PTK 1.4.0以上的版本卸载CM后升级。
+- 集群流复制参数需开启（enable_stream_replication）。
+
+<br/>
+
+## 各版本注意事项
+
+### 当前版本为3.0.X
+
+如果原数据库版本为3.0.X，需要检查是否存在包含rownum和connect by语法的视图。
+
+可以通过如下语句来获取视图定义，检查其是否存在rownum或者connect by语法：
+
+```sql
+select pg_get_viewdef('viewname') def where def like '%ROWNUM%' or def like '%CONNECT BY%' ;
+```
+
+如果存在这样的视图，需执行以下操作：
+
+1. 获取视图定义
+
+   ```sql
+   Select pg_get_viewdef('v1'); 
+   ```
+
+   v1代表存在rownum或者connectby语法的视图名称。
+
+2. 删除相关视图
+
+   ```sql
+   Drop view v1;
+   ```
+
+3. 升级完成后使用原视图定义重建这些视图
+
+   ```sql
+   Create view as viewdef;
+   ```
+
+   viewdef代表第一步中获取的视图定义。
+   
+   <br/>
+
+### 目标版本为5.0.6
+
+MogDB 5.0.6新增并行导入导出功能（详见[逻辑备份恢复效率增强](../characteristic-description/high-availability/enhanced-efficiency-of-logical-backup-and-restore.md)），该功能依赖于新增内置插件tidrangescan。升级完成后，如需使用gs_dump、gs_restore并行导入导出功能，需在要进行导入导出的库里手动创建tidrangescan插件：
+
+```sql
+create extension tidrangescan;
+```
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/upgrade-guide/3-in-place-upgrade.md b/product/zh/docs-mogdb/v5.0/upgrade-guide/3-in-place-upgrade.md
new file mode 100644
index 0000000000000000000000000000000000000000..7aa3804be1cdf035b8e5c49b7090af4d87110244
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/upgrade-guide/3-in-place-upgrade.md
@@ -0,0 +1,128 @@
+---
+title: 就地升级
+summary: 就地升级
+author: 郭欢 候宗田 姚前
+date: 2024-05-30
+---
+
+# 就地升级
+
+就地升级是指一次性升级集群内所有节点，升级期间需停止业务进行。
+
+使用MogDB配套的部署运维工具PTK进行就地升级，是最方便常用的升级方式，过程简单易操作，只需将新版压缩包放在指定目录，然后执行对应的PTK命令，PTK就会自动完成所有检查（包括系统、磁盘、数据库状态等）、执行备份操作，然后进行升级或回滚。
+
+## 升级路径
+
+MogDB V5.0.X支持通过PTK对**V3.0.0-V3.0.X**和**V5.0.0-V5.0.X**版本的数据库进行集群升级。不支持高版本向低版本升级。
+
+## 备份数据
+
+在升级过程中，为避免执行错误出现升级异常，导致原版本数据库文件或数据被意外修改，而无法执行回滚操作的情况，升级前须做好数据备份和完整性保护，方便在升级发生错误时使用已备份的数据恢复到升级前状态，避免因操作失误导致业务无法恢复的情况出现。
+
+**在使用PTK升级过程中，工具会自动完成原版本数据库软件的备份**，如果需要备份全部的数据文件，可以使用[gs_basebackup](../reference-guide/tool-reference/tools-used-in-the-internal-system/gs_basebackup.md)进行基础的物理备份，示例如下：
+
+1. 使用数据库用户（如omm）创建备份目录
+
+   ```shell
+   mkdir /home/omm/mogdb_data_bak
+   ```
+
+2. 通过gs_basebackup进行备份
+
+   ```shell
+   gs_basebackup -D /home/omm/mogdb_data_bak -h 127.0.0.1 -p 26000
+   ```
+
+   需根据实际情况替换主机名、端口号。
+
+## 升级操作
+
+我们需要先通过以下命令来确认当前数据库集群是否有创建过插件：
+
+```shell
+ptk cluster -n <CLUSTER_NAME> list-plugins
+```
+
+执行后会输出两个表格，第一个表格代表安装过的插件列表，安装过并不意味着数据库里使用了。第二个表格代表具体的每个数据库中创建过的插件，如果没有创建过任何插件，Extension(s)字段会为空。我们需要确认第二个表格中Extension(s)字段下是否有值，不同的情况升级的方式有些许差别。
+
+### 未创建插件的集群升级
+
+如果升级前的数据库内没有创建过任何插件，可以直接指定新版本的安装包进行升级：
+
+```shell
+ptk cluster -n <CLUSTER_NAME> upgrade [-y] -p <PACKAGE_PATH>
+```
+
+### 含有插件的集群升级
+
+如果数据库中使用了插件的话，由于升级后数据库元数据会发生改变，可能会导致升级后插件不可用或者升级失败。所以对于使用了插件的集群，需要额外指定以下参数来升级：
+
+- `--plugin-dir`: 本地目录，该目录下存放提前下载的新版本插件包（下载的插件包请勿变更文件名）
+
+- `--plugin-upgrade-patch`：插件升级所需的SQL补丁包（目标版本为**MogDB 5.0.2或更新**时，无需指定此参数）
+
+升级命令如下：
+
+```shell
+ptk cluster -n <CLUSTER_NAME> upgrade [-y] -p <PACKAGE_PATH> --plugin-dir <PLUGIN_DIR>
+```
+
+> ![img](https://cdn-mogdb.enmotech.com/docs-media/icon/icon-caution.gif) 注意：插件版本必须和数据库版本进行匹配，如果包含插件，在数据库升级时必须对插件也进行升级。
+
+## 升级提交
+
+执行上述命令后，PTK会完成升级的完整操作，升级后集群以新版本运行，此时您可以在数据库上进行验证操作，当升级后检查集群状态为正常的情况下，可以通过以下命令提交升级，开启集群读写状态，删除旧版本的备份文件。注意，提交后集群无法再回滚，请确认正确后再提交。
+
+```shell
+ptk cluster -n <cluster_name> upgrade-commit
+```
+
+确认提交升级后，可以通过以下命令查看集群状态：
+
+```shell
+ptk cluster -n <cluster_name> status
+```
+
+## 升级回滚和数据恢复
+
+如果升级过程中存在报错中断，您可以通过人为介入来解决，当解决了问题后，可以通过重新执行升级指令继续完成升级。
+
+如果升级后验证发现问题可以通过upgrade-rollback命令进行回滚，PTK会将集群回滚为旧版本的状态。
+
+```shell
+ptk cluster -n <cluster_name> upgrade-rollback
+```
+
+如果升级过程发生异常，需要从备份数据进行恢复，可执行以下操作：
+
+1. 停止数据库服务器
+
+   ```shell
+   gs_ctl stop -D $PGDATA
+   ```
+
+2. 清理原库中的所有或部分数据文件
+
+   ```shell
+   rm -rf $PGDATA/*
+   ```
+
+3. 使用数据库系统用户权限从备份中还原需要的数据库文件
+
+   ```shell
+   cp -r /home/omm/mogdb_data_bak/* $PGDATA/
+   ```
+
+4. 若数据库中存在链接文件，需要修改使其链接到正确的文件
+
+5. 重启数据库服务器，并检查数据库内容，确保数据库已经恢复到所需的状态
+
+   ```shell
+   gs_ctl start -D $PGDATA
+   ```
+
+## 注意事项
+
+在执行以上升级操作的过程中，如果发现未能按照预期正常进行，例如展示集群状态时，状态信息为异常等，需要联系原厂工程师进行解决。
+
+请在升级后所有数据库状态都验证正确以后，再执行升级提交操作，如果状态不正确，需进行回滚操作，确保数据库恢复到升级前的正确状态，然后联系原厂工程师对升级中遇到的问题进行确认。
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/upgrade-guide/4-rolling-upgrade.md b/product/zh/docs-mogdb/v5.0/upgrade-guide/4-rolling-upgrade.md
new file mode 100644
index 0000000000000000000000000000000000000000..2ee6a0d1f3fb254efc6c69967a6fee4b7f72d0a4
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/upgrade-guide/4-rolling-upgrade.md
@@ -0,0 +1,114 @@
+---
+title: 滚动升级
+summary: 滚动升级
+author: 郭欢 候宗田 姚前
+date: 2024-05-17
+---
+
+# 滚动升级
+
+滚动升级不需要将所有节点全部停机，而是可以实现对外服务的同时进行升级操作。
+
+PTK自1.4.0版本开始支持滚动升级的能力，但由于滚动升级过程中，始终是针对备库进行升级，不会直接升级主库，所以升级过程无法提交任何SQL，也不支持带插件升级。
+
+## 升级路径
+
+滚动升级仅支持元数据无变更的版本之间升级，即升级前后数据库的内核版本需保持一致，内核版本可通过 `ptk candidate db` 输出的 `Number` 列查看（需PTK 1.4.0 以上版本）：
+
+```sql
+# ptk candidate db
+  Software  | Version | Number | Lifecycle Policy | Release Date  
+------------+---------+--------+------------------+---------------
+  MogDB     | 2.0.0   | 92.298 | LTS              | 2021-05-25    
+            | 2.0.1   | 92.299 | LTS              | 2021-07-08    
+            | 2.0.3   | 92.300 | LTS              | 2022-06-29    
+            | 2.0.4   | 92.302 | LTS              | 2022-10-15    
+            | 2.1.1   | 92.421 | Preview          | 2022-03-22    
+            | 3.0.0   | 92.605 | LTS              | 2022-06-30    
+            | 3.0.1   | 92.605 | LTS              | 2022-07-30    
+            | 3.0.2   | 92.605 | LTS              | 2022-09-16    
+            | 3.0.3   | 92.605 | LTS              | 2022-10-31    
+            | 3.0.4   | 92.605 | LTS              | 2023-03-24    
+            | 3.0.5   | 92.607 | LTS              | 2023-07-20    
+            | 3.0.6   | 92.607 | LTS              | 2023-09-15    
+            | 3.0.7   | 92.607 | LTS              | 2023-12-29    
+            | 3.1.0   | 92.781 | Preview          | 2022-12-30    
+            | 3.1.1   | 92.781 | LTS              | 2023-11-26    
+            | 5.0.0   | 92.848 | LTS              | 2023-07-14    
+            | 5.0.1   | 92.850 | LTS              | 2023-08-15    
+            | 5.0.2   | 92.900 | LTS              | 2023-09-30    
+            | 5.0.3   | 92.900 | LTS              | 2023-10-27    
+            | 5.0.4   | 92.901 | LTS              | 2023-11-30    
+            | 5.0.5   | 92.901 | LTS              | 2023-12-30    
+            | 5.0.6   | 92.920 | LTS              | 2024-03-30             
+```
+
+## 备份数据
+
+在升级过程中，为避免执行错误出现升级异常，导致原版本数据库文件或数据被意外修改，而无法执行回滚操作的情况，升级前须做好数据备份和完整性保护，方便在升级发生错误时使用已备份的数据恢复到升级前状态，避免因操作失误导致业务无法恢复的情况出现。
+
+**在使用PTK升级过程中，工具会自动完成原版本数据库软件的备份**，如果需要备份全部的数据文件，可以使用[gs_basebackup](../reference-guide/tool-reference/tools-used-in-the-internal-system/gs_basebackup.md)进行基础的物理备份，示例如下：
+
+1. 使用数据库用户（如omm）创建备份目录
+
+   ```shell
+   mkdir /home/omm/mogdb_data_bak
+   ```
+
+2. 通过gs_basebackup进行备份
+
+   ```shell
+   gs_basebackup -D /home/omm/mogdb_data_bak -h 127.0.0.1 -p 26000
+   ```
+
+   需根据实际情况替换主机名、端口号。
+
+## 升级操作
+
+以一主一备为例，假设初始状态时主库IP为 `IP1`，备库为 `IP2`
+
+1. 检查机器状态为Normal
+
+   ```shell
+   ptk cluster -n <集群名> status
+   ```
+
+2. 升级集群中的备库
+
+   通过 `-H` 参数执行集群内一个备库进行单节点升级，该节点要能够临时切为主提供服务
+
+   ```shell
+   ptk cluster -n <集群名> upgrade -p <新版本安装包> -H <IP2>
+   ```
+
+3. 进行主备倒换
+
+   将升级后的备库提升为主库，原主库降为备库
+
+   ```shell
+   ptk cluster -n <集群名> switchover -H <IP2>
+   ```
+
+4. 升级原来的主库
+
+   ```shell
+   ptk cluster -n <集群名> upgrade -p <新版本安装包> -H <IP1>
+   ```
+
+5. （可选）将主重新切换到原主机器
+
+   ```shell
+   ptk cluster -n <集群名> switchover -H <IP1>
+   ```
+
+6. 提交升级
+
+   ```shell
+   ptk cluster -n <集群名> upgrade-commit
+   ```
+
+## 注意事项
+
+滚动升级会存在不同版本的主备同时运行的场景，因此在使用滚动升级时应确保新旧版本之间不存在元数据和日志文件格式的变更。
+
+请提前做好数据备份，在遇到问题时可以回退到升级前状态，然后将遇到的问题反馈给原厂工程师。
\ No newline at end of file
diff --git a/product/zh/docs-mogdb/v5.0/upgrade-guide/upgrade-guide.md b/product/zh/docs-mogdb/v5.0/upgrade-guide/upgrade-guide.md
new file mode 100644
index 0000000000000000000000000000000000000000..b005f971a7e5d1bb24e4f36f779ce68062c5aed4
--- /dev/null
+++ b/product/zh/docs-mogdb/v5.0/upgrade-guide/upgrade-guide.md
@@ -0,0 +1,13 @@
+---
+title: 升级指南
+summary: 升级指南
+author: guo huan
+date: 2024-05-17
+---
+
+# 升级指南
+
+- **[升级概述](./1-upgrade-overview.md)**
+- **[升级前必读](./2-read-before-upgrade.md)**
+- **[就地升级](./3-in-place-upgrade.md)**
+- **[滚动升级](./4-rolling-upgrade.md)**
\ No newline at end of file