多群组操作指南¶
本教程面向使用FISCO-BCOS多群组特性的用户，介绍如何通过build_chain脚本创建多群组区块链节点以及如何通过控制台操作区块链。
创建多群组区块链¶
FISCO BCOS提供了一键安装脚本build_chain.sh用于快速生成链配置文件。该脚本使用可参考快速建链指南。
创建下图所示拓扑的区块链系统，具体操作如下：
# 在home目录下创建节点目录
$ mkdir -p ~/fisco
$ cd ~/fisco
# 创建配置文件ipList
$ cat > ipList << EOF
192.168.0.1:2 agency1 1,2
192.168.0.2:2 agency2 1
192.168.0.3:2 agency3 2
EOF
# 获取二进制程序，并调用build_chain.sh脚本建链
# 若有源码编译FISCO BCOS需求，请参考 FISCO BCOS源码安装
$ bash <(curl -s https://raw.githubusercontent.com/FISCO-BCOS/FISCO-BCOS/release-2.0.1/tools/ci/download_bin.sh) -b release-2.0.1
# 下载build_chain.sh脚本
$ curl -LO https://raw.githubusercontent.com/FISCO-BCOS/FISCO-BCOS/release-2.0.1/tools/build_chain.sh && chmod u+x build_chain.sh
$ bash build_chain.sh -f ipList -e ./bin/fisco-bcos
# 拷贝节点到每台机器
$ scp -r nodes/192.168.0.1 192.168.0.1:~
$ scp -r nodes/192.168.0.2 192.168.0.2:~
$ scp -r nodes/192.168.0.3 192.168.0.3:~
# 登录每台机器，启动所有节点 && 查看节点进程 && 查看每个节点是否共识正常
$ ssh 192.168.0.1
$ cd ~/192.168.0.1 && bash start_all.sh && ps aux | grep fisco-bcos
# 有+++日志输出
$ tail -f nodes/log/* | grep +++
$ ssh 192.168.0.2
$ cd ~/192.168.0.2 && bash start_all.sh && ps aux | grep fisco-bcos
# 有+++日志输出
$ tail -f nodes/log/* | grep +++
$ ssh 192.168.0.3
$ cd ~/192.168.0.3 && bash start_all.sh && ps aux | grep fisco-bcos
# 有+++日志输出
$ tail -f nodes/log/* | grep +++
Important
- 若build_chain脚本执行失败，请查看nodes/build.log检查出错原因
- 若节点启动失败，请查看node*/nohup.out文件检查启动失败原因
- 节点启动失败可能的原因： 启动端口与其他应用端口重复
配置并启动控制台¶
为方便用户操作，FISCO BCOS在web3sdk基础上封装了控制台，用户可方便地通过控制台增删共识节点、修改区块可打包最大交易数、修改最大gas限制，并可调用FISCO BCOS底层提供的所有RPC接口，详细说明请参考控制台使用指南。
控制台是对web3sdk的封装，配置控制台前，需先部署web3sdk，详细配置可参考配置控制台
控制台配置完毕后，通过bash start group_id启动组group_id的控制台:
# 获取控制台
$ curl -LO https://github.com/FISCO-BCOS/LargeFiles/raw/master/tools/console.tar.gz && tar -zxf console.tar.gz
$ cd console
# 设启动组1的控制台
$ bash start 1
节点入网操作¶
为保证区块链安全性，FISCO BCOS引入了游离节点、观察者节点和共识节点，这三种节点类型可通过控制台相互转换，具体可参考节点入网。
控制台提供了 AddSealer(as) 、AddObserver(ao) 和 RemoveNode(rn) 三类命令将指定节点转换为共识节点、观察者节点和游离节点，并可使用 getSealerList(gsl)、getObserverList(gol) 和 getNodeIDList(gnl) 查看当前组的共识节点列表、观察者节点列表和组内所有节点列表。
例： 将指定节点分别转换成组1的共识节点、观察者节点、游离节点，具体操作和验证步骤如下：
Important
转换节点类型前，请确保节点Node ID存在，节点Node ID可在节点目录下执行 cat conf/node.nodeid获取
$ mkdir -p ~/fisco && cd ~/fisco
# 获取节点Node ID（设节点目录为~/nodes/192.168.0.1/node0/）
$ cat ~/fisco/nodes/192.168.0.1/node0/conf/node.nodeid
7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
# 连接组1的控制台(设控制台位于~/console目录)
$ cd ~/fisco/console
$ bash start 1
# 将指定节点转换为共识节点
> addSealer 7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
# 查询共识节点列表
> getSealerList
[
7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
]
# 将指定节点转换为观察者节点
> addObserver 7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
# 查询观察者节点列表
> getObserverList
[
7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
]
# 将指定节点转换为游离节点
> removeNode 7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
# 查询节点列表
> getNodeIDList
[
7a056eb611a43bae685efd86d4841bc65aefafbf20d8c8f6028031d67af27c36c5767c9c79cff201769ed80ff220b96953da63f92ae83554962dc2922aa0ef50
]
> getSealerList
[]
> getObserverList
[]
修改系统参数¶
FISCO BCOS系统目前主要包括如下系统参数(未来会扩展其他系统参数)：
| 系统参数 | 默认值 | 含义 |
|---|---|---|
| tx_count_limit | 1000 | 一个区块中可打包的最大交易数目 |
| tx_gas_limit | 300000000 | 一个区块最大gas限制 |
控制台提供 setSystemConfigByKey(ssc) 命令来修改这些系统参数，getSystemConfigByKey(gsc) 命令可查看系统参数的当前值：
Important
不建议随意修改tx_count_limit和tx_gas_limit，如下情况可修改这些参数：
- 机器网络或CPU等硬件性能有限：调小tx_count_limit，或降低业务压力；
- 业务逻辑太复杂，执行区块时gas不足：调大tx_gas_limit。
# 设置一个区块可打包最大交易数为500
> setSystemConfigByKey tx_count_limit 500
# 查询tx_count_limit
> getSystemConfigByKey tx_count_limit
[500]
# 设置区块gas限制为400000000
> getSystemConfigByKey tx_gas_limit 400000000
> getSystemConfigByKey
[400000000]