update v3.2.4 and v3.2.5 doc (#1759)

FISCO-BCOS · Jan 5, 2024 · 51ff126 · 51ff126
1 parent 7c9d2bf
commit 51ff126
Show file tree

Hide file tree

Showing 3 changed files with 190 additions and 0 deletions.
diff --git a/3.x/zh_CN/docs/introduction/change_log/3_2_4.md b/3.x/zh_CN/docs/introduction/change_log/3_2_4.md
@@ -0,0 +1,101 @@
+# v3.2.4
+
+#### 新增
+
+* [新增feature开关dmc2Serial，支持执行模式从dmc切换为串行模式](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3914)
+* [新增节点只读开关](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3930)
+* [新增允许非群组节点同步区块开关](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3937)
+* [新增解决stateStorage_hash计算错误的bugfix](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3951)
+* [新增控制启用rip功能的开关](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3970)
+* [新增节点配置的getFeatureKeys功能](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4012)
+
+#### 修改
+
+* [支持并修复evm中create2等操作码](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3787)
+* [修改不必要的错误日志级别](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3981)
+
+#### 修复
+
+* [修复自由节点同步区块过程中错误](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3942)
+* [迁移3.5.0版本中对交易池同步dag的修复](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3861)
+* [修复建链脚本build_chain.sh一些小问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/3998)
+
+#### 升级描述
+
+* 升级节点可执行程序
+
+  效果：修复bug，并带来稳定性、性能的提升
+
+  操作：停止节点服务，升级节点可执行程序为当前版本，重启节点服务
+
+  注意事项：推荐逐步替换可执行程序进行灰度升级
+
+  支持升级的版本：v3.0.0+
+
+* 升级链数据版本
+
+  效果：可使用当前版本的最新特性
+
+  操作：先完成升级所有节点可执行程序，再参考[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/introduction/change_log/3_2_1.html#id5)
+  发送交易升级链数据版本至 v3.2.0
+
+  注意事项：务必备份原节点的所有账本数据，若操作失误造成升级失败，可通过原数据回滚到升级前的状态
+  支持升级的版本：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/3_2_5.md b/3.x/zh_CN/docs/introduction/change_log/3_2_5.md
@@ -0,0 +1,85 @@
+# v3.2.5
+
+#### 修复
+
+* [修复build_chain脚本中安全漏洞的系统调用](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4039)
+* [修复节点开启只读模式后收到AMOP消息报错的问题](https://github.com/FISCO-BCOS/FISCO-BCOS/pull/4043)
+
+#### 升级描述
+
+* 升级节点可执行程序
+
+  效果：修复bug，并带来稳定性、性能的提升
+
+  操作：停止节点服务，升级节点可执行程序为当前版本，重启节点服务
+
+  注意事项：推荐逐步替换可执行程序进行灰度升级
+
+  支持升级的版本：v3.0.0+
+
+* 升级链数据版本
+
+  效果：可使用当前版本的最新特性
+
+  操作：先完成升级所有节点可执行程序，再参考[文档](https://fisco-bcos-doc.readthedocs.io/zh_CN/latest/docs/introduction/change_log/3_2_1.html#id5)
+  发送交易升级链数据版本至 v3.2.0
+
+  注意事项：务必备份原节点的所有账本数据，若操作失误造成升级失败，可通过原数据回滚到升级前的状态
+  支持升级的版本：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
@@ -93,6 +93,8 @@ v3.2.x
 ------------------
 
 .. admonition:: FISCO BCOS 3.x Releases
+     - `FISCO BCOS v3.2.5 <./3_2_5.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.5>`_]
+     - `FISCO BCOS v3.2.4 <./3_2_4.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.4>`_]
      - `FISCO BCOS v3.2.3 <./3_2_3.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.3>`_]
      - `FISCO BCOS v3.2.2 <./3_2_2.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.2>`_]
      - `FISCO BCOS v3.2.1 <./3_2_1.html>`_ [`release <https://github.com/FISCO-BCOS/FISCO-BCOS/releases/tag/v3.2.1>`_]
@@ -112,6 +114,8 @@ v3.2.x
    :hidden:
    :maxdepth: 0
 
+   3_2_5.md
+   3_2_4.md
    3_2_3.md
    3_2_2.md
    3_2_1.md