《Hyperledger Fabric菜鸟进阶攻略》 —1.2.2　安装所需工具

1.2.2　安装所需工具

1.安装git

git是一个非常优秀的开源版本管理控制工具，使用git工具可以方便地下载官方（Golang、

Hyperledger Fabric等）在GitHub网站上发布的相关源代码或其他内容。

安装git工具使用如下命令：

$ sudo apt update

$ sudo apt install git

Mac OS系统中默认已安装该工具。如果未安装该工具，则可以在git-scm官方网站（https://git-scm.com/downloads）下载相应系统的安装包并安装。

2.安装cURL

使用如下命令安装cURL：

$ sudo apt install curl

其他系统的cURL安装包可以在https://curl.haxx.se/download.html页面中下载并安装。

3.安装Docker

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

$ docker --version

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

$ sudo apt update

$ sudo apt install docker.io

查看Docker版本信息：

$ docker --version

输出类似如下的Docker版本信息：

Docker version 17.03.2-ce, build f5ec1e2

4.安装docker-compose

确定系统中是否已安装docker-compose工具：

$ docker-compose --version

如果系统提示未安装，则使用如下命令安装docker-compose工具：

$ sudo apt install docker-compose

安装成功后，查看docker-compose版本信息：

$ docker-compose --version

输出类似如下的docker-compose版本信息：

docker-compose version 1.8.0, build unknown

5.安装Golang

Fabric 1.0.0版本要求Golang 1.7以上版本，Fabric 1.1.0版本要求Golang 1.9以上版本，Fabric 1.2.0版本要求Golang 1.10以上版本，我们使用Fabric 1.2.0版本，所以从官方下载最新版本的Golang。

（1）下载Golang

使用wget工具下载Golang的最新版本压缩包文件go1.10.3.linux-amd64.tar.gz：

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

下载Golang压缩包文件，需要操作系统能够保证正常访问Golang官方网站。下载过程可能耗时较长（取决于具体网络情况），请耐心等待。

其他系统可以在Golang官方网站https://golang.org/dl/下载页面中下载相应的安装包并安装。

下载完成后，文件会保存在当前目录下。可以使用ll命令查看：

（2）解压文件

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

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

注意，在解压过程中可能出现如下错误：

gzip: stdin: unexpected end of file

tar: Unexpected EOF in archive

tar: Unexpected EOF in archive

tar: Error is not recoverable: exiting now

或如下错误信息：

gzip: stdin: unexpected end of file

tar: 归档文件中异常的 EOF

tar: 归档文件中异常的 EOF

tar: Error is not recoverable: exiting now

如果出现上述错误提示信息，则说明下载的压缩包文件有问题，如果没有下载完整或压缩包数据损坏，可将其删除后重新下载并解压至指定的目录中。

（3）配置环境变量

将压缩包文件解压至指定目录后，Golang可以让系统的所有用户正常使用，这里使用vim文件编辑工具打开系统的profile文件进行编辑：

$ sudo vim /etc/profile

如果只想让当前登录用户使用Golang，而其他用户不能使用Golang，则编辑当前用户$HOME目录下的.bashrc或.profile文件，在该文件中添加相应的环境变量即可。

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

export GOPATH=$HOME/go

export GOROOT=/usr/local/go

export PATH=$GOROOT/bin:$PATH

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

$ source /etc/profile

通过go version命令验证是否成功：

$ go version

输出如下的Golang版本信息：

go version go1.10.3 linux/amd64

如果系统中有旧版本的Golang，则使用如下命令卸载旧版本的Golang，然后重新安装并配置：

$ su -

# apt-get remove golang-go --purge && apt-get autoremove --purge && apt-get clean

6.安装NVM与npm

（1）安装NVM

NVM（Node Version Manager）是Node.js的版本管理软件，可以根据不同的需求场景随时在Node.js的各个版本之间进行切换。

由于Node.js版本更新较快，且各版本之间差异较大，直接从Node官网安装可能需要很长时间，而且中间可能会因为网络访问及数据传输原因造成下载中断或失败等问题。为了方便安装及后期管理Node.js的版本，需要先在系统中安装NVM管理工具。使用如下命令安装NVM：

$ sudo apt update

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

$ export NVM_DIR="$HOME/.nvm"

$ [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

（2）安装Node

NVM工具安装并配置成功后，可以直接使用nvm命令安装Node，且Node安装成功后，NVM会自动对npm工具进行安装。使用如下命令安装Node：

$ nvm install v8.11.1

安装Node时需要注意，安装版本为8.9.x或以上的Node.js，Fabric目前不支持9.x系列的Node.js版本。安装成功输出如下内容：

（3）检查Node及npm版本

$ node -v && npm -v

输出内容如下：

v8.11.1

5.6.0

FAQ

1.Hyperledger Fabric只支持Ubuntu系统吗？

Hyperledger Fabric支持常见的Linux相关系统（如Debian、Cent OS等）和Mac OS。

由于不同操作系统或各系统的不同版本可能会造成一些问题，所以在此推荐使用的操作系统为64位的Ubuntu 16.04 LTS。

2.cURL是什么？有什么作用？

cURL是一个可以在终端命令行下使用URL语法执行的开源文件传输工具。它可以支持基于HTTP/Socket的代理；cURL还支持使用SSL证书，支持HTTP POST、HTTP PUT，支持FTP上传，以及基于HTTP表单的上传；支持Cookie，可以使用用户名+密码的方式实现认证（Basic、Plain、Digest、CRAM-MD5、NTLM、Negotiate和Kerberos）等。

3.为什么要安装Docker及docker-compose

Docker是一个开源的应用容器引擎，可以为应用创建一个轻量级的、可移植的容器。Hyperledger Fabric环境依赖于Docker提供的容器服务，所以必须安装Docker环境；推荐使用1.13或更高版本。

Compose是一个用于定义和运行多个容器的Docker应用程序的工具，可以使用YAML文件配置相关的指定服务，运行该服务时只需要一个简单的命令即可。

4.能否不使用Golang而换作其他语言环境？

Hyperledger Fabric的很多组件使用Golang实现，并且我们会使用Golang来编写链式代码的应用程序，所以需要在系统中安装并设置Golang环境。

5.一定要安装Node与npm吗？

Node与npm工具为可选安装工具。如果后期使用Node.js的Hyperledger Fabric SDK开发Hyperledger Fabric应用程序，则需要安装；否则无须安装。