HyperLedger Explore 浏览器配置启动教程

Hyperledger Fabric维护的实际上是一个区块链网络。为了能够直观的观察网络上的节点，交易等行为，Hyperledger Explore随之诞生。

本文讲述如何搭建 Hyperledger Explore。

Hyperledger Explorer

源代码链接： https://github.com/hyperledger/blockchain-explorer

目录结构

├── app            	 Application backend root, Explorer configuration

	├── rest         REST API

	├── persistence  Persistence layer

		├── fabric   Persistence API (Hyperledger Fabric)

	├── platform     Platforms

		├── fabric   Explorer API (Hyperledger Fabric)

	├── test         Application backend test

├── client         	 Web UI

	├── public       Assets

	├── src          Front end source code

		├── components		React framework

		├── services	  	Request library for API calls

		├── state		Redux framework

		├── static       	Custom and Assets

浏览器的目的是为了维护网络，所以默认要启动一个fabric网络。默认读者已经部署了一个BYFN网络，如果没有，参考https://hyperledger-fabric.readthedocs.io/en/latest/build_network.html。

准备

首先需要安装：

nodejs 8.11.x (Note that v9.x is not yet supported)
PostgreSQL 9.5 or greater
Jq [https://stedolan.github.io/jq/]

注意对应安装的版本。一般构建完BYFN下面这两个应该都安装了：

docker 17.06.2-ce [https://www.docker.com/community-edition]
docker-compose 1.14.0 [https://docs.docker.com/compose/]

下载源码

git上下载源码

git clone https://github.com/hyperledger/blockchain-explorer.git.
cd blockchain-explorer.

配置/初始化数据库

cd blockchain-explorer/app

这个文件夹下有一个 explorerconfig.json 里面可以配置数据库。

{

  "persistence": "postgreSQL",

  "platforms": ["fabric"],

  "postgreSQL": {

    "host": "127.0.0.1",

    "port": "",

    "database": "fabricexplorer", //数据库名称

    "username": "admin123",      //用户名

    "passwd": "admin123"         //密码

  },

  "sync": {

    "type": "local",

    "platform": "fabric",

    "blocksSyncTime": ""

  }

}

后续的初始化脚本会读取这个文件，根据配置的信息登录数据库，执行初始化的创建语句。

执行初始化：

cd blockchain-explorer/app/persistence/fabric/postgreSQL/db

./createdb.sh

这个过程如果报错，需要用户自己登录postgresql 创建对应的数据库 fabricexplorer，用户名 admin123，密码 admin123.

如果出现 Ident authentication failed for user XX错误，修改一下pg_hdconfig的配置就可以了。

执行createdb.sh会执行同一个文件夹的 explorerpg.sql updatepg.sql

设置fabric网络

需要配置浏览器能找到当前fabric网络。

cd blockchain-explorer/app/platform/fabric
vi config.json

搜索config.json中的所有fabric-path。我的fabric-sample安装目录是 /mnt/fabric-samples/ 。所以把fabric-path改成 /mnt/fabric-samples/ 。这样浏览器就能够凭借配置，找到tlsCACerts adminPrivateKey signedCert 来执行网络的查询。

构建Hyperledger Explore

cd blockchain-explorer

npm install

cd blockchain-explorer/app/test

npm install

npm run test

cd client/

npm install

npm test -- -u --coverage

npm run build

在运行test的时候要注意观察是不是所有的mocha的用例都通过了。

启动 Hyperledger Explorer

cd blockchain-explorer/
./start.sh

启动浏览器。这个目录下的脚本 ./stop.sh 用来关闭。默认的端口是8080

访问对应端口：