第6章 ヘッドレス Process Automation Manager コントローラーのインストールおよび実行

Process Server は、管理モードまたは非管理モードで動作するように設定できます。Process Server が非管理モードにある場合は、手動でコンテナーを作成および維持する必要があります。Process Server が管理モードにある場合は、Process Automation Manager コントローラーが Process Server 設定を管理して、コントローラーと対話してコンテナーの作成と維持を行います。

Process Automation Manager コントローラーは Business Central と統合します。Business Central をインストールする場合は、Execution Server ページを使用してコンテナーを作成および維持します。ただし、Business Central をインストールしない場合は、ヘッドレス Process Automation Manager コントローラーをインストールし、REST API または Process Server Java Client API を使用してそのコントローラーと対話します。

6.1. ヘッドレス Process Automation Manager コントローラーのインストール

ヘッドレス Process Automation Manager コントローラーをインストールして、REST API または Process Server Java Client API を使用して対話します。

前提条件

  • バックアップを作成してある Red Hat JBoss EAP システム (バージョン 7.1 またはそれ以降) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを EAP_HOME とします。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。

手順

  1. Red Hat カスタマーポータルの Software Downloads ページに移動し (ログインが必要)、ドロップダウンオプションから製品およびバージョンを選択します。

    • 製品: Red Hat Process Automation Manager
    • バージョン: 7.0
  2. Red Hat Process Automation Manager 7.0.0 Add Ons (rhpam-7.0.0-add-ons.zip ファイル) をダウンロードします。
  3. rhpam-7.0.0-add-ons.zip ファイルを展開します。rhpam-7.0-controller-ee7.zip ファイルは、展開したディレクトリーにあります。
  4. rhpam-7.0-controller-ee7 アーカイブを一時ファイルに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。
  5. TEMP_DIR/rhpam-7.0-controller-ee7/controller.war ディレクトリーを EAP_HOME/standalone/deployments/ にコピーします。

    警告

    コピーするヘッドレス Process Automation Manager コントローラーデプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。

  6. TEMP_DIR/rhpam-7.0-controller-ee7/SecurityPolicy/ ディレクトリーの中身を EAP_HOME/bin にコピーします。ファイルの上書きを確認するメッセージが表示されたら、はい を選択します。
  7. EAP_HOME/standalone/deployments/ ディレクトリーに、controller.war.dodeploy という名前で空のファイルを作成します。このファイルにより、サーバーが起動するとヘッドレス Process Automation Manager コントローラーが自動的にデプロイされます。

6.1.1. ユーザーの作成

ヘッドレス Process Automation Manager コントローラーを使用する前に、kie-server ロールを持つユーザーを作成する必要があります。

前提条件/事前作業

コントローラーが、Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME) にインストールされている。

手順

  1. ターミナルアプリケーションで EAP_HOME/bin ディレクトリーに移動します。
  2. 以下のコマンドを入力し、<USER_NAME> および <PASSWORD> を、作成するユーザー名およびパスワードに置き換えます。

    $ ./add-user.sh -a --user <USER_NAME> --password <PASSWORD> --role kie-server
    注記

    必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、admin という名前のユーザーは作成しないでください。

    パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。

  3. ユーザー名とパスワードを書き留めておきます。

6.1.2. Process Server およびヘッドレス Process Automation Manager コントローラーの設定

Process Server をヘッドレス Process Automation Manager コントローラーから管理する場合は、本セクションの説明通りに、Process Server およびヘッドレス Process Automation Manager コントローラーインストールの両方で standalone-full.xml ファイルを編集する必要があります。

前提条件

  • 5章ZIP からの Red Hat Process Automation Manager のインストール」セクションの説明通りに、Process Server が Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME) にインストールされている。
  • コントローラーが EAP_HOME にインストールされている。

    注記

    実稼働環境では Process Server およびヘッドレス Process Automation Manager コントローラーを異なるサーバーにインストールすることを推奨します。ただし、開発環境など、Process Server およびヘッドレス Process Automation Manager コントローラーを同じサーバーにインストールする場合は、併せて共有の standalone-full.xml ファイルを変更します。

  • Process Server ノードに、kie-server ロールを持つユーザーが作成されている。
  • Controller サーバーノードに、kie-server ロールを持つユーザーが作成されている。

    詳細は「ユーザーの作成」を参照してください。

手順

  1. Controller の EAP_HOME/standalone/configuration/standalone-full.xml ファイルの <system-properties> セクションに以下のプロパティーを追加し、<USERNAME> および <USER_PWD> を、kie-server ロールを持つユーザーの認証情報に置き換えます。

       <property name="org.kie.server.user" value="<USERNAME>"/>
       <property name="org.kie.server.pwd" value="<USER_PWD>"/>
  2. Process Server の EAP_HOME/standalone/configuration/standalone-full.xml ファイルの <system-properties> セクションに以下のプロパティーを追加します。

      <property name="org.kie.server.controller.user" value="<CONTROLLER_USER>"/>
      <property name="org.kie.server.controller.pwd" value="<CONTROLLER_PWD>"/>
      <property name="org.kie.server.id" value="<KIE_SERVER_ID>"/>
      <property name="org.kie.server.location" value="http://<HOST>:<PORT>/kie-server/services/rest/server"/>
      <property name="org.kie.server.controller" value="<CONTROLLER_URL>"/>
  3. このファイルで、以下の値を置き換えます。

    • <CONTROLLER_USER> および <CONTROLLER_PWD>kie-server ロールを持つユーザーの認証情報に置き換えます。
    • <KIE_SERVER_ID> を Process Server システムの ID または名前に置き換えます (例: rhpam700-process-server-1)。
    • <HOST> を Process Server ホストの ID または名前に置き換えます (例: localhost または 192.7.8.9)。
    • <PORT> を Process Server ホストのポートに置き換えます (例: 8080)。

      注記

      org.kie.server.location プロパティーで Process Server の場所を指定します。

    • <CONTROLLER_URL> を、ヘッドレス Process Automation Manager コントローラーの URL に置き換えます。起動時に Process Server をこの URL に接続します。

6.2. ヘッドレス Process Automation Manager コントローラーの実行

ヘッドレス Process Automation Manager コントローラーを Red Hat JBoss EAP にインストールしたら、以下の手順に従ってヘッドレス Process Automation Manager コントローラーを実行します。

前提条件/事前作業

ヘッドレス Process Automation Manager コントローラーが Red Hat JBoss EAP インストールのベースディレクトリー (EAP_HOME) にインストールされ設定されている。

手順

  1. ターミナルアプリケーションで EAP_HOME/bin に移動します。
  2. 以下のコマンドを入力します。

    • Linux または UNIX ベースのシステムの場合:

      $ ./standalone.sh
    • Windows の場合:

      standalone.bat
  3. Controller が Red Hat JBoss EAP 上で動作していることを確認するには、以下のコマンドを入力します。ここで、<CONTROLLER><CONTROLLER_PWD> は、「ユーザーの作成」で作成したユーザー名とパスワードの組み合わせです。このコマンドにより、Process Server インスタンスに関する情報が出力されます。

    curl -X GET "http://<HOST>:<PORT>/controller/rest/controller/management/servers" -H  "accept: application/xml" -u '<CONTROLLER>:<CONTROLLER_PWD>'
注記

あるいは、Process Server Java API Client を使用して、ヘッドレス Process Automation Manager コントローラーにアクセスすることもできます。