第5章 ZIP からの Red Hat Process Automation Manager のインストール
Red Hat Process Automation Manager の ZIP ファイル (Business Central 用および Process Server 用) ではグラフィカルユーザーインターフェースが必要ないため、SSH を使用して Red Hat Process Automation Manager をインストールできます。
Business Central および Process Server は、実稼働環境では異なるサーバーにインストールすることを推奨します。
ヘッドレス Process Automation Manager コントローラーのインストールは「6章ヘッドレス Process Automation Manager コントローラーのインストールおよび実行」を参照してください。
5.1. ZIP ファイルからの Business Central のインストール
Business Central の Web コンソールにより、個々のコンポーネントに対する以下のタスクを一元化された Web ベースの環境で実行できます。
- ルール、プロセス、および関連アセットを作成、管理、および編集します。
- 接続された Process Server およびそのコンテナーを管理します。
- Business Central に接続した Process Server インスタンスのプロセスおよびタスクに対してランタイム操作を実行します。
前提条件
-
バックアップを作成してある Red Hat JBoss EAP システム (バージョン 7.1 またはそれ以降) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを
EAP_HOMEとします。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
Red Hat カスタマーポータル から以下のファイルをダウンロードしている。
rhpam-7.0.0-business-central-eap7-deployable.zip
手順
-
rhpam-7.0.0-business-central-eap7-deployable.zipファイルを一時ファイルに展開します。以下の例では、このディレクトリーをTEMP_DIRとします。 TEMP_DIR/rhpam-7.0.0-business-central-eap7-deployable/jboss-eap-7.1ディレクトリーの内容をEAP_HOMEにコピーします。ファイルの上書きまたはディレクトリーのマージを確認したら、はい を選択します。警告コピーする Red Hat Process Automation Manager デプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
5.2. ZIP ファイルからの Process Server のインストール
Process Server はビジネスアセットのランタイム環境を提供し、アセットレポジトリー (ナレッジストア) に保存されたデータにアクセスします。
前提条件
-
バックアップを作成してある Red Hat JBoss EAP システム (バージョン 7.1 またはそれ以降) が利用できる。Red Hat JBoss EAP システムのベースディレクトリーを
EAP_HOMEとします。 - インストールを完了するのに必要なユーザーパーミッションが付与されている。
Red Hat カスタマーポータル から以下のファイルをダウンロードしている。
rhpam-7.0.0-kie-server-ee7.zip
手順
-
rhpam-7.0.0-kie-server-ee7.zipアーカイブを一時ディレクトリーに展開します。以下の例では、このディレクトリーをTEMP_DIRとします。 TEMP_DIR/rhpam-7.0.0-kie-server-ee7/rhpam-7.0.0-kie-server-ee7/kie-server.warディレクトリーをEAP_HOME/standalone/deployments/にコピーします。警告コピーする Red Hat Process Automation Manager デプロイメントの名前が、Red Hat JBoss EAP インスタンスの既存デプロイメントと競合しないことを確認します。
-
TEMP_DIR/rhpam-7.0.0-kie-server-ee7/rhpam-7.0.0-kie-server-ee7/SecurityPolicy/の中身をEAP_HOME/binにコピーします。ファイルの上書きを確認したら、はい を選択します。 -
EAP_HOME/standalone/deployments/ディレクトリーに、kie-server.war.dodeployという名前で空のファイルを作成します。このファイルにより、サーバーが起動すると Process Server が自動的にデプロイされます。
5.3. Process Server への JDBC データソースの設定
データソースは、アプリケーションサーバーなど、Java Database Connectivity (JDBC) クライアントを有効にするオブジェクトで、データベースへの接続を確立します。アプリケーションは、JNDI (Java Naming and Directory Interface) ツリーまたはローカルのアプリケーションコンテキストでデータソースを検索し、データベース接続を要求してデータを取得します。Process Server にデータソースを設定して、サーバーと、指定したデータベースとの間で適切なデータ交換を行う必要があります。
前提条件/事前作業
データベース接続を作成するのに使用する JDBC プロバイダーが、Process Server をデプロイするすべてのサーバーに設定されている。
手順
-
テキストエディターで
EAP_HOME/standalone/configuration/standalone-full.xmlを開き、<system-properties>タグの場所を特定します。 以下のプロパティーを
<system-properties>タグに追加します。<DATASOURCE>はデータソースの名前になり、<HIBERNATE_DIALECT>はデータベースの Hibernate 方言になります。注記org.kie.server.persistence.dsプロパティーのデフォルト値はjava:jboss/datasources/ExampleDSです。org.kie.server.persistence.dialectプロパティーのデフォルト値はorg.hibernate.dialect.H2Dialectです。<property name="org.kie.server.persistence.ds" value="<DATASOURCE>"/> <property name="org.kie.server.persistence.dialect" value="<HIBERNATE_DIALECT>"/>
以下に例を示します。
<system-properties> <property name="org.kie.server.repo" value="${jboss.server.data.dir}"/> <property name="org.kie.example" value="true"/> <property name="org.jbpm.designer.perspective" value="full"/> <property name="designerdataobjects" value="false"/> <property name="org.kie.server.user" value="rhpamUser"/> <property name="org.kie.server.pwd" value="rhpam123!"/> <property name="org.kie.server.location" value="http://localhost:8080/kie-server/services/rest/server"/> <property name="org.kie.server.controller" value="http://localhost:8080/business-central/rest/controller"/> <property name="org.kie.server.controller.user" value="kieserver"/> <property name="org.kie.server.controller.pwd" value="kieserver1!"/> <property name="org.kie.server.id" value="local-server-123"/> <!-- Data source properties. --> <property name="org.kie.server.persistence.ds" value="java:jboss/datasources/KieServerDS"/> <property name="org.kie.server.persistence.dialect" value="org.hibernate.dialect.PostgreSQLDialect"/> </system-properties>
以下の方言がサポートされます。
-
DB2:
org.hibernate.dialect.DB2Dialect -
MSSQL:
org.hibernate.dialect.SQLServer2012Dialect -
MySQL:
org.hibernate.dialect.MySQL5InnoDBDialect -
MariaDB:
org.hibernate.dialect.MySQL5InnoDBDialect -
Oracle:
org.hibernate.dialect.Oracle10gDialect -
PostgreSQL:
org.hibernate.dialect.PostgreSQL82Dialect -
PostgreSQL plus:
org.hibernate.dialect.PostgresPlusDialect -
Sybase:
org.hibernate.dialect.SybaseASE157Dialect
5.4. ユーザーの作成
Business Central または Process Server にログインする前に、ユーザーを作成する必要があります。本セクションでは、admin、rest-all、および kie-server のロールを持つ Business Central ユーザーと、kie-server ロールを持つ Process Server ユーザーを作成する方法を説明します。ロールの詳細は「2章ロールおよびユーザー」を参照してください。
前提条件
「5章ZIP からの Red Hat Process Automation Manager のインストール」の説明通りに、Red Hat Process Automation Manager が Red Hat JBoss EAP インストール (EAP_HOME) のベースディレクトリーにインストールされている。
手順
-
ターミナルアプリケーションで
EAP_HOME/binディレクトリーに移動します。 Business Central へのログインに使用する、
adminロール持つユーザーを作成します。以下のコマンドの<username>および<password>を、作成するユーザーとそのパスワードに置き換えます。$ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role admin,rest-all
注記必ず、既存のユーザー、ロール、またはグループとは異なるユーザー名を指定してください。たとえば、
adminという名前のユーザーは作成しないでください。パスワードは 8 文字以上で、数字と、英数字以外の文字をそれぞれ 1 文字以上使用する必要があります。ただし & の文字は使用できません。
Process Server にログインするのに使用する、
kie-serverロールを持つユーザーを作成します。$ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role kie-server
ユーザー名とパスワードを書き留めておきます。
注記Business Central と Process Server を同じサーバーにインストールした場合は、両方のロールを持つユーザーを 1 つ作成できます。
$ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role admin,rest-all,kie-server
Business Central および Process Server は、実稼働環境では異なるサーバーにインストールすることを推奨します。
5.5. 統合 Process Automation Manager コントローラーを使用する Process Server の設定
Process Server は Process Automation Manager コントローラーによる管理モードにすることも、非管理モードにすることもできます。Process Server が非管理モードにある場合は、手動でコンテナーを作成および維持する必要があります。Process Server が管理モードにある場合は、Process Automation Manager コントローラーが Process Server 設定を管理して、コンテナーと対話してコンテナーの作成と維持を行います。
Process Automation Manager コントローラーは Business Central と統合します。Business Central をインストールする場合は、Business Central の Execution Server ページを使用してコンテナーと対話します。
Business Central をインストールしていない場合は、「6章ヘッドレス Process Automation Manager コントローラーのインストールおよび実行」でヘッドレス Process Automation Manager コントローラーを使用する方法を参照してください。
ZIP ファイルから Red Hat Process Automation Manager をインストールした場合は、Process Server および Business Central のインストールの standalone-full.xml ファイルを編集して、統合 Process Automation Manager コントローラーを持つ Process Server を設定する必要があります。
Process Server を Business Central で管理する場合に限りこのように変更します。Business Central をインストールしない場合は、「6章ヘッドレス Process Automation Manager コントローラーのインストールおよび実行」の記載通りに、ヘッドレス Process Automation Manager コントローラーを使用できます。
前提条件
以下のセクションに記載通りに、Business Central および Process Server が Red Hat JBoss EAP インストールのベースディレクトリー (
EAP_HOME) にインストールされている。- 「ZIP ファイルからの Business Central のインストール」
「ZIP ファイルからの Process Server のインストール」
注記実稼働環境では、Business Central と Process Server を異なるサーバーにインストールすることを推奨します。ただし、たとえば開発環境で、Process Server と Business Central を同じサーバーにインストールする場合は、本セクションの説明に従って、共有の
standalone-full.xmlファイルを変更します。
-
Process Server ノードに、
kie-serverロールを持つユーザーが作成されている。 Business Central サーバーノードに、
rest-allロールを持つユーザーが作成されている。詳細は「ユーザーの作成」を参照してください。
手順
Business Central の
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>"/>
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>"/>
以下の値を置き換えてください。
-
<CONTROLLER_USER>および<CONTROLLER_PWD>をrest-allロールを持つユーザーの認証情報に置き換えます。 -
<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>を Business Central の URL に置き換えます。Process Server は、起動時にこの URL に接続します。インストーラーまたは Red Hat JBoss EAP zip ファイルを使用して Business Central をインストールした場合、
<CONTROLLER_URL>は以下のようになります。standalone.jarファイルを使用して Business Central を実行している場合、<CONTROLLER_URL>は以下のようになります。
-
5.6. Red Hat Process Automation Manager の実行
Red Hat JBoss EAP に Red Hat Process Automation Manager をインストールしたら、以下の手順に従ってスタンドアロンモードで Red Hat Process Automation Manager を実行します。
前提条件/事前作業
本章の説明通りに Red Hat Process Automation Manager がインストールされて設定されている。
手順
-
ターミナルアプリケーションで
EAP_HOME/binに移動します。 スタンドアロン設定を実行します。
Linux または UNIX ベースのシステムの場合:
$ ./standalone.sh -c standalone-full.xml
Windows の場合:
standalone.bat -c standalone-full.xml
注記Process Server を使用せず、Business Central だけをデプロイした場合は、
standalone.shスクリプトにstandalone-full.xmlファイルを指定せず Business Central だけを起動できます。この場合は、Business Central を起動する前にstandalone.xmlファイルの設定を変更しておく必要があります。Linux または UNIX ベースのシステムの場合:
$ /standalone.sh
Windows の場合:
standalone.bat
-
Web ブラウザーで、URL
localhost:8080/business-centralを開きます。 - 「ユーザーの作成」 の Business Central で作成したユーザーの認証情報を使用してログインします。

Where did the comment section go?
Red Hat's documentation publication system recently went through an upgrade to enable speedier, more mobile-friendly content. We decided to re-evaluate our commenting platform to ensure that it meets your expectations and serves as an optimal feedback mechanism. During this redesign, we invite your input on providing feedback on Red Hat documentation via the discussion platform.