트랜잭션 하위 시스템을 사용하면 시간 제한 값, 트랜잭션 로깅, 통계 수집, 자카르타 트랜잭션 사용 여부와 같은 Transaction Manager(TM) 옵션을 구성할 수 있습니다. 트랜잭션 하위 시스템은 다음 네 가지 주요 요소로 구성됩니다.

잘 설계된 트랜잭션의 일반적인 표준은 원자성, 일관성, 격리 및 지속적(ACID)이라는 것입니다.

고유한 노드 식별자를 사용하면 JBoss EAP에서 지정된 노드 식별자만 일치하는 트랜잭션 및 트랜잭션 상태를 복구할 수 있습니다. com.ar bootstrapa.ats.arspringa.nodeIdentifier 속성을 사용하여 노드 식별자를 설정할 수 있습니다.

웹 기반 관리 콘솔 또는 명령줄 관리 CLI를 사용하여 트랜잭션 관리자를 구성할 수 있습니다.

관리 콘솔을 사용하여 트랜잭션 관리자 구성

다음 단계에서는 웹 기반 관리 콘솔을 사용하여 트랜잭션 관리자를 구성하는 방법을 설명합니다.

관리 CLI를 사용하여 트랜잭션 관리자 구성

관리 CLI를 사용하여 일련의 명령을 사용하여 트랜잭션 관리자를 구성할 수 있습니다. 이 명령은 모두 관리형 도메인의 기본 프로필에 대해 독립 실행형 서버에 대해 /subsystem=transactions 또는 /profile=default/subsystem=transactions/ 로 시작합니다.

모든 트랜잭션 관리자 구성 옵션의 자세한 목록은 JBoss EAP의 Transaction Manager 구성 옵션을 참조하십시오.

관리 콘솔, 관리 CLI 또는 시스템 속성을 사용하여 많은 트랜잭션 관리자 옵션을 구성할 수 있습니다. 그러나 다음 옵션은 시스템 속성을 사용하는 경우에만 구성할 수 있습니다. 관리 CLI 또는 관리 콘솔을 사용하여 구성할 수 없습니다.

이 예에서는 standalone.xml 서버 구성 파일에서 이러한 시스템 속성을 구성하는 방법을 보여줍니다.

<system-properties>
    <property name="RecoveryEnvironmentBean.periodicRecoveryPeriod" value="180"/>
    <property name="RecoveryEnvironmentBean.recoveryBackoffPeriod" value="20"/>
    <property name="RecoveryEnvironmentBean.periodicRecoveryInitilizationOffset" value="5"/>
    <property name="RecoveryEnvironmentBean.expiryScanInterval" value="24"/>
</system-properties>

시스템 속성 구성 방법에 대한 자세한 내용은 구성 가이드의 시스템 속성을 참조하십시오.

이 작업은 데이터 소스에서 자카르타 트랜잭션을 활성화하는 방법을 보여줍니다.

사전 요구 사항

자카르타 트랜잭션을 사용하도록 데이터 소스 구성

이제 데이터 소스가 자카르타 트랜잭션을 사용하도록 구성되어 있습니다.

JBoss EAP의 기본 설치에서는 트랜잭션에 대한 ORB(Object Request Broker) 지원이 비활성화됩니다. 관리 CLI 또는 관리 콘솔을 사용하여 iiop-openjdk 하위 시스템에서 ORB 설정을 구성할 수 있습니다.

iiop-openjdk 하위 시스템에서 사용 가능한 구성 옵션 목록은 구성 가이드의 IIOP 하위 시스템 속성 에서 참조하십시오.

관리 CLI를 사용하여 ORB 구성

관리 CLI를 사용하여 ORB의 각 측면을 구성할 수 있습니다. 이는 JTS와 함께 ORB를 사용하는 최소 구성입니다.

full 프로필을 사용하여 관리형 도메인에 대해 다음 관리 CLI 명령을 구성할 수 있습니다. 필요한 경우 구성해야 하는 프로필에 맞게 프로필을 변경합니다. 독립 실행형 서버를 사용하는 경우 명령의 /profile=full 부분을 생략합니다.

