Ubuntu 18.04.5 安装 Hyperledger Fabric1.4

安装环境

vmware Ubuntu 18.04.5

readme

• 都以root用户执行

  $ sudo -i
  
  我的密码：iamk
  

• 需要换源，docker和ubuntu软件源，可以下载快一点
• 需要配置git的ssh密钥，clone快一点，防止失败
• 需要虚拟机内使用代理翻墙，不然会一直超时，或运行卡顿
• 每次失败时要先down再up，以删除生成的文件，不然判断文件夹存在会跳过执行生成证书的步骤
• 这里使用的是1.4.3版本的fabric和镜像，1.4.0的fabric-samples和二进制文件。相邻版本可以切换使用，相差不是特别大，有可能是源码本身问题，作为一个解决办法的思路

1 准备依赖环境

1.0 ubuntu软件更换国内源

参考

1.1 安装git

$ apt install git

1.2 安装 cURL

$ apt install curl

1.3 安装 Docker

查看系统是否已经安装 Docker：

$ docker --version

如果未安装，使用如下命令安装最新版本的 Docker：

$ apt install docker.io

• docker换源

编辑daemon.json,没有则新键

$ vim /etc/docker/daemon.json

添加源(阿里，网易，gayhub，百度)

{
  "registry-mirrors": [
    "https://ustc-edu-cn.mirror.aliyuncs.com",
    "https://hub-mirror.c.163.com",
    "https://ghcr.io",
    "https://mirror.baidubce.com"
  ]
}

重启docker

$ service docker restart

参考

1.4 安装 docker-compose

查看系统是否已经安装

$ docker-compose --version

如果未安装

$ apt install docker-compose

1.5 安装 Golang

• 下载 Golang
  用 wget 工具安装 Golang：

$ wget https://dl.google.com/go/go1.11.11.linux-amd64.tar.gz

Golang 的版本要求查看 Fabric 依赖的软件版本，不是越新版本越好，新版本会出现不兼容的情况，Fabric1.4 要求 Golang 版本为 go1.11.x。

• 解压文件
  下载完 Golang 压缩包之后，使用 tar 命令将压缩包解压到指定的 /usr/local/ 路径下

$ tar -zxvf go1.11.11.linux-amd64.tar.gz -C /usr/local/

• 配置环境变量

$ vi /etc/profile

• 在 profile 文件最后添加如下内容：

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

• 使用 source 命令，使刚刚添加的配置信息生效：

$ source /etc/profile

• 使用 go version 命令验证是否安装成功：

$ go version

• 设置代理

$ export GO111MODULE=on
$ export GOPROXY=https://goproxy.cn

参考

2 搭建fabric环境

• 多数教程中都会执行bootstrap.sh文件，该文件的作用是下载fabric-samples并切换版本、下载镜像、和下载二进制文件，我这里除了下载镜像都是手动下载的方式完成
• 需要配置github的ssh密钥，不然拉取可能会很慢或者失败
• 我这里一开始用的都是1.4.0的版本，后来有问题，就将fabric的版本切了1.4.3，镜像用的1.4.3，fabric-samples还是用的1.4.0，二进制文件用的也是1.4.0的，版本相近问题不大

2.1 拉取 fabric 源码

$ cd $GOPATH
$ mkdir -p src/github.com/hyperledger
$ cd src/github.com/hyperledger
$ git clone git@github.com:hyperledger/fabric.git

查看并切换版本

$ cd ./fabric
$ git branch -a  
$ git checkout v1.4.3 

2.2 拉取 fabric-samples源码

$ cd src/github.com/hyperledger
$ git clone git@github.com:hyperledger/fabric-samples.git
$ cd ./fabric-samples
$ git branch -a
$ git checkout v1.4.0

2.3 下载二进制文件

下载链接是这个，但我进不去

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

网盘地址
链接：https://pan.baidu.com/s/1wghtuQcHSbPk2X4513ZKAw
提取码：6666

下载后有两个文件

