forge-bot/acquire-core-x
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
acquire-core-x/README.md
forge-bot e6e29e6b5d Phase 1: 실동작 Enduro/X + PostgreSQL XA 매입 슬라이스 
- Enduro/X 7.0.12 소스빌드 이미지(-DENABLE_POSTGRES=ON, libndrxxaecpg XA 스위치)
- docker-compose: postgres(max_prepared_transactions=100) + endurox app
- ECPG XA 서비스 3종: ACQUIRE→RECONCILE→SETTLE (tpservice + EXEC SQL)
- 클라이언트 tpbegin/tpcall체인/tpcommit → tmsrv 2PC(prepare/commit) 원자 커밋
- 검증: 서비스 AVAIL, 커밋 row(status=S) psql 확인, 롤백 시 무잔존, pg_prepared_xacts=0
- 규명된 런타임 요건: sysctl fs.mqueue.*, ulimit msgqueue/nofile, XA open-str JSON
- docs/architecture.md, README, service-catalog 설계

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-19 09:16:12 +00:00

2.6 KiB
Raw Blame History

acquire-core-x — 카드 매입·정산 시스템 (실동작 Enduro/X)

실제 Enduro/X(오픈소스 Tuxedo/ATMI TP 모니터) + ECPG/PostgreSQL 위에서 실제로 기동·트랜잭션 처리되는 카드 매입·정산 레거시 시스템. 포지(Klaro Forge) 자율 마이그레이션 도구의 대형 전환 대상 픽스처 — 이 C/ATMI 시스템을 Java Spring Boot로 전환한다.

앞서의 acquire-core-full(자체 TxCore 셔임, 컴파일만 되는 픽스처)과 달리, 이 프로젝트는 진짜 TP 미들웨어에서 tpcall·XA 트랜잭션이 실제로 동작한다. (사용자 요구 = B방식)

스택

계층 실체
TP 모니터 Enduro/X 7.0.12 (오픈 Tuxedo/ATMI: tpservice/tpcall/tpadvertise/tpbegin) — 소스빌드
전문 버퍼 UBF (≈FML32): Bget/Bchg, 필드테이블 mkfldhdr
DB 접근 ECPG (EXEC SQL) → PostgreSQL 15
분산 트랜잭션 XA 2PC — libndrxxaecpg.so ECPG XA 스위치, tmsrv가 조율
오케스트레이션 ndrxd + ndrxconfig.xml + app.ini(CCONFIG)

실행 (docker-compose)

docker compose -f docker/docker-compose.yml up -d --build   # postgres + endurox app

필수 런타임 요건 (없으면 ndrxd 부팅 실패 — 실측으로 규명됨)

POSIX 큐/세마포어 한도 때문에 app 컨테이너에 반드시 필요:

sysctls:
  fs.mqueue.msg_max:     "512"
  fs.mqueue.msgsize_max: "65536"
ulimits:
  msgqueue: 536870912      # 큐 1개 = msg_max×msgsize_max ≈ 5.6MB, 기본 RLIMIT_MSGQUEUE(800KB) 초과
  nofile:   65536

PostgreSQL는 XA(2단계 커밋) 위해 -c max_prepared_transactions=100.

구성

  • docker/ — endurox.Dockerfile(Enduro/X 소스빌드, -DENABLE_POSTGRES=ON), docker-compose.yml
  • db/ — schema.sql(merchant/purchase/approval/settlement/ledger …)
  • app/ — conf/(ndrxconfig.xml, app.ini, 환경), ubftab/(UBF 필드테이블), 서비스 .pgc/.c, entrypoint.sh
  • docs/ — architecture.md, service-catalog.md
  • ref/ — Enduro/X upstream PostgreSQL 통합테스트(참고용, .gitignore)
  • slice/ — 최초 검증용 non-DB ATMI 슬라이스(부팅+tpcall 증명 완료)

검증 상태

  • Enduro/X 소스빌드 (PostgreSQL XA 포함) → 이미지 acquire-x/endurox:7.0.12
  • ndrxd 부팅 (10 프로세스 runok)
  • 커스텀 tpservice advertise + 실제 tpcall 왕복 (ACQUIRE: fee=2500 net=997500)
  • ECPG XA 서비스 체인(매입→대사→정산) + 커밋 row psql 검증 + 롤백 검증 ✅
  • 2000본+ 확장 (Phase 2)
  • 포지 마이그레이션 → Spring Boot (Phase 3)