第4章 Red Hat Process Automation Manager インストーラーの使用


本セクションでは、インストール JAR ファイルを使用して KIE Server およびヘッドレス Process Automation Manager コントローラーをインストールする方法を説明します。JAR ファイルは、既存の Red Hat JBoss EAP 7.2 サーバーインストールに Red Hat Process Automation Manager をインストールする実行ファイルです。インストーラーは、インタラクティブモードまたはコマンドラインインターフェース (CLI) モードで実行できます。

注記

Red Hat Process Automation Manager JAR ファイルインストーラーは、yum または RPM Package Manager を使用してインストールした Red Hat JBoss EAP ディストリビューションを サポートしません。このようにインストールされた Red Hat JBoss EAP に Red Hat Process Automation Manager をインストールするには、Red Hat Process Automation Manager 7.7 Deployable for Red Hat JBoss EAP 7.2 ファイルをダウンロードし、5章ZIP からの Red Hat Process Automation Manager のインストール の手順に従います。

注記

IBM JDK では、その他の JDK で生成したキーストアを使用できないため、別の JDK で生成したキーストアを使用して、IBM JDK で実行している既存の Red Hat JBoss EAP に Red Hat Process Automation Manager をインストールすることはできません。

次のステップ:

以下のセクションのいずれかに記載される手順を行います。

4.1. インタラクティブモードでのインストーラーの使用

Red Hat Process Automation Manager のインストーラーは、実行可能な JAR ファイルです。このインストーラーを使用して、既存の Red Hat JBoss EAP 7.2 サーバーインストールに Red Hat Process Automation Manager をインストールできます。

注記

セキュリティー上の理由で、root 以外のユーザーでインストーラーを実行する必要があります。

前提条件

  • サポート対象の JDK がインストールされている。サポート対象の JDK の一覧については、「Red Hat Process Automation Manager 7 Supported Configurations」を参照してください。
  • バックアップ済みの Red Hat JBoss EAP 7.2 のサーバーインストールが利用できる。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。
  • $PATH 環境変数に含まれている JAR バイナリー。Red Hat Enterprise Linux では、java-$JAVA_VERSION-openjdk-devel パッケージに含まれています。

    注記

    Red Hat Process Automation Manager は、UTF-8 エンコーディングで機能するように設計されています。基礎となる JVM で別のエンコーディングシステムを使用すると、予期せぬエラーが発生する可能性があります。JVM で UTF-8 を使用するようにするには、"-Dfile.encoding=UTF-8" のシステムプロパティーを使用します。

