Hyperledger Fabric1.0运行first-network和fabcar以及常见问题解决（持续更新）

基础环境搭建

---

操作系统：阿里云Ubuntu16.04
Git、Golang
Docker环境支持：docker、docker-compose
Fabric组件Docker镜像
fabric-samples源码库
Nodejs： 8.9.4

#先看这个搭建Hyperledger Fabric基础环境
https://blog.csdn.net/holechain/article/details/88795776
#（看到安装docker-compose完成即可，接下来看此篇）

安装Node.js

---

1. 首先，使用下面的命令来安装 nvm（第一种方式，两种选其一即可）

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | bash

• 下载并安装完成后用户退出重新登录或者重新 source 一下环境变量

source ~/.bashrc

• 查看当前的版本

 nvm ls

• 首次安装没有版本，使用nvm install安装指定版本的 node

nvm install v8.9.4

• 再次查看 node 版本信息

 nvm list

• 博主之前已经安装v6.9.5，目前->所指是v6.9.5版本，需要切换成v8.9.4版本

nvm use v8.9.4

2. 手动安装Node.js（第二种方式）

wget wget https://nodejs.org/dist/v8.9.4/node-v8.9.4-linux-x64.tar.gz
tar -zxvf node-v8.9.4-linux-x64.tar.gz
sudo mv node-v8.9.4-linux-x64 /usr/local/node
sudo ln -s /usr/local/node/bin/node /usr/local/bin/node
sudo ln -s /usr/local/node/lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm

3. 测试是否安装成功，以及Node.js并设置镜像加速

node -v
npm -v
npm config set registry https://registry.npm.taobao.org

构建网络

---

• 创建fabric-samples目录

mkdir -p github.com/hyperledger/fabric-samples

• 进入fabric-samples下

git clone https://github.com/hyperledger/fabric-samples.git

• 查看版本分支

git tag

• 切换项目版本

git checkout  release1.0

• 查看当前项目的版本

git branch

• 如果你要删除已命名的分支，执行下方代码

git branch -d release1.0

• 打开下方网址（下载fabric-samples目录下bin目录中所需要的文件）

https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric

• 下载hyperledger-fabric-linux-amd64-1.0.5.tar.gz压缩包
  

wget https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric/hyperledger-fabric/linux-amd64-1.0.5/hyperledger-fabric-linux-amd64-1.0.5.tar.gz

• 解压到fabric-samples目录下

tar -zxvf hyperledger-fabric-linux-amd64-1.0.5.tar.gz -C /home/go/src/github.com/hyperledger/fabric-samples

• 下载dockerimages执行文件复制并在fabric-samples中创建init.sh
  
• 在浏览器打开下方网站，复制该文件的内容到init.sh中（目的是下载fabric所需要的docker镜像）

https://raw.githubusercontent.com/hyperledger/fabric/v1.0.5/scripts/bootstrap.sh 

• 复制好之后，init.sh保存

vim init.sh

• 赋予权限

chmod -R 777 init.sh

• 运行文件（1.0.5是指定fabric的docker镜像版本）

./init.sh 1.0.5

• 进入first-network目录中

cd first-network

• 关闭应用

./byfn.sh -m down

• 执行以下命令构建网络

./byfn.sh -m generate

1. 生成创世区块

• 指定按照yaml文件生成配置（crypto-config.yaml：用于配置组织节点的个数）

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

• 在first-network目录下设置变量：（设置工作目录）

export FABRIC_CFG_PATH=$PWD

• 生成系统链的创世区块：-profile指定联盟配置，outputBlock指定存放的位置

../bin/configtxgen -profile TwoOrgsOrdererGenesis -outputBlock ./channel-artifacts/genesis.block

2. 生成应用通道的配置信息

• 生成通道的创世交易：-profile指定业务联盟，-outputCreateChannelTx指存放的路径，创建的名字叫mychannel

export CHANNEL_NAME=mychannel
../bin/configtxgen -profile TwoOrgsChannel -outputCreateChannelTx ./channel-artifacts/channelID $CHANNEL_NAME

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

• 生成两个组织锚节点的交易信息

../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org1MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org1MSP

../bin/configtxgen -profile TwoOrgsChannel -outputAnchorPeersUpdate ./channel-artifacts/Org2MSPanchors.tx -channelID $CHANNEL_NAME -asOrg Org2MSP

操作网络

---

编辑docker-compose-cli.yaml，注释command命令

vim docker-compose-cli.yaml

运行docker-compose-cli.yaml

CHANNEL_NAME=$CHANNEL_NAME TIMEOUT=600 docker-compose -f docker-compose-cli.yaml up -d

1. 创建和加入通道

• 与客户端交互操作

docker exec -it cli bash

