19.2. トランザクション管理

トランザクションの管理

トランザクションの属性を表示します。

JNDI 名、EIS 製品名およびバージョン、ステータスなどのトランザクションに関する情報を表示するには、:read-resource CLI コマンドを使用します。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-resource

トランザクションの参加者を表示します。

各トランザクションログには、participants と呼ばれる子要素が含まれます。この要素で read-resource CLI コマンドを使用して、トランザクションの参加者を確認します。参加者は JNDI 名によって識別されます。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=java\:\/JmsXA:read-resource

結果は以下のようになります。

{
   "outcome" => "success",
   "result" => {
       "eis-product-name" => "HornetQ",
       "eis-product-version" => "2.0",
       "jndi-name" => "java:/JmsXA",
       "status" => "HEURISTIC",
       "type" => "/StateManager/AbstractRecord/XAResourceRecord"
   }
}

ここで示された結果は HEURISTIC 状態にあり、リカバリーの対象となります。詳細は、トランザクションをリカバリーします。 を参照してください。

特別な場合では、ログに対応するトランザクションレコードがないオーファンレコード (XAResourceRecords) をオブジェクトストアに作成できます。たとえば、準備済みの XA リソースが TM の記録前にクラッシュし、ドメイン管理 API はアクセス不可能である場合などです。このようなレコードにアクセスするには、管理オプション expose-all-logs を true に設定する必要があります。このオプションは管理モデルには保存されず、サーバーが再起動されると false に戻ります。

/profile=default/subsystem=transactions/log-store=log-store:write-attribute(name=expose-all-logs, value=true)

トランザクションを削除します。

各トランザクションログは、トランザクションを表すトランザクションログを削除するために :delete 操作をサポートします。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:delete

トランザクションをリカバリーします。

各トランザクションの参加者は、:recover CLI コマンドを使用したリカバリーをサポートします。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:recover

ヒューリスティックトランザクションおよび参加者のリカバリー

• トランザクションの状態が HEURISTIC の場合、リカバリー操作は状態を PREPARE に変更し、リカバリーをトリガーします。
• トランザクションの参加者の 1 つがヒューリスティックな場合、リカバリー操作は commit 操作を再生しようとします。成功すると、参加者はトランザクションログから削除されます。これを確認するには、:probe で log-store 操作を再実行し、参加者がリストされていないことを確認します。最後の参加者が削除されると、トランザクションも削除されます。

リカバリーが必要なトランザクションの状態を更新します。

トランザクションをリカバリーする必要がある場合は、リカバリーを試行する前に :refresh CLI コマンドを使用してリカバリーが必要なことを確認できます。

/profile=default/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9/participants=2:refresh