第6章 ヘッドレス Decision Manager コントローラーのダウンロードおよびインストール
Decision Server は、管理モードまたは非管理モードで動作するように設定できます。非管理モードの場合は、手動で KIE コンテナー (デプロイメントユニット) を作成および維持する必要があります。管理モードの場合は、Decision Manager コントローラーが Decision Server の設定を管理し、ユーザーはコントローラーと対話形式で KIE コンテナーを作成、維持します。
Decision Manager コントローラーは Business Central と統合します。Business Central をインストールしている場合は、Execution Server ページを使用して KIE コンテナーを作成および維持します。ただし、Business Central をインストールしない場合は、ヘッドレス Decision Manager コントローラーをインストールし、REST API または Decision Server Java Client API を使用してそのコントローラーと対話します。
前提条件
-
2章Red Hat Decision Manager インストールファイルのダウンロード に従って Red Hat Decision Manager 7.3.0 Add Ons (
rhdm-7.3.0-add-ons.zip) ファイルがダウンロードされている。 -
Red Hat JBoss Web Server 5.0.1 以降のサーバーインストールが利用できる。Red Hat JBoss Web Server インストールのベースディレクトリーは
JWS_HOMEとします。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
手順
-
rhdm-7.3.0-add-ons.zipファイルを展開します。rhdm-7.3-controller-jws.zipファイルは展開したディレクトリーにあります。 -
rhdm-7.3-controller-jws.zipアーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIRとします。 TEMP_DIR/rhdm-7.3-controller-jws.zip/controller.warディレクトリーをJWS_HOME/tomcat/webappsディレクトリーにコピーします。注記コピーする Red Hat Decision Manager デプロイメントの名前が Red Hat JBoss Web Server インスタンスの既存デプロイメントと競合しないことを確認します。
-
controller.warディレクトリーから.war拡張子を削除します。 -
TEMP_DIR/rhdm-7.3-controller-jws/SecurityPolicy/ディレクトリーをJWS_HOME/binにコピーします。ファイルの上書きを確認するメッセージが表示されたら、Yes を選択します。 JWS_HOME/tomcat/conf/tomcat-users.xmlファイルにkie-serverロールおよびユーザーを追加します。以下の例で、<USERNAME>と<PASSWORD>は任意のユーザー名とパスワードです。<role rolename="kie-server"/> <user username="<USER_NAME>" password="<PASSWORD>" roles="kie-server"/>Decision Server を実行するインスタンスの
JWS_HOME/tomcat/binディレクトリーで、以下のタスクの 1 つを実行します。Linux または UNIX の場合は、以下の内容の
setenv.shファイルを作成します。CATALINA_OPTS="-Xmx1024m -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true -Dorg.kie.server.controller.user=<CONTROLLER_USER> -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD> -Dorg.kie.server.id=<KIE_SERVER_ID> -Dorg.kie.server.location=http://<HOST>:<PORT>/kie-server/services/rest/server -Dorg.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller"Windows の場合は、以下の内容の
setenv.batファイルを作成します。set CATALINA_OPTS= -Xmx1024m -Dorg.jbpm.server.ext.disabled=true -Dorg.jbpm.ui.server.ext.disabled=true -Dorg.jbpm.case.server.ext.disabled=true -Dorg.kie.server.controller.user=<CONTROLLER_USER> -Dorg.kie.server.controller.pwd=<CONTROLLER_PWD> -Dorg.kie.server.id=<KIE_SERVER_ID> -Dorg.kie.server.location=http://<HOST>:<PORT>/kie-server/services/rest/server -Dorg.kie.server.controller=http://<HOST>:<PORT>/controller/rest/controller
ヘッドレス Decision Manager コントローラーを実行しているインスタンスの
JWS_HOME/tomcat/binディレクトリーに、以下の内容でsetenv.shファイルを作成します。CATALINA_OPTS="-Dorg.kie.server.user=<USERNAME> -Dorg.kie.server.pwd=<USER_PWD>"ヘッドレス Decision Manager コントローラーを起動するには、
JWS_HOME/tomcat/binディレクトリーに以下のいずれかのコマンドを実行します。Linux または UNIX ベースのシステムの場合:
$ ./startup.shWindows の場合:
startup.bat
-
数分後に
JWS_HOME/tomcat/logsディレクトリーを確認し、エラーが発生している場合には修正します。 Decision Manager コントローラーが Red Hat JBoss Web Server で動作していることを確認するには、以下のコマンドを実行します。このコマンドで、
<CONTROLLER>および<CONTROLLER_PWD>をtomcat-users.xmlファイルの値に置き換えます。このコマンドにより、Decision Server インスタンスに関する情報が出力されます。curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
別の方法では、Decision Server Java API Client を使用してヘッドレス Decision Manager コントローラーにアクセスすることもできます。