【第一篇】Hyperledger Explorer 部署步骤与踩

作者: Amberlucky | 来源:发表于2019-06-12 11:34 被阅读0次

部署流程

本次选用的Hyperledger-explorer版本为最新的release版本v0.3.9.1
github地址： https://github.com/hyperledger/blockchain-explorer

这里没有写如何部署Fabric网络以及连接Fabric提供的例子: first-nework, 后面可以考虑分享，直接使用的例子网上也蛮多的，提供几个参考链接：
https://medium.com/@thanawitsupinnapong/setting-up-hyperledger-explorer-on-fabric-5f1f7cda73b3
https://medium.com/coinmonks/hyperledger-explorer-quick-start-50a49c6d7957

这篇文章主要介绍安装环境，部署运行，及我的一些踩坑记录，有一些我也还没有解决，如果你解决过，感恩你跟我分享❤。如果你有遇到其他的问题，也欢迎评论。

一、安装环境

安装要求说明：

Requirements
The following are prerequisites for installing the required development tools.

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

Hyperledger Explorer works with Hyperledger Fabric 1.2. Install the following software dependencies to manage fabric network.

docker-ce [https://www.docker.com/community-edition]
docker-compose [https://docs.docker.com/compose/]
GO [https://golang.org/dl/]

我的环境：

# cat /etc/redhat-release
CentOS Linux release 7.3.1611 (Core)

# node -v
v8.11.2

# npm -v
5.6.0

# git --version
git version 2.9.5

# jq --version
jq-1.5

# psql --version
psql (PostgreSQL) 9.2.24

那就按照要求安装吧！

1. 安装Git

步骤1. 安装依赖包
Git 的工作需要调用 curl，zlib，openssl，expat，libiconv 等库的代码，所以需要先安装这些依赖工具。在有 yum 的系统上（比如 Fedora），可以用下面的命令安装：

yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel
yum install  gcc perl-ExtUtils-MakeMaker

步骤2. 下载&解压: 之后，从下面的 Git 官方站点下载最新版本源代码

cd /usr/src
wget https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.9.5.tar.gz
tar -zxvf git-2.9.5.tar.gz

注意. 如果之前有安装过旧版本git，先删除

 yum remove git

步骤3. 安装并添加环境变量

# cd git-2.9.5
# make prefix=/usr/local/git all
# make prefix=/usr/local/git install
# vim /etc/profile
//添加一行
# export PATH=$PATH:/usr/local/git/bin
# source /etc/profile

步骤4. 查看git版本

# git --version
git version 2.9.5

2. 安装nodejs

//1.下载
wget https://nodejs.org/download/release/v8.11.2/node-v8.11.2-linux-x64.tar.gz
//2.解压
tar --strip-components 1 -xzvf node-v* -C /usr/local
//3.查看版本
# node –v
v8.11.2

3. 安装PostgreSQL

安装依赖

yum install postgresql-server postgresql-contrib

初始化DB

postgresql-setup initdb

启动DB

systemctl start postgresql

暂停服务(可选)

systemctl enable postgresql

修改配置/var/lib/pgsql/data/pg_hba.conf 信任指定服务器连接

将：
host    all             all             127.0.0.1/32            ident
修改为：
host    all             all             127.0.0.1/32            trust

 # IPv4 local connections:
    host    all            all      127.0.0.1/32      trust
后面增加
    host    all             all      0.0.0.0/0          trust

开启远程访问

 vi /var/lib/pgsql/data/postgresql.conf
    修改#listen_addresses = 'localhost'  为  listen_addresses='*'
    当然，此处‘*’也可以改为任何你想开放的服务器IP

重启PostgreSQL数据服务

systemctl restart postgresql

4. 安装JQ

jq linux json格式化工具
1、添加epel源

>wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
>rpm -ivh epel-release-latest-7.noarch.rpm
>yum repolist

2、安装

yum install jq

查看版本

>jq --version
jq-1.5

二、开始部署

准备代码和工具：
我们需要的工具

➜  bin git:(bb39b6e) ✗ pwd
/fabric-samples/bin   # 部署Fabric网络的时候生成的，在配置config.json的时候会用到：  "configtxgenToolPath": "/data/fabric/bin", 把他都copy到需要使用的路径下面，比如我这里是"/data/fabric/bin"
➜  bin git:(bb39b6e) ✗ tree
.
├── configtxgen
├── configtxlator
├── cryptogen
├── discover
├── fabric-ca-client
├── get-docker-images.sh
├── idemixgen
├── orderer
└── peer

把证书密钥等相关内容copy到本地，我这里是放到/data/fabric/crypto-config/ 配置config.json的时候需要使用。

[ansible@rocketmq-test-2 crypto-config]$ tree -L 3
.
├── ordererOrganizations
│   └── example.com
│       ├── ca
│       ├── msp
│       ├── orderers
│       ├── tlsca
│       └── users
└── peerOrganizations
    ├── org1.example.com
    │   ├── ca
    │   ├── msp
    │   ├── peers
    │   ├── tlsca
    │   └── users
    └── org2.example.com
        ├── ca
        ├── msp
        ├── peers
        ├── tlsca
        └── users

2.1. 设置数据库

vim blockchain-explorer/app/explorerconfig.json

你可以更新explorerconfig.json来更新postgresql的配置，我这边先不改

{
  "persistence": "postgreSQL",
  "platforms": ["fabric"],
  "postgreSQL": {
    "host": "127.0.0.1",
    "port": "5432",
    "database": "fabricexplorer",
    "username": "hppoc",
    "passwd": "password"
  },
  "sync": {
    "type": "local",
    "platform": "fabric",
    "blocksSyncTime": "3"
  }
}

有些情况下，你需要给db/文件赋予权限当前目录blockchain-explorer/

 chmod -R 775 app/persistence/fabric/postgreSQL/db

执行数据库脚本

//切换到postgres，在安装postgresql的过程中就会默认创建postgres用户
sudo su - postgres
cd /data/fabric/blockchain-explorer-0.3.9.1/app/persistence/fabric/postgreSQL/db
./createdb.sh

查看创建数据

//退出postgres用户
exit
//连接psql  \l 查看数据  \d 查看表格  \q退出
[ansible@rocketmq-test-2 blockchain-explorer-0.3.9.1]$ sudo -u postgres psql
psql (9.2.24)
Type "help" for help.

postgres=# \l
                                    List of databases
      Name      |  Owner   | Encoding |   Collate   |    Ctype    |   Access privileges   
----------------+----------+----------+-------------+-------------+-----------------------
 fabricexplorer | hppoc    | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 postgres       | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0      | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
                |          |          |             |             | postgres=CTc/postgres
 template1      | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/postgres          +
                |          |          |             |             | postgres=CTc/postgres

(4 rows)

尝试连接成功

 psql postgres://hppoc:password@127.0.0.1:5432/fabricexplorer

2.2. 修改配置文件config.json

当前目录blockchain-explorer/

vim app/platform/fabric/config.json

修改内容

所有grpcs 改为 grpc
tlsEnable 从true 改为false //第1.2步都是因为连接的Fabric网络禁用了Tls，如果使用first-network默认是不禁用的，就不用改。
path修改，修改成本地的证书密钥路径，我这里是/data/fabric/crypto-config/

{
  "network-configs": {
    "network-1": {
      "version": "1.0",
      "clients": {
        "client-1": {
          "tlsEnable": false,
          "organization": "Org1MSP",
          "channel": "mychannel",
          "credentialStore": {
            "path": "./tmp/credentialStore_Org1/credential",
            "cryptoStore": {
              "path": "./tmp/credentialStore_Org1/crypto"
            }
          }
        }
      },
      "channels": {
        "mychannel": {
          "peers": {
            "peer0.org1.example.com": {}
          },
          "connection": {
            "timeout": {
              "peer": {
                "endorser": "6000",
                "eventHub": "6000",
                "eventReg": "6000"
              }
            }
          }
        }
      },
      "organizations": {
        "Org1MSP": {
          "mspid": "Org1MSP",
          "fullpath": false,
          "adminPrivateKey": {
            "path": "/data/fabric/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/keystore"
          },
          "signedCert": {
            "path": "/data/fabric/crypto-config/peerOrganizations/org1.example.com/users/Admin@org1.example.com/msp/signcerts"
          }
        },
        "OrdererMSP": {
          "mspid": "OrdererMSP",
          "adminPrivateKey": {
            "path": "/data/fabric/crypto-config/ordererOrganizations/example.com/users/Admin@example.com/msp/keystore"
          }
        }
      },
      "peers": {
        "peer0.org1.example.com": {
          "tlsCACerts": {
            "path": "/data/fabric/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt"
          },
          "url": "grpc://192.168.22.246:7051",
          "eventUrl": "grpc://192.168.22.246:7053",
          "grpcOptions": {
            "ssl-target-name-override": "peer0.org1.example.com"
          }
        },
       
        "peer0.org2.example.com": {
          "url": "grpc://192.168.22.249:7051"
        }
      },
      "orderers": {
        "orderer.example.com": {
          "url": "grpc://localhost:7050"
        }
      }
    },
    "network-2": {}
  },
  "configtxgenToolPath": "/data/fabric/bin",
  "license": "Apache-2.0"
}

2.3. 编译启动

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

2.4. 访问服务

默认访问链接是：http://localhost:8080
如果8080被占用，想要修改端口号，可以修改/blockchain-explorer/appconfig.json

{
  "host": "localhost",
  "port": "8080",  # 修改端口号
  "license": "Apache-2.0"
}

image.png

也可以通过右上角开关切换颜色：

image.png

三、那些我踩到的坑

3.1. gcc未安装

make: Entering directory `/data/fabric/blockchain-explorer-0.3.9.1/node_modules/pkcs11js/build'
  CXX(target) Release/obj.target/pkcs11/src/main.o

make: g++: Command not found

image.png

解决方案：

yum install -y gcc-c++

3.2. mlocate 未安装

报错：

[ansible@rocketmq-test-2 blockchain-explorer-0.3.9.1]$ tail -222f logs/console/console-2019-06-11.log
postgres://hppoc:password@127.0.0.1:5432/fabricexplorer
/bin/sh: locate: command not found
/bin/sh: locate: command not found
/bin/sh: locate: command not found

image.png

解决：

> yum install mlocate
> updatedb

注意：若用sudo install 那么updatedb 也需要用1sudo updatedb

测试:

> locate mysql
/usr/share/mysql/charsets/macce.xml
/usr/share/mysql/charsets/macroman.xml
/usr/share/mysql/charsets/swe7.xml
/usr/share/mysql/czech/errmsg.sys
/usr/share/mysql/danish/errmsg.sys
/usr/share/mysql/dutch/errmsg.sys
...

3.3. grpc未安装

提示需要npm rebuild

解决方案：

npm rebuild

3.4. Fabric禁用tls,但是配置用了grpcs ,需要改为grpc

报错：

(node:3648) DeprecationWarning: grpc.load: Use the @grpc/proto-loader module with grpc.loadPackageDefinition instead
E0606 06:13:02.106104472    3648 ssl_transport_security.cc:1227] Handshake failed with fatal error SSL_ERROR_SSL: error:1408F10B:SSL routines:SSL3_GET_RECORD:wrong version number.
E0606 06:13:03.106865936    3648 ssl_transport_security.cc:1227] Handshake failed with fatal error SSL_ERROR_SSL: error:1408F10B:SSL routines:SSL3_GET_RECORD:wrong version number.
E0606 06:13:04.647205386    3648 ssl_transport_security.cc:1227] Handshake failed with fatal error SSL_ERROR_SSL: error:1408F10B:SSL routines:SSL3_GET_RECORD:wrong version number.
2019-06-06T10:13:05.104Z - error: [Remote.js]: Error: Failed to connect before the deadline URL:grpcs://192.168.110.246:7051
2019-06-06T10:13:05.105Z - error: [Channel.js]: Error: Failed to connect before the deadline URL:grpcs://192.168.110.246:7051
<<<<<<<<<<<<<<<<<<<<<<<<<< Explorer Error >>>>>>>>>>>>>>>>>>>>>
Error: Failed to discover ::Error: Failed to connect before the deadline URL:grpcs://192.168.110.246:7051
    at Channel._initialize (/data/fabric/blockchain-explorer-0.3.9.1/node_modules/fabric-client/lib/Channel.js:347:11)
    at <anonymous>
    at process._tickCallback (internal/process/next_tick.js:188:7)
Received kill signal, shutting down gracefully

3.5. 配置了两个节点，但是只显示了一个节点 - 未解決

3.6. Error: 2 UNKNOWN: Stream removed - 未解決

报错信息如下，这个网上说有可能是grpc版本的问题，但是我替换了几个grpc版本还是不行，而这在我另一台服务器上是没有问题的，所以我猜测很可能还是环境问题，具体的是哪个有问题，网上找了下也没有答案。

➜  blockchain-explorer-0.3.9.1 tail -222f logs/console/console-2019-06-11.log
postgres://hppoc:password@127.0.0.1:5432/fabricexplorer
(node:20923) DeprecationWarning: grpc.load: Use the @grpc/proto-loader module with grpc.loadPackageDefinition instead
<<<<<<<<<<<<<<<<<<<<<<<<<< Explorer Error >>>>>>>>>>>>>>>>>>>>>
{ Error: 2 UNKNOWN: Stream removed
    at Object.exports.createStatusError (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/common.js:87:15)
    at ClientDuplexStream._emitStatusIfDone (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client.js:235:26)
    at ClientDuplexStream._receiveStatus (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client.js:213:8)
    at Object.onReceiveStatus (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client_interceptors.js:1290:15)
    at InterceptingListener._callNext (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client_interceptors.js:564:42)
    at InterceptingListener.onReceiveStatus (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client_interceptors.js:614:8)
    at /home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client_interceptors.js:1110:18
  code: 2,
  metadata: Metadata { _internal_repr: {} },
  details: 'Stream removed' }
Received kill signal, shutting down gracefully

Closed out connections

3.7. TypeError: Channel's second argument must be a ChannelCredentials - 未解決

grpc版本是1.14.2时，报的错误是：UNKNOWN: Stream removed 把grpc版本降到1.7.1之后报的错误是这个。而在我另一台服务器上，grpc版本是1.14.2的时候，是可以正常使用的，所以也不太清楚具体是什么原因。

<<<<<<<<<<<<<<<<<<<<<<<<<< Explorer Error >>>>>>>>>>>>>>>>>>>>>
TypeError: Channel's second argument must be a ChannelCredentials
    at ServiceClient.Client (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client.js:472:19)
    at new ServiceClient (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/node_modules/grpc/src/client.js:884:12)
    at new AdminPeer (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/app/platform/fabric/AdminPeer.js:65:30)
    at FabricClient.newAdminPeer (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/app/platform/fabric/FabricClient.js:546:25)
    at FabricClient.initializeChannelFromDiscover (/home/linfang/workspace/fabric/blockchain-explorer-0.3.9.1/app/platform/fabric/FabricClient.js:499:38)
    at <anonymous>
Received kill signal, shutting down gracefully

Closed out connections

3.8. orderer节点url配置的是远程服务的地址，但是日志里面还是显示访问 grpc://localhost:7050 - 未解决

因为本地没有order服务，所以这个问题没解决，目前是通过部署在Orderer服务上暂时启动了这个服务, 部署在orderer服务器上后，把url改为grpc://localhost:7050 是可以访问的
我的Order url的配置是：

 ...
  "peers": {
        "peer0.org1.example.com": {
          "tlsCACerts": {
            "path": "/data/fabric/crypto-config/peerOrganizations/org1.example.com/peers/peer0.org1.example.com/tls/ca.crt"
          },
          "url": "grpc://192.168.110.246:7051",
          "eventUrl": "grpc://192.168.110.246:7053",
          "grpcOptions": {
            "ssl-target-name-override": "peer0.org1.example.com"
          }
        },
       
        "peer0.org2.example.com": {
          "url": "grpc://192.168.110.249:7051"
        }
      },
      "orderers": {
        "orderer.example.com": {
          "url": "grpc://192.168.110.245:7050"
        }
      }
    },
    ...

【第一篇】Hyperledger Explorer 部署步骤与踩

部署流程

一、安装环境

我的环境：

1. 安装Git

2. 安装nodejs

3. 安装PostgreSQL

4. 安装JQ

二、开始部署

三、那些我踩到的坑

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

【第一篇】Hyperledger Explorer 部署步骤与踩

部署流程

一、安装环境

我的环境：

1. 安装Git

2. 安装nodejs

3. 安装PostgreSQL

4. 安装JQ

二、开始部署

三、 那些我踩到的坑

相关文章

网友评论

延伸阅读

深度阅读

栏目导航

热点阅读

三、那些我踩到的坑