Fabric-V1.4安装配置 及 票据应用示例

Fabric-V1.4安装配置 及 票据应用示例

Fabric 1.4 更新内容

Fabric已经发布到1.4LTS版本，各个版本对比如下：

Fabric v1.1版本主要的新特性包括：

• Fabric CA的CRL
• 区块以及交易的事件推送
• 增加了所有组建间的双向TLS通信
• Node.js Chaincode链码的支持
• Chaincode API新增了creator identity
• 性能相对v1.0有了明显的提升

Fabric v1.2开始有了比较大的feature开始出现：

• Private Data Collections：这个特性不得不说在隐私保护上解决了不少项目的痛点，也减少了许多项目为了隐私保护在业务层做的复杂设计。
• Service Discovery：服务发现这个特性，使得客户端拥有了更多的灵活性和可操作性，可以动态感知整个Fabric网络的变化。
• Pluggable endorsement and validation：可插拔的背书及校验机制，采用了Go Plugin机制来实现，避免了之前需要重新编译源代码的操作，提升了灵活性。

Fabric v1.3中，同样增加了十分有用的feature：

• 基于Identity Mixer的MSP Implementation：基于零知识证明实现的身份的匿名和不可链接，这个特性替代了v0.6版本中的T-cert。
• key-level endorsement policies：更细粒度的背书策略，细化到具体的key-value，更加灵活，不仅限于一个链码程序作背书。
• 新增Java Chaincode：至此，v1.3之后支持了Go、Node.js、Java 三种Chaincode，为开发者提供了更多的选择。
• Peer channel-based event services：Channel级别的事件订阅机制，早在v1.1版本中已经亮相了，在v1.3版本中正式发布，至此，旧的Event Hub正式宣告弃用。

Fabric v1.4是一个里程碑式的版本，是首个LTS的版本（Long Term Support的版本）：

• 可操作性和可维护性的提升：
• 开放日志级别设置的接口
• 开放节点健康状态的检查接口
• 开放节点数据指标的收集接口
• 改进了Node SDK的编程模型，简化开发者的代码复杂度，使得SDK更加易用
• Private Data的增强：
• 对于后续添加的允许访问节点能够获取之前的隐私数据
• 添加客户端层面的隐私数据的权限控制，不需要添加链码逻辑。

环境搭建准备工作

实验环境

这里作一个更新，新建Centos7.4的虚拟机环境。大致搭建过程如下。 云主机：Centos 7.4 、CPU：4C、内存：16G，硬盘:200G。

相关前置软件安装

关闭Selinux，关闭防火墙等相关操作，相关操作网络上随处可查。

建议更新后再进行下列操作：

> yum update

安装git、curl、pip

> yum install git
> yum install curl
> yum -y install epel-release
> yum install python-pip
> pip install --upgrade pip

安装docker相关

>  yum install docker-ce
# 或者：yum install docker-ce.18.06.3.ce-3.el7  指定具体版本，可以先设置好yum 源（yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo）
> pip install docker-compose #（可能会失败，那就用以下的命令）
> pip install docker-compose --ignore-installed requests 

相关软件环境： 安装完成后查看各个软件版本，如下图：

注： 可能会碰到docker-compose报错：

File "/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py", line 55, in <module>
GSS_EXCEPTIONS = (gssapi.GSSException,)
AttributeError: 'module' object has no attribute 'GSSException'

那么通过修改配置文件:/usr/lib/python2.7/site-packages/paramiko/ssh_gss.py来解决:

vi /usr/lib/python2.7/site-packages/paramiko/ssh_gss.py
53.55行修改如下解决：
53：import gssapi.error
55：GSS_EXCEPTIONS = (gssapi.error.GSSException,)

安装Golang、Node.js、npm

安装Golang

如果单独去下载安装包麻烦的话，那么直接通过wget来下载解压，配置环境变量。

wget https://studygolang.com/dl/golang/go1.10.8.linux-amd64.tar.gz
tar -xvf go1.10.8.linux-amd64.tar.gz

