有些软件的安装过程比较简单,不会详细介绍,可以自行从网上查找那装。本篇内容主要集中在Hyperledger Fabric的安装配置上。

本篇主要介绍在Ubuntu系统上安装Hyperledger Fabric的过程。这里使用的Ubuntu:16.04 LTS。

1. Git安装

Git工具安装命令如下:

sudo apt update
sudo apt install git

可以使用如下命令检测是否安装成功。如果能返回git版本信息,则说明正确安装。

git version

2. 安装Docker和docker-compose

2.1 Docker安装

Docker工具安装命令如下:

sudo apt update
sudo apt install docker.io

同样可以使用如下命令验证是否正确安装,若能返回docker的版本信息,则说明正确安装。

docker --version

安装完成之后需要给当前用户赋docker权限。代码如下:

sudo groupadd docker #创建docker组
sudo gpasswd -a XXX docker #将目标用户XXX添加到docker组
sudo service docker restart #如有必要,重启docker服务
2.2 docker-compose安装

docker-compose的V1和V2版本的安装的方法不同,如果在后续Fabric执行sudo ./network up时遇到如下问题时则需要提升docker-compose的版本。
在这里插入图片描述
docker-compose V1版本安装
可以使用如下命令安装docker-compose V1版本, 具体如下:

sudo apt update
sudo apt install docker-compose
docker-compose --version

docker-compose V2版本安装

可以到docker-compose的github官网(https://github.com/docker/compose)下载需要的版本相应的资源:
在这里插入图片描述
然后执行如下安装命令:

//将该文件改名为docker-compose
mv docker-compose-linux-x86_64 docker-compose 
//添加执行权限
chmod +x docker-compose 
//移动到相应文件夹下
mv docker-compose /usr/bin/
//验证是否成功案安装
docker-compose version

3.安装Go语言环境

3.1 下载安装

Go语言的安装很简单,把安装包下载解压后把文件包放到/usr/local目录下就可以了。为了下载方便,可以找一个国内的镜像(但是国内的镜像可以没有最新版的go语言版本)。
Go官方地址:https://golang.google.cn/dl/

3.2 环境变量配置

下载解压完成之后,还需要完成环境变量的配置。Ubuntu系统上环境变量需要在/etc/profile文件设置。具体如下:
第1步:打开文件

sudo vim /etc/profile #打开文件

第2步:在文件末尾添加如下变量

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

第3步:执行文件

source /etc/profile

执行完成后,可以检验设置的环境变量是否生效了。可以使用echo命令输出变量,若能正常输出,则说明已经生效。

echo $GOPATH

若没有生效,则需要检查文件/etc/profile是否具有执行权限(x)。

ll /etc/profile

若没有x权限,则修改文件权限,然后再重新执行一遍文件。

sudo chmod -R 777 /etc/profile
3.3 其他配置

为了方便后续Fabric网络的搭建,还有几个配置需要设置。具体如下:

go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.cn
sudo chmod -R 777 $GOPATH

4 Hyperledger Fabric安装

现在正式进入Hyperledger Fabric环境的安装配置过程,具体包括以下步骤:

4.1下载Fabric源码
sudo mkdir $GOPATH/src/github.com/hyperledger/fabric
cd $GOPATH/src/github.com/hyperledger
//下载Fabric源码
git clone https://github.com/hyperledger/fabric.git

这里要说明一点,从github下载的Fabric包含所有版本。可以使用git checkout命令切换到需要的版本(不确定这一步是否需要):

//假如需要切换到Fabric 1.2
git checkout -b v1.2.0

Fabric源码下载完成之后,需要修改fabric/scripts(该目录是前文Fabric源码解压之后形成的目录,这里是一种简化写法。下同)文件夹下的bootstrap.sh文件,将BINARIES从true变为false。
在这里插入图片描述
上述文件修改完成之后,然后执行配置文件。具体指令如下:

cd fabric/scripts
sudo ./bootstrap.sh
4.2 下载其它相关文件

完成Fabric源码下载之后,还需要下载与指定Fabric版本配套的fabric-samplesfabric-ca文件。

4.2.1 下载fabric-samples文件

似乎以前的Fabric版本在运行上述bootstrap.sh文件后会自动完成fabric-samples文件的下载,但Fabric2.5版本却不行(或者自行检查是否自动下载了该文件)。这里可以直接使用git命令下载fabric-samples文件,具体如下:

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

然后将fabric-samples文件放到/fabric/scripts目录下。

4.2.2 下载fabric-ca等文件

接着还需要下载两个文件fabric-cahyperledger-fabric-linux(这不是完整的文件名),对这两个文件的介绍如下:

  • hyperledger-fabric-linux: 该文件是Hyperledger Fabric为Linux 64位系统提供的一份预编译的二进制包;
  • fabric-ca:该文件是Hyperledger Fabric区块链架构中用于Linux 64位系统的Fabric CA(Certificate Authority,证书颁发机构)的二进制包;
  • 这两个文件具体的下载版本都跟系统有关,需要根据系统的情况进行选择。因为笔者的系统Ubuntu,所以选择linux版本;

这两个文件下载过程如下:

  • 首先从bootstrap.sh文件中找到所需下载的二进制文件的版本。
    在这里插入图片描述
    关于这两个文件网上很多资料给出的下载地址都已失效。所以这里直接去github里面寻找相关文件。
  • 第一个文件可以从https://github.com/hyperledger/fabric/release在对应Hyperledger Fabric版本的Assets中找到。
    在这里插入图片描述
  • 第二个文件可以直接从https://github.com/hyperledger/fabric-ca/下载。
  • 将上述两个文件放到fabric-samples文件夹下并解压。
tar -zxvf hyperledger-fabric-linux-amd64-2.5.4.tar.gz
tar -zxvf hyperledger-fabric-ca-linux-amd64-1.5.7.tar.gz
4.3 修改环境变量

打开文件/etc/profile并修改环境变量。

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

并使用source命令执行上述文件。

参考资料

  1. https://blog.csdn.net/weixin_42221109/article/details/121831442
  2. https://blog.csdn.net/qq_35995514/article/details/125468792
Logo

开放原子开发者工作坊旨在鼓励更多人参与开源活动,与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动,如meetup、训练营等,主打技术交流,干货满满,真诚地邀请各位开发者共同参与!

更多推荐