보안 인터셉터 활성화

값을 identity 로 설정하여 security 속성을 활성화합니다.

/profile=full/subsystem=iiop-openjdk:write-attribute(name=security,value=identity)

IIOP 하위 시스템에서 트랜잭션 활성화

JTS에 ORB를 사용하려면 트랜잭션 속성 값을 기본 사양이 아닌 full 로 설정합니다.

/profile=full/subsystem=iiop-openjdk:write-attribute(name=transactions, value=full)

Transactions 하위 시스템에서 JTS 활성화

/profile=full/subsystem=transactions:write-attribute(name=jts,value=true)

관리 콘솔을 사용하여 ORB 구성

관리 CLI는 트랜잭션 레코드를 검색하고 조작하는 기능을 지원합니다. 이 기능은 JBoss EAP의 IC 및 관리 API 간의 상호 작용을 통해 제공됩니다.

트랜잭션 관리자는 보류 중인 각 트랜잭션에 대한 정보와 관련된 참가자를 오브젝트 저장소라는 영구 스토리지에 저장합니다. 관리 API는 오브젝트 저장소를 log-store 라는 리소스로 노출합니다. 프로브 작업은 트랜잭션 로그를 읽고 각 레코드의 노드 경로를 생성합니다. 로그 저장소 를 새로 고쳐야 할 때마다 프로브 작업을 수동으로 호출할 수 있습니다. 트랜잭션 로그가 신속하게 표시되고 사라지는 것은 정상입니다.

로그 저장소 새로 고침

다음 명령은 관리형 도메인에서 default 프로필을 사용하는 서버 그룹의 로그 저장소를 새로 고칩니다. 독립 실행형 서버의 경우 명령에서 profile=default 를 제거합니다.

/profile=default/subsystem=transactions/log-store=log-store:probe

준비된 모든 트랜잭션 보기

준비된 모든 트랜잭션을 보려면 먼저 로그 저장소를 새로 고치고 파일 시스템 ls 명령과 유사하게 작동하는 다음 명령을 실행합니다.

ls /profile=default/subsystem=transactions/log-store=log-store/transactions

또는

/host=master/server=server-one/subsystem=transactions/log-store=log-store:read-children-names(child-type=transactions)

각 트랜잭션은 고유 식별자와 함께 표시됩니다. 개별 작업은 개별 트랜잭션에 대해 실행할 수 있습니다. 자세한 내용은 트랜잭션 관리를 참조하십시오.

트랜잭션 속성 보기

Java Naming and Directory Interface 이름, EIS 제품 이름 및 버전 또는 해당 상태와 같은 트랜잭션에 대한 정보를 보려면 read-resource 작업을 사용합니다.

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

트랜잭션 참가자 세부 정보 보기

각 트랜잭션 로그에는 participants 라는 하위 요소가 포함되어 있습니다. 이 요소에서 read-resource 작업을 사용하여 트랜잭션 참여자의 세부 정보를 확인합니다. 참가자는 Java 네이밍 및 디렉터리 인터페이스 이름으로 식별됩니다.

/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" => "ActiveMQ",
       "eis-product-version" => "2.0",
       "jndi-name" => "java:/JmsXA",
       "status" => "HEURISTIC",
       "type" => "/StateManager/AbstractRecord/XAResourceRecord"
   }
}

여기에 표시된 결과 상태는 HEURISTIC 상태이며 복구 대상입니다. 자세한 내용은 트랜잭션 참가자 복구를 참조하십시오.

특별한 경우 로그에 해당 트랜잭션 레코드가 없는 XAResourceRecords인 오브젝트 저장소에서 고립 레코드를 만들 수 있습니다. 예를 들어, XA 리소스가 준비되었지만 기록된 리소스가 충돌하기 전에 충돌했으며 도메인 관리 API에서 액세스할 수 없습니다. 이러한 레코드에 액세스하려면 관리 옵션 expose-all-logs 를 true 로 설정해야 합니다. 이 옵션은 관리 모델에 저장되지 않으며, 서버를 다시 시작할 때 false 로 복원됩니다.

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

