[Hyperledger Fabric] 4. 在 Ubuntu16.04 64位环境下手动启动Fabric网络

一、 前期准备

版本

更新或下载URL

Ubuntu

16.04 64位

Hyperledger Fabric

1.0.3

依据官方提供的网址:

http://hyperledger-fabric.readthedocs.io/en/latest/samples.html

依赖项(不分先后顺序)

docker

17.05.0-ce

yes|cp -f ./docker.repo /etc/yum.repos.d/docker.repo

sudo apt-get install –y docker-engine

systemctl start docker.service

 

docker.repo内容见下教程

docker-compose

1.9.0 build 2585387

pip install docker-compose

go

1.7.5

sudo apt-get install –y golang

python

2.7.5

sudo apt-get install –y python

python-pip

9.0.1

sudo apt-get install -y python-pip

pip install --upgrade pip backports.ssl_match_hostname

git

1.8.3.1

sudo apt-get install –y git

nodejs

6.11.3

sudo apt-get install –y nodejs

npm

3.10.10

nodejs已集成

 

说明:

1.     相关工具的安装均为64位,版本不同可能将导致无法正常启动IDE或无法完成某些配置,请务必注意版本信息。

2.     后续安装过程中有部分工具,仅仅需要解压即可完成安装,建议将解压出的问题统一安装至相同目录便于管理。

 

 

 

二、 配置步骤

环境搭建详见我个人博客:https://blog.csdn.net/mimica/article/details/78412038

 

1.     网络拓扑

 

2.     准备自己手动生成相关配置文件

添加bootstrap-*.sh下载的签名、生成证书等工具——configtxgen、configtxlator、cryptogen、orderer、peer

 

方法一:添加路径至环境变量,永久生效。环境变量路径:

vim/etc/environment

 

方法二:直接拷贝工具至/usr/bin,类似方法一,需要root权限(使用切换至root)。命令:

sudo yes|cp –f  [你的fabric例子代码存放路径]/fabric-samples/script/bin/configtxlator /usr/bin/
sudo yes|cp –f  [你的fabric例子代码存放路径]/fabric-samples/script/bin/configtxgen /usr/bin/
sudo yes|cp –f  [你的fabric例子代码存放路径]/fabric-samples/script/bin/cryptogen /usr/bin/
sudo yes|cp –f  [你的fabric例子代码存放路径]/fabric-samples/script/bin/orderer /usr/bin/
sudo yes|cp –f  [你的fabric例子代码存放路径]/fabric-samples/script/bin/peer /usr/bin/

 

添加文件的可执行权限

chmod –R a+x configtxlator configtxgen cryptogen orderer peer

 

方法三:使用官方提供的源码重新编译生成工具,命令:

文件所在:~/go/src/github.com/hyperledger/fabric

执行命令:

make cryptogen
make configtxgen
make configtxlator

2.1.   生成组织关系和身份证书

通过以下命令可以为Fabric网络生成指定拓扑结构的组织和身份文件,并存放到crypto-config目录

命令:

cryptogen generate --config=./crypto-config.yaml --output ./crypto-config

 

通过crypto-config.yaml配置文件生成组织关系和身份证书,执行成功结果如下:

 

通过以下命令可查看crypto-config目录结构,命令:

tree –L 4 crypto-config

2.2.   生成Ordering服务启动初始区块

本地使用简单solo模式,生产环境请使用kafka集群服务。

1)   生成Ordering服务系统通道的初始区块文件

FABRIC_CFG_PATH=. configtxgen -profile TwoOrgsOrdererGenesis –outputBlock ./orderer.genesis.block

 

成功生成Ordering服务初始区块,如下所示:

 

说明:

非solo模式下,所生成的orderer.genesis.block需要复制到Orderer节点上(与Orderer配置中ORDERER_GENERAL_GENESISFILE指定的文件路径一致,默认路径为:/etc/hyperledger/fabric路径下),在启动Ordering服务时进行使用。

 

2.3.   生成新建应用通道的配置交易文件

新建应用通道是,需要事先准备好配置交易文件,包括属于该通道的组织结构信息。这些信息会写入该应用通道的初始区块中。而且生成的配置交易信息文件会在后续步骤被客户端使用,因此可以放在客户端节点上。

1)   使用configtx.yaml配置文件中的TwoOrgsChannel模板指定Org1和Org2都属于随后新建的应用通道。

执行命令:

CHANNEL_NAME=businesschannel
 
