Governance模块¶

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

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

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

前置条件¶

Broker模块

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

具体安装步骤，请参见Broker模块安装。
Mysql数据库

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

推荐安装Mysql 5.6+版本。具体安装步骤，安装请参见Mysql安装。
Processor模块可选配置。通过Processor触发规则引擎。具体安装步骤，请参见Processor模块安装。

获取安装包¶

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

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

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

解压后的目录结构如下

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

修改配置文件¶

配置端口

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

配置Mysql数据库

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

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

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

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

配置Processor访问路径在配置文件./conf/application-prod.properties中，修改weevent.processor.url配置，默认为 http://127.0.0.1:7008

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

重置密码的邮件设置

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

spring.mail.default-encoding= UTF-8
spring.mail.host= smtp.163.com
spring.mail.username= mailusername@163.com
spring.mail.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支持同时管理多个WeEvent服务和区块链网络，配置界面如下。

其他¶

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