Add 3.2.2 description (#1714)

FISCO-BCOS · Jul 4, 2023 · d59e4e2 · d59e4e2
1 parent b58c8dd
commit d59e4e2
Show file tree

Hide file tree

Showing 3 changed files with 89 additions and 2 deletions.
diff --git a/2.x/docs/compatibility.md b/2.x/docs/compatibility.md
@@ -278,11 +278,11 @@ FISCO-BCOS 3.0.0 及之后的版本之间相互兼容。FISCO-BCOS 3.0.0-rc的
 | WeBankBlockchain-Governance-Authority | 权限治理组件               | V3                                    | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Acct/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Account/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Account/tree/V3/) |                              |
 | WeBankBlockchain-Governance-Account   | 账户治理组件               | V3                                    | [文档](https://governance-doc.readthedocs.io/zh_CN/v3.0.0/docs/WeBankBlockchain-Governance-Auth/index.html) | [github](https://github.com/WeBankBlockchain/Governance-Authority/tree/V3) | [gitee](https://gitee.com/WeBankBlockchain/Governance-Authority/tree/V3/) |                              |
 
-#### 3.2.7. FISCO-BCOS v3.2.1
+#### 3.2.7. FISCO-BCOS v3.2.x
 
 | 项目                                  | 功能简介                   | 版本                      | 文档                                                         | github                                                       | gitee                                                        | 备注                         |
 | ------------------------------------- | -------------------------- | ------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------------- |
-| FISCO-BCOS                            | 区块链底层平台             | v3.2.1                    | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/)  | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) |                              |
+| FISCO-BCOS                            | 区块链底层平台             | v3.2.x                    | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/)  | [github](https://github.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/FISCO-BCOS/tree/v3.2.0) |                              |
 | Solidity                              | solidity智能合约           | v0.8.11                   | [文档](https://docs.soliditylang.org/en/v0.8.11)             |                                                              |                                                              | **最高支持solidity v0.8.11** |
 | JavaSDK                               | Java语言SDK                | v3.2.x                    | [文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/develop/sdk/java_sdk/index.html) | [github](https://github.com/FISCO-BCOS/java-sdk/tree/v3.2.0) | [gitee](https://gitee.com/FISCO-BCOS/java-sdk/tree/v3.2.0)   |                              |
 | GoSDK                                 | Go语言SDK                  | 暂不支持</br>后续版本规划 |                                                              |                                                              |                                                              |                              |

diff --git a/3.x/zh_CN/docs/introduction/change_log/3_2_2.md b/3.x/zh_CN/docs/introduction/change_log/3_2_2.md
@@ -0,0 +1,86 @@
+# v3.2.2
+
+#### 修复
+
+* 新增交易同步模式开关，支持3.1.x灰度升级至3.2.2版本（[#3678](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3678)）
+
+#### 修复
+
+* 修复交易同步在极端场景下P2P比RPC写交易池快的问题（[#3683](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3683))
+* 调整scheduler模块中的日志等级（[#3707](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3707)）
+
+#### 升级描述
+
+* 升级节点可执行程序
+
+  效果：修复bug，并带来稳定性、性能的提升
+
+  操作：停止节点服务，升级节点可执行程序为当前版本，重启节点服务
+
+  注意事项：推荐逐步替换可执行程序进行灰度升级
+
+  支持升级的版本：v3.0.0+
+
+* 升级链数据版本
+
+  效果：可使用当前版本的最新特性
+
+  操作：先完成升级所有节点可执行程序，再参考[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/introduction/change_log/3_2_1.html#id5)发送交易升级链数据版本至 v3.2.2
+
+  注意事项：务必备份原节点的所有账本数据，若操作失误造成升级失败，可通过原数据回滚到升级前的状态
+  支持升级的版本：v3.0.0+
+
+* 组件兼容性
+
+  请查阅[完整描述](https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/compatibility.html#fisco-bcos-v3-2-2)
+
+|            | 推荐版本    | 最低版本                 | 说明                               |
+| ---------- | ----------- | ------------------------ | ---------------------------------- |
+| WeBASE     | 3.0.2       | 3.0.2                    |                                    |
+| WeIdentity | v3.0.0-rc.1 | v3.0.0-rc.1              |                                    |
+| Console    | 3.2.0       | 3.0.0                    |                                    |
+| Java SDK   | 3.2.2       | 3.0.0                    |                                    |
+| CPP SDK    | 3.2.2       | 3.0.0                    |                                    |
+| Solidity   | 0.8.11      | 最低 0.4.25，最高 0.8.11 | 需根据合约版本下载编译器（控制台） |
+| WBC-Liquid | 1.0.0-rc3   | 1.0.0-rc3                |                                    |
+
+#### 升级方法
+
+该操作仅支持将3.x版本升级为本版本，不支持3.0-rc或2.x的升级。
+
+##### 查询数据兼容版本号（compatibility_version）
+
+用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#getsystemconfigbykey)进行查询，如当前返回的版本为3.0.0
+
+``` 
+[group0]: /apps>  getSystemConfigByKey compatibility_version
+3.0.0
+```
+
+##### 替换节点二进制
+
+需将**所有节点**的二进制逐步替换为当前版本。为了不影响业务，替换过程能够以灰度方式进行，逐个替换并重启节点。替换过程中，当前的链仍然会以旧的数据兼容版本号的逻辑继续执行。当所有节点二进制替换完成并重启后，需用控制台修改数据兼容版本号为当前版本。
+
+##### 设置数据兼容版本号（compatibility_version）
+
+用[控制台](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/operation_and_maintenance/console/console_commands.html#setsystemconfigbykey)设置数据兼容版本号，如当前版本为3.2.0。
+
+```
+[group0]: /apps>  setSystemConfigByKey compatibility_version 3.2.0
+{
+    "code":0,
+    "msg":"success"
+}
+
+注：若开启权限治理功能，需要使用 setSysConfigProposal 命令
+```
+
+设置成功，再次查询，得到当前版本已升级为3.2.0
+
+``` 
+[group0]: /apps>  getSystemConfigByKey compatibility_version
+3.2.0
+```
+
+当前链已经完成升级，至此，**链开始以新的逻辑继续运行**，并支持了新的特性。
+
diff --git a/3.x/zh_CN/docs/introduction/change_log/index.rst b/3.x/zh_CN/docs/introduction/change_log/index.rst
@@ -84,6 +84,7 @@ v3.2.x
    :hidden:
    :maxdepth: 0
 
+   3_2_2.md
    3_2_1.md
    3_2_0.md