笔记小站
fisco-generator工具
JoBackRer Lv2
  2025-01-14 18:12:01   2025-01-14 19:25:49

前置条件:

机构 节点 所属群组 P2P地址 RPC监听地址 Channel监听地址 IP地址
机构A 节点0 群组1,2,3,4 30300 20200 8545 127.0.0.1
节点1 群组1,2,3,4 30301 20201 8546 127.0.0.1
机构B 节点2 群组1 30302 20202 8547 127.0.0.1
节点3 群组1 30303 20203 8548 127.0.0.1
机构C 节点4 群组2 30304 20204 8549 127.0.0.1
节点5 群组2 30305 20205 8550 127.0.0.1
机构D 节点6 群组3 30306 20206 8551 127.0.0.1
节点7 群组3 30307 20207 8552 127.0.0.1
节点8 群组3 30308 20208 8553 127.0.0.1
机构E 节点9 群组4 30309 20209 8554 127.0.0.1

下载工具Generator

1
git clone https://gitee.com/FISCO-BCOS/generator.git

切进目录并进行安装

1
2
3
4
cd generator/
./scripts/install.sh
# 测试是否安装成功
./generator -h

image.png

获取节点的二进制文件

1
./generator --download_fisco ./meta

如何一直获取不下来，可以采取其他方式下载到指定文件夹

1
mkdir ./meta

这个meta相当于一个临时文件夹。

查看fisco版本信息

1
./meta/fisco-bcos -v

准备工作

根据前置条件中可以看到需求是ABCD机构所以要将当前的文件复制成ABCD四份。

1
2
3
4
cp -r generator/ generator-a
cp -r generator/ generator-b
cp -r generator/ generator-c
cp -r generator/ generator-d

image.png

生成区块链的唯一密钥证书(在generator目录下生成)

1
./generator --generate_chain_certificate ./dir_chain_ca

--generate_chain_certificate生成区块链唯一的密钥相当于之前搭建中nodes/127.0.0.1/sdk内的内容

./dir_chain_ca生成的文件名称

1
2
3
4
5
# 预输出效果如下
root@backrer-virtual-machine:~/fisco/generator# ./generator --generate_chain_certificate ./dir_chain_ca
INFO |  Chain cert begin.
INFO |  Generate root cert success, dir is /root/fisco/generator/dir_chain_ca
INFO |  Chain cert end.

然后生成各个机构的证书及密钥,并复制到指定的机构目录下的meta中

1
2
3
4
5
6
7
8
./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencya
./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyb
./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyc
./generator --generate_agency_certificate ./dir_agency_ca ./dir_chain_ca agencyd
cp -r ./dir_agency_ca/agencya/* ../generator-a/meta/
cp -r ./dir_agency_ca/agencyb/* ../generator-b/meta/
cp -r ./dir_agency_ca/agencyc/* ../generator-c/meta/
cp -r ./dir_agency_ca/agencyd/* ../generator-d/meta/

--generate_agency_certificate生成机构的密钥

./dir_agency_ca生成的文件位置

./dir_chain_ca区块链的唯一密钥

agencyxx机构名称

机构A,B的生成和群组1

准备

切换到generator-a目录中，编辑conf/node_deployment.ini

根据提供的ip端口进行对应的修改

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[group]
group_id=1

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; Listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30300
channel_listen_port=20200
jsonrpc_listen_port=8545

[node1]
p2p_ip=127.0.0.1
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30301
channel_listen_port=20201
jsonrpc_listen_port=8546

同理切换到generator-b,编辑conf/node_deployment.ini

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
[group]
group_id=1

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; Listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30302
channel_listen_port=20202
jsonrpc_listen_port=8547

[node1]
p2p_ip=127.0.0.1
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30303
channel_listen_port=20203
jsonrpc_listen_port=8548

生成机构A的节点证书和p2p连接信息文件(切换到generator-a)

1
2
./generator --generate_all_certificates ./agencya_node_info
ll agencya_node_info

将p2p连接信息文件复制到agency-b中

1
cp agencya_node_info/peers.txt  ../generator-b/meta/peersa.txt

同理生成机构B的节点证书和p2p连接信息文件(切换到generator-b)

1
./generator --generate_all_certificates ./agencyb_node_info

将p2p连接信息文件复制到agency-a中

1
cp agencyb_node_info/peers.txt  ../generator-a/meta/peersb.txt

这里要注意一点，由于目前是要生成群组1所以群组需要创世区块，我们要将机构机构B中的两个cert文件拷贝到机构A的meta中。

1
cp -r agencyb_node_info/cert_*  ../generator-a/meta/

切换到机构A中并编辑文件conf/group_genesis.ini

1
2
cd ../generator-a/
vim conf/group_genesis.ini
1
2
3
4
5
6
7
8
[group]
group_id=1

[nodes]
node0=127.0.0.1:30300
node1=127.0.0.1:30301
node2=127.0.0.1:30302
node3=127.0.0.1:30303

group_id群组号

根据前置要求表中配置好node的ip以及端口

结合四个节点证书生成创世块.

1
./generator --create_group_genesis ./group
1
2
3
4
root@backrer-virtual-machine:~/fisco/generator-a# ./generator --create_group_genesis ./group
INFO |  Build operation begin.
INFO | generate ./group/group.1.genesis, successful
INFO |  Build operation end.

image.png

将group.1.genesis文件复制到机构B中

1
cp group/group.1.genesis  ../generator-b/meta/

生成机构A

在generator-a文件下

使用--build_install_package生成机构的所有节点。

1
2
./generator --build_install_package ./meta/peersb.txt ./nodea
ll ./nodea

./meta/peersB.txt放置群组内其他节点的连接信息

./nodeA节点文件的输出目录

启动机构A的两个节点

1
2
3
bash nodea/start_all.sh
# 查询启动状态
ps -ef | grep fisco

image.png

生成机构B

切换到机构B

1
cd ../generator-b

生成机构B,并且启动

1
2
3
4
./generator --build_install_package ./meta/peersa.txt ./nodeb
bash nodeb/start_all.sh
# 查询启动状态
ps -ef | grep fisco

查看群组1的共识情况

1
tail -f ./node*/node*/log/log*  | grep +++

