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

本セクションでは、インストール JAR ファイルを使用して Process Server およびヘッドレス Process Automation Manager コントローラーをインストールする方法を説明します。JAR ファイルは、既存の Red Hat JBoss EAP 7.1 サーバーインストール環境に 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.1 Deployable for Red Hat JBoss EAP 7.1 ファイルをダウンロードし、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.1 サーバーインストールに Red Hat Process Automation Manager をインストールできます。

注記

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

前提条件

  • バックアップを作成してある Red Hat JBoss EAP 7.1 以降のサーバーインストールが利用できる。
  • インストールを完了するのに必要なユーザーパーミッションが付与されている。
  • $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.1.0.jar
    注記

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

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

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

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

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

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

    注記

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

  5. ユーザーを作成して Next をクリックします。デフォルトでは、新規ユーザーに admin ロール、kie-server ロール、および rest-all ロールが付与されます。別のロールを選択する場合は、admin ロールを外します。詳細は、2章ロールおよびユーザー を参照してください。

    注記

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

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

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

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

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

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

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

  10. Customize Process Server settings を選択した場合には、必要に応じて以下のいずれかを変更します。

    • Process Server プロパティーの名前を変更します。
    • ヘッドレス Process Automation Manager コントローラーの URL を変更します。
    • Process Server のサーバーオプションの選択を解除します。
  11. Next をクリックして、ランタイム環境を設定します。
  12. 画面上部に Processing finished が表示されたら、Next をクリックしてインストールを完了します。
  13. 必要であれば、Generate Installation Script and Properties File をクリックしてインストールデータを XML ファイルに保存し、続いて Done をクリックします。このファイルを使用して、同じタイプのサーバーに Red Hat Process Automation Manager を自動的にインストールできます。XML ファイルの installpath パラメーターを変更して、Red Hat Process Automation Manager をインストールする新しいサーバーのパスを指定しなければならない点に注意してください。XML ファイルを使用してインストールを行う場合は、以下のコマンドを実行します。

    java -jar rhpam-installer-7.1.0.jar <path-to-file>

これで、インストーラーを使用して Red Hat Process Automation Manager がインストールできました。Business Central のみをインストールした場合は、別のサーバーでこれらのステップを繰り返して Process Server をインストールします。