手順

  1. ターミナルウインドウで、インストーラー JAR ファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

    java -jar rhpam-installer-7.7.0.jar
    注記

    Windows でインストーラーを実行すると、インストール時に管理者の認証情報が求められる場合があります。この要求を回避するには、インストールコマンドに izpack.mode=privileged オプションを追加します。

    java -Dizpack.mode=privileged -jar
    rhpam-installer-7.7.0.jar

    また、32 ビットの Java 仮想マシンでインストーラーを実行している場合には、メモリー不足になる可能性があります。この問題を防ぐには、以下のコマンドを実行します。

    java -XX:MaxHeapSize=4g -jar
    rhpam-installer-7.7.0.jar

    グラフィカルインストーラーにスプラッシュ画面と使用許諾契約書のページが表示されます。

  2. I accept the terms of this license agreement (本使用許諾契約書の内容に同意します) をクリックし、Next をクリックします。
  3. Red Hat Process Automation Manager をインストールする Red Hat JBoss EAP 7.2 サーバーのホームを指定して、Next をクリックします。
  4. インストールするコンポーネントを選択し、Next をクリックします。

    注記

    Business Central と KIE Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにこの 2 つをインストールすることを推奨します。異なるサーバーにインストールするには、インストーラーを 2 回実行します。

  5. ユーザーを作成して、Next をクリックします。デフォルトでは、同じコンテナーに Business Central と KIE Server の両方をインストールする場合は、新しいユーザーに adminkie-server および rest-all ロールが割り当てられます。KIE Server のみをインストールした場合には、ユーザーには kie-server ロールが割り当てられます。別のロールを選択するには、admin の選択を解除します。詳細は、2章Red Hat Process Automation Manager ロールおよびユーザーを参照してください。

    注記

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

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

    ユーザー名とパスワードを書き留めておきます。Business Central および KIE Server にアクセスする時に必要になります。

  6. Installation Overview ページで Next をクリックしてインストールを起動します。Installation Overview ページに、インストールされるコンポーネントの一覧が表示されます。
  7. インストールが完了したら、Next をクリックします。
  8. KIE Server がインストールされている場合には、Component InstallationConfigure Runtime の手順が表示されます。Configure Runtime Environment ページで、デフォルトのインストールを実行するか、詳細設定を行うかを選択します。

    Perform advanced configuration を選択した場合は、データベース設定、または特定の KIE Server オプションのカスタマイズが選択できます。

  9. JDBC Drive Configuration ページで Customize database settings を選択した場合は、データソースの JDBC ドライバーのベンダーを選択し、ドライバーの JAR ファイルを 1 つ以上選択し、Next をクリックします。

    データソースは、アプリケーションサーバーなど、Java Database Connectivity (JDBC) クライアントを有効にするオブジェクトで、データベースへの接続を確立します。アプリケーションは、JNDI (Java Naming and Directory Interface) ツリーまたはローカルのアプリケーションコンテキストでデータソースを検索し、データベース接続を要求してデータを取得します。KIE Server にデータソースを設定して、サーバーと、指定したデータベースとの間で適切なデータ交換を行う必要があります。

  10. KIE Server Properties ConfigurationCustomize KIE Server properties を選択した場合は、以下のいずれかを変更します。

    • KIE Server ID: KIE Server プロパティーの名前
    • Controller URL: ヘッドレス Process Automation Manager コントローラーの URL
    • 無効にする KIE Server 機能の選択を解除します。
  11. Next をクリックして、ランタイム環境を設定します。
  12. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。
  13. オプションで、Generate Installation Script and Properties File をクリックして、XML ファイルでインストールデータを保存し、Done をクリックします。

    インストーラーは、今後のインストールを自動化する auto.xml ファイルと、ユーザーのパスワードと他の機密情報に関連する変数を保存する auto.xml.variables ファイルの 2 つのファイルを生成します。複数のシステムで auto.xml ファイルを使用して、元のインストールと同じ設定の同じタイプのサーバーに、Red Hat Process Automation Manager を簡単に繰り返しインストールできます。必要に応じて、auto.xml ファイルの installpath パラメーターを更新してください。XML ファイルでインストールを行うには、以下のコマンドを入力します。

    java -jar rhpam-installer-7.7.0.jar <path-to-auto.xml-file>

これで、インストーラーを使用して Red Hat Process Automation Manager がインストールできました。Business Central だけをインストールした場合は、この手順を繰り返して、別のサーバーに KIE Server をインストールします。

注記

Microsoft SQL Server を使用する場合は、データベースに適した正しいトランザクションの分離を設定されていることを確認してください。設定されていない場合には、デッドロックが発生する可能性があります。推奨の設定は、以下のステートメントを入力して、ALLOW_SNAPSHOT_ISOLATION と READ_COMMITTED_SNAPSHOT を ON にします。

ALTER DATABASE <DBNAME> SET ALLOW_SNAPSHOT_ISOLATION ON
ALTER DATABASE <DBNAME> SET READ_COMMITTED_SNAPSHOT ON

4.2. CLI モードでのインストーラーの使用

コマンドラインインターフェース (CLI) を使用して Red Hat Process Automation Manager インストーラーを実行できます。

注記

セキュリティー上の理由で、root 以外のユーザーでインストーラーを実行する必要があります。

前提条件

  • サポート対象の JDK がインストールされている。サポート対象の JDK の一覧については、「Red Hat Process Automation Manager 7 Supported Configurations」を参照してください。
  • バックアップ済みの Red Hat JBoss EAP 7.2 のサーバーインストールが利用できる。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。
  • $PATH 環境変数に含まれている JAR バイナリー。Red Hat Enterprise Linux では、java-$JAVA_VERSION-openjdk-devel パッケージに含まれています。

    注記

    Red Hat Process Automation Manager は、UTF-8 エンコーディングで機能するように設計されています。基礎となる JVM で別のエンコーディングシステムを使用すると、予期せぬエラーが発生する可能性があります。JVM で UTF-8 を使用するようにするには、"-Dfile.encoding=UTF-8" のシステムプロパティーを使用します。

