'「乾貨」快速安裝體驗WeEvent'

WeEvent是一套分佈式事件驅動架構，實現了可信、可靠、高效的跨機構、跨平臺事件通知機制。

快速安裝

快速安裝是為了方便用戶搭建開發和測試環境，在單臺機器上快速部署WeEvent服務。提供Docker鏡像、Bash腳本兩種安裝方式。

以下安裝過程以Centos 7.2為例。

Docker鏡像安裝

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

WeEvent的鏡像裡包括了FISCO-BCOS網絡，WeEvent服務的子模塊Broker和Governance，以及各種依賴。

Bash安裝

需要的一些基礎工具yum install wget tree tar dos2unix lsof gcc openssl-devel pcre-devel 。

• 獲取安裝包
• 從github下載安裝包weevent-1.0.0.tar.gz，並且解壓到/tmp/ 。

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

• 如果github下載速度慢，可以嘗試國內下載鏈接。

解壓後目錄結構如下：

$ cd weevent-1.0.0/ 
$ tree -L 2
.
├── bin
│ ├── check-service.sh
│ ├── start-all.sh
│ ├── stop-all.sh
│ └── uninstall-all.sh
├── config.properties
├── install-all.sh
├── modules
│ ├── broker
│ ├── governance
│ └── nginx
└── third-packages
 └── nginx-1.14.2.tar.gz

• 修改配置
• 默認配置文件./config.properties如下：

# Required module
# support 2.0 and 1.3
fisco-bcos.version=2.0
# FISCO-BCOS node channel, eg: 127.0.0.1:20200;127.0.0.2:20200
fisco-bcos.channel=127.0.0.1:20200
# The path of FISCO-BCOS 2.0 that contain certificate file ca.crt/node.crt/node.key,
# OR FISCO-BCOS 1.3 that contain ca.crt/client.keystore
fisco-bcos.node_path=~/FISCO-BCOS/127.0.0.1/node0/conf
# Required module
nginx.port=8080
# Required module
broker.port=8090
# Optional module
governance.enable=false
governance.governance.port=8099
governance.mysql.ip=127.0.0.1
governance.mysql.port=3306
governance.mysql.user=xxx
governance.mysql.password=yyy

• 配置說明 :
• 區塊鏈FISCO-BCOS
• fisco-bcos.version
• FISCO-BCOS 2.0和1.3版本都支持，推薦使用2.0及以上版本。
• fisco-bcos.channel
• 區塊鏈節點的channel訪問入口。配置多個節點時用;分割，如127.0.0.1:8821;127.0.0.2:8821。
• fisco-bcos.node_path
• 區塊鏈節點的訪問證書、私鑰存放目錄。FISCO-BCOS 2.0的證書文件為ca.crt、node.crt、node.key，1.3版本的證書文件為ca.crt、client.keystore。
• 如果WeEvent服務和區塊鏈節點不在同一臺機器上，需要把證書文件拷貝到WeEvent機器的當前目錄，修改fisco-bcos.node_path=./。
• Nginx監聽端口nginx.port
• Broker監聽端口broker.port
• Governance模塊配置
• governance.enable是否安裝Governance模塊，默認為false不安裝
• 監聽端口governance.port
• Mysql配置governance.mysql.*
• 一鍵安裝
• 以安裝到目錄/usr/local/weevent/為例。

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

• 正常安裝後，輸出有如下關鍵字:

8081 port is okay
8080 port is okay
param ok
install module broker 
install broker success 
install module nginx 
install nginx success 

• 如果安裝失敗，可以在安裝日誌./install.log中查看更多細節。
• 目標安裝路徑/usr/local/weevent/的結構如下

$ cd /usr/local/weevent/
$ tree -L 2
.
|-- broker 
| |-- apps
| |-- broker.sh
| |-- check-service.sh
| |-- conf
| |-- deploy-topic-control.sh
| |-- lib 
| `-- logs
|-- check-service.sh 
|-- nginx 
| |-- conf
| |-- html
| |-- logs
| |-- nginx.sh
| |-- nginx_temp
| `-- sbin 
|-- start-all.sh 
|-- stop-all.sh 
`-- uninstall-all.sh

• 啟停服務
• 啟動服務
• 在服務安裝目錄下/usr/local/weevent，通過start-all.sh命令啟動所有服務 ，正常啟動如下：

$ ./start-all.sh
start broker success (PID=3642)
add the crontab job success
start nginx success (PID=3643)
add the crontab job success

• 停止所有服務的命令./stop-all.sh。
• 檢查是否安裝成功

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