配置环境变量。修改/etc/profile文件,路径根据下载安装路径来。

vim /etc/profile
添加
export GOROOT=/usr/go
export GOPATH=/usr/gopath
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

安装Node.js

wget https://npm.taobao.org/mirrors/node/v11.0.0/node-v11.0.0.tar.gz
tar -xvf node-v11.0.0.tar.gz
解压后进入Node文件夹：
yum install gcc gcc-c++
完成后gcc -v,这时候会发现gcc为4.8.5 建议更新：
wget http://ftp.gnu.org/gnu/gcc/gcc-7.3.0/gcc-7.3.0.tar.gz

更新完成后，解压gcc，并安装：

tar -xvf gcc-7.3.0.tar.gz
进入gcc-7.3.0目录执行：
./contrib/download_prerequisites
mkdir 一个新的目录
进入该目录 cd 目录
../configure --enable-checking=release --enable-languages=c,c++ --disable-multilib 
make (请耐心等待，我这里大概等待了2个多小时。。。)
make install
建议重启后再进行之后的操作

重启后看到gcc版本为7.3.0

安装Node.js

进入Node.js文件夹(这里可能有一个文件夹名的问题，建议修改node7.3.0文件夹名直接为node)
./configure
make （耐心等待）
make install
建议重启后再进行之后的操作

安装npm

npm install npm -g

完成上述操作后，查看各软件版本：

安装 Fabric

首先下载Fabric源码，我们在go/src目录下新建文件夹。

mkdir -p github.com/hyperledger
进入该文件夹执行：
git clone https://github.com/hyperledger/fabric.git (耐心等待)

完成后进入 fabric/scripts文件夹，可以看到bootstrap.sh脚本，cat该脚本可以看到fabric版本为1.4.0：

执行bootstrap.sh脚本，自动进行fabric相关镜像的下载,耐心等待

./bootstrap.sh

镜像下载完成后如图：

通过Fabric-samples提供的BYFN(build your first network)构建网络。

 ./byfn.sh -m generate -c jackychannel（自定义名字）

过程很快，完成后如图：

启动网络：

./byfn.sh -m up -c jackychannel

启动后如图： 完成后如图：

这个时候出现4个peer节点，通过top命令可以清楚看到：

注： 关闭命令：./byfn.sh -m down

启动网络服务后会启动排序服务节点、4个Peer节点，以及1个命令行容器cli。

搭建完成后功能测试

上述步骤完成后，可是去看下一些基本的操作和命令。

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/channel-artifacts目录中,可称为创世区块目录（目录根据每个人的配置）

可以看到下列文件：

Org1MSPanchors.tx、Org2MSPanchors.tx,两个锚节点配置。 channel.tx，生成通道配置文件。 genesis.block，创世区块文件。

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network/crypto-config目录中，可称为证书目录（目录根据每个人的配置）

该目录存放生成排序服务节点和Peer节点的MSP证书文件，如图：

使用docker命令查看运行中的镜像：

docker ps

结果如图：

进入cli来进行一些简单的操作：

docker exec -it cli bash

切换到容器内做一个简单的查询：

peer chaincode query -C jackychannel(刚设置启动的名称) -n mycc -c '{"Args":["query","a"]}'

结果会看到90余额。

票据应用测试

在Fabric官网文档中有一个商业票据的例子，这里简单进行了测试。(停止Fabric网络服务后再进行以下操作。)

两个组织：MagnetoCorp、DigiBank， 票据网络：PaperNet。

进入该目录启动基本网络：

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/basic-network
./start.sh

启动完成后查看：docker ps 会出现4个运行中容器。

使用：docker network inspect net_basic命令查看docker网络：

进入以下目录，启动：

cd commercial-paper/organization/magnetocorp/configuration/cli/
./monitordocker.sh net_basic

出现下图：

另外开一个终端连接到服务器，在之前目录下，创建MagnetoCorp公司特定的docker容器。

cd commercial-paper/organization/magnetocorp/configuration/cli/
docker-compose -f docker-compose.yml up -d cliMagnetoCorp

