36.2. JDBC Web Server データソースの設定

手順

1. 以下の手順を実行して、データベースを準備します。

   1. TEMP_DIR などの一時ディレクトリーに rhpam-7.12.0-add-ons.zip を展開します。
   2. TEMP_DIR/rhpam-7.12.0-migration-tool.zip を展開します。
   3. 現在のディレクトリーから、TEMP_DIR/rhpam-7.12.0-migration-tool/ddl-scripts ディレクトリーに移動します。このディレクトリーには、複数のデータベースタイプの DDL スクリプトが含まれています。

   4. 使用するデータベースに、お使いのデータベースタイプの DDL スクリプトをインポートします。以下に例を示します。

      psql jbpm < /ddl-scripts/postgresql/postgresql-jbpm-schema.sql

      注記

      PostgreSQL または Oracle を Spring Boot と併用する場合は、対応する Spring Boot の DDL スクリプト (/ddl-scripts/oracle/oracle-springboot-jbpm-schema.sql または /ddl-scripts/postgresql/postgresql-springboot-jbpm-schema.sql) をインポートする必要があります。

2. rhpam-7.12.0-maven-repository.zip のオフライン Maven リポジトリーファイルを展開します。

3. 展開したオフラインの Maven リポジトリーから JWS_HOME/tomcat/lib ディレクトリーにコピーします。VERSION は対象のライブラリーのバージョンに置き換えます。

   org/jboss/spec/javax/transaction/jboss-transaction-api_1.2_spec/{VERSION}/jboss-transaction-api_1.2_spec-{VERSION}.jar
   org/jboss/integration/narayana-tomcat/{VERSION}/narayana-tomcat-{VERSION}.jar
   org/jboss/narayana/jta/narayana-jta/{VERSION}/narayana-jta-{VERSION}.jar
   org/jboss/jboss-transaction-spi/{VERSION}/jboss-transaction-spi-{VERSION}.jar

4. データベースの JDBC ドライバーを JWS_HOME/tomcat/lib ディレクトリーにコピーします。

5. JWS_HOME/tomcat/conf/context.xml ファイルで、プーリングしている XA データソースを設定します。

   注記

   以下の例のプロパティーで、お使いのデータベースサーバーに該当しない場合があります。JDBC ドライバーのドキュメントを参照して、どのプロパティーを設定するかを判断してください。

   1. プーリング機能なしで XA データソースを設定します。この XA データソースは、対象のデータベースに新規接続を作成するときに使用します。以下の例では、XA データソースは xads で、変数は 表36.1「XA データソースの変数」 に定義されています。

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      auth="Container"
      databaseName="${datasource.dbName}"
      description="XA Data Source"
      factory="org.apache.tomcat.jdbc.naming.GenericNamingResourcesFactory" loginTimeout="0"
      name="xads"
      uniqueName="xads"
      portNumber="${datasource.port}"
      serverName="${datasource.hostname}"
      testOnBorrow="false"
      type="${datasource.class}"
      url="${datasource.url}"
      URL="${datasource.url}"
      user="${datasource.username}"
      password="${datasource.password}"
      driverType="4"
      schema="${datasource.schema}"
      />
      </Context>

      表36.1 XA データソースの変数

      変数	説明
      <datasource.dbName>	データベース名。
      <datasource.port>	データベースのポート番号。
      <datasource.hostname>	データベースホスト名。
      <datasource.class>	JDBC ドライバーの XADataSource クラス。
      <datasource.url>	JDBC データベース接続の URL。データベースによって、URL プロパティーが url、または URL (H2 データベースなど) になります。
      <datasource.username>	データベース接続のユーザー名。
      <datasource.password>	データベース接続のパスワード。
      <datasource.schema>	データベーススキーマ。

   2. 新規接続の作成時に XA データソースに依存するプーリングデータソースを設定します。以下の例では、データソースは poolingXaDs で、<datasource.username> はデータベース接続のユーザー名、<datasource.password> はデータベース接続のパスワードどなっています。

      <?xml version="1.0" encoding="UTF-8"?>
      <Context>
      <Resource
      name="poolingXaDs"
      uniqueName="poolingXaDs"
      auth="Container"
      description="Pooling XA Data Source" factory="org.jboss.narayana.tomcat.jta.TransactionalDataSourceFactory" testOnBorrow="true"
      transactionManager="TransactionManager" transactionSynchronizationRegistry="TransactionSynchronizationRegistry" type="javax.sql.XADataSource"
      username="${datasource.username}"
      password="${datasource.password}"
      xaDataSource="xads"
      />
      </Context>

      データソースが java:comp/env/poolingXaDs の JNDI 名で取得でき、次の手順に記載されているように、org.kie.server.persistence.ds システムプロパティーを使用して KIE Server に渡すことができます。

      注記

      プーリングのデータソース設定は、特に TransactionManager や TransactionSynchronizationRegistry など、kie-server アプリケーションの context.xml ファイルで以前に設定された追加リソースに依存します。

6. KIE Server をがデータソースを使用するように設定します。

   1. テキストエディターで以下のスクリプトのいずれかを開きます。

      注記

      setenv.sh スクリプトまたは setenv.bat スクリプトはすでに存在しているはずです。存在していない場合は作成してください。

      • Linux または Unix の場合:

        JWS_HOME/tomcat/bin/setenv.sh

      • Windows の場合:

        JWS_HOME/tomcat/bin/setenv.bat

   2. 以下のプロパティーを CATALINA_OPS に追加します。<hibernate.dialect> はお使いのデータベースの Hibernate 方言に置き換えます。

      CATALINA_OPTS="-Xmx1024m
      -Dorg.jboss.logging.provider=jdk
      -Dorg.kie.server.persistence.ds=java:comp/env/poolingXaDs
      -Dorg.kie.server.persistence.tm=JBossTS
      -Dorg.kie.server.persistence.dialect=${<hibernate.dialect>}"