FABRIC_CFG_PATH=. configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./businesschannel.tx -channelID ${CHANNEL_NAME}

 

成功新建应用通道的配置交易文件,如下所示:

 

2.4.   生成锚节点配置更新文件

锚节点配置更新文件可以用来对组织的锚节点进行配置,但需要分别指定对应的组织名称。

具体生成步骤:

1)    生成组织1:Org1MSP

FABRIC_CFG_PATH=. configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./Org1MSPanchors.tx -channelID ${CHANNEL_NAME} -asOrg Org1MSP

 

2)    生成组织2:Org2MSP

FABRIC_CFG_PATH=. configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./Org2MSPanchors.tx -channelID ${CHANNEL_NAME} -asOrg Org2MSP

 

成功生成锚节点配置更新文件,如下所示:

 

说明:

1)    所生成的锚节点配置更新文件仍会在后续步骤被客户端使用,因此也可以放在客户端节点上。

2)    所有用于启动的配置文件生成并部署到对应节点后,可以进行服务的启动操作。

a)    启动Order节点

b)    启动Peer节点

 

3.     启动Orderer节点

检查启动节点的所有配置是否就绪:

1)   在/etc/hyperledger/fabric下放置有编写好的orderer.yaml。

该文件可参考官方sampleconfig/orderer.yaml文件编写。(具体yaml文件语法请自行搜索了解)

2)   在/etc/hyperledger/fabric下放置生成的msp、tls文件目录。

3)   在/etc/hyperledger/fabric下放置初始区块文件orderer.genesis.block。

 

注:请自行拷贝相关文件至:/etc/hyperledger/fabric下,以便启动orderer节点。

 

 

Orderer节点的默认配置文件中指定简单Orderer节点功能。通常来说,在使用时需依据需求对一些关键配置进行指定。

环境变量配置入口:to be add

启动本地Orderer节点:

orderer start

 

4.     启动Peer节点

5.     操作网络

6.     基于容器方式

 

 

 

三、 FAQ

1.     使用cryptogen无法生成文件

症状:

 

可能原因:

1)    与操作版本不对应

2)    文件损坏

3)    无可执行权限

 

解决方法:

1)    重新下载对应版本

2)    赋予可执行权限

 

重新下载工具(configtxgen、configtxlator、cryptogen):

 

2.     生成Ordering服务系统通道的初始文件失败

症状:

 

原因:

未确认FABRIC_CFG_PATH该变量路径,可预先设置该路径为当前路径。

 

解决方法:

在控制台执行以下命令:

FABRIC_CFG_PATH=.

 

解决后:

 

额外说明:无

 

3.     orderer start启动失败

症状:

原因:

 

解决方法:

 

相关命令:

 

解决后:

 

额外说明:

 

 

4.     注释compose-compose-cli.yaml的script.sh后通过命令行方式手动启动fabric网络失败

启动命令:

CHANNEL_NAME=businesschannel TIMEOUT=300 docker-compose –f docker-compose-cli.yaml up -d

 

 

原因:

docker守护进程启动时无法正确选择sock文件的URL位置。

 

解决方法:

将docker服务添加自系统自启动,重启Ubuntu即可。

 

相关命令:

1.     切换至root用户:su
2.     设置docker为开机自启动:systemctl enable docker
3.     未马上手动重启服务器的情况下,手动启动docker服务:
               systemctl start docker
               systemctl restart docker
4.     退出root后,查看docker容器启动情况:sudo docker ps

 

解决后:

额外说明:

 

5.     连接peer节点

 

原因:

依据上图提示得知连接orderer.example.com:7050错误,具体的错误描述为:认证握手失败,x509证书签名未被授权。

 

解决方法:

给证书签名

 

相关命令:

 

解决后:

 

额外说明:

 

6.     进入docker-compose-cli.yaml配置文件指定的cli容器无法生成通道的创世区块

原因:

存在同名的channel,因为同样的channel已经在之前被建立,命名冲突。

 

解决方法:

移除docker,重新启动。

 

相关命令:

1)     删除一个指定容器:sudo docker rm [container id]
2)     强制删除一个指定容器:sudo docker rm –f [container id]
3)     强制删除全部容器:sudo docker rm –f $(sudo docker ps -aq)

解决后:

生成通道的创世区块:mychannel.block

额外说明:

1)    检查是否已经创建同名channel;

2)    清理之前的搭建环境,如果是在虚拟机中搭建或创建快照,建议重新恢复至快照状态再重新下载容器,按步骤逐一测试。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值