• 创建通道（-o指定与哪个orderer节点通信，-c指定创建的通道名称，-f指定使用的文件）

export CHANNEL_NAME=mychannel
peer channel create -o orderer.example.com:7050 -c $CHANNEL_NAME -f ./channel-artifacts/channel.tx --tls $CORE_PEER_TLS_ENABLED --cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem

• 查看orderer节点的运行日志

docker logs orderer.example.com

• 加入通道

peer channel join -b mychannel.block

• 查看peer加入的通道列表

peer channel list

2. 安装并实例化链码

---

• 安装链码（-n指定链码安装的名字，-v指定version，-l指定使用语言，-p指定安装链码的所在路径）

peer chaincode install -n mycc -v 1.0 -p github.com/hyperledger/fabric/examples/chaincode/go/chaincode_example02

• 实例化链码

peer chaincode instantiate \
-o orderer.example.com:7050 \
--tls $CORE_PEER_TLS_ENABLED \
--cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
-C $CHANNEL_NAME \
-n mycc \
-v 1.0 \
-c  '{"Args":["init","a","100","b","200"]}' \
-P "OR    ('Org1MSP.member','Org2MSP.member')"

• 查询

peer chaincode query -C $CHANNEL_NAME -n mycc -c '{"Args":["query","a"]}'

• 转账

peer chaincode invoke \
-o orderer.example.com:7050 \
--tls $CORE_PEER_TLS_ENABLED \
--cafile /opt/gopath/src/github.com/hyperledger/fabric/peer/crypto/ordererOrganizations/example.com/orderers/orderer.example.com/msp/tlscacerts/tlsca.example.com-cert.pem \
-C $CHANNEL_NAME \
-n mycc \
-c '{"Args":["invoke","a","b","10"]}'

点击exit退出docker容器

./byfn.sh -m down

###参数说明：

• -o：指定order服务节点地址
• –tls：是否开启TLS验证
• –cafile：指定TLS_CA证书的所在路径
• -C：指定通道名称
• -n：指定链码名称
• -c：指定调用链码的所需参数
• -p：指定安装链码的所在路径
• -P：指定背书策略
  #Node.js和fabcar交互

---

进入fabric-samples目录下的fabcar目录中

cd fabric-samples/fabcar

查看package.json文件

cat package.json

Fabcar启动

---

• 关闭活跃容器

docker rm -f  $(docker ps -a)

• 清理缓存的网络

docker network prune

• 删除fabcar智能合约的底层链码图像，如果是第一次运行这个项目可以不执行（可以通过 docker images来查询需要删除的镜像）

docker rmi dev-peer0.org1.example.com-fabcar-1.0-5c906e402ed29f20260ae42283216aa75549c571e2e380f3615826365d8269ba

• 在fabcar目录中安装客户端

npm install

• 启动网络

./startFabric.sh  node

• 执行完成后，注册管理用户

node enrollAdmin.js

• 实现registerUser.js，生成用户账户

node registerUser.js

• 现在我们可以运行JavaScript程序。首先，运行query.js 程序，返回账本上所有汽车列表。应用程序中预先加载了一个queryAllCars函数，用于查询所有车辆，因此我们可以简单地运行程序：

node query.js

• 如果想返回某个车辆信息，编辑query.js，我们将函数queryAllCars更改为queryCar并将特定的“Key” 传递给args参数。在这里，我们使用CAR4。 所以我们编辑后的query.js程序现在应该包含以下内容：

• 重新运行query.js

node query.js

FAQ

---

1. 运行./byfn.sh -m down出现错误的解决方法：

https://segmentfault.com/a/1190000014221967

2. 执行node registerUser.js出现错误：Failed to register: Error: fabric-ca request register failed with errors [[{"code":0,"message":"No identity type provided. Please provide identity type"}]]
   

• 大概的意思是需要我们提供一个可验证的type。 只需编辑 node registerUser.js文件

vim node registerUser.js

• 把returnfabric_ca_client.register({enrollmentID: 'user1', affiliation:'org1.department1'}, admin_user);替换为下方代码

returnfabric_ca_client.register({enrollmentID: 'user1', affiliation:'org1.department1',role: 'client'}, admin_user);

• 点击保存重新运行即可

3. 设置marbles . step 4 error error: Caught exception: TypeError: Cannot read property 'getConnectivityState' of undefined出错

npm uninstall grpc
rm -rf node_modules/
npm install

4. 
   

参考文档

---

https://github.com/IBM-Blockchain/marbles/blob/master/docs/use_local_hyperledger.md
https://hyperledger-fabric.readthedocs.io/en/release-1.0/chaincode4noah.html
https://hyperledger-fabric.readthedocs.io/en/release-1.0/write_first_app.html