이 대체 명령을 사용하면 트랜잭션의 참가자 ID를 집계된 형식으로 표시할 수 있습니다.

/host=master/server=server-one/subsystem=transactions/log-store=log-store/transactions=0\:ffff7f000001\:-b66efc2\:4f9e6f8f\:9:read-children-names(child-type=participants)

트랜잭션 참가자 삭제

각 트랜잭션 로그는 삭제 작업을 지원하여 트랜잭션을 나타내는 트랜잭션 로그를 삭제합니다.

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

그러면 트랜잭션의 모든 참가자도 삭제됩니다.

트랜잭션 참가자 복구

각 트랜잭션 참여자는 복구 작업을 사용하여 복구를 지원합니다.

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

트랜잭션 참가자의 상태가 HEURISTIC 인 경우 복구 작업은 상태를 PREPARE 로 전환하고 주기적인 복구 프로세스에 커밋을 재생합니다.

커밋에 성공하면 참가자가 트랜잭션 로그에서 제거됩니다. 로그 저장소에서 프로브 작업을 실행하고 참가자가 더 이상 나열되지 않는지 확인하여 이를 확인할 수 있습니다. 마지막 참가자인 경우 트랜잭션도 삭제됩니다.

트랜잭션 참가자의 상태 새로 고침

트랜잭션에 복구가 필요한 경우 복구를 시도하기 전에 새로 고침 작업을 사용하여 복구가 필요한지 확인할 수 있습니다.

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

트랜잭션 관리자 통계가 활성화된 경우 트랜잭션 관리자가 처리한 트랜잭션에 대한 통계를 볼 수 있습니다. 트랜잭션 관리자 통계를 활성화하는 방법에 대한 정보는 JBoss EAP 구성 가이드 의 트랜잭션 관리자 구성 섹션을 참조하십시오.

관리 콘솔 또는 관리 CLI를 사용하여 통계를 볼 수 있습니다. 관리 콘솔에서 런타임 탭에서 트랜잭션 하위 시스템으로 이동하여 트랜잭션 통계를 사용할 수 있습니다. 관리 CLI에서 read-resource 작업에 include-runtime=true 를 사용하여 통계를 볼 수 있습니다. 예를 들면 다음과 같습니다.

/subsystem=transactions:read-resource(include-runtime=true)

다음 표는 각 트랜잭션 통계에 대한 관리 콘솔 표시 이름, 관리 CLI 특성 및 설명을 보여줍니다.

트랜잭션에는 오브젝트를 저장할 위치가 필요합니다. 개체 스토리지의 옵션 중 하나는 JDBC 데이터 소스입니다. 성능이 특정 우려인 경우 JDBC 오브젝트 저장소는 파일 시스템 또는 ActiveMQ 저널 오브젝트 저장소보다 느려질 수 있습니다.

JDBC 데이터 소스를 트랜잭션 오브젝트 저장소로 사용

JDBC 데이터 소스를 트랜잭션 오브젝트 저장소로 사용하려면 다음 단계를 따르십시오.

트랜잭션 JDBC 스토어 속성

다음 표는 JDBC 오브젝트 스토리지와 관련된 사용 가능한 모든 특성을 식별합니다.

ActiveMQ 저널 오브젝트 저장소 사용

ActiveMQ 저널 오브젝트 저장소를 사용하려면 다음 단계를 따르십시오.

JBoss EAP의 다른 로깅 설정과는 관계없이 트랜잭션에 대해 기록되는 정보의 양을 제어할 수 있습니다. 관리 콘솔 또는 관리 CLI를 사용하여 로깅 설정을 구성할 수 있습니다.

관리 콘솔을 사용하여 트랜잭션 로거 구성

관리 CLI를 사용하여 트랜잭션 로거 구성

다음 명령을 사용하여 관리 CLI에서 로깅 수준을 설정합니다. 독립 실행형 서버의 경우 명령에서 /profile=default 를 제거합니다.

/profile=default/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=VALUE)

/subsystem=logging/logger=org.jboss.jbossts.txbridge:add(level=ALL)