手順

  1. ターミナルウインドウにおいて、インストーラーファイルをダウンロードしたディレクトリーに移動し、以下のコマンドを入力します。

    java -jar rhpam-installer-7.7.0.jar -console

    コマンドラインの対話プロセスが開始し、使用許諾契約書が表示されます。

    press 1 to continue, 2 to quit, 3 to redisplay.
  2. 使用許諾契約書を読んで 1 を入力し、Enter キーを押して続行します。

    Specify the home directory of one of the following servers:  Red Hat JBoss EAP 7.2 or Red Hat JBoss Web Server 5.2.0
  3. 既存の Red Hat JBoss EAP 7.2 インストールの親ディレクトリーを入力します。

    インストーラーが、指定したインストール場所を確認します。1 を入力して確認し、続行します。

    注記

    Business Central と KIE Server は同じサーバーにインストールできますが、実稼働環境では異なるサーバーにインストールすることが推奨されます。

  4. インストーラーの指示に従って、インストールを完了します。

    注記

    ユーザー名およびパスワードを作成する場合は、指定したユーザー名が既存のロールまたはグループの名前と競合しないようにしてください。たとえば、admin というロールがある場合は、admin という名前のユーザーは作成しないでください。

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

    ユーザー名とパスワードを書き留めておきます。Business Central および KIE Server にアクセスする時に必要になります。

  5. インストールが完了すると、以下のメッセージが表示されます。

    Would you like to generate an automatic installation script and properties file?
  6. y を入力してインストールデータが含まれる XML ファイルを作成します。あるいは、n を入力してインストールを完了します。y を入力すると、XML ファイルのパスを指定するよう求められます。
  7. パスを入力するか、Enter キーを押して提案されたパスを了承します。

    インストーラーは、今後のインストールを自動化する auto.xml ファイルと、ユーザーのパスワードと他の機密情報に関連する変数を保存する auto.xml.variables ファイルの 2 つのファイルを生成します。複数のシステムで auto.xml ファイルを使用して、元のインストールと同じ設定の同じタイプのサーバーに、Red Hat Process Automation Manager を簡単に繰り返しインストールできます。必要に応じて、auto.xml ファイルの installpath パラメーターを更新してください。XML ファイルでインストールを行うには、以下のコマンドを入力します。

    java -jar rhpam-installer-7.7.0.jar <path-to-auto.xml-file>
  8. Business Central のみをインストールした場合は、別のサーバーでこれらのステップを繰り返して KIE Server をインストールします。
注記

Microsoft SQL Server を使用する場合は、データベースに適した正しいトランザクションの分離を設定されていることを確認してください。設定されていない場合には、デッドロックが発生する可能性があります。推奨の設定は、以下のステートメントを入力して、ALLOW_SNAPSHOT_ISOLATION と READ_COMMITTED_SNAPSHOT を ON にします。

ALTER DATABASE <DBNAME> SET ALLOW_SNAPSHOT_ISOLATION ON
ALTER DATABASE <DBNAME> SET READ_COMMITTED_SNAPSHOT ON

4.3. インストーラーでの Process Automation Manager コントローラーを使用する KIE Server の設定

KIE Server は、Process Automation Manager コントローラーで管理することも、非管理モードにすることも可能です。非管理モードの場合は、手動で KIE コンテナー (デプロイメントユニット) を作成および維持する必要があります。管理モードの場合は、Process Automation Manager コントローラーが KIE Server の設定を管理し、ユーザーはコントローラーと対話形式で KIE コンテナーを作成、維持します。

Process Automation Manager コントローラーは Business Central と統合されており、Business Central をインストールする場合は、Business Central の Execution Server ページを使用して Process Automation Manager コントローラーと対話できます。

インストーラーは対話モードまたは CLI モードで使用し、Business Central と KIE Server をインストールして、Process Automation Manager コントローラーで KIE Server を設定します。

注記

Business Central をインストールしない場合は、「10章ヘッドレス Process Automation Manager コントローラーのインストールおよび実行」で Process Automation Manager の使用方法を参照してください。

前提条件

  • バックアップを作成済みの Red Hat JBoss EAP 7.2 サーバーインストールが設定された 2 台のコンピューターが利用できる。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。

手順

  1. 1 台目のコンピューターで、インタラクティブモードまたは CLI モードでインストーラーを実行します。詳細は以下のセクションのいずれかを参照してください。

  2. Component Selection ページで、KIE Server チェックボックスを外します。
  3. Business Central インストールを完了します。
  4. 2 台目のコンピューターで、インタラクティブモードまたは CLI モードでインストーラーを実行します。
  5. Component Selection ページで Business Central チェックボックスを外します。
  6. Configure Runtime Environment ページで Perform Advanced Configuration を選択します。
  7. Customize KIE Server properties を選択し、Next をクリックします。
  8. Business Central のコントローラー URL を入力し、KIE Server に追加のプロパティーを設定します。コントローラー URL は以下の形式を取ります。<HOST:PORT> は 2 台目のコンピューターの Business Central のアドレスに置き換えます。

    <HOST:PORT>/business-central/rest/controller
  9. インストールを完了します。
  10. Process Automation Manager コントローラーが Business Central と統合されていることを確認するには、Business Central の Execution Servers ページに移動して、設定した KIE Server が REMOTE SERVERS に表示されていることを確認します。
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る