Kie Workbench 和 Kie server

瞎BB队长 4月 14, 2016

最近尝试用规则引擎去处理一些事务逻辑。在开源的规则引擎系统里用的比较广泛的就是Drools啦。

drools, kie-workbench, kie-server是些什么东西

drools

Drools是一个bussiness rule management system (BRMS)，实现了规则引擎中广泛使用的Rete算法

kie-workbench

KIE (knowledge is everything)包含了主体drools之外，还有其他一些附加功能。

workbench是一个在线工具，包括drools项目的建立，编辑，版本控制，构建和部署等很多功能，是一个web　IDE.

kie-server

kie-server是一个独立的REST服务，主要是执行规则。

安装Tomcat

去tomcat官网下个tomcat8+的版本就行了(至少7+)
解压放在合适的地方(如果时Linux, 建议放在/usr/local/下面（不要问为什么，我有强迫症）
在环境变量中加入export TOMCAT_HOME=/usr/local/apache-tomcat-8.0.33
在$TOMCAT_HOME/conf/tomcat-users.xml中加入role和user

<role rolename="tomcat"/>
<role rolename="manager-gui"/>
<role rolename="manager-script"/>
<role rolename="manager-jmx"/>
<role rolename="manager-status"/>
<role rolename="admin"/>
<role rolename="kie-server"/>
<user username="tomcat" password="tomcat" roles="tomcat,manager-gui,manager-script,manager-jmx,manager-status,admin,kie-server"/>

Tomcat安装kie workbench需要的JAR

安装kie-workbench

workbench在drools的官网能下载，我用的是6.3.0-final的版本。

将下载的war包放在tomcat的webapps目录下面，会自动解压（前提是tomcat正在运行）。然后会发现多了一个workbench的目录，里面有个README.txt，具体描述安装过程，其中需要的jar包在上面提供了下载链接。

安装kie-server

在官网下载下来的ZIP包中包含了3个war包，我用的是tomcat，所以选择了-webc的war包放在webapps目录下面。

配置setenv.sh

在$TOMCAT_HOME/bin目录下建立setenv.sh，配置如下：

CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME \
    -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties \
    -Djbpm.tsr.jndi.lookup=java:comp/env/TransactionSynchronizationRegistry \
    -Djava.security.auth.login.config=$CATALINA_HOME/webapps/kie-drools-wb/WEB-INF/classes/login.config \
    -Dorg.jboss.logging.provider=jdk \
    -Dorg.jbpm.server.ext.disabled=true \
　　　 -Dorg.kie.server.user=tomcat \
    -Dorg.kie.server.pwd=tomcat \
    -Dorg.kie.server.controller=http://localhost:8080/kie-drools-wb/rest/controller \
    -Dorg.kie.server.controller.user=tomcat \
    -Dorg.kie.server.controller.pwd=tomcat \
    -Dorg.kie.server.id=sherry-kie-server \
    -Dorg.kie.server.location=http://localhost:8080/kie-server-webc/services/rest/server"

其中的org.ki.server的配置项在workbench的readme中没有提到，我在掉了很多次坑之后终于发现了这些配置项的重要性。主要是org.kie.server.controller一定配置，不然通过workbench建立的container会找不到endpoints. 用kie-server的REST　api也看不到container的信息。

org.kie.server.user/pwd: 这个是kie-server的用户名和密码，在workbench上对kie-server做交互的时候需要用户认证
org.kie.server.controller: 这个是维持kie-server配置的控制器，它的地址就是workbench路径的/rest/controller
org.kie.server.controller.user: 登陆workbench的用户名
org.kie.server.controller.pwd: 登陆workbench的密码

使用kie-workbench和kie-server

kie-workbench: http://docs.jboss.org/drools/release/6.3.0.Final/drools-docs/html/ch18.html
kie-server: http://docs.jboss.org/drools/release/6.3.0.Final/drools-docs/html/ch22.html

配置好的container

container

会被坑的地方

Tomcat如果通过bin/shutdown.sh关闭，再次重新启动时workbench会报错(previous error)无法启动。因为之前启动workbench会有一个9418的端口被占用了(git)，需要手动Kill那个进程，具体用lsof -i:9418查到对应的pid，然后再kill -9杀掉进程。
Workbench中的成功状态并不一定是kie-server中的成功状态，还是需要检查日志的。我一开始没有添加org.kie.server.user, 默认为kieserver，而我在Tomcat中统一配置的用户名是tomcat，结果导致我新加的项目添加到container中失败（但是workbench中是显示成功的，在kie-server的rest api中找不到该container），日志中报错说This request requires HTTP authentication.
kie-server中的drools有两种方式运行(BRM和BPM)，如果不在配置中把org.jbpm.server.ext.disabled设置成true，启动时会报一堆错
$TOMCAT_HOME/work里面的.tlog文件真的是有毒。我一开始没有设置org.kie.server.user，每次workbench都是以默认的kieserver这个用户去连接kie-server导致验证出错，后来我加了org.kie.server.user和org.kie.server.pwd之后，还是报错说org.apache.catalina.realm.LockOutRealm.authenticate An attempt was made to authenticate the locked user "kieserver"，在检查了Ｎ遍配置，并N次重启服务后，还是不停报这个错。这时候有种直觉告诉我是不是什么地方有缓存了这个用户，于是删掉了.tlog文件，再次重启终于成功的把我新加的项目创建到container里面了

有问题的地方

如果workbench中建立的container,　在kie-server的REST api/services/rest/server/containers中看不到，应该是org.kie.server.controller没有配置正确。