fabric-explorer1.1版本区块链浏览器环境搭建

image.png

一、简介

Hyperledger Explorer是一个简单，功能强大，易于使用，高度可维护的开源浏览器，用于查看底层区块链网络上的活动。

二、本机环境

系统：Ubuntu 16.04
系统架构：x86_64
docker : 18.03.0-ce
docker-compose：1.21.0 
nodejs : v8.11.1    (支持v8.11.x版本，不支持v9.x版本) 
npm : 5.6.0
PostgreSQL：9.5 （支持9.5以上版本）

三、项目代码地址

https://github.com/hyperledger/blockchain-explorer

四、安装

1. 安装PostgreSQL方法
   https://www.jianshu.com/p/40e35ff27e41
2. 可以使用nvm来管理nodejs的版本

五、操作步骤

0x01 操作postgresql数据库

1. 下载项目代码，并进入项目目录

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

2. 连接数据库

sudo -u postgres psql

image.png

3. 执行脚本，创建数据库表

\i app/persistance/postgreSQL/db/explorerpg.sql

image.png

\i app/persistance/postgreSQL/db/updatepg.sql

image.png

4. 退出数据库
   输入\q回车
   image.png

帮助信息：
postgresql的基本命令

• 退出 \q
• 查看database \l
• 查看table \d

0x02 修改配置文件

1. 将/blockchain-explorer/app/platform/fabric/config.json中所有的fabric-path/fabric-samples/first-network/crypto-config路径，替换成自己fabric网络中的crypto-config的路径。(绝对路径、相对路径都可以)

• 例子：

 {
        "network-config": {
                "org1": {
                        "name": "peerOrg1",
                        "mspid": "Org1MSP",
                        "peer1": {
                                "requests": "grpcs://127.0.0.1:7051",
                                "events": "grpcs://127.0.0.1:7053",
                                "server-hostname": "peer0.org1.example.com",
                                "tls_cacerts": "/home/jack/sharex/deploy/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt"
                        },
                        "peer2": {
                                "requests": "grpcs://127.0.0.1:8051",
                                "events": "grpcs://127.0.0.1:8053",
                                "server-hostname": "peer1.org1.example.com",
                                "tls_cacerts": "/home/jack/sharex/deploy/crypto-config/peerOrganizations/org1.example.com/peers/peer1.org1.example.com/tls/ca.crt"
                        },
                        "admin": {
                                "key": "/home/jack/sharex/deploy/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore",
                                "cert": "/home/jack/sharex/deploy/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/signcerts"
                        }
}

上面的代码只是部分片段，/home/jack/sharex/deploy/目录就是我存放fabric网络中crypto-config文件夹的目录。

这里需要注意，你的网络是否开启了tls
如果你的fabric网络没有启用tls，请将grpcs修改为grpc。port(端口号)9051修改为9050。然后删除tls_cacerts。

2. 进入blockchain-explorer/app/persistance/postgreSQL/db文件夹下，修改
   pgconfig.json文件，改成你喜欢的端口，注意不要有端口冲突。

{
        "pg": {
                "host": "0.0.0.0",
                "port": "5432",
                "database": "fabricexplorer",
                "username": "hppoc",
                "passwd": "password"
        }
}

注意：如果是本地运行fabric浏览器，host设置为127.0.0.1。如果在服务器上，建议设置为0.0.0.0。

0x03 安装依赖

cd blockchain-explorer
npm install

cd blockchain-explorer/app/test
npm install 
npm run test

执行nom run test之后，会打印出一些信息。

cd /blockchain-explorer/client
npm install
npm test -- -u --coverage
npm run build

注意：在执行npm test -- -u --coverage的时候，会打印出许多信息。注意查看是否PASS

六、启动网络

配置网络的端口号(根据需要)

可以在blockchain-explorer目录下的appconfig.json文件中修改端口号以及host。
默认是"host": "localhost","port": "8080",

{
        "host": "0.0.0.0",
        "port": "8080",
        "license": "Apache-2.0"
}

我是在服务器上搭建的fabric浏览器，所以用的是0.0.0.0。如果是在本地搭建，默认的配置即可。

启动网络

进入文件夹

cd blockchain-explorer/

执行启动命令

./start.sh

这里不会在屏幕中打印出log。 因为被重定向到文件了。

打开你的浏览器，输入你的ip和端口号即可。
例如：localhost:8080

然后就会查看到如下界面(可能有点慢)

image.png

停止命令

./stop.sh

http://localhost:8080/api-docs 可以查看swagger文档。