Ubuntu下搭建Hyperledger Fabric v1.0环境

时间:2021-06-11 16:45:08
多次尝试才正常启动了Fabric,如遇到各种莫名错误,请参考如下一步步严格安装,特别用户权限需要注意。

一、安装Ubuntu16

虚拟机或双系统,虚拟机有VirtualBox或者VMware,Ubuntu 16.04镜像安装好。
打开系统设置,选择软件和更新 , 然后在下载自:中选择aliyun
 Ubuntu下搭建Hyperledger Fabric v1.0环境

二、安装基础工具

注意操作用户是自建用户,不是root,特别一些命令涉及用户目录的地方要特别注意

首先安装一些常用工具

  1. sudo apt-get update
  2. sudo apt-get install ssh
  3. sudo apt-get install git
  4. sudo apt-get install python-pip

go需要单独安装下

  1. wget https://storage.googleapis.com/golang/go1.9.linux-amd64.tar.gz
  2. sudo tar -C /usr/local -xzf go1.9.linux-amd64.tar.gz
  3. gedit /etc/profile

编辑全局变量环境,添加一下profile

  1. export PATH=$PATH:/usr/local/go/bin
  2. export GOROOT=/usr/local/go
  3. export GOPATH=/home/<span style="color:#ff0000;">用户名</span>/go
  4. export PATH=$PATH:/home/<span style="color:#ff0000;">用户名</span>/go/bin

生效profile,建立go目录

  1. source /etc/profile
  2. mkdir /home/<spanstyle="color:#ff0000;">用户名</span>/go

此时酌情重启下系统

三、安装docker  基于aliyun

  1. sudo apt-get update
  2. sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
  3. # step 2: 安装GPG证书
  4. curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
  5. # Step 3: 写入软件源信息
  6. sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
  7. # Step 4: 更新并安装 Docker-CE
  8. sudo apt-get -y update
  9. sudo apt-get -y install docker-ce
 安装docker后还需要添加用户到docker组
sudo usermod -aG docker XXX 
注销并重新登录,然后添加阿里云的Docker Hub镜像: 
建立docker文件 
  1. sudo mkdir -p /etc/docker
  2. sudo gedit /etc/docker/daemon.json
{
"registry-mirrors": ["https://obou6wyb.mirror.aliyuncs.com"]
}
  1. sudo systemctl daemon-reload
  2. sudo systemctl restart docker
最后 docker version 看下安装结果

四、安装 Docker-Compose  从DaoClound

  1. curl -L https://get.daocloud.io/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
  2. chmod +x /usr/local/bin/docker-compose
  3. docker-compose version

五.Fabric源码下载

首先建好存放源码的文件夹(也可手动建)路径如下: 
  1. mkdir –p ~/go/src/github.com/hyperledger
  2. cd ~/go/src/github.com/hyperledger
  3. git clone https://github.com/hyperledger/fabric.git
由于我们只是在搭建环境。不需要最新的代码,所以只需要切换到v1.0.0大版本就行。
  1. cd ~/go/src/github.com/hyperledger/fabric 进入fabric目录
  2. git checkout v1.0.0

六. Fabric Docker镜像的下载

  1. cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
  2. source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0
  3. docker images

Ubuntu下搭建Hyperledger Fabric v1.0环境
 

七、启动Fabric网络并完成ChainCode的测试

现在还停留在e2e_cli文件中(如果没有先进入),这里提供了启动、关闭Fabric网络的自动化脚本。我们要启动Fabric网络,并自动运行Example02 ChainCode的测试,执行一个命令: 
./network_setup.sh up
这个指令具体进行了如下操作: 
  1. 编译生成Fabric公私钥、证书的程序,程序在目录:fabric/release/linux-amd64/bin
  2. 基于configtx.yaml生成创世区块和通道相关信息,并保存在channel-artifacts文件夹。
  3. 基于crypto-config.yaml生成公私钥和证书信息,并保存在crypto-config文件夹中。
  4. 基于docker-compose-cli.yaml启动1Orderer+4Peer+1CLI的Fabric容器。
  5. 在CLI启动的时候,会运行scripts/script.sh文件,这个脚本文件包含了创建Channel,加入Channel,安装Example02,运行Example02等功能。

出现则表示网络运行成功,ctrl+c退出

Ubuntu下搭建Hyperledger Fabric v1.0环境

八、手动测试Fabric网络

这里有官方提供的小例子,在官方例子中,channel名字是mychannel,链码的名字是mycc。 
首先进入CLI,然后重新打开一个命令行窗口,输入: 
docker exec -it cli bash 
这时用户为root@748dafdc900b,在/opt/gopath/src/github.com/hyperledger/fabric/peer目录下,运行以下命令可以查询a账户的余额: 
peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}' 
Ubuntu下搭建Hyperledger Fabric v1.0环境

方框内可以看见余额为:90

下面我们可以进行转账操作,操作为invoke ,由a转b 50:

peer chaincode invoke -o orderer.example.com:7050 --tls true --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 mychannel -n mycc -c '{"Args":["invoke","a","b","50"]}'

现在转账完毕, 我们试一试再查询一下a账户的余额,重复之前的查询指令,结果为: 
Ubuntu下搭建Hyperledger Fabric v1.0环境
结果正确,a的余额只有40了。 
最后,我们需要关闭Fabric,这里先使用exit命令退出cli容器。 
exit 
然后类似于启动指令: 
cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli 
./network_setup.sh down

Ubuntu下搭建Hyperledger Fabric v1.0环境

最后,我们整个Fabric的环境已经测试完毕!!


Ubuntu无法解析域名的解决办法:
Could not resolve host: download.docker.com

修改文件/etc/resolvconf/resolv.conf.d/base

vim /etc/resolvconf/resolv.conf.d/base
# 在该文件加上一行:
nameserver 8.8.8.8
resolvconf -u   #执行

安装过程中如果出现网络连接错误,可以将软件源改成阿里云镜像

# 编辑/etc/apt/sources.list文件, 在文件最前面添加以下条目(适用于Ubuntu18.04)

deb http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-security main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-updates main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-proposed main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ bionic-backports main restricted universe multiverse
#(适用于Ubuntu16.04)

deb-src http://archive.ubuntu.com/ubuntu xenial main restricted #Added by software-properties
deb http://mirrors.aliyun.com/ubuntu/ xenial main restricted
deb-src http://mirrors.aliyun.com/ubuntu/ xenial main restricted multiverse universe #Added by software-properties
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-updates main restricted multiverse universe #Added by software-properties
deb http://mirrors.aliyun.com/ubuntu/ xenial universe
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates universe
deb http://mirrors.aliyun.com/ubuntu/ xenial multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-updates multiverse
deb http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-backports main restricted universe multiverse #Added by software-properties
deb http://archive.canonical.com/ubuntu xenial partner
deb-src http://archive.canonical.com/ubuntu xenial partner
deb http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted
deb-src http://mirrors.aliyun.com/ubuntu/ xenial-security main restricted multiverse universe #Added by software-properties
deb http://mirrors.aliyun.com/ubuntu/ xenial-security universe
deb http://mirrors.aliyun.com/ubuntu/ xenial-security multiverse 

运行sudo apt install curl 安装curl,此时如果出现如下错误:

E: Could not get lock /var/lib/dpkg/lock - open (11: Resource temporarily unavailable)
E: Unable to lock the administration directory (/var/lib/dpkg/), is another process using it?

  解决方案:

ps -A |grep apt # 查看进程号
sudo kill -9 [processnumber] #结束进程
sudo apt install curl

 如果出现路径权限问题,需要将路径所有者改成自建用户,例如:

sudo chown -R dsd:dsd ./bin/  # 将目录所有者改为自建用户 

如果提示已经有容器在运行,发生冲突,则应停止正在运行的docker进程:

docker ps -qa | xargs docker stop
docker ps -qa | xargs docker rm
# 或者:
./ network_setup.sh down

  Make 编译出错如下

make configtxgen configtxlator cryptogen
Makefile:93: *** "No go in PATH: Check dependencies". Stop.

  解决方案:重新source环境变量,如:

source /etc/profile
# 或者:
source ~/.bashrc

  


教程参考以下:

http://blog.csdn.net/so5418418/article/details/78355868

https://yq.aliyun.com/articles/110806

http://get.daocloud.io/

Ubuntu下搭建Hyperledger Fabric v1.0环境 2018快速国内源

2018年03月09日 21:16:36
阅读数:476
多次尝试才正常启动了Fabric,如遇到各种莫名错误,请参考如下一步步严格安装,特别用户权限需要注意。

一、安装Ubuntu16

虚拟机或双系统,虚拟机有VirtualBox或者VMware,Ubuntu 16.04镜像安装好。
打开系统设置,选择软件和更新 , 然后在下载自:中选择aliyun
 Ubuntu下搭建Hyperledger Fabric v1.0环境

二、安装基础工具

注意操作用户是自建用户,不是root,特别一些命令涉及用户目录的地方要特别注意

首先安装一些常用工具

  1. sudo apt-get update
  2. sudo apt-get install ssh
  3. sudo apt-get install git
  4. sudo apt-get install python-pip

go需要单独安装下

  1. wget https://storage.googleapis.com/golang/go1.9.linux-amd64.tar.gz
  2. sudo tar -C /usr/local -xzf go1.9.linux-amd64.tar.gz
  3. gedit /etc/profile

编辑全局变量环境,添加一下profile

  1. export PATH=$PATH:/usr/local/go/bin
  2. export GOROOT=/usr/local/go
  3. export GOPATH=/home/<span style="color:#ff0000;">用户名</span>/go
  4. export PATH=$PATH:/home/<span style="color:#ff0000;">用户名</span>/go/bin

