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.

配置/初始化数据库

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; word-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">cd blockchain-explorer/app</pre>

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

[ 复制代码

](javascript:void(0); "复制代码")

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; word-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">{ "persistence": "postgreSQL", "platforms": ["fabric"], "postgreSQL": { "host": "127.0.0.1", "port": "5432", "database": "fabricexplorer", //数据库名称 "username": "admin123", //用户名 "passwd": "admin123" //密码 }, "sync": { "type": "local", "platform": "fabric", "blocksSyncTime": "3" }
}</pre>

[ 复制代码

](javascript:void(0); "复制代码")

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

执行初始化：

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; word-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">cd blockchain-explorer/app/persistence/fabric/postgreSQL/db
./createdb.sh</pre>

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

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

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

设置fabric网络

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

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; word-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">cd blockchain-explorer/app/platform/fabric
vi config.json</pre>

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

构建Hyperledger Explore

[ 复制代码

](javascript:void(0); "复制代码")

<pre style="margin: 0px; padding: 0px; white-space: pre-wrap; word-wrap: break-word; font-family: "Courier New" !important; font-size: 12px !important;">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</pre>

[ 复制代码

](javascript:void(0); "复制代码")

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

启动 Hyperledger Explorer

• cd blockchain-explorer/
• ./start.sh

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

访问对应端口：

image