IBM区块链系列Hyperledger ,除了最核心的fabric网络外还出了一系列的工具和工程,这里就记录下区块链浏览器的安装部署,现在的版本是使用PostgreSQL数据库来存储数据(之前版本使用mysql)。
浏览器使用Psql和nodejs开发,所以对java或golang小伙伴来说,肯定会碰一些钉子。(官方的安装不是很详细)
先上地址:
https://github.com/hyperledger/blockchain-explorer.git
如果发现bug可以贡献修复
1、依赖环境安装
a) nodejs 8.11.x (Note that v9.x is not yet supported)
b) PostgreSQL 9.5 or greater
c) Jq [https://stedolan.github.io/jq/]
d) git
e) gcc-c++
1)安装git
yum install -y git
查看版本:
[root@fabric-test2 server]# git --version
git version 1.8.3.1
2)nodejs安装
a.下载
wget https://nodejs.org/dist/v8.11.4/node-v8.11.4-linux-x64.tar.xz
b.解压
tar -xvf node-v8.11.4-linux-x64.tar.xz
c.链接
ln -s /server/node-v8.11.4-linux-x64/bin/node /usr/local/bin/node
ln -s /server/node-v8.11.4-linux-x64/bin/npm /usr/local/bin/npm
d.测试
[root@fabric-test2 node-v8.11.4-linux-x64]# node -v
v8.11.4
[root@fabric-test2 node-v8.11.4-linux-x64]# npm -v
5.6.0
3)PostgreSQL安装
1.添加RPM
yum install https://download.postgresql.org/pub/repos/yum/9.5/redhat/rhel-7-x86_64/pgdg-centos95-9.5-2.noarch.rpm
2.安装PostgreSQL 9.5
yum install postgresql95-server postgresql95-contrib
3.初始化数据库
/usr/pgsql-9.5/bin/postgresql95-setup initdb
4.设置开机自启动
systemctl enable postgresql-9.5.service
5.启动服务
systemctl start postgresql-9.5.service
PostgreSQL 安装完成后,会建立一下‘postgres’用户,用于执行PostgreSQL,数据库中也会建立一个'postgres'用户,默认密码为自动生成,需要在系统中改一下。
6.修改用户密码
su - postgres 切换用户,执行后提示符会变为 '-bash-4.2$'
psql -U postgres 登录数据库,执行后提示符变为 'postgres=#'
ALTER USER postgres WITH PASSWORD 'postgres'; 设置postgres用户密码(!!!这个密码要注意下不能包含@符号)
\q 退出数据库
7.开启远程访问
vi /var/lib/pgsql/9.5/data/postgresql.conf
修改#listen_addresses = 'localhost' 为 listen_addresses='*'
当然,此处‘*’也可以改为任何你想开放的服务器IP
8.信任远程连接
vi /var/lib/pgsql/9.5/data/pg_hba.conf
修改如下内容,信任指定服务器连接
# IPv4 local connections:
host all all 127.0.0.1/32 md5
增加
host all all 0.0.0.0/0 md5
9. 重启PostgreSQL数据服务
systemctl restart postgresql-9.5.service
4)安装jq
jq的安装需要epel源
wget http://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm -ivh epel-release-latest-7.noarch.rpm
yum repolist
安装:
yum install jq -y
5)安装gcc-c++
yum install -y gcc-c++
编译使用
依赖环境准备就绪,接下来是安装了;
2、初始化配置
1)源码下载
git clone https://github.com/hyperledger/blockchain-explorer.git
cd blockchain-explorer
2)数据库初始化
创建一个用户:
cd blockchain-explorer/app/persistence/postgreSQL
修改执行模式
chmod -R 775 db/
修改pgconfig.json 文件
cd db
vi pgconfig.json 如下:
{
"pg": {
"host": "127.0.0.1",
"port": "5432",
"database": "fabricexplorer",
"username": "postgres",
"passwd": "postgres"
}
}
其实这里配置后还是需要输入密码,不过这个配置后续有用;
执行脚本:
[root@fabric-test2 db]# ./createdb.sh
输入数据库密码就好;
3)Fabric 网络搭建
这个之前有教程,不再介绍;
4)Fabric 网络配置
先讲之前的配置备份
cp blockchain-explorer/app/platform/fabric/config.json blockchain-explorer/app/platform/fabric/config.json.bk
配置(以之前fabric分布式部署例子为基础)
vi blockchain-explorer/app/platform/fabric/config.json
配置如下:
{
"network-config": {
"org1": {
"name": "OrgCoreCompanyMSP",
"mspid": "OrgCoreCompanyMSP",
"peer1": {
"requests": "grpcs://10.0.200.114:7051",
"events": "grpcs://10.0.200.114:7053",
"server-hostname": "peer0.corecompany.lychee.com",
"tls_cacerts":
"/opt/gopath/src/github.com/hyperledger/fabric/lychees/bscf/crypto-config/peerOrganizations/corecompany.lychee.com/peers/peer0.corecompany.lychee.com/tls/ca.crt"
},
"admin": {
"key":
"/opt/gopath/src/github.com/hyperledger/fabric/lychees/bscf/crypto-config/peerOrganizations/corecompany.lychee.com/users/[email protected]/msp/keystore",
"cert":
"/opt/gopath/src/github.com/hyperledger/fabric/lychees/bscf/crypto-config/peerOrganizations/corecompany.lychee.com/users/[email protected]/msp/signcerts"
}
}
},
"channel": "bscfchannel",
"orderers": [
{
"mspid": "OrdererMSP",
"server-hostname": "orderer1.lychee.com",
"requests": "grpcs://10.0.200.111:7050",
"tls_cacerts":
"/opt/gopath/src/github.com/hyperledger/fabric/lychees/bscf/crypto-config/ordererOrganizations/lychee.com/orderers/orderer1.lychee.com/tls/ca.crt"
}
],
"keyValueStore": "/tmp/fabric-client-kvs",
"configtxgenToolPath": "/opt/gopath/src/github.com/hyperledger/fabric/release/linux-amd64/bin/",
"SYNC_START_DATE_FORMAT": "YYYY/MM/DD",
"syncStartDate": "2018/01/01",
"eventWaitTime": "30000",
"license": "Apache-2.0",
"version": "1.1"
}
这里要注意下:
1、org1 可以随意命名,跟fabric网络无关;
2、可先添加一个节点做测试,等成功后再配置全部;
3、org中的name、mspid等必需根网络配置的一致(fabric网络的configtx.yaml文件);
4、注意ip地址和grpcs/grpc;
5、注意证书文件路径;
6、keyValueStore 这个是client的存放位置,可暂时随意配置个位置。
3、打包部署
这个熟悉前段开发的会比较顺利,但是做java后端和golang的小伙伴可能需要折腾下;(其实就是一个工程打包,下载依赖,部署的过程)
cd blockchain-explorer
npm install
cd client/
npm install
npm run build
如果遇到 root没权限,则需要使用非安全模式,顺便输出下详细日志如下:
cd blockchain-explorer
npm install --unsafe-perm -d
cd client/
npm install --unsafe-perm -d
npm run build --unsafe-perm -d
!!!注意,如果中间出错,重新安装时先要删除node_modules文件夹,client里的也需要;
4、运行
cd blockchain-explorer
./start.sh
日志文件:
logs/app app日志
logs/console 运行日志
logs/db db日志
这几个文件里面的日志要结合看才能更好的解决问题;
console成功日志:
Property config.syncStartDate set to 2018/01/01
Please open web browser to access :http://127.0.0.1:8080/
pid is 9641
Successfully received the block event[object Object]
5、问题总结
1. make: g++: Command not found
yum install -y gcc-c++
2. getBlockActivity undefined 找不到
这个是npm install问题,删除node_modules,重新安装(也可能是fabric网络未配置好,重新检查下app/platform/fabric/config.json 网络配置)
3.TypeError: Cannot read property 'forEach' of undefined
这个是fabric网络未配置好,重新检查下app/platform/fabric/config.json 网络配置
4.server.on undefined 找不到
server.on('connection', connection => {
^
TypeError: Cannot read property 'on' of undefined
at Object. (/server/blockchain-explorer/main.js:74:8)
at Module._compile (module.js:652:30)
at Object.Module._extensions..js (module.js:663:10)
at Module.load (module.js:565:32)
at tryModuleLoad (module.js:505:12)
at Function.Module._load (module.js:497:3)
at Function.Module.runMain (module.js:693:10)
at startup (bootstrap_node.js:191:16)
at bootstrap_node.js:612:3
这个是区块链网络配置问题,因为启动不了网络所以报错,重新检查下app/platform/fabric/config.json 网络配置,修改稿后重新打包
cd client
npm run build
或者
删除node_modules,重新安装
5. TypeError: Cannot read property 'queryChannels' of undefined
这个是fabric网络未配置好,重新检查下app/platform/fabric/config.json 网络配置
6. /bin/sh: locate: command not found
安装包
yum -y install mlocate
更新库
updatedb
7.server.on 等问题,先检查网络配置,再检查数据库配置;如果实在不行,就删除blockchain-explorer/node_modules下和blockchain-explorer/client/node_modules/所有文件,然后重新编译安装!
6、效果如下: