第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

手順

  1. rhpam-7.0.0-business-central-eap7-deployable.zip ファイルを一時ファイルに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。
  2. 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

手順

  1. rhpam-7.0.0-kie-server-ee7.zip アーカイブを一時ディレクトリーに展開します。以下の例では、このディレクトリーを TEMP_DIR とします。
  2. 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 インスタンスの既存デプロイメントと競合しないことを確認します。

  3. TEMP_DIR/rhpam-7.0.0-kie-server-ee7/rhpam-7.0.0-kie-server-ee7/SecurityPolicy/ の中身を EAP_HOME/bin にコピーします。ファイルの上書きを確認したら、はい を選択します。
  4. 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 をデプロイするすべてのサーバーに設定されている。

手順

  1. テキストエディターで EAP_HOME/standalone/configuration/standalone-full.xml を開き、<system-properties> タグの場所を特定します。
  2. 以下のプロパティーを <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 にログインする前に、ユーザーを作成する必要があります。本セクションでは、adminrest-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) のベースディレクトリーにインストールされている。

手順

  1. ターミナルアプリケーションで EAP_HOME/bin ディレクトリーに移動します。
  2. Business Central へのログインに使用する、admin ロール持つユーザーを作成します。以下のコマンドの <username> および <password> を、作成するユーザーとそのパスワードに置き換えます。

    $ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role admin,rest-all
    注記

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

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

  3. Process Server にログインするのに使用する、kie-server ロールを持つユーザーを作成します。

    $ ./add-user.sh -a --user <USERNAME> --password <PASSWORD> --role kie-server
  4. ユーザー名とパスワードを書き留めておきます。

    注記

    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) にインストールされている。

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

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

手順

  1. 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>"/>
  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>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 に接続します。

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 がインストールされて設定されている。

手順

  1. ターミナルアプリケーションで EAP_HOME/bin に移動します。
  2. スタンドアロン設定を実行します。

    • 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
  3. Web ブラウザーで、URL localhost:8080/business-central を開きます。
  4. 「ユーザーの作成」 の Business Central で作成したユーザーの認証情報を使用してログインします。