• hyperledger-fabric-ca-linux-amd64-1.4.0.tar.gz
• hyperledger-fabric-linux-amd64-1.4.0.tar.gz

第一个文件里有一个bin文件夹，第二个文件里有bin和config文件夹，将两个 bin 文件夹内的二进制文件汇总在一个 bin 文件夹内，最后将 bin 和 config 文件夹复制到 fabric-samples 文件夹下。

$ cd <文件bin和config所在目录>
$ cp -r bin $GOPATH/src/github.com/hyperledger/fabric-samples
$ cp -r config $GOPATH/src/github.com/hyperledger/fabric-samples

2.4 下载镜像

-b 表示不下载二进文件
-s 表示不下载fabric-samples

$ cd $GOPATH/src/github.com/hyperledger
$ ./fabric/scripts/bootstrap.sh -s -b 1.4.3 1.4.3 0.4.15

至此，Fabric 网络启动所需依赖全部下载完成。

2.5 设置环境变量

$ vi /etc/profile

在 profile 文件最后添加：

export PATH=$PATH:$GOROOT/bin:$GOPATH/bin:$HOME/go/src/github.com/hyperledger/fabric-samples/bin

使用 source 命令使文件生效：

$ source /etc/profile

检验环境变量是否成功

$ fabric-ca-client version
fabric-ca-client:
 Version: 1.4.0
 Go version: go1.11.1
 OS/Arch: linux/amd64

3 测试网络

3.1 启动网络

注意: 每次启动失败都要先down再up

$ cd $GOPATH/src/github.com/hyperledger/fabric/scripts/fabric-samples/first-network
$ ./byfn.sh up

如果看到该错误

Error: error getting endorser client for channel: endorser client failed to connect to peer0.org1.example.com:7051: failed to create new connection: connection error: desc = "transport: error while dialing: dial tcp: lookup peer0.org1.example.com: no such host"
peer0.org1 failed to join the channel, Retry after 3 seconds

解决方法
参考

$ cd $GOPATH/src/github.com/hyperledger/fabric-samples/first-network/base
$ vim docker-compose-base.yaml

在每个environment下面都追加下面的参数，然后重新down再up就搞定。

- GODEBUG=netdns=go

3.2 关闭网络

$ ./byfn.sh down

4 运行End-2-End案例

4.1 下载e2e_cli源码

下载地址：链接中目录下的第七章

• 拷贝到如下目录（没有就自行创建）

$ cd $GOPATH/src/github.com/hyperledger/fabric/examples/e2e_cli

• 修改为可执行权限

$ chmod -R 777 $GOPATH/src/github.com/hyperledger/fabric/examples/e2e_cli

如果是从window上拷贝到linux的，还要修改e2e_cli目录下及e2e_cli/scripts目录下.sh文件编码格式，参考

4.2 下载二进制文件

将本文2.3节的那些文件拷贝到如下目录

$ mkdir -p $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64

$ cd <文件bin和config所在目录>
$ cp -r bin $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64
$ cp -r config $GOPATH/src/github.com/hyperledger/fabric/release/linux-amd64

4.3 运行e2e_cli

每次失败后先down,再up

$ cd $GOPATH/src/github.com/hyperledger/fabric/examples/e2e_cli
$ ./network_setup.sh down
$ ./network_setup.sh up

看到如下则成功，和npy搞了好几天，终于看到all good了，泪目（给我哭）

写在最后，其实没有啥解决办法，能改的基本都改了，要改不了的都改不了，1.4.0版本估计有问题，7050端口的peer镜像一直启动不起来，查了很久也没办法，然后看了很多教程，灵感一现，换掉镜像，所以切换了相邻版本1.4.3的fabric和镜像,最后成功的。

5 参考

• Ubuntu 16.04 安装 Hyperledger Fabric1.4（主要参考）
• 准备hyperledger fabric1.4网络运行的环境
• 手动执行生成二进制文件（未实践）
• HyperLedger Fabric 1.4 官方End-2-End运行（8）
• fabric github传送门