12.7.8.2. トランザクションマネージャーの設定
トランザクションマネージャー (TM) は、Web ベースの管理コンソールまたはコマンドライン管理 CLI を使用して設定できます。与えられたコマンドまたはオプションごとに、JBoss EAP 6 を管理対象ドメインとして実行していると想定されます。スタンドアロンサーバーを使用している場合、または別のプロファイルを変更する場合
default、次の方法で手順とコマンドを変更する必要がある場合があります。
例のコマンドに関する注意点
- 管理コンソールの場合、
defaultプロファイルは、コンソールに最初にログインしたときに選択されるプロファイルです。別のプロファイルでトランザクションマネージャーの設定を変更する必要がある場合は、代わりにプロファイルを選択してくださいdefault、各命令で。同様に、プロファイルをdefaultサンプル CLI コマンドのプロファイル。 - スタンドアロンサーバーを使用する場合、プロファイルは 1 つだけ存在します。特定のプロファイルを選択するための指示は無視してください。CLI コマンドで、
/profile=defaultサンプルコマンドの一部。
注記
TM オプションを管理コンソールまたは管理 CLI に表示するには、
transactionsサブシステムを有効にする必要があります。これはデフォルトで有効になっており、他の多くのサブシステムが正しく機能するために必要であるため、無効になる可能性はほとんどありません。
管理コンソールを使用した TM の設定
Web ベースの管理コンソールを使用して TM を設定するには、画面上部の 設定 タブを選択します。管理対象ドメインを使用している場合は、左上の プロファイル 選択ボックスから正しいプロファイルを選択してください。コンテナー メニューを展開し、トランザクション を選択します。
ほとんどのオプションは、トランザクションマネージャーの設定ページに表示されます。リカバリ オプションはデフォルトで非表示になっています。リカバリ タブをクリックして、リカバリオプションを確認します。編集 をクリックして、オプションを編集します。変更は直ちに反映されます。
ヘルプが必要ですか? をクリックします。インラインヘルプテキストを表示するためのラベル。
管理 CLI を使用した TM の設定
管理 CLI では、一連のコマンドを使用して TM を設定できます。コマンドはすべてで始まります/profile=default/subsystem=transactions/プロファイル付きの管理対象ドメインの場合default、また/subsystem=transactionsスタンドアロンサーバーの場合。
重要
トランザクションサブシステムがトランザクションログのストレージタイプとして hornetq ジャーナルを使用するように設定されている場合、JBoss EAP の 2 つのインスタンスがジャーナルの保存に同じディレクトリーを使用することは許可されていません。アプリケーションサーバーインスタンスは同じ場所を共有することはできず、アプリケーションサーバーインスタンスごとに一意な場所を設定する必要があります。
| オプション | 説明 | CLI コマンド |
|---|---|---|
|
統計の有効化 (Enable Statistics）
|
トランザクション統計を有効にするかどうか。これらの統計は、ランタイム タブの サブシステムメトリック セクションの管理コンソールで表示できます。
| /profile=default/subsystem=transactions/:write-attribute(name=enable-statistics,value=true)
|
|
Enable TSM Status
|
アウトオブプロセスのリカバリーに使用される TSM (トランザクションステータスマネージャー) サービスを有効にするかどうか。アウトオブプロセスリカバリマネージャーを実行して、別のプロセスから ActionStatusService に接続することはサポートされていません (通常はメモリー内で接続されます)。
|
この設定オプションはサポートされていません。
|
|
デフォルトのタイムアウト (Default Timeout)
|
デフォルトのトランザクションタイムアウトです。デフォルトでは
300 秒に設定されています。トランザクションごとにプログラムで上書きできます。
| /profile=default/subsystem=transactions/:write-attribute(name=default-timeout,value=300)
|
|
オブジェクトストアパス (Object Store Path)
|
TM オブジェクトストアがデータを格納する相対または絶対ファイルシステムパス。デフォルトでは、
object-store-relative-toパラメーターの値。
| /profile=default/subsystem=transactions/:write-attribute(name=object-store-path,value=tx-object-store)
|
|
オブジェクトストアパスに相対的 (Object Store Path Relative To)
|
ドメインモデルのグローバルなパス設定を参照します。デフォルト値は、JBoss EAP 6 のデータディレクトリーで、
jboss.server.data.dir プロパティーの値です。デフォルトは、管理対象ドメインの場合は EAP_HOME/domain/data/、スタンドアロンサーバーインスタンスの場合は EAP_HOME/standalone/data/ です。オブジェクトストアの値object-store-pathTM 属性は、このパスに関連しています。
| /profile=default/subsystem=transactions/:write-attribute(name=object-store-relative-to,value=jboss.server.data.dir)
|
|
ソケットバインディング
|
ソケットベースのメカニズムが使用されている場合に、トランザクションマネージャーが回復およびトランザクション ID の生成に使用するソケットバインディングの名前を指定します。参照する
process-id-socket-max-ports一意の識別子の生成の詳細については。ソケットバインディングは、管理コンソールの サーバー タブでサーバーグループごとに指定されます。
| /profile=default/subsystem=transactions/:write-attribute(name=socket-binding,value=txn-recovery-environment)
|
|
Status Socket Binding
|
トランザクションステータスマネージャーに使用するソケットバインディングを指定します。
|
この設定オプションはサポートされていません。
|
|
リカバリーリスナー (Recovery Listener)
|
トランザクションリカバリーのプロセスがネットワークソケットをリッスンするかどうかを指定します。デフォルトは
false です。
| /profile=default/subsystem=transactions/:write-attribute(name=recovery-listener,value=false)
|
次のオプションは高度な使用を目的としており、管理 CLI を使用してのみ変更できます。デフォルト設定から変更する場合は注意が必要です。詳細は Red Hat グローバルサポートサービスまでお問い合わせください。
| オプション | 説明 | CLI コマンド |
|---|---|---|
|
jts
|
Java Transaction Service (JTS) トランザクションを使用するかどうかを指定します。デフォルト値は
false で、JTA トランザクションのみを使用します。
| /profile=default/subsystem=transactions/:write-attribute(name=jts,value=false)
|
|
node-identifier
|
トランザクションマネージャーのノード識別子。このオプションは以下の場合に必要になります。
node-identifier は一意である必要があります。複数のノードが同じリソースマネージャーと対話したり、トランザクションオブジェクトストアを共有したりするため、node-identifier は JTA に対しても一意である必要があります。
| /profile=default/subsystem=transactions/:write-attribute(name=node-identifier,value=1)
|
|
process-id-socket-max-ports
|
トランザクションマネージャーは、各トランザクションログに対し一意の識別子を作成します。一意の識別子を生成するメカニズムは 2 種類あります。 ソケットベースのメカニズムとプロセスのプロセス識別子をベースにしたメカニズムです。
ソケットベースの識別子の場合、あるソケットを開くと、そのポート番号が識別子に使用されます。ポートがすでに使用されている場合は、空きのポートが見つかるまで次のポートがプローブされます。The
process-id-socket-max-portsTM が失敗する前に試行するソケットの最大数を表します。デフォルト値は 10 です。
| /profile=default/subsystem=transactions/:write-attribute(name=process-id-socket-max-ports,value=10)
|
|
process-id-uuid
| true に設定すると、プロセス識別子を使用して各トランザクションに一意の識別子が作成されます。そうでない場合は、ソケットベースのメカニズムが使用されます。デフォルトは true です。詳細は、process-id-socket-max-ports を参照してください。有効にするprocess-id-socket-binding、設定process-id-uuidにfalse。
| /profile=default/subsystem=transactions/:write-attribute(name=process-id-uuid,value=true)
|
|
process-id-socket-binding
|
トランザクションマネージャーがソケットベースのプロセス id を使用する必要がある場合に使用するソケットバインディング設定の名前。になります
undefinedもしもprocess-id-uuidはtrue;それ以外の場合は設定する必要があります。
| /profile=default/subsystem=transactions/:write-attribute(name=process-id-socket-binding,value=true)
|
|
use-hornetq-store
|
トランザクションログには、ファイルベースのストレージではなく、HornetQ のジャーナルストレージメカニズムを使用します。デフォルトでは無効になっていますが、I/O パフォーマンスが改善されます。別々のトランザクションマネージャーで JTS トランザクションを使用することは推奨されません。このオプションの変更を反映するには shutdown コマンドを使用してサーバーを再起動する必要があります。
| /profile=default/subsystem=transactions/:write-attribute(name=use-hornetq-store,value=false)
|