再输入：docker ps 可以看到fabric-tools：3f078207c01a已加入网络中：

MagnetoCorp 管理员通过fabric-tools：3f078207c01a来进行操作。

接下来看下智能合约： 进入以下目录：

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/contract/lib

该目录下三个文件，其中papercontract.js为商业票据的智能合约。可以cat看下具体内容，这里暂不展开。

执行如下部署合约代码：

docker exec cliMagnetoCorp peer chaincode install -n papercontract -v 0 -p /opt/gopath/src/github.com/contract -l node

实例化智能合约：

docker exec cliMagnetoCorp peer chaincode instantiate -n papercontract -v 0 -l node -c '{"Args":["org.papernet.commercialpaper:instantiate"]}' -C mychannel -P "AND ('Org1MSP.member')"

输入如下：

之前打开的终端中会有输出，也就是logsout容器的中的日志输出内容，具体如下：

再次docker ps就可以看到：dev-peer0.org1.example.com-papercontract-0，说明此容器是peer0.org1.example.com节点启动的，且正在运行的papercontract链码版本为0。

MagnetoCorp Application进行票据发行:

过程图：

MagnetoCorp的Isabella发起整个交易过程。

进入以下目录：

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/magnetocorp/application

可以看到下列文件: eslintrc.js、issue.js、package.json、addToWallet.js、node_modules

node addToWallet.js

在执行上述命令的时候，强烈建议先进行如下操作：这几个坑一般都存在~~

修改package.json文件
vi package.json
把里面1.0.0版本改成1.4.0
npm install（如报错执行下列命令）
npm install --unsafe-perm fabric-network
如有：Error: /lib64/libstdc++.so.6: version `CXXABI_1.3.9' not found 报错那么执行下列命令：
find / -name "libstdc++.so.6*
找到文件的指定目录，笔者这里是6.0.24，复制到/lib64目录、删除之前的libstdc++.so.6文件，执行如下命令链接：
ln -s libstdc++.so.6.0.24 libstdc++.so.6

再删除之前的node_modules文件夹，再次执行：

npm install（如报错执行下列命令）
npm install --unsafe-perm fabric-network
node addToWallet.js

这个时候正常的话会出现done，如图：

查看钱包的结构：

ll ../identity/user/isabella/wallet/
ll ../identity/user/isabella/wallet/User1\@org1.example.com

结果如下图：

Isabella钱包信息: 用户私钥：c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-priv 用户公钥：c75bd6911aca808941c3557ee7c97e90f3952e379497dc55eb903f31b50abc83-pub 用户证书文件：User1@org1.example.com

发起交易： Isabella现在可以使用issue.js来提交一个交易（发行MagnetoCorp 公司的商业票据00001）

node issue.js

结果如图：

以上操作都是在MagnetoCorp的Isabella，接下来是，DigiBank-Balaji ，他将购买刚刚发行的商业票据。

购买流程图：

进入下列目录：

/usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/configuration/cli
执行：docker-compose -f docker-compose.yml up -d cliDigiBank

结果如图：

cd /usr/go/src/github.com/hyperledger/fabric/scripts/fabric-samples/commercial-paper/organization/digibank/application
vi buy.js

buy.js文件可查看合约内容.

和之前npm的操作一样、修改相关文件内容：

修改package.json文件
vi package.json  # 把里面1.0.0版本改成1.4.0
npm install（如报错执行下列命令）
npm install --unsafe-perm fabric-network

创建账户及购买，商业票据00001生命周期的最后一个交易是redeem交易，Balaji 通过运行redeem.js程序来实现这一过程。

node addToWallet.js 
node buy.js
node redeem.js

在执行过程中可能会出现：

那么执行：

npm install -g js-yaml

结果如图：

整个实验大致完成。

参考文章：

1. https://www.jianshu.com/p/cb032c42c909
2. https://blog.csdn.net/ASN_forever/article/details/87859346
3. https://hyperledger-fabric.readthedocs.io/en/latest/