kie-drools-wbをTomcatにデプロイする

原文: Deploying kie-drools-wb on Tomcat by Michael Anstis(Drools & jBPM)

ここ最近、Droolsユーザーメーリングリストで、KIE Drools WorkbenchをTomcatにデプロイする際の質問をいくつか受けました。6.0.1がリリースされた直後にも同様の質問がありました。

何か問題があると疑い、金曜日の午後に試してみました。結果、多少問題はありましたが、6.0.1も6.1.0-SNAPSHOTもTomcat7へデプロイできました。

下記内容のほとんどはTomcat用のWARアーカイブに含まれる README.txtに記載されています。WARの中にある為、気づかない方もいるようです。

6.0.1
Tomcat7のクリーンインストールをまず行う。

1. "kie-tomcat-integration"jarアーカイブをTOMCAT_HOME/lib配下にコピーする(org.kie:kie-tomcat-integration))
2. "JACC"jarをTOMCAT_HOME/lib配下にコピーする(JBoss Maven リポジトリにある javax.security.jacc:artifactId=javax.security.jacc-api)
3. "slf4j-api"jarをTOMCAT_HOME/lib配下にコピーする(JBoss Maven リポジトリにある org.slf4j:artifactId=slf4j-api)
4. valveの定義を TOMCAT_HOME/conf/server.xmlの、Hostエレメント内に設定
      <Valve className="org.kie.integration.tomcat.JACCValve" />
5. TOMCAT_HOME/conf/tomcat-users.xml のロールやユーザーを修正する。'analyst'か'admin'ロールはkie-drools-wbを利用する際の認証に使われる為、必ず設定
6. WEB-INF/classes/META-INF/servicesからorg.uberfire.security.auth.AuthenticationSourceを削除
7. WEB-INF/classes/META-INF/servicesに記載されているorg.uberfire.security.auth.AuthenticationSource-TOMCAT-JEE-SECURITYをorg.uberfire.security.auth.AuthenticationSourceに変更
8. TOMCAT_HOME/bin/setenv.shでJAVA_OPTS="-Xmx1024m -XX:MaxPermSize=256m" をexportし、Perm領域を増やす
9. TOMCAT_HOME/bin/startup.shでTomcatを起動
10. 管理コンソール http://localhost:8080/management にアクセス
11. 修正したWARをデプロイ

この手順を実施せずともWARパッケージは使えますが、WEB-INF/classes/users.propertiesにユーザーを定義する必要があります。

6.1.0-SNAPSHOT
Tomcat7のクリーンインストールをまず行う。

1. "kie-tomcat-integration"jarアーカイブをTOMCAT_HOME/lib配下にコピーする(org.kie:kie-tomcat-integration))
2. "JACC"jarをTOMCAT_HOME/lib配下にコピーする(JBoss Maven リポジトリにある javax.security.jacc:artifactId=javax.security.jacc-api)
3. "slf4j-api"jarをTOMCAT_HOME/lib配下にコピーする(JBoss Maven リポジトリにある org.slf4j:artifactId=slf4j-api)
4. valveの定義を TOMCAT_HOME/conf/server.xmlの、Hostエレメント内に設定
    <Valve className="org.kie.integration.tomcat.JACCValve" />
5. TOMCAT_HOME/conf/tomcat-users.xml のロールやユーザーを修正する。'analyst'か'admin'ロールはkie-drools-wbを利用する際の認証に使われる為、必ず設定
6. TOMCAT_HOME/bin/startup.shでTomcatを起動
7. 管理コンソール http://localhost:8080/management にアクセス
8. 修正したWARをデプロイ

6.0.1と6.1.0の違いは、リリースブランチ間でいくつかのコードをクリーンアップしたことによる差分です。

原文: Deploying kie-drools-wb on Tomcat by Michael Anstis(Drools & jBPM)