From d59e4e2969d183e443a5551984833ec3780cb481 Mon Sep 17 00:00:00 2001 From: jimmyshi <417711026@qq.com> Date: Tue, 4 Jul 2023 09:28:39 +0800 Subject: [PATCH] Add 3.2.2 description (#1714) --- 2.x/docs/compatibility.md | 4 +- .../docs/introduction/change_log/3_2_2.md | 86 +++++++++++++++++++ .../docs/introduction/change_log/index.rst | 1 + 3 files changed, 89 insertions(+), 2 deletions(-) create mode 100644 3.x/zh_CN/docs/introduction/change_log/3_2_2.md diff --git a/2.x/docs/compatibility.md b/2.x/docs/compatibility.md index d38d1eb31..a048da347 100644 --- 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 | 暂不支持
后续版本规划 | | | | | 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 new file mode 100644 index 000000000..03ece5482 --- /dev/null +++ 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 index aac356290..0948295c0 100644 --- 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