Red Hat Summit3.2.3. JTS および JTA の変更
3.2.3.1. JBoss Transaction Service 設定の移行
概要
これまでのバージョンの JBoss EAP では、JBoss Transaction Service トランザクションマネージャーは以下の XML ファイルのいずれかで設定されていました。
| JBoss EAP バージョン | 設定ファイル名 |
|---|---|
|
4.2
|
jboss-eap-4.2.0/server/default/conf/jbossjta-properties.xml
|
|
4.3
|
jboss-eap-4.3.0/server/default/conf/jbossjta-properties.xml
|
|
5.2
|
jboss-eap-5.2.0/server/default/conf/jbossts-properties.xml
|
JBoss EAP 6 では、トランザクションサービスはサーバー設定ファイルで設定されます。
- JBoss EAP 6 には、ノード識別子のデフォルト値が含まれています。これは、単一のJBoss EAP サーバーインスタンスを実行する場合は問題ありませんが、複数のサーバーインスタンスを実行する場合は変更する必要があります。
- JBoss EAP 6 には、デフォルトで JTA トランザクションが有効になっています。JTS トランザクションを設定するには、追加の手順が必要です。
JTA トランザクションのノード識別子設定の移行
JBoss EAP 6 には、ノード識別子のデフォルト設定値が同梱されます。これは、単一のJBoss EAP サーバーインスタンスを実行する場合は問題ありませんが、ノード識別子はすべての JBoss EAP サーバーインスタンスについて一意でなければならないので、複数のサーバーインスタンスを実行する場合は値を変更する必要があります。
注記
以下の例では、置き換え可能な値 UNIQUE_NODE_ID および UNIQUE_JACORB_ID を使用して、一意のノードおよび JacORB ID を表します。必ず、JBoss EAP サーバーインスタンス全体で一意となる識別子の値に置き換えてください。
JBoss EAP 5 では、以下のプロパティーを使用してノード識別子が
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
jbossts-properties.xml ファイルで設定されていました。
<property name="com.arjuna.ats.arjuna.xa.nodeIdentifier" value=UNIQUE_NODE_ID/>
<property name="com.arjuna.ats.arjuna.xa.nodeIdentifier" value=UNIQUE_NODE_ID/>
JBoss EAP 6 では、ノード識別子は、管理 CLI コマンドを使用してサーバー設定ファイルの
transaction サブシステムで設定されます。使用するコマンドは、管理対象ドメインとスタンドアロンサーバーのどちらを実行しているかによって異なります。
以下は、スタンドアロンサーバーのノード識別子を設定するコマンドの例になります。
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
/system-property=jboss.tx.node.id:add(value=UNIQUE_NODE_ID)
/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
reload
/system-property=jboss.tx.node.id:add(value=UNIQUE_NODE_ID)
/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
reload
以下は、管理対象ドメインのノード識別子を設定する方法の例になります。管理対象ドメインで実行している場合は、ドメインのすべてのホストおよびサーバーについて、一意の識別子で以下のコマンドを繰り返します。
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
/host=master/server-config=server-one/system-property=jboss.tx.node.id:add(boot-time=true,value=UNIQUE_NODE_ID)
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
reload
/host=master/server-config=server-one/system-property=jboss.tx.node.id:add(boot-time=true,value=UNIQUE_NODE_ID)
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
reload
JBoss EAP 6 で JTS トランザクションを有効にするための変更
JBoss EAP 5 では、EAP5_HOME/docs/examples/transactions ディレクトリーにある Ant スクリプトを実行して JTS トランザクションを有効にし、いくつかの手動の手順を実行していました。このスクリプトは、すべての JBoss EAP サーバー設定の jbossts-properties.xml および jacorb.properties ファイルが更新されました。
JBoss EAP 6 では、管理 CLI を使用して JBoss EAP インスタンスおよび JacORB インスタンスを一意に識別します。使用するコマンドは、管理対象ドメインとスタンドアロンサーバーのどちらを実行しているかによって異なります。
以下は、スタンドアロンサーバーの JBoss EAP および JacORB インスタンスを識別するスクリプトの例です。
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
batch
# Create a system property for the unique node identifier
/system-property=jboss.tx.node.id:add(value=UNIQUE_NODE_ID)
/system-property=jacorb.node.id:add(value=UNIQUE_JACORB_ID)
# JacORB properties must be unique for each JBoss server instance
# JacORB name must appear in JacORB context root i.e. ${jacorb.name}/Naming/root
/subsystem=jacorb:write-attribute(name=transactions,value="on")
/subsystem=jacorb:write-attribute(name="name",value="${jacorb.node.id}")
/subsystem=jacorb:write-attribute(name="root-context",value="${jacorb.node.id}/Naming/root")
/subsystem=transactions:write-attribute(name=jts,value=true)
/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
run-batch
reload
batch
# Create a system property for the unique node identifier
/system-property=jboss.tx.node.id:add(value=UNIQUE_NODE_ID)
/system-property=jacorb.node.id:add(value=UNIQUE_JACORB_ID)
# JacORB properties must be unique for each JBoss server instance
# JacORB name must appear in JacORB context root i.e. ${jacorb.name}/Naming/root
/subsystem=jacorb:write-attribute(name=transactions,value="on")
/subsystem=jacorb:write-attribute(name="name",value="${jacorb.node.id}")
/subsystem=jacorb:write-attribute(name="root-context",value="${jacorb.node.id}/Naming/root")
/subsystem=transactions:write-attribute(name=jts,value=true)
/subsystem=transactions:write-attribute(name=node-identifier,value="${jboss.tx.node.id}")
run-batch
reload
以下は、管理対象ドメインの JBoss EAP および JacORB インスタンスを識別するスクリプトの例です。管理対象ドメインで実行している場合は、設定のプロファイルごとに以下のスクリプトを実行する必要があります。
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
batch
#
# Define global system properties for the node identifier and JacORB implementation name.
#
/system-property=jboss.tx.node.id/:add(value="11",boot-time="true")
/system-property=jacorb.node.id:add(value="mars",boot-time="true")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="security",value="on")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="transactions",value="on")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="name",value="${jacorb.node.id}")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="root-context",value="${jacorb.node.id}/Naming/root")
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name="jts",value="true")
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name="node-identifier",value="${jboss.tx.node.id:1}")
run-batch
reload --host=master
batch
#
# Define global system properties for the node identifier and JacORB implementation name.
#
/system-property=jboss.tx.node.id/:add(value="11",boot-time="true")
/system-property=jacorb.node.id:add(value="mars",boot-time="true")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="security",value="on")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="transactions",value="on")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="name",value="${jacorb.node.id}")
/profile=PROFILE_NAME/subsystem=jacorb:write-attribute(name="root-context",value="${jacorb.node.id}/Naming/root")
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name="jts",value="true")
/profile=PROFILE_NAME/subsystem=transactions:write-attribute(name="node-identifier",value="${jboss.tx.node.id:1}")
run-batch
reload --host=master
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}