快速安装¶

快速安装是为了方便用户搭建开发和测试环境，在单台机器上快速部署WeEvent服务。提供Docker镜像、Bash脚本两种安装方式。

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

Docker镜像安装¶

$ docker pull weevent/weevent:1.6.0; docker run -d -p 8080:8080 -p 7001:7001 weevent/weevent:1.6.0 /root/run.sh

WeEvent的镜像里包括了FISCO-BCOS网络，WeEvent服务的各个子模块以及各种依赖。

Bash安装¶

需要的一些基础工具yum install wget tree tar netstat。

获取安装包

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

$ cd /tmp/
$ wget https://github.com/WeBankFinTech/WeEvent/releases/download/v1.6.0/weevent-1.6.0.tar.gz
$ tar -zxf weevent-1.6.0.tar.gz

如果github下载速度慢，可以尝试国内下载链接。解压后目录结构如下：

$ cd weevent-1.6.0/
$ tree -L 2
.
├── bin
│   ├── start-all.sh
│   └── stop-all.sh
├── config.properties
├── fisco.yml
├── install-all.sh
├── modules
│   ├── broker
│   ├── gateway
│   ├── governance
│   ├── lib
│   ├── processor
│   └── zookeeper

修改配置config.properties

默认配置文件./config.properties如下：
```
#java jdk environment
JAVA_HOME=/usr/local/jdk1.8.0_191

# Required module
# support 2.x
fisco-bcos.version=2.0
# The path of FISCO-BCOS 2.x that contain certificate file ca.crt/sdk.crt/sdk.key
fisco-bcos.node_path=~/fisco/nodes/127.0.0.1/sdk

# Required module
gateway.port=8080
zookeeper.default=true
zookeeper.connect-string=127.0.0.1:2181

# Required module
broker.port=7000

# Optional module
governance.enable=false
governance.port=7009
#support both h2 and mysql, default h2
database.type=h2
#mysql.ip=127.0.0.1
#mysql.port=3306
#mysql.user=xxx
#mysql.password=yyy

# Optional module
processor.enable=false
processor.port=7008
```
配置说明 :
- JDK变量JAVA_HOME
  
  因为区块链使用的加密算法很多OpenJDK版本没有提供。所以这里特别让用户设置符合要求的JDK。
- 区块链FISCO-BCOS
  - fisco-bcos.version
    
    支持2.0及其以上版本。
  - fisco-bcos.node_path
    
    区块链节点的访问证书、私钥存放目录，FISCO-BCOS 2.x一般目录为~/fisco/nodes/127.0.0.1/sdk。
    
    如果WeEvent服务和区块链节点不在同一台机器上，需要把上述目录下文件拷贝到WeEvent所在机器的当前目录如 ./conf目录下，并设置fisco-bcos.node_path=./conf 。注意：fisco-bcos.node_path目录结构需与节点证书目录~/fisco/nodes/127.0.0.1/sdk结构一致，同时不要包含其他文件，安装时会将fisco-bcos.node_path目录下所有内容拷贝到每个模块子目录下。
    
    以下为标准版和国密版依赖的证书文件及目录结构：
    $ tree fisco/nodes/127.0.0.1/sdk/ fisco/nodes/127.0.0.1/sdk/ ├── ca.crt ├── sdk.crt └── sdk.key $ tree fisco_gm/nodes/127.0.0.1/sdk/ fisco_gm/nodes/127.0.0.1/sdk/ └── gm ├── gmca.crt ├── gmensdk.crt ├── gmensdk.key ├── gmsdk.crt └── gmsdk.key
- Gateway
  - 监听端口gateway.port
  - zookeeper配置
    
    zookeeper.default=true，值为true表示使用zookeeper.connect-string里配置的端口，在本机安装zookeeper服务使用。
    
    zookeeper.default=false，值为false表示使用zookeeper.connect-string的配置去连接用户已有的zookeeper服务。
- Broker监听端口broker.port
- Governance模块配置
  - governance.enable是否安装Governance模块，默认为false不安装
  - 监听端口governance.port
  - 默认使用内置的H2数据库，也支持Mysql配置mysql.*
- Processor模块配置
  - proceessor.enable是否安装Proceessor模块，默认为false不安装
  - 监听端口processor.port
修改配置fisco.yml

配置说明：该配置字段fisco bcos sdk config部分与FiscoBcos SDK配置一致，详细配置说明参考 FiscoBcos SDK配置说明，安装时关注字段为节点配置。
```
network:
  peers:
    - "127.0.0.1:20200"
    - "127.0.0.1:20201"
```

注解

多数情况下以上配置只需修改`config.properties`中证书路径`fisco-bcos.node_path`和`fisco.yml`中`network.peers`连接的节点地址即可运行。其他字段可按照自己实际需求进行修改配置。

一键安装

以安装到目录/usr/local/weevent/为例。

$ ./install-all.sh -p /usr/local/weevent/

正常安装后，输出有如下关键字:

7000 port is okay
8080 port is okay
2181 port is okay
param ok
install module zookeeper
install module gateway 
install gateway success 
install module broker 
install broker success 

目标安装路径/usr/local/weevent/的结构如下:

$ cd /usr/local/weevent/
$ tree -L 1
.
|-- broker
|-- lib
|-- gateway
|-- start-all.sh
|-- stop-all.sh
|-- zookeeper

启停服务
- 启动服务
  
  在服务安装目录下/usr/local/weevent，通过start-all.sh命令启动所有服务，正常启动如下：
```
$ ./start-all.sh
ZooKeeper JMX enabled by default
Using config: /usr/local/weevent/zookeeper/apache-zookeeper-3.6.1-bin/bin/../conf/zoo.cfg
Starting zookeeper ... STARTED
start weevent-broker success (PID=3642)
add the crontab job success
start weevent-gateway success (PID=3643)
add the crontab job success
```
  如果安装了governance服务，默认访问链接为：http://127.0.0.1:8080/weevent-governance/# ，默认用户名为：admin，默认密码为：123456
- 停止所有服务的命令./stop-all.sh。
卸载服务

所有服务停止后，直接删除目录即可。

快速安装作为一种简易安装方式，默认使用内置的H2数据库。并且所有子服务都是单实例的，生产环境中建议多实例部署。各子模块详细部署参见Broker模块部署和Governance模块部署。