3.2.2. 汎用デプロイ可能パッケージのインストール

汎用デプロイ可能パッケージをインストールするには、基盤のプラットフォーム (Red Hat JBoss WS) をインストールした後に以下を設定する必要があります。
バグを報告する

3.2.2.1. Red Hat JBoss Web Server 2.0 (Tomcat 7) へのトランザクションマネージャーの設定

  1. Red Hat Customer Portal からダウンロードした汎用デプロイ可能 zip パッケージを展開します。この zip パッケージには、jboss-bpms-engine.zip と jboss-bpms-manager.zip の 2 つの zip ファイルが含まれています。
  2. jboss-bpms-manager.zip ファイルの内容を一時的な場所に展開します。この zip ファイルには、business-central.war と dashbuilder.war (展開後の形式) の 2 つの web アプリケーションが含まれ、これらのアプリケーションが一時的な場所に置かれます。これらのフォルダーの名前から .war 拡張子を削除し、名前を変更します。
    これらのフォルダーを、$TOMCAT_DIR/webapps フォルダー直下にコピーします。
    これにより、$TOMCAT_DIR/webapps/business-central と $TOMCAT_DIR/webapps/dashbuilder の 2 つの展開された形式のフォルダーが存在するようになります。

    注記

    $TOMCAT_DIR は、ご使用の web サーバーがあるホームディレクトリーを意味します。web サーバーのホームディレクトリーへの実際のパスに置き換えてください (例: /home/john/jboss-ews-2.0/tomcat7/)。
  3. jboss-bpms-engine.zip アーカイブの jboss-bpms-engine フォルダーを、必要なライブラリーをコピーできる一時的な場所に展開します。展開後、展開されたフォルダーと lib フォルダー下にすべてのコア BPMS ライブラリーが含まれるようになります。
  4. トランザクションマネージャーをインストールします。
    jboss-bpms-engine ライブラリーを $TOMCAT_DIR/lib/ ディレクトリーに展開した lib フォルダーより、以下のトランザクションマネージャー jar ライブラリーをコピーします。
    • btm-VERSION.jar
    • btm-tomcat55-lifecycle-VERSION.jar
    • jta-VERSION.jar
    • slf4j-api-VERSION.jar
    • slf4j-ext-VERSION.jar
    さらに、以下のライブラリーをダウンロードし、$TOMCAT_DIR/lib/ フォルダーにコピーします。
  5. ドライバーをご使用のデータベースにインストールします。適切なデータベースドライバーを持つ jar ファイルを $TOMCAT_DIR/lib/ にコピーします。

    注記

    組み込みの H2 データベースを使用している場合は、ドライバーは business-central/WEB-INF/lib/ にあります。
  6. トランザクションマネージャー設定ファイルを $TOMCAT_DIR/conf/ に作成します。
    • btm-config.properties 
      bitronix.tm.serverId=tomcat-btm-node0
bitronix.tm.journal.disk.logPart1Filename=${btm.root}/work/btm1.tlog
bitronix.tm.journal.disk.logPart2Filename=${btm.root}/work/btm2.tlog
bitronix.tm.resource.configuration=${btm.root}/conf/resources.properties
    • resources.properties (resource.ds1.uniqueName defines は後に tomcat リソース定義で使用されるデータソース名を定義します - この値を覚えておいてください)
      ご使用の環境に合わせるため、以下の定義の値を変更してください。

      例3.2 H2 データソース定義

      resource.ds1.className=bitronix.tm.resource.jdbc.lrc.LrcXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=10
resource.ds1.maxPoolSize=20
resource.ds1.driverProperties.driverClassName=org.h2.Driver
resource.ds1.driverProperties.url=jdbc:h2:file:~/jbpm
resource.ds1.driverProperties.user=sa
resource.ds1.driverProperties.password=
resource.ds1.allowLocalTransactions=true

      例3.3 MySQL 5.5 データソース定義

      resource.ds1.className=com.mysql.jdbc.jdbc2.optional.MysqlXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:mysql://localhost:3306/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      例3.4 DB2 タイプ 4 のデータソース定義

      resource.ds1.className=com.ibm.db2.jcc.DB2Driver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:db2://localhost:50000/sampledb
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      例3.5 Oracle のデータソース定義

      resource.ds1.className=oracle.jdbc.xa.client.OracleXADataSource
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:oracle:thin:@//localhost:1521/bpms 
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true

      例3.6 Microsoft SQL サーバーのデータソース定義

      resource.ds1.className=com.microsoft.sqlserver.jdbc.SQLServerDriver
resource.ds1.uniqueName=jdbc/jbpm
resource.ds1.minPoolSize=0
resource.ds1.maxPoolSize=10
resource.ds1.driverProperties.URL=jdbc:sqlserver://localhost:1433;databaseName=bpms;
resource.ds1.driverProperties.user=dbuser
resource.ds1.driverProperties.password=dbpassword
resource.ds1.allowLocalTransactions=true
  7. トランザクションマネージャーリスナーを $TOMCAT_DIR/conf/server.xml で設定し、コンテナの起動およびシャットダウン時に Bitronix を起動および停止します。
    以下の要素を最後の <Listener> 要素として <Server> 要素に追加します。 
    <Listener className="bitronix.tm.integration.tomcat55.BTMLifecycleListener" />
  8. btm.root システムプロパティーと、bitronix 設定ファイルが置かれる場所を定義します。
    $TOMCAT_DIR/bin/ 内に、以下の内容が含まれる setenv.sh ファイルを作成します。 
    CATALINA_OPTS="-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=$CATALINA_HOME -Dbitronix.tm.configuration=$CATALINA_HOME/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"
    必要な場合はファイルの実行パーミッションを付与します。デザイナーのデフォルトのパースペクティブを Full ではなく RuleFlow にするため、最後のプロパティー org.jbpm.designer.perspective は RuleFlow に設定されます。

    重要

    Microsoft Windows システムでは、ファイル内容の $CATALINA_HOME の値を同等の環境変数名に置き換えるか、以下の例のように絶対パスを使用して setenv.bat に値を追加します。 
    set "CATALINA_OPTS=-Xmx512M -XX:MaxPermSize=512m -Dbtm.root=C:/Tomcat -Dbitronix.tm.configuration=C:/Tomcat/conf/btm-config.properties -Dorg.jbpm.designer.perspective=RuleFlow"
バグを報告する