机构C的生成与群组2

切到机构C,编辑文件conf/node_deployment.ini

1
2
cd ../generator-c
vim conf/node_deployment.ini

根据前置要求设置好对应的端口，以及群组id

这里就不展示修改后的文档了。

生成机构C的节点证书和p2p连接信息，并将连接信息拷贝给机构A

1
2
./generator --generate_all_certificates ./agencyc_node_info
cp -r agencyc_node_info/peers.txt  ../generator-a/meta/peersc.txt

在这里由于我们需要生成群组2，又因为机构A也在群组2中，所以我们要将机构A的连接信息和cert文件拷贝给机构C以便于生成创世区块。

1
2
cp -r ../generator-a/agencya_node_info/cert*  meta/
cp -r ../generator-a/agencya_node_info/peers.txt  meta/peersa.txt

编辑机构C的conf/group_genesis.ini文件

1
2
3
4
5
6
7
8
[group]
group_id=2

[nodes]
node0=127.0.0.1:30300
node1=127.0.0.1:30301
node2=127.0.0.1:30301
node3=127.0.0.1:30305

生成群组2的创世块文件,并将创世区块拷贝给机构A

1
2
./generator --create_group_genesis ./group
cp -r group/group.2.genesis ../generator-a/meta/

生成机构C并启动

1
2
3
./generator --build_install_package ./meta/peersa.txt ./nodec
bash nodec/start_all.sh
ps -ef | grep fisco

现在将机构A添加到群组2中(切到机构A)

1
2
cd ../generator-a
./generator --add_group ./meta/group.2.genesis ./nodea

./meta/group.2.genesis群组2的创世块

./nodea需要加入群组的节点目录

使机构A连接机构C

1
./generator --add_peers ./meta/peersc.txt ./nodea

./meta/peersc.txt连接信息文件

./nodea要连接的节点

重新启动机构A，并查询机群组2是否有共识存在

1
2
3
4
bash nodea/stop_all.sh
bash nodea/start_all.sh
# 查询群组2共识情况
tail -f ./node*/node*/log/log*  | grep g:2.*+++

机构D的生成与群组3的创建

方法与上方类似

切换到generator-d,并编辑文件conf/node_deployment.ini

1
2
cd ../generator-c
vim conf/node_deployment.ini

由于这里是三个节点所有在配置文件时要多配置一个节点

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
[group]
group_id=3

[node0]
; Host IP for the communication among peers.
; Please use your ssh login IP.
p2p_ip=127.0.0.1
; Listening IP for the communication between SDK clients.
; This IP is the same as p2p_ip for the physical host.
; But for virtual host e.g., VPS servers, it is usually different from p2p_ip.
; You can check accessible addresses of your network card.
; Please see https://tecadmin.net/check-ip-address-ubuntu-18-04-desktop/
; for more instructions.
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30306
channel_listen_port=20206
jsonrpc_listen_port=8551

[node1]
p2p_ip=127.0.0.1
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30307
channel_listen_port=20207
jsonrpc_listen_port=8552

[node2]
p2p_ip=127.0.0.1
rpc_ip=127.0.0.1
channel_ip=0.0.0.0
p2p_listen_port=30308
channel_listen_port=20208
jsonrpc_listen_port=8553

生成机构D的节点证书和p2p连接信息文件

1
./generator --generate_all_certificates ./agencyd_node_info

将连接信息拷贝给机构A

1
cp -r agencyd_node_info/peers.txt ../generator-a/meta/peersd.txt

将A的信息拷贝给D用于创建创世区块

1
2
cp -r ../generator-a/agencya_node_info/peers.txt meta/peersa.txt
cp -r ../generator-a/agencya_node_info/cert*  meta/

配置group_genesis.ini

1
2
3
4
5
6
7
8
9
[group]
group_id=3

[nodes]
node0=127.0.0.1:30300
node1=127.0.0.1:30301
node2=127.0.0.1:30306
node3=127.0.0.1:30307
node3=127.0.0.1:30308

创建群组3创世区块，并将文件拷给机构A

1
2
./generator --create_group_genesis ./group
cp -r group/group.3.genesis ../generator-a/meta/

生成机构D节点并启动

1
2
./generator --build_install_package ./meta/peersa.txt ./noded
bash noded/start_all.sh

切换机构A中，将群组3的初始化以及连接机构D

1
2
./generator --add_group ./meta/group.3.genesis ./nodea/
./generator --add_peers ./meta/peersd.txt ./nodea/

重启机构A,并且查看共识

1
2
3
bash nodea/stop_all.sh
bash nodea/start_all.sh
tail -f ./node*/node*/log/log*  | grep g:3.*+++

机构E同理

自行完成

 Comments
Comment plugin failed to load
Loading comment plugin