Governance模块

本节介绍Governance子模块的详细安装步骤。 WeEvent服务的快速安装请参见快速安装 。在一台机器上详细安装，和通过快速安装然后把目标路径中的governance子目录打包拷贝到这台机器，效果是一样的。

Governance为用户提供一个事件治理的Web管理端。支持事件治理、区块链节点分析、系统监控预警等。

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

前置条件

  • Broker模块

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

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

  • Mysql数据库

    必选配置。Governance通过Mysql存储数据。

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

获取安装包

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

$ cd /usr/local/weevent/
$ wget https://github.com/WeBankFinTech/WeEvent/releases/download/v1.0.0/weevent-governance-1.0.0.tar.gz
$ tar -xvf weevent-governance-1.0.0.tar.gz

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

解压后的目录结构如下

$ cd ./weevent-governance-1.0.0
$ tree -L 2
|-- apps
|   `-- weevent-governance-1.0.0.jar
|-- check-service.sh
|-- conf
|   |-- application-prod.yml
|   |-- application.yml
|   |-- banner.txt
|   |-- log4j2.xml
|   |-- mappers
|   `-- server.p12
|-- governance.sh
|-- html
|   |-- index.html
|   |-- README
|   `-- static
|-- init-governance.sh

修改配置文件

  • 配置端口

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

    server:
  port: 7009

  • 配置Mysql数据库

    在配置文件./conf/application-prod.yml中，修改datasource中的url配置、username、password 。

    spring:  
  datasource:
    url: jdbc:mysql://127.0.0.1:3306/governance?useUnicode=true&characterEncoding=utf-8&useSSL=false
    driver-class-name: org.mariadb.jdbc.Driver
    username: test
    password: 123456
    type: org.apache.commons.dbcp2.BasicDataSource

    注意：数据库要赋予配置账号创建库表的权限。

    >> grant all privileges on *.* to 'test'@'%' identified by '123456';
>> flush privileges;

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

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

  • 重置密码的邮件设置

    可选配置。在配置文件./conf/application-prod.yml中，修改mail中的host、username、password 配置。

    mail:
    default-encoding: UTF-8
    # smtp服务器地址 ex: smtp.163.com,smtp.qq.com,smtp.sohu.com
    host: smtp.163.com
    username: mailusername@163.com
    password: mailpwd

服务启停

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

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

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

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

  • 验证服务

    通过./check-service.sh 命令检查服务功能是否正常。

    $ ./check-service.sh
check governance service
governance service is ok

加入Nginx反向代理

将部署好的Governance配置到Nginx对外提供服务。Nginx子模块的安装及详细配置参见Nginx模块安装及配置 。

如果需要部署更多实例，将上述步骤安装好的Governance目录拷贝到目标位置，启动即可。

用户可以通过浏览器访问http://localhost:8080/weevent-governance/。显示如下登陆页面说明安装成功。

Governance-ui.png

多视图管理

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

Governance-multi-view.png

推荐安装WeBase 1.0.4。具体安装步骤，请参见WeBase安装。

以下两点需要特别注意：

  • 由于WeBase和WeEvent端口冲突，需修改WeBase一键部署源码包中的common.properties文件，配置已有的区块链和服务端口。具体如下:

    mgr.port=8182
front.port=8181
node.p2pPort=30300
node.channelPort=20200
node.rpcPort=8545
if.exist.fisco=yes

  • 需要修改webase-node-mgr服务中的conf/application.yml文件。将isUseSecurity和isDeleteInfo都改成false。