<logger category="org.jboss.jbossts.txbridge">
  <level name="ALL" />
</logger>

/subsystem=logging/logger=com.arjuna:write-attribute(name=level,value=ALL)

<logger category="com.arjuna">
  <level name="ALL" />
</logger>

// Transaction id
Uid tx = new Uid();
. . . .
TransactionStatusConnectionManager tscm = new TransactionStatusConnectionManager();

// Check if the transaction aborted
assertEquals(tscm.getTransactionStatus(tx), ActionStatus.ABORTED);

$ EAP_HOME/bin/standalone.sh -DRecoveryEnvironmentBean.transactionStatusManagerPort=NETWORK_PORT_NUMBER

/subsystem=transactions:write-attribute(name=enable-statistics,value=true)

public class TxStats
{
    /**
     * @return the number of transactions (top-level and nested) created so far.
     */

    public static int numberOfTransactions();

    /**
     * @return the number of nested (sub) transactions created so far.
     *

     public static int numberOfNestedTransactions();

     /**
     * @return the number of transactions which have terminated with heuristic
     *         outcomes.
     */

    public static int numberOfHeuristics();
    /**
     * @return the number of committed transactions.
     */

    public static int numberOfCommittedTransactions();

    /**
     * @return the total number of transactions which have rolled back.
     */

    public static int numberOfAbortedTransactions();

    /**
     * @return total number of inflight (active) transactions.
     */

    public static int numberOfInflightTransactions ();

    /**
     * @return total number of transactions rolled back due to timeout.
     */

    public static int numberOfTimedOutTransactions ();
    /**
     * @return the number of transactions rolled back by the application.
     */

    public static int numberOfApplicationRollbacks ();

    /**
     * @return number of transactions rolled back by participants.
     */

    public static int numberOfResourceRollbacks ();

    /**
     * Print the current information.
     */

    public static void printStatus(java.io.PrintWriter pw);
}

트랜잭션 시간 제한에는 다음과 같은 여러 이유가 있을 수 있습니다.

다음 오류 메시지에 대한 로그를 확인하여 시간 초과 트랜잭션을 식별할 수 있습니다.

WARN ARJUNA012117 "TransactionReaper::check timeout for TX {0} in state {1}"

여기서 {0} 은(는) 트랜잭션의 Uid이고 {1} 은(는) 트랜잭션 관리자의 타임아웃 트랜잭션 트랜잭션의 {1} 상태 보기입니다.

Transaction Manager는 트랜잭션 시간 제한을 디버깅하기 위해 다음 옵션을 제공합니다.

트랜잭션 관리자의 XTS(XML Transaction Service) 구성 요소는 비즈니스 트랜잭션에서 개인 및 공용 웹 서비스의 조정을 지원합니다. XTS는 JBoss EAP 서버에서 호스팅되는 웹 서비스에 대한 WS-AT 및 WS-BA 지원을 제공합니다. 이는 standalone-xts.xml 구성을 사용하여 활성화할 수 있는 선택적 하위 시스템입니다.

다음 속성을 사용하면 만료된 트랜잭션을 지울 수 있습니다.

모든 scanner 모듈은 Expiry Scanner 인터페이스에서 동일한 동작을 상속받습니다. 이 인터페이스는 다음을 포함하여 모든 scanner 모듈에서 구현한 검사 방법을 제공합니다. 스캐너 스레드는 이 검사 방법을 호출합니다.

트랜잭션 리소스가 분산 트랜잭션을 완료하는 동안 트랜잭션 리소스가 일면 결정을 내릴 때 트랜잭션 업데이트를 커밋하거나 롤백할 때 복구가 수행됩니다. 분산된 데이터는 결정되지 않은 상태로 남을 수 있습니다. 네트워크 오류 또는 리소스 시간 초과는 복구가 완료될 수 있습니다. 추론적 완료로 인해 다음과 같은 복구 결과 예외 중 하나가 발생합니다.

다음 절차에서는 Jakarta 트랜잭션을 사용하여 트랜잭션의 복구 결과를 처리하는 방법을 설명합니다.

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

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