生效profile,建立go目录

  1. source /etc/profile
  2. mkdir /home/<spanstyle="color:#ff0000;">用户名</span>/go

此时酌情重启下系统

三、安装docker  基于aliyun

  1. sudo apt-get update
  2. sudo apt-get -y install apt-transport-https ca-certificates curl software-properties-common
  3. # step 2: 安装GPG证书
  4. curl -fsSL http://mirrors.aliyun.com/docker-ce/linux/ubuntu/gpg | sudo apt-key add -
  5. # Step 3: 写入软件源信息
  6. sudo add-apt-repository "deb [arch=amd64] http://mirrors.aliyun.com/docker-ce/linux/ubuntu $(lsb_release -cs) stable"
  7. # Step 4: 更新并安装 Docker-CE
  8. sudo apt-get -y update
  9. sudo apt-get -y install docker-ce
 安装docker后还需要添加用户到docker组
sudo usermod -aG docker XXX 
注销并重新登录,然后添加阿里云的Docker Hub镜像: 
建立docker文件 
  1. sudo mkdir -p /etc/docker
  2. sudo gedit /etc/docker/daemon.json
{
"registry-mirrors": ["https://obou6wyb.mirror.aliyuncs.com"]
}
  1. sudo systemctl daemon-reload
  2. sudo systemctl restart docker
最后 docker version 看下安装结果

四、安装 Docker-Compose  从DaoClound

  1. curl -L https://get.daocloud.io/docker/compose/releases/download/1.19.0/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose
  2. chmod +x /usr/local/bin/docker-compose
  3. docker-compose version

五.Fabric源码下载

首先建好存放源码的文件夹(也可手动建)路径如下: 
  1. mkdir –p ~/go/src/github.com/hyperledger
  2. cd ~/go/src/github.com/hyperledger
  3. git clone https://github.com/hyperledger/fabric.git
由于我们只是在搭建环境。不需要最新的代码,所以只需要切换到v1.0.0大版本就行。
  1. cd ~/go/src/github.com/hyperledger/fabric 进入fabric目录
  2. git checkout v1.0.0

六. Fabric Docker镜像的下载

  1. cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli/
  2. source download-dockerimages.sh -c x86_64-1.0.0 -f x86_64-1.0.0
  3. docker images

Ubuntu下搭建Hyperledger Fabric v1.0环境
 

七、启动Fabric网络并完成ChainCode的测试

现在还停留在e2e_cli文件中(如果没有先进入),这里提供了启动、关闭Fabric网络的自动化脚本。我们要启动Fabric网络,并自动运行Example02 ChainCode的测试,执行一个命令: 
./network_setup.sh up
这个指令具体进行了如下操作: 
  1. 编译生成Fabric公私钥、证书的程序,程序在目录:fabric/release/linux-amd64/bin
  2. 基于configtx.yaml生成创世区块和通道相关信息,并保存在channel-artifacts文件夹。
  3. 基于crypto-config.yaml生成公私钥和证书信息,并保存在crypto-config文件夹中。
  4. 基于docker-compose-cli.yaml启动1Orderer+4Peer+1CLI的Fabric容器。
  5. 在CLI启动的时候,会运行scripts/script.sh文件,这个脚本文件包含了创建Channel,加入Channel,安装Example02,运行Example02等功能。

出现则表示网络运行成功,ctrl+c退出

Ubuntu下搭建Hyperledger Fabric v1.0环境

八、手动测试Fabric网络

这里有官方提供的小例子,在官方例子中,channel名字是mychannel,链码的名字是mycc。 
首先进入CLI,然后重新打开一个命令行窗口,输入: 
docker exec -it cli bash 
这时用户为root@748dafdc900b,在/opt/gopath/src/github.com/hyperledger/fabric/peer目录下,运行以下命令可以查询a账户的余额: 
peer chaincode query -C mychannel -n mycc -c '{"Args":["query","a"]}' 
Ubuntu下搭建Hyperledger Fabric v1.0环境

方框内可以看见余额为:90

下面我们可以进行转账操作,操作为invoke ,由a转b 50:

peer chaincode invoke -o orderer.example.com:7050 --tls true --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 mychannel -n mycc -c '{"Args":["invoke","a","b","50"]}'

现在转账完毕, 我们试一试再查询一下a账户的余额,重复之前的查询指令,结果为: 
Ubuntu下搭建Hyperledger Fabric v1.0环境
结果正确,a的余额只有40了。 
最后,我们需要关闭Fabric,这里先使用exit命令退出cli容器。 
exit 
然后类似于启动指令: 
cd ~/go/src/github.com/hyperledger/fabric/examples/e2e_cli 
./network_setup.sh down

Ubuntu下搭建Hyperledger Fabric v1.0环境

最后,我们整个Fabric的环境已经测试完毕!!

教程参考以下:

http://blog.csdn.net/so5418418/article/details/78355868

https://yq.aliyun.com/articles/110806

http://get.daocloud.io/