第七章 手动部署FISCO BCOS区块链并完成新增群组,在原有群组中新增机构
鉴于笔者以前各大博客教程都有很多人提问,早期建立一个技术交流群,里面技术体系可能比较杂,想了解相关区块链开发,技术提问,请加QQ群:538327407(已满),群2:135019400
目标
1、新增群组搭建完整联盟链
2、根据群组新增机构
3、新增群组,将原有机构加入
一、前提准备:
java 环境
详细可以参考前面几章的操作。
二、正式操作
画了一张图,大致说明操作。
1、创世机构生成链证书,dir_chain_ca 文件复制给各个机构
2、在各个机构的的generator 目录下 执行命令生成个各自的机构证书
以下三个命令 要在各自的操作界面操作
机构A:./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyA 机构B:./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyB
备注:生成机构证书 都需要有链证书等做基础
3、链证书、机构证书、机构私钥至机构对应机构的meta目录下
上图为创世区块的meta 文件夹,里面还收集了其他节点的证书。
普通机构,只有自己的节点证书、还有其他群组的peers.txt 的文件,以及群组配置文件、链证书、自己的机构证书等。
4、修改各个机构的node_deployment.ini文件
p2p_ip 和rpc_ip 修改为 内网地址
前提:内网端口等要打开
5、生成各个机构的节点证书和p2p 连接信息文件
机构A:./generator --generate_all_certificates ./agencyA_node_info 机构B:./generator --generate_all_certificates ./agencyB_node_info
需要用的上面node_deployment.ini,及机构meta文件夹下的机构证书与私钥
6、各自机构peers.txt 互相传递
机构生成节点时需要指定其他节点的节点P2P连接地址,因此,A机构需将节点P2P连接地址文件发给其他机构,同样的其他机构都要把peers[自定义].txt copy 给除自己外的机构/meta 文件夹下
7、创世区块修改群组
修改:./conf/group_genesis.ini
配置group_id,以及p2p_ip,rpc_ip
8、此步会根据机构A的meta文件夹下配置的节点证书,生成group_genesis.ini配置的群组创世区块
./generator --create_group_genesis ./group
生成好之后,会出现一个group 文件夹
将./group/group.1.genesis 文件copy 个每个机构 的meta 下面
9、生成所属节点
./generator --build_install_package ./meta/peers.txt ./nodeA ./generator --build_install_package ./meta/peers.txt ./nodeB ./generator --build_install_package ./meta/peers.txt ./nodeC
说明:上面命令 peers.txt 是可以自定义名称的,初始化时候我将他们统一放到peers.txt ,不过后续拓展新的节点和新机构,我有单独拆分为:比如机构A中有机构B的peersB.txt 配置文件。
10、启动节点
bash ./nodeA/start_all.sh
如果出现端口占用,这么解决
(1).根据端口查找进程
sudo lsof -i:[port]
(2).根据PID杀掉进程
sudo kill [PID]
重新启动
bash ./nodeA/start_all.sh
查看:
进程:ps -ef | grep fisco
查看节点:tail -f ./node*/node*/log/log* | grep +++
出现+++ 为节点正常共识
生成新的机构
(1) 生成机构证书
(2)copy 机构证书到meta 目录,并将 /agency*_node_info/cert*.crt 放到对应的创世区块的机构/meta/
同时包括p2p连接peers.txt
(3) 修改 node_deployment.ini 文件
下载控制台
bash <(curl -s https://raw.githubusercontent.com/FISCO-BCOS/console/master/tools/download_console.sh)
如果下载忙 ctrl+C 重新下载,多实验几次,有的时候比较快
修改console 内部的conf ,ca证书、节点证书和私钥 一个xml 配置项
官方说法:
将节点sdk目录下的ca.crt、node.crt和node.key文件拷贝到conf目录下。
将conf目录下的applicationContext-sample.xml文件重命名为applicationContext.xml文件。
配置applicationContext.xml文件,其中添加注释的内容根据区块链节点配置做相应修改。
提示:相关IP改为内网ip
则applicationContext.xml配置不用修改。
一个机构 内部节点 每个节点 证书都不一样,
控制台可以使用swith 2 等操作切换,不需要手动修改 配置
参考:https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/sdk/sdk.html#spring
新建群组(将原有机构A加入--》到机构C为创世区块的群组2中)
前提条件:完成基础安装
下载
cd ~/ && git clone https://github.com/FISCO-BCOS/generator.git
安装
此操作要求用户具有sudo权限。
cd generator && bash ./scripts/install.sh
检查是否安装成功,若成功,输出 usage: generator xxx
./generator -h
拉取节点二进制
拉取最新fisco-bcos二进制文件到meta中
./generator --download_fisco ./meta
检查二进制版本
若成功,输出 FISCO-BCOS Version : x.x.x-x
./meta/fisco-bcos -v
将机构A 中./dir_chain_ca/目录copy 到项目中
(1)修改新机构的 group_genesis.ini 文件, group_id 等改为新的群组,其他的也做相应修改
(2) 机构C 本身的node_deployment.ini 配置好,就配置了 group_id 改为 对应的群组
(3)机构C生成节点证书及P2P连接信息文件 ,执行如下命令:
./generator --generate_all_certificates ./agencyC_node_info
(4) 将机构A /agencyA_node_info/cert*.crt 放到 机构C的meta 目录下
(5) 对应的peers.txt 也copy 过去,并改名为peers[自己定义].txt,
(6)对应的peers.txt 复制给机构A的meta 下面的peers.txt 中
(7)生成group_genesis.ini配置的群组创世区块。执行如下命令:
./generator --create_group_genesis ./group
(8)group.2.genesis copy 给机构A 的meta 文件下
(9)机构C生成所属节点,执行如下命令:
./generator --build_install_package ./meta/peersA.txt ./nodeC
(10)启动节点 bash ./nodeC/start_all.sh
(11)下载console ,把之前其他机构console 拿过来,修改console 目录下conf
官方说法:
将meta/node_172.27.16.5_3030 等类似 目录下的ca.crt、node.crt和node.key文件拷贝到conf目录下。
将conf目录下的applicationContext-sample.xml文件重命名为applicationContext.xml文件。
配置applicationContext.xml文件,其中添加注释的内容根据区块链节点配置做相应修改。
则applicationContext.xml配置不用修改。
(12) 使用switch 2 等切换控制台,前提是要给控制台配置好配置
在原有的群组里面新增机构(注意要在同一个内网,或者网络是可以联通的情况下)
ps:本事例和官方操作不同,官方是在机构A和机构C已经建立群组2的基础上,将机构C加入群组1,笔者是在机构A和机构B组合群组1情况下,新增一个独立机构,并完全加入到群组1中
1、下载源程序,将机构A的链证书文件夹(./dir_agency_ca),发送机构C的项目根目录下
2、生成机构C证书:
./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyC
3、发送链证书、机构证书、机构私钥,示例是通过文件拷贝的方式,
放到机构C的工作目录的meta目录下
4、修改 node_deployment.ini,主要修改 p2p_ip和rpc_ip
5、生成机构C节点证书,执行如下命令:
./generator --generate_all_certificates ./agencyC_node_info
6、将C的节点peers.txt copy 给A,同时将A的copy 给C
7、agencyC_node_info 相关 cert*.crt copy 给机构A(创世区块所在机构)./meta/
8、将群组group.1.genesis 文件分配copy 给机构C 的meta ,生成机构C所属节点
并执行命令:
./generator --build_install_package ./meta/peers.txt ./nodeC
启动机构C的节点:
bash ./nodeC/start_all.sh
9、机构C执行,为机构C节点添加群组1创世区块后需从启节点
./generator --add_group ./meta/group.1.genesis ~/generator/nodeC
10、机构A中进入控制台,添加新的节点
添加机构C节点连接文件peers至已有节点,此步将peersC.txt
的节点P2P连接地址添加至./nodeA下的所有节点内:
./generator --add_peers ./meta/peersC.txt ./nodeA
备注:默认同一个群组的其他机构都要如此操作,现在还是静态的配置,新增的节点配上所有已有的节点就行,两个节点的连接只用配一边就已经可以连接了,文档里推荐的所有全部配上,是为了更稳妥,把两边都配上。
主要通过控制台 addSealer 命令: 后面的节点id 是新加入机构C的两个节点,通过机构C中meta 文件夹下的节点文件夹中的node.nodeid 文件获取
如上操作,添加新节点成功
11、重启节点
bash ~/generator/nodeD/stop_all.sh
bash ~/generator/nodeD/start_all.sh
12、在机构C的控制台中,加入群组A的配置,就可以了
<?xml version="1.0" encoding="UTF-8" ?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:p="http://www.springframework.org/schema/p" xmlns:tx="http://www.springframework.org/schema/tx" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd"> <bean id="encryptType" class="org.fisco.bcos.web3j.crypto.EncryptType"> <constructor-arg value="0"/> <!-- 0:standard 1:guomi --> </bean> <bean id="groupChannelConnectionsConfig" class="org.fisco.bcos.channel.handler.GroupChannelConnectionsConfig"> <property name="allChannelConnections"> <list> <bean id="group1" class="org.fisco.bcos.channel.handler.ChannelConnections"> <property name="groupId" value="1" /> <property name="connectionsStr"> <list> <value>172.27.16.5:20200</value> <value>172.27.16.5:20201</value> </list> </property> </bean> </list> </property> </bean> <bean id="channelService" class="org.fisco.bcos.channel.client.Service" depends-on="groupChannelConnectionsConfig"> <property name="groupId" value="1" /> <property name="agencyName" value="fisco" /> <property name="allChannelConnections" ref="groupChannelConnectionsConfig"></property> </bean> </beans>
在机构C控制台进行共识测试,各个控制台的输出共识结果相同
补充:如果是外网情况的部署
1、创世区块的结构group 配置如下
2、其他节点配置如下
依照上述操作,可以实现不同网络环境下,完成实际联盟链部署。
读后感觉不错,有收获可以微信请作者喝杯咖啡,读后有疑问请加微信,拉群研讨,注明来意