Governance模块

如果是第一次安装WeEvent，参见这里的系统要求 。以下安装以CentOS 7.2为例。

因为区块链使用的加密算法很多OpenJDK版本没有提供。所以在各Java启动脚本里有设置JAVA_HOME变量让用户设置符合要求的JDK。

前置条件

  • Zookeeper服务

    必选配置。服务注册和发现会使用到。

    推荐使用Zookeeper 3.5.5及其以上版本。具体安装步骤，请参见Zookeeper安装。

  • Broker模块

    必选配置，通过Broker访问区块链。

    具体安装步骤，请参见Broker模块安装。

  • Mysql数据库

    可选配置。支持Mysql存储数据，如果不配置则使用内置的H2数据库。如果要使用Mysql数据库，需要做一个

    切换，切换步骤，请参考FAQ。

    推荐安装Mysql 5.7+版本。具体安装步骤，安装请参见Mysql安装 。

  • Processor模块 可选配置。通过Processor触发规则引擎。 具体安装步骤，请参见Processor模块安装。

获取安装包

从github下载安装包weevent-governance-1.6.0.tar.gz，并且解压到/usr/local/weevent/下。

$ cd /usr/local/weevent/
$ wget https://github.com/WeBankBlockchain/WeEvent/releases/download/v1.6.0/weevent-governance-1.6.0.tar.gz
$ tar -xvf weevent-governance-1.6.0.tar.gz

如果github下载速度慢，可以尝试国内下载链接。

解压后的目录结构如下

$ cd ./weevent-governance-1.6.0
$ tree -L 1
.
|-- apps
|-- check-service.sh
|-- conf
|-- governance.sh
|-- html
|-- init-governance.sh
|-- lib

修改配置文件

  • 配置Zookeeper服务

    可选配置。./conf/application-prod.properties中spring.cloud.zookeeper配置项。

    # spring cloud zookeeper
spring.cloud.zookeeper.enabled=true
spring.cloud.zookeeper.connect-string=127.0.0.1:2181

  • 配置端口

    在配置文件./conf/application-prod.properties中，Governance 的服务端口server.port ，默认7009。

    server.port=7009

  • 区块链FISCO-BCOS节点(复制Broker模块中，配置连接FISCO-BCOS节点的配置文件以及相关证书)

    • 区块链节点配置文件fisco.yml

      修改nodes=127.0.0.1:20200配置项，nodes为区块链节点channel访问入口。

    • 访问节点的证书文件

      2.x版本的证书文件ca.crt、sdk.crt、sdk.key放在./conf/conf目录下，国密的证书放在./conf/conf/gm目录下。详细参考FISCO-BCOS SDK配置说明。

    • governance支持配置多个节点

      配置文件governance.properties 示例如下，可以体验节点之间传文件等。

      nodeAddressList[0]=127.0.0.1:20200
nodeAddressList[1]=127.0.0.1:20201
nodeAddressList[2]=127.0.0.1:20202,127.0.0.1:20203

初始化数据库

执行脚本init-governance.sh 初始化数据库，成功输出如下。否则，用户需要检查数据库配置是否正常。

$ ./init-governance.sh
init governance db success

服务启停

通过./governance.sh start命令启动服务，正常启动如下：

$ ./governance.sh start
start weevent-governance success (PID=53926)
add the crontab job success

通过./governance.sh stop命令停止服务。

进程启动后，会自动添加crontab监控任务./governance.sh monitor。

服务访问

服务启动后通过 http://127.0.0.1:8080/weevent-governance/# 访问governance服务，默认用户名为：admin，默认密码为：123456

多视图管理

Governance支持同时管理多个WeEvent服务和区块链网络， 配置界面如下。

../../_images/Governance-multi-view.pngGovernance-multi-view.png

其他

推荐安装Processor。具体安装步骤，请参见Processor模块安装。