第39章 ヘッドレス Process Automation Manager コントローラーのダウンロードおよびインストール
KIE Server は、管理モードまたは非管理モードで動作するように設定できます。KIE Server が非管理モードの場合は、手動で KIE コンテナー (デプロイメントユニット) を作成および維持する必要があります。KIE Server が管理されている場合は、Process Automation Manager コントローラーが KIE Server の設定を管理し、ユーザーはコントローラーと対話形式で KIE コンテナーを作成、維持します。
Process Automation Manager コントローラーは Business Central と統合します。Business Central をインストールしている場合は、Execution Server ページを使用して KIE コンテナーを作成および維持します。ただし、Business Central をインストールしない場合は、ヘッドレス Process Automation Manager コントローラーをインストールし、REST API または KIE Server Java Client API を使用してそのコントローラーと対話します。
前提条件
-
34章Red Hat Process Automation Manager インストールファイルのダウンロード に従って、Red Hat Process Automation Manager 7.11.0 Add Ons (
rhpam-7.11.0-add-ons.zip
) ファイルがダウンロードされている。 -
Red Hat JBoss Web Server 5.4.0 サーバーインストールが利用できる。Red Hat JBoss Web Server インストールのベースディレクトリーは
JWS_HOME
とします。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
手順
-
rhpam-7.11.0-add-ons.zip
ファイルを展開します。rhpam-7.11.0-controller-jws.zip
ファイルは、展開したディレクトリーにあります。 -
rhpam-7.11.0-controller-jws.zip
アーカイブを一時ディレクトリーに展開します。以下の例では、この名前をTEMP_DIR
とします。 TEMP_DIR/rhpam-7.11.0-controller-jws.zip/controller.war
ディレクトリーをJWS_HOME/tomcat/webapps
ディレクトリーにコピーします。注記コピーする Red Hat Process Automation Manager デプロイメントの名前が、Red Hat JBoss Web Server インスタンスの既存デプロイメントと競合しないことを確認します。
-
controller.war
ディレクトリーから.war
拡張子を削除します。 -
TEMP_DIR/rhpam-7.11.0-controller-jws/SecurityPolicy/
ディレクトリーのコンテンツをJWS_HOME/bin
にコピーします。 - ファイルの上書きを求めるプロンプトが出されたら、Yes を選択します。
JWS_HOME/tomcat/conf/tomcat-users.xml
ファイルにkie-server
ロールおよびユーザーを追加します。以下の例で、<USER_NAME>
と<PASSWORD>
は、任意のユーザー名とパスワードです。<role rolename="kie-server"/> <user username="<USER_NAME>" password="<PASSWORD>" roles="kie-server"/>
KIE Server を実行するインスタンスの
JWS_HOME/tomcat/bin
ディレクトリーで、以下のタスクの 1 つを実行します。Linux または UNIX の場合は、以下の内容の
setenv.sh
ファイルを作成します。CATALINA_OPTS="-Xmx1024m -Dorg.jboss.logging.provider=jdk -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.jboss.logging.provider=jdk -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
上記の例では、以下の変数に置き換えてください。
-
<CONTROLLER_USER>
および<CONTROLLER_PWD>
を、この手順の最初の方で定義したkie-server
ロールを持つユーザー名とパスワードに置き換えます。 -
<KIE_SERVER_ID>
を一意の識別子に置き換えます。 -
<CONTROLLER_HOST>:<CONTROLLER_PORT>
をコントローラーの IP アドレス (ホストとポート) に置き換えます。KIE Server とコントローラーで同じサーバーを使用する場合は、<CONTROLLER_HOST>:<CONTROLLER_PORT>
はlocalhost:8080
に置き換えます。
ヘッドレス Process Automation Manager コントローラーを実行しているインスタンスの
JWS_HOME/tomcat/bin
ディレクトリーに、以下の内容で読み取り可能なsetenv.sh
ファイルを作成します。ここでの<USERNAME>
は KIE Server ユーザーで、<USER_PWD>
はそのユーザーのパスワードになります。CATALINA_OPTS="-Dorg.kie.server.user=<USERNAME> -Dorg.kie.server.pwd=<USER_PWD>"
ヘッドレス Process Automation Manager コントローラーを起動するには、
JWS_HOME/tomcat/bin
ディレクトリーに以下のいずれかのコマンドを実行します。Linux または UNIX ベースのシステムの場合:
$ ./startup.sh
Windows の場合:
startup.bat
-
数分後に
JWS_HOME/tomcat/logs
ディレクトリーを確認し、エラーが発生している場合には修正します。 -
ヘッドレス Process Automation Manager コントローラーが正常に動作していることを確認するには、Web ブラウザーに
http://<CONTROLLER_HOST>:<CONTROLLER_PORT>/controller/rest/controller/management/servers
を入力します。KIE Server とコントローラーで同じサーバーを使用する場合は、<CONTROLLER_HOST>:<CONTROLLER_PORT>
はlocalhost:8080
に置き換えます。 -
tomcat-users.xml
ファイルに保存したユーザー名とパスワードを入力します。