第七章 手动部署Fisco Bcos 区块链并完成新增群组，在原有群组中新增机构

鉴于笔者以前各大博客教程都有很多人提问，早期建立一个技术交流群，里面技术体系可能比较杂，想了解相关区块链开发，技术提问，请加QQ群：538327407

目标

1、新增群组搭建完整联盟链

2、根据群组新增机构

3、新增群组，将原有机构加入

一、前提准备：

java 环境

详细可以参考前面几章的操作。

二、正式操作

 官方参考文档：https://fisco-bcos-documentation.readthedocs.io/zh_CN/latest/docs/tutorial/enterprise_quick_start.html#ac2

 

画了一张图，大致说明操作。

 

 

 

 

 

 

 

 

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）.根据ＰＩＤ杀掉进程

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"/> 
    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:20200value>
                            <value>172.27.16.5:20201value>

                        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、其他节点配置如下

 

 依照上述操作，可以实现不同网络环境下，完成实际联盟链部署。