이 페이지만모든 페이지
1 / 88

ProSync 4.7

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

데이터 암호화

ProSync는 Extract 프로세스에서 Apply 프로세스로 데이터를 전송할 때 보안을 위한 데이터 암호화를 사용할 수 있다.

AES-256-CBC 암호화를 사용하며 Redo(Archive)log 에서 추출한 변경 데이터에 대한 암호화만을 제공한다.

ENABLE_NETWORK_ENCRYPT=[Y|N]

파라미터
설명

해당 파라미터를 Y로 설정하는 경우 데이터 암호화 및 복호화 과정이 추가되므로 동기화 성능에 영향을 미칠 수 있다.

ENABLE_NETWORK_ENCRYPT

전송하는 Chunk의 암호화 여부를 결정한다

사용

제품 소개

Change Data Capture(이하 CDC)는 변경된 데이터를 peer 측 서버로 전달해주는 기능을 하는 소프트웨어를 의미한다. 데이터에는 정형 데이터, 반정형 데이터 혹은 비정형 데이터를 모두 포함한다.

일반적인 Migration 솔루션과는 다르게 CDC는 변경 부분에 대해서만 전달함으로써 처리량이 적어 Throughput 등에 있어서 큰 이점을 얻을 수 있다.


ProSync는 TmaxTibero의 CDC 솔루션이다. 현재 제공되는 데이터 타입은 정형 데이터, 즉 RDBMS에 대한 동기화만을 제공하고 있으며 실시간성이 높고, 이력 관리를 통한 장애 복구나 ProSync Manager를 통한 정합성 검사 등의 기능을 제공하고 있다.

Change Data Capture

참고

정형 데이터는 보통 RDBMS에 저장되는 테이블을 의미하는 경우가 많으며, 반정형 데이터는 Json이나 XML 혹은 NoSQL 기반의 데이터들을 의미한다.

비정형 데이터는 따로 형식이 없는 모든 타입의 데이터를 의미하며, 이는 모든 파일과 디렉토리들을 포함한다.

ProSync

참고

제품 설계에 대한 상세한 내용은 에서 확인할 수 있다. ​

'제품 설계'

하드웨어 요구사항

ProSync는 On-Line 으로 운영되는 프로그램으로 혹시 모를 중단이나 비정상 종료가 발생하면 안 된다. 이 때문에 프로그램 사용자는 하드웨어 요구사항에 대해서 어느 정도 이해하고 있는 것이 좋다.

본 장에서는 CPU와 Memory 그리고 Disk 요구사항을 차례대로 살펴볼 것이다. 기본 값으로 사용해도 동기화하는 데에는 문제가 없지만, CPU나 Memory가 어떤 부분에서 많이 사용되는지, Disk는 어느 정도 사용하는지 등에 대해 대략적인 정보를 정리한다.

ProSync 소개

ProSync 제품 소개 및 설계 내용을 안내한다.

운영 가이드

PostgreSQL 제약사항

ProSync가 지원하는 데이터베이스 중 PostgreSQL 관련 제약사항을 설명한다.

postgres 언어 설정 필요

영어 또는 한국어로 설정한다.

libpq 라이브러리 설정 필요

libpq 라이브러리 관련 패치들이 모두 반영되지 않아 다음 중 하나를 적용하여 우회해야 한다.

  • SCRAM-SHA-256 인증을 지원하도록 수동 빌드한 libpq 사용

  • SCRAM-SHA-256 인증을 지원하는 최신 libpq 라이브러리 사용

  • SCRAM-SHA-256 인증을 사용하지 않도록 postgresql.conf의 password_encryption을 md5로 변경한 뒤 ProSync 재설치

numeric 타입 길이 제약

길이 65532 이상 numeric data의 경우 에러로그 출력 후 skip 처리한다.

PR 미지원

설치 시, apply config파일에 REPLAY_THREAD_CNT=1 파라미터가 추가된다.

영어소문자와 숫자만 사용 가능하다.

postgresql의 제약사항으로 인해 문자열은 null 이후 종료된다.

PostgreSQL의 object는 기본적으로 소문자로 생성되기 때문에, MAP 파라미터 사용 또는 "TABLE_NAME" 과 같이 "를 사용하여 명시적으로 대문자 테이블 생성이 필요하다.

PostgreSQL의 제한(한 row의 최대 크기는 1GB)과 ProSync 동기화 방식의 제약사항으로 인해 BYTEA 컬럼에 대해서는 500MB - 2 바이트(postgresql에서 붙이는 접두사 \x)까지 동기화 가능하다.

데이터베이스 호환성

ProSync가 지원하는 데이터베이스 및 항목을 설명한다.

지원 Database

Source Database

  • Tibero (Single/TAC/TAS/TSC) 6 이상

  • Oracle 11g

  • Oracle 12c

  • Oracle 19c

  • PostgreSQL 15

  • PostgreSQL 16

  • Tibero

  • Oracle 11g

  • Oracle 12c

  • Oracle 19c

  • PostgreSQL 15


트랜잭션 단위의 동기화를 지원한다.

테이블에 대한 INSERT, UPDATE, DELETE 작업을 동기화한다.

아래 대상은 동기화를 지원하지 않는다.

  • 실체화 뷰(Materialized View)

  • Clustered Table

  • Indexed Organized Table(IOT) (Source DB가 Oracle인 경우)

  • 대상 테이블에 Interval Partitioning이 적용된 경우, DB가 동적으로 생성한 Partition에 포함된 데이터는 동기화되지 않을 수 있다.

을 참고한다.

DDL 동기화는 DB 단위로 지원한다.

지원 컬럼 타입은 사용하는 DB에 따라 다르므로, 을 참고하여 DB별 지원 컬럼 타입 및 매핑 정보를 확인한다.

  • Tibero ➔ Tibero

  • Oracle ➔ Tibero

  • Tibero ➔ Oracle

  • Tibero ➔ PostgreSQL

  • PostgreSQL ➔ Tibero

제품 구성도

제품 소개와 제품 설계를 기반으로 ProSync가 어떤 구성으로 설치되고 운영되는지에 대한 구성도를 설명한다.

앞서 설명한 프로세스 개요 및 설계 구조가 실제 운영 환경 내 구성에 적용되는 사항을 이해하면 설치 절차 및 파라미터 변경 사항을 정확히 파악할 수 있다.

아래와 같은 구성을 권장한다.

가장 기본적인 ProSync의 구성도로, 추출하고자 하는 위치에 관련 프로세스가 기동되고, 반영하고자 하는 위치에 반영프로세스가 기동되는 구조이다. Agent 프로세스의 경우 프로세스들을 모니터링하기 때문에 환경별로 1개씩 기동된다.

편의를 위해 아래와 같은 구성 또한 가능하다.

모든 프로세스를 추출쪽으로 옮겨놓은 구성으로, 설치 및 운영이 매우 간단하다. 하지만 Apply가 Target쪽에 쿼리를 전달한다는 측면에서 네트워크 쓰루풋에 손해를 볼 수 있으며, 하드웨어 자원들도 모두 공유되기 때문에 권장되는 구성은 아니다.


Active-Active 구성의 Cluster DB는 Shared Storage가 필수이기 때문에, Shared Storage와 DB Server를 분리하여 작성한다.

반영 쪽이 Cluster인지 여부는 크게 중요하지 않다. 각 DB별 연결정보 파일 (tnsnames.ora 나 tbdsn.tbr 파일 등)을 통해 Cluster 쪽 연결 정보를 추상화하여 접속하기 때문에 반영할 수 있는 DB와 연결만 되면 된다.

Admin 실행

ProSync Admin Utility의 설치 방법 및 실행 명령어를 안내한다.

ProSync Admin Utility는 ProSync를 설치하는 과정에서 함께 설치된다.


ProSync Admin Utility를 실행하는 명령어의 문법은 다음과 같다.

항목
설명

양방향 동기화 미지원

instance명 제한

문자열 중간의 null 문자 존재하는 경우 null 이후 문자열 동기화 불가

명시적인 object명 설정 필요

BYTEA 컬럼 길이 제한

EXCLUDE_USER 파라미터 미지원

PostgreSQL 16

NOLOGGING 옵션이 설정된 테이블에 대한 DML 작업은 동기화하지 않는다.
DDL Rule
동기화 대상 테이블 생성 및 등록

Target Database

지원 항목

트랜잭션 단위 동기화

DML 동기화 대상

DML 동기화 제약사항

DDL 동기화 대상

DDL 동기화 범위

지원 컬럼 타입

지원 동기화 방향

항목
설명

filename

파일명이다.

ext

파일의 확장자로, 지정하지 않을 경우 SUFFIX 시스템 변수에 지정된 확장자가 기본값이다.

ProSync Admin Utility 실행 과정은 다음과 같다.

ProSync Admin Utility가 정상적으로 실행되면 위 예제처럼 Admin 프롬프트가 나타난다.

이 프롬프트에서 데이터베이스 사용자는 ProSync 관리를 위한 명령을 실행할 수 있다.

-h, --help

도움말 화면을 출력한다.

-v, --version

버전을 출력한다.

설치

실행

options

script

prs_adm [options] [script]
@filename[.ext]
$ prs_adm
ProSync 4 - Admin Utility
TmaxData Corporation Copyright (c) 2024-. All rights reserved.
그림 1. Single to Single 1
그림 2. Single to Single 2
그림 3. Cluster 구성

참고

Single 과 Cluster DB

ProSync에서 Single이란 Cluster가 아닌 DB를 의미한다. ProSync 관점에서의 Cluster DB란 Active-Active Cluster가 가능한 RDBMS를 의미하며, 단 두 가지 제품군만이 이 기능을 제공한다.

Tibero Active Cluster (TAC)와 Oracle의 Real Application Clusters(RAC) 를 의미한다고 이해할 수 있다.

참고

Process의 기동 위치

Extract 프로세스를 제외한 모든 프로세스는 기동 위치에 관계없다. Extract 프로세스의 기동 위치 요구사항은 Source DB 종류에 따라 다르다.

  • Tibero, Oracle: 데이터 변경분(Redo/Archive Log)을 해당 서버의 disk에서 직접 읽기 때문에 추출하고자 하는 서버에 기동되어야 한다.

  • PostgreSQL: WAL logical replication 연결(network)을 통해 추출하기 때문에 반드시 Source DB 서버에 기동될 필요는 없다. Source DB에 network로 접속할 수 있고 replication 권한이 있는 위치라면 기동할 수 있다.

또한 ProSync는 현재 DBMS에 대한 반영만을 지원하고 있는데, 이 때문에 SQL로 데이터를 가져오거나 반영할 수 있는 Llob 프로세스나 Apply 프로세스 입장에서는 기동 위치에 큰 제약이 없다.

다만 변경분의 데이터에서 SQL로 데이터를 생성하고 TCP 소켓을 통해 반영 측에 전달하면 네트워크 쓰루풋 관점에서 크게 손해를 보기 때문에 가능하면 Apply는 반영하고자 하는 위치에, Llob 프로세스 또한 추출하고자 하는 위치에 기동시키는 것이 일반적이다.

Cluster의 경우 Llob 프로세스는 두 위치 중 아무 곳에나 기동되어도 된다.

Single to Single 구성 예시

Cluster to Single/Cluster 구성 예시

참고

Admin과 ProSync Manager

위 두 프로세스는 모니터링과 관련된 툴로 Agent와 연결만 된다면 어디에 기동되어도 무방하다.

ProSync 디렉토리 구조

ProSync 설치 후 디렉토리 구조에 대한 설명이다.

ProSync 설치 후 $PRS_HOME 디렉토리는 아래 구조로 구성된다. 각 디렉토리는 ProSync 실행 및 관리를 지원한다.

동기화 프로세스(Extract/Apply/LLOB)의 바이너리는 DB 종류별로 구분된다.

DB
Extract
Apply
LLOB

설치 전 준비

ProSync를 설치하기 전에 반드시 확인해야 할 항목들을 안내한다. 환경 변수 설정, DB 사전 설정 등 설치가 원활히 진행되기 위한 준비 과정을 설명한다.

Extract

본 문서는 ProSync Extract 프로세스에 대한 대부분의 내용을 포함하고 있다. Extract 프로세스 정의부터 역할 및 세부적인 Configuration 등을 안내한다.

prs_llob

Oracle

prs_oext

prs_oapply

prs_ollob

PostgreSQL

prs_pext

prs_papply

prs_pllob

디렉토리
설명

bin

ProSync 프로세스 바이너리 파일이 위치하는 디렉토리이다.

client/lib

프로세스 실행에 필요한 라이브러리 파일이 위치하는 디렉토리이다.

config

ProSync 실행에 필요한 설정 파일이 위치하는 디렉토리이다.

config/templates

환경설정 파일 템플릿들이 위치하는 디렉토리이다.

# tree 결과
├── bin
│   ├── olr_test
│   ├── prs_adm
│   ├── prs_agent
│   ├── prs_apply
│   ├── prs_cm.sh
│   ├── prs_cred
│   ├── prs_dummy
│   ├── prs_ext
│   ├── prs_llob
│   ├── prs_oapply
│   ├── prs_oext
│   ├── prs_ollob
│   ├── prs_pext
│   ├── prs_papply
│   ├── prs_pllob
│   ├── prs_pretty_instance_map
│   └── tblr_test
├── client
│   └── lib
├── config
│   ├── templates
│   └── variant
├── install
│   ├── prs_backup.sh
│   ├── prs_common_agent.sh
│   ├── prs_common_dsn.sh
│   ├── prs_common.sh
│   ├── prs_common_topmap.sh
│   ├── prs_install_agent.sh
│   ├── prs_install.sh
│   ├── prs_meta.sh
│   ├── prs_util.sh
│   ├── scripts
│   └── templates
└── license
    └── oss_licenses

Tibero

prs_ext

prs_apply

ProSync 실행

Agent와 Instance가 정상적으로 설치되었다면, ProSync를 운영할 수 있다. 시스템 환경 변수가 올바르게 설정된 상태에서는 Admin process를 통해 Agent 및 Instance의 기동, 정지, 종료, 상태 확인 등의 작업을 수행할 수 있다.

아래 명령어를 입력하여 Admin process를 실행한다.

명령어를 입력하면 프롬프트가 아래와 같이 표시된다.

이 프롬프트에서 다음과 같은 명령어를 사용할 수 있다.

install

ProSync 설치에 필요한 파일이 위치하는 디렉토리이다.

install/prs_install.cfg

ProSync 설치 설정 파일이다.

install/prs_install_agent.cfg

Agent 프로세스 설치 설정 파일이다.

install/prs_install.sh

ProSync 설치 스크립트이다.

install/prs_install_agent.sh

Agent 프로세스 설치 스크립트이다.

install/prs_common.sh

prs_install.sh에서 사용되는 공통 함수들을 모아놓은 스크립트이다.

install/prs_common_agent.sh

prs_install_agent.sh에서 사용되는 공통 함수들을 모아놓은 스크립트이다.

install/prs_common_dsn.sh

ProSync 설치 시 DSN 관련 공통 함수들을 모아놓은 스크립트이다.

install/prs_util.sh

ProSync 설치 시 사용되는 유틸리티 함수들을 모아놓은 스크립트이다.

install/prs_backup.sh

ProSync 패치 시 백업 데이터를 생성하는 스크립트이다.

install/prs_meta.sh

ProSync 패치를 수행하는 스크립트이다.

install/prs_obj_group1.list

동기화 대상 테이블 정보가 담겨 있는 파일이다.

install/scripts

ProSync 설치에 필요한 SQL 파일들이 위치하는 디렉토리이다.

install/templates

ProSync의 설치 및 설정에 필요한 템플릿 파일들이 위치하는 디렉토리이다.

license

ProSync 라이선스 파일이 위치하는 디렉토리이다.

Memory 요구사항

Memory 사용량은 ProSync 사용에 있어서 가장 민감한 부분 중 하나이다. 제품 설계 에서 보았듯이 데이터를 추출하는 쪽에선 크게 데이터를 저장할 일이 없지만 데이터를 받는 쪽에선 트랜잭션 단위로 데이터가 모여야 데이터를 peer쪽에 반영할 수 있기 때문에, 이 데이터들을 모아놓는 데에 있어서 많은 양의 메모리가 사용된다.

본 장에선 대표적으로 메모리가 사용될만한 부분을 Sender (Extract / Llob ) 와 Receiver(Apply) 로 나누어서 설명한다.

Sender(Extract, Llob) 측의 메모리 사용

Extract 프로세스는 Non-Blocking I/O로 데이터를 전송한다. 대기 없이 데이터를 전송하려면 반드시 수신측에서 빠르게 데이터를 처리해 줘야 한다. TCP 의 수신버퍼에 데이터가 비워지지 않으면 Sender쪽은 Blocking이던 Non-Blocking이던 데이터를 처리하지 못한다. 이 경우 보내지 못한 데이터는 Queue에 쌓이게 되는데, 이때 메모리 사용량이 늘어나게 된다.

ProSync는 네트워크 지연 상황 발생 시 512MB 이상의 데이터가 Queue에 쌓일 경우 데이터를 보내지 않고 대기하게 된다. 이 크기는 기본값이며 히든 파라미터로 조절은 가능하다. (_MSG_LIST_SIZE_TO_PAUSE) 하지만 지연 상황에서 이 크기 때문에 속도가 달라지는 경우가 거의 없어 히든 파라미터로 처리되고 있고, 사용자는 이 사실만 알고 있으면 메모리 사용량이 올라가는 이유를 쉽게 추측할 수 있다.

Llob 프로세스의 경우 동작이 살짝 다른데, 데이터를 보내고 받을 때 64k 단위로 데이터를 주고받게 되어 있으며, 각 데이터가 Llob 과 Apply 프로세스간 송수신이 완료되어야 다음 데이터를 요청하도록 짜여져 있다. 따라서 Blocking 여부와 상관없이, Llob 에서 사용하는 최대 Thread 개수를 따라가고, 이 크기 자체가 미미하다.


Receiver(Apply) 측의 메모리 사용

TCP 를 통한 데이터 Receive에서 중요한 부분 중의 하나는 Kernel의 Receive Buffer를 빠르게 비워주는 동작이다. 이게 늦어지면 Window Size에 여유가 없어져서 결국 Sender쪽에선 아무 데이터를 보낼 수 없는 상태가 된다. 따라서 ProSync의 Apply Process는 수신을 대기하는 file descriptor(Socket)에 데이터가 감지되면 가장 먼저 데이터를 Memory로 복사하는 동작을 수행한다.

복사된 데이터들은 자연스럽게 Apply쪽에 쌓이게 된다. 쌓인 데이터는 Apply 프로세스가 사용하는 일련의 파이프 라인에 의존하여 관리된다. 여기서 해당 내용을 자세히 다루진 않고, Apply 와 해당 문서 하단의 Flow Control 에서 더 상세하게 다루도록 한다.

간단하게 요약하면, 메모리 내에 데이터가 너무 많으면 파일로 내리는 내용이고 파일로 내릴 수 없는 데이터들이 많이 쌓이게 되면 Socket 자체로부터 들어오는 데이터를 읽지 않는다. 이렇게 되면 앞서 설명한 Sender 쪽의 Non-Blocking 동작에 의해 알아서 읽기 동작을 멈추게 된다.

설치 안내서

ProSync를 설치하는 과정을 순차적으로 안내한다. '제품 설계' 페이지에서 소개된 프로세스들의 설치 과정과 시스템 요구사항 등의 내용을 모두 포함한다.

설치 예시

ProSync의 다양한 CDC 구성 예시를 통해 실제 환경에 맞는 설치 방안을 제시한다. 필요 시 '제품 구성도'를 참고한다.

아래 설치 예시는 제품 구성도에서 설명한 구성을 기준으로 한다.

Flow Control

ProSync의 Flow Control을 위해 사용되는 기능들을 정리한 문서이다. 데이터가 동기화되는 일련의 과정이 안정적으로 운영되기 위해선 데이터 처리 속도가 관건이다.

처리가 너무 느리다면 동기화 로직 상 데이터는 계속해서 쌓이게 된다. 쌓인 데이터를 계속해서 메모리에 적재하면 당연히 문제가 발생하기 때문에 임계값을 통해 데이터를 파일로 저장하거나 일시적으로 지연시키는 동작이 수행된다.

또한 처리 속도를 올리기 위해서 사용되는 기능들도 존재한다. 처리 속도가 빠르면 그만큼 추출한 데이터가 실시간성이 높게 반영이 된다는 의미이므로, 이 부분을 고려하여 환경 설정을 하는 것이 좋다.

마지막으로 에러가 발생했을 때, 정합성을 위해 기본적으로 동기화가 멈추게 되어 있는데, 이렇게 되면 데이터가 더 이상 처리될 수 없어서 영구적인 지연이 발생할 수 있다. 따라서 에러가 발생했을 때, 이를 자동으로 생략하거나 Rule에 맞춰서 데이터를 처리하는 방법에 대해서도 알아본다.

Key Features

Extract 프로세스에서 사용 가능한 기능에 대해 안내한다.

ProSync 설치

Agent 및 Instance 설치 방법을 단계별로 안내한다.

Admin process 실행 방법

Agent 실행

Instance 실행

실행 결과 확인

실행 결과 확인 예시

참고

자세한 명령어 및 운영 방법은 Admin 가이드 문서를 참고한다.

$ prs_adm
ProSync 4 - Admin Utility

TmaxData Corporation Copyright (c) 2024-. All rights reserved.

Admin>
Admin> start agent $agent_id
Admin> start $instance_id
Admin> status
ProSync 4 - Admin Utility

TmaxData Corporation Copyright (c) 2024-. All rights reserved.

status

prs_agent ID: agent1, HOST: 172.17.0.1, PORT: 7600, CM_GROUP: CM1, CM_ID: 1 is running
prs_agent ID: agent2, HOST: 172.17.0.2, PORT: 7601, CM_GROUP: CM1, CM_ID: 1 is stopped
prs_agent ID: agent3, HOST: 172.17.0.3, PORT: 7602, CM_GROUP: CM2, CM_ID: 0 is stopped
prs_agent ID: agent4, HOST: 172.17.0.4, PORT: 7603, CM_GROUP: CM2, CM_ID: 1 is stopped

Instance ID: [instance]
instance_ext1 is running (prs_agent ID : agent1, HOST: 172.17.0.1, PORT: 7600)
instance_apply1 is running (prs_agent ID : agent1, HOST: 172.17.0.1, PORT: 7600)
instance_llob is running (prs_agent ID : agent1, HOST: 172.17.0.1, PORT: 7600)

Admin

그림1. prosync process

ProSync Admin Utility

ProSync Admin Utility는 ProSync의 효율적인 사용을 위한 대화형 유틸리티이다. 이 유틸리티로 ProSync 프로세스의 기동, 정지, 일시정지와 같은 관리를 할 수 있다. 또한, ProSync 관리자는 시스템 관리를 위한 명령을 실행할 수 있다.

ProSync Admin Utility는 이러한 기본 기능 외에도 운영체제 관련 명령어의 실행, ProSync Admin Utility의 파라미터 확인, 스크립트 기능 등을 제공한다. 특히 스크립트 기능은 여러 ProSync Admin Utility 명령어를 하나의 스크립트 파일로 생성할 수 있어 편리하다.

ProSync Admin Utility는 다음과 같은 기능을 제공한다.

  • ProSync INSTANCE_ID별 기동, 일시정지, 재개, 정지

  • 특정 프로세스의 기동 및 정지

  • 스크립트를 통한 일괄 작업의 실행

  • ProSync 프로세스들의 상태 조회

  • 운영체제 관련 명령어의 실행

  • ProSync Admin Utility의 파라미터 설정 및 조회

  • 수행한 명령어에 대한 이력 관리

시스템 환경 요구사항

Platform
CPU
OS
Binary Bits

Admin 인터페이스 설명

ProSync Admin Utility 인터페이스에 대해 소개한다.

ProSync Admin Utility는 다음과 같은 특성을 가진 인터페이스로 실행한다.

  • ProSync Admin Utility가 정상적으로 실행되면 위와 같은 Admin 프롬프트가 출력된다. 프롬프트에서 ProSync Admin Utility 명령어를 입력할 수 있다.

  • 대소문자를 구분하지 않는다.

다음은 ProSync Admin Utility 실행 화면이다.

위의 예에서는 ProSync Admin Utility를 실행한 뒤 HELP 명령어를 통해 ProSync Admin Utility가 지원하는 명령어를 확인할 수 있다. 이처럼 ProSync Admin Utility는 텍스트 모드의 화면에서 입력을 받고, 사용자의 요구에 따라 결과를 출력한다.

시스템 요구사항

ProSync 설치 및 운영을 위해 필요한 시스템 환경 정보를 제공한다. 하드웨어, 운영체제, 데이터베이스, 네트워크, 소프트웨어 요구사항 및 필요한 권한을 항목별로 명시한다.

GNU

x86_64

Red Hat Enterprise Linux 7.x ~ 9.x

RHEL 호환 Enterprise Linux 배포판 7.x ~ 9.x 예: Oracle Linux, Rocky Linux

64bit

SUN

SPARC

Solaris 11.4

64bit

IBM

PPC

AIX 7.1

64bit

주의

HP 플랫폼: HP 플랫폼은 현재 ProSync 지원범위에 포함되지 않는다. HP 플랫폼은 4.4.0까지만 지원 가능하다.

Linux 배포본: ProSync는 OS 버전별로 빌드되어 배포되므로, 설치 대상 서버의 OS 버전에 맞는 배포본을 사용해야 한다. 각 배포본은 대상 OS의 기본 glibc를 기준으로 빌드된다. (RHEL 7: glibc 2.17 / RHEL 8: glibc 2.28 / RHEL 9: glibc 2.34)

Linux 라이브러리: 설치 및 정상 운영을 위해 libaio 라이브러리가 사전에 설치되어 있어야 한다.

Conflict

데이터 충돌 발생 시, 처리방안에 대해 확인한다.

Admin>
$ prs_adm
ProSync 4 - Admin Utility
TmaxData Corporation Copyright (c) 2024-. All rights reserved.

Admin> HELP 

참고

본 안내서에서는 특별한 경우를 제외하고는 모든 ProSync Admin Utility 명령어를 대문자로 표현한다.

명령어의 파라미터로 소문자가 사용된 경우는 다른 파라미터로 확장될 수 있는 경우이다.

Disk 요구사항

ProSync가 Disk로 저장하는 데이터들은 크게 다음과 같다.

  • Log File

  • TX Hash File

  • Part File

위 세 파일은 파라미터로 관리되거나 자동으로 ProSync가 삭제하는 동작을 통해서 관리된다.

본 문서에서는 위 파일들에 대해 간단하게 소개하고 어떤 방식으로 관리되고 있는지 설명한다.

Log File

ProSync의 로그 파일은 프로그램 로그나 SAM(Sequential Access Method) 파일, Discard와 같은 에러 발생 시 사용되는 로그 파일들이 있다. 어떤 파일이든 ProSync 로그는 같은 방식으로 처리가 되고, 이 부분만 기억하면 Disk 사용량을 쉽게 예측할 수 있다.

ProSync의 로그들은 일정 크기까지 데이터를 쓰고, 임계치를 넘어가면 새 파일에 데이터를 쓰며 기존 데이터는 Backup 위치로 이관시킨다. 이관된 위치에는 데이터가 영구적으로 쌓이게 될 수 있는데, 이를 위해 제공되는 파라미터를 통하여 Backup 위치 내에서 파일 개수를 동일하게 유지시킬 수 있다.

이 설정은 모두 파라미터로 관리되고 있으며, 해당 내용을 참고하여 설정하면 좋다.


Apply 프로세스에서만 사용되며 상세한 내용은 에서 자세히 설명하며, 본 장에서는 간략히 언급한다.

TX Hash File은 수신 이후 데이터들이 쌓이는 공간이며, 이력 저장 주기(RDBMS의 Log Switch) 마다 데이터 전체가 Disk에 작성된다. 작성된 데이터는 Log File과 마찬가지로 파라미터를 통해 특정 개수 혹은 특정 용량까지만 이력을 보관하도록 설정할 수 있다.

Part File은 Transaction의 크기가 클 때 메모리에서 Disk로 내려가는 파일로, 반영쪽에 데이터가 반영되고 나서야 제거가 될 수 있다. ProSync 동작 특성 상 Part File의 용량이나 개수를 제한하기가 어렵기 때문에, 사용자가 추출하고자 하는 데이터의 양상에 맞게 Disk를 여유있게 준비해야 한다. 예를 들어 10억건의 DML을 넣는 Transaction이 자주 발생하는 환경이라면, 유사한 크기의 Part File이 생길 수 있음을 인지하고 Disk 관리를 해주어야 한다.

Agent

Agent 프로세스에 대해 안내한다.

Agent 프로세스는 Admin 프로세스 또는 ProSync Manager로부터 메시지를 수신하면, 이를 ext, apply, llob 프로세스에 전달하고, 처리 결과를 다시 Admin 프로세스 및 ProSync Manager에 전달한다. 또한, ext, apply, llob 프로세스의 기동, 종료 등의 작업을 수행한다. 추가적으로 CM Failover 기능을 사용하는 경우 CM 모니터링 및 하위 프로세스 모니터링 작업도 수행한다.


기동 시 다른 Thread 시작, 메시지 수신 및 전송 등의 작업을 수행한다.

ext, apply, llob 프로세스의 기동, 종료 등의 작업을 수행한다.

CM Failover 기능을 사용하는 경우 CM을 모니터링하여 CM 상태에 따라 하위 프로세스의 기동, 종료 작업을 수행한다. CM Failover 기능에 대한 자세한 내용은 을 참고한다.

ProSync Manual

안내서 정보

안내서 제목: ProSync 매뉴얼 발행일: 2026.11.17 소프트웨어 버전: ProSync v4.7.1 안내서 버전: v1.0.1

본 안내서는 TmaxTibero®(이하 Tibero)에서 제공하는 CDC (Change Data Capture) 도구인 ProSync를 사용하는 데이터베이스 개발자를 위한 안내서로, ProSync의 기본적인 사용 방법을 설명한다.

  • 데이터베이스의 이해 데이터베이스 기본 개념 및 RDBMS(Relational Database Management System) 작동 원리에 대한 이해

  • SQL 및 PSM 지식 SQL 문법 및 PSM(Persistent Stored Modules)의 기본적인 사용 방법에 대한 이해

Flow Control

참고

Backup 로그 파일 설정 관련

로그 모듈의 Backup과 관련된 개수 설정은 모두 용량과 관련이 있다. 일반적인 로그를 예로 보면, LOG_FILE_SIZE 크기 이상 로그가 쌓이면 LOG_BACKUP_DIR 위치로 로그 파일이 넘어가고, 새 로그 파일을 생성하여 로그를 작성한다.

이때, LOG_BACKUP_SIZE크기 이상 만큼의 백업 로그들이 LOG_BACKUP_DIR상에 쌓이게 되면, 가장 오래된 로그를 지워 크기를 유지시키도록 되어 있다.

이를 통해 사용자는 로그 파일 개수를 유지시키는 게 가능하다.

TX Hash File / Part File

참고

Part File 관련

TX Hash는 크기 제한이 있는 공간이다. Part File이 발생하는 시점은 단순히 한 TX의 크기가 임계치를 넘어갔을 때가 아니라, TX Hash 크기가 부족할 때 가장 크기가 큰 Transaction 데이터부터 Part File로 옮겨주게 된다.

설명상 두 항목으로 구분하였지만, 실제로는 상호 밀접하게 연관된 구성 요소이다.

Apply

본 문서는 ProSync Apply 프로세스에 관한 설명과 운영 등 전반적인 내용을 포함한다. Apply 프로세스 정의 및 역할, 세부적인 Configuration 등을 안내한다.

Mapping

본 장에서는 Map 파라미터를 통해 설정할 수 있는 Resolution Rule (DCR)과 Schema Mapping을 위한 DDL 설정에 대해 알아본다. Mapping은 기본적으로 테이블명, 컬럼명에 대한 Mapping을 지원한다.

Archive Log 모드

ProSync는 Archiving되지 않은 온라인 Redo Log는 추출하지 않고, Archiving이 완료된 Archive Log만을 추출하여 Apply 프로세스로 전달할 수 있다.

EXTRACT_ARCHIVE_LOG_ONLY=[Y|N]

파라미터
설명

EXTRACT_ARCHIVE_LOG_ONLY

Archive Log만을 추출할지 여부를 설정한다.

주의

위 기능을 사용하는 경우, Archive Log만을 추출하게 되어 실시간 성능 저하 가능성이 있으므로 사용에 유의한다.

장애 대응 가이드

장애 상황에 대한 조치로서, 프로세스별 장애 상황과 이에 대한 내용을 안내한다.

기본적인 Unix 기반 운영체제의 명령어 플랫폼별 $SHELL의 사용법이나, 시스템 요구사항 확인에 대한 이해


티맥스티베로 ProSync 매뉴얼에 적용되는 저작권 안내 사항이다.

경기도 성남시 분당구 정자일로 45 티맥스타워

Tel : +82-1544-8629

E-Mail : docs@tibero.com

이 소프트웨어(ProSyncTM) 사용설명서의 내용과 프로그램은 저작권법과 국제 조약에 의해서 보호받고 있다. 사용설명서의 내용과 여기에 설명된 프로그램은 TmaxTibero Co., Ltd.와의 사용권 계약 하에서만 사용이 가능하며, 사용설명서는 사용권 계약의 범위 내에서만 배포 또는 복제할 수 있다. 이 사용설명서의 전부 또는 일부분을 TmaxTibero의 사전 서면 동의 없이 전자, 기계, 녹음 등의 수단을 사용하여 전송, 복제, 배포, 2차적 저작물 작성 등의 행위를 하여서는 안 된다.

이 소프트웨어 사용설명서와 프로그램의 사용권 계약은 어떠한 경우에도 사용설명서 및 프로그램과 관련된 지적재산권(등록 여부를 불문)을 양도하는 것으로 해석되지 아니하며, 브랜드나 로고, 상표 등을 사용할 권한을 부여하지 않는다. 사용설명서는 오로지 정보의 제공만을 목적으로 하고, 이로 인한 계약상의 직접적 또는 간접적 책임을 지지 아니하며, 사용설명서 상의 내용은 법적 또는 상업적인 특정한 조건을 만족시키는 것을 보장하지는 않는다. 사용설명서의 내용은 제품의 업그레이드나 수정에 따라 그 내용이 예고 없이 변경될 수 있으며, 내용상의 오류가 없음을 보장하지 않는다.

ProSync™는 TmaxTibero Co., Ltd.의 등록 상표이다. 기타 모든 제품들과 회사 이름은 각각 해당 소유주의 상표로서 참조용으로만 사용된다.

본 제품의 일부 파일 또는 모듈은 아래의 라이선스를 준수한다.

  • Apache License 2.0

  • BSD 2-Clause License

  • BSD 3-Clause License

  • MIT License

  • ICU license

  • OpenSSL, Inc.

  • Apache Foundation

  • Jean-loup Gailly and Mark Adler

  • Paul Hsieh's hash

상세 정보는 제품 내 위치한 아래의 디렉터리에서 확인할 수 있다. ${PRS_HOME}/licenses/oss_licenses/oss_licenses.txt


본 문서는 총 6개의 본문과 1개의 참고 사항으로 구성된다.


Prosync 4.7 매뉴얼 PDF 파일을 제공합니다.

PDF는 파일 생성 시점의 내용을 기준으로 하며, 이후 수정 사항은 반영되지 않을 수 있습니다.

최신 내용은 온라인 매뉴얼을 확인해주시기 바랍니다.

  • PDF 생성일: 2026-10-28

참고

본 안내서는 ProSync를 실무에 적용하거나 운용하는 데 필요한 모든 사항을 포함하지 않는다.

안내서의 내용은 ProSync 제품의 개선이나 업그레이드에 따라 변경될 수 있다.

사전 필요 지식

저작권 안내

주소

Website

기술서비스센터

Restricted Rights Legend

Trademarks

Open Source Software Notice

안내서 구성

ProSync 소개

ProSync 제품 및 설계 내용에 대한 대략적인 설명을 포함한다.

설치 안내서

ProSync를 설치하는 과정을 순차적으로 다룬다.

운영 가이드

Admin, Agent 등 ProSync 운영에 필요한 프로세스를 안내한다.

패치 가이드

패치 적용을 위한 프로세스를 안내한다.

롤백 가이드

4.4.x로의 패치 이후 문제 발생 시 이전 버전으로 돌아가기 위한 단계를 설명한다.

장애 대응 가이드

프로세스별 장애 상황에 대한 대응 방안을 안내한다.

참고 자료

파라미터

ProSync 구성을 설명하는 초기화 매개변수에 대해 안내한다.

PDF 다운로드

ProSync Manual_4.7.pdf
PDF · 4MB
열기
CM Failover 기능 사용
그림 1. Agent Process

Agent Process

Process 설명

Threads

Control Thread

Worker Thread

Monitor Thread

Where Clause

Redo Log는 물리적인 위치에 대한 변경분이 남는다. RDBMS (주로 Oracle, Tibero) 에서는 row 데이터가 ROWID 라는 고유의 값을 가지게 되는데, 이 ID에는 데이터 파일의 위치, 파일 내 데이터 블록의 위치, 블록 내 row의 위치 에 대한 정보가 저장되어 있다.

ProSync는 이 물리적으로 정해진 ROWID만 가지고는 Target Database에서 정확하게 어떤 row인지 판별할 수가 없다. 왜냐하면 데이터 파일도 다를 것이고, 블록 위치나 row 위치 정보도 모두 다르기 때문에 ROWID로는 서로 다른 Database의 row를 매칭 시키기가 어렵다.

따라서 SUPPLEMENTAL_LOGGING옵션 등을 통해 row 데이터의 추가적인 정보를 Redo Log상에 함께 남기게 된다. 예를 들면, 사용자가 Where Clause에 1개의 Column정보만 넣었다고 하더라도, Redo Log에는 해당 Row 내에 있는 모든 Column 정보가 다 남도록 해준다.

Target Database와 Apply 프로세스는 이 정보를 가지고 쿼리를 재구축한다. 다만 이렇게 되면, Primary key 를 가지고 있는 테이블 입장에선 불필요한 다른 컬럼 정보들을 Where Clause에 입력해주는 경우가 생긴다. Database의 플랜 별로 최적화되어 잘 처리될 수도 있지만, 불필요한 상황 자체를 방어하기 위해 ProSync에선 Primary key만 사용할지에 대한 여부를 파라미터로 관리한다.

Parameter 관련

USE_PK_FOR_WHERE 이 파라미터를 사용하면 Primary key가 있는 테이블에 대한 Update나 Delete 시에 Where Clause에는 Primary key만 입력하게 된다.

주의

Data Conflict Rule(DCR) 관련

옵션을 사용할 경우 USE_PK_FOR_WHERE 옵션은 무시된다. 동기화의 논리 구조상 Conflict를 찾는 것이 우선이기 때문에 ProSync에선 두 옵션 간에 이와 같은 우선순위를 둔다.

데이터 압축

ProSync는 Extract 프로세스에서 Apply 프로세스로 데이터를 전송할 때 네트워크 부하 감소를 위한 데이터 압축을 사용할 수 있다.

ENABLE_NETWORK_COMPRESS=[Y|N] NETWORK_COMPRESS_LEVEL=compress_level

파라미터
설명

ENABLE_NETWORK_COMPRESS

전송하는 Chunk의 압축 여부를 결정한다.

NETWORK_COMPRESS_LEVEL

Sequence 동기화

ProSync는 Source 데이터베이스의 Sequence 객체 값을 Target 데이터베이스로 실시간 동기화하는 기능을 제공한다. Sequence의 NEXTVAL이 호출되며 속성값이 갱신될 때 마다 Target으로 전달된다.


Source 데이터베이스
Target 데이터베이스
지원 여부

데이터베이스 설정

ProSync 사용을 위한 Source Database별 설정 방법을 안내한다.

다음 항목을 TIP 파일에 설정한다.

CREATE 문으로 생성된 테이블을 자동으로 동기화 대상에 등록하는 경우(AUTO_SYNC_ON_CREATE=Y), DB 단위 supplemental log가 설정되어 있어야 한다. _DDL_AUTO_SUPPLOG_CTBL을 TRUE로 설정하며, 운영 중인 DB에는 ALTER SYSTEM으로 바로 적용할 수 있다.

ALTER SYSTEM으로 변경한 값은 DB 재기동 후 유지되지 않으므로, 다음 항목을 TIP 파일에도 추가한다.

자세한 내용은 페이지의 '동기화 대상 자동 등록'을 참고한다.

Tibero Standby Cluster(TSC) 환경에서 Standby DB를 Source로 사용하는 경우 Standby DB가 read-only 모드로 open되어 있어야 하는 등 추가 준비 사항이 있다. 또한 Failover 이후에는 승격된 Standby DB가 Redo를 생성하는 추출 대상이 되므로, 위의 TIP 파일 설정은 Primary DB와 Standby DB 모두(TAC-TSC는 모든 노드)에 적용해야 한다. 설치 config 파일의

DML History

APPLY 프로세스에서 DML 반영 시 MAP 파라미터로 지정한 History 테이블에 반영된 history 를 남기는 기능이다.

해당 기능을 사용하기 위해서는 기존 ProSync 동기화를 진행하는 인스턴스 이외에 DML History 기능 작동을 위한 인스턴스가 추가로 하나 더 필요하다.

APPLY 프로세스의 config 파일인 [inst_id]_apply1.cfg 파일에 다음의 파라미터를 설정해야 한다.

Parameter
설명

추가적으로 동기화 대상 테이블에 추가적인 column들이 필요하다.

DML Error Report

APPLY 프로세스가 동기화 진행 중 DML 반영을 실패 또는 장애 상황이 발생했을 때 일정 횟수를 재시도 한 뒤 report 파일로 write하는 기능이다.

DML에 관해서만 기록이 가능하며, APPLY 프로세스의 config 파일인 [inst_id]_apply1.cfg 파일에 다음의 파라미터를 설정해야 한다.

파라미터
설명

압축 테이블 추출

Source DB가 Tibero인 경우 압축 테이블에 대한 동기화 지원을 설명한다.

Source DB가 Tibero인 경우, 압축된 테이블에 대한 동기화를 지원한다. 압축 테이블의 변경 데이터는 Redo Log에 압축 심볼 참조 형태로 기록되며, Extract 프로세스는 Supplemental Log에 포함된 심볼 매핑 정보를 이용하여 이를 원본 값으로 복원한 후 동기화한다.

압축 테이블 동기화를 위한 별도의 파라미터 설정은 필요하지 않으며, 다음 조건을 만족하면 자동으로 동작한다.

  • 동기화 대상 테이블에 Supplemental Logging이 설정되어 있어야 한다.

  • Source DB(Tibero)와 ProSync 모두 압축 테이블 동기화를 지원하는 버전이어야 한다.

압축 방식

데이터 압축 기능을 사용할 때 데이터 압축률을 설정한다.

0~9까지 설정 가능하며, 0으로 설정한 경우 압축을 하지 않고 9에 가까워질수록 압축률이 커진다.

Data Conflict Rule (DCR)
column
설명

OLD_{컬럼 명}

해당 column의 경우 UPDATE, DELETE 같은 column의 값이 변경될 때의 값이 남게 된다. 따라서 기존 컬럼과 똑같은 타입으로 설정해 주어야 한다.

HIST_NO

NUMBER 이며, 순차 채번을 위한 column이다. Target DB SYS User 에 SQ_{HISTORY_TABLE} 의 이름을 가진 sequence의 생성이 필요하다. 이때 Sequence table 은 MIN 1 MAX 99999999 을 가지며, cycle 로 순환되어야 한다.

IUD_FLAG

VARCHAR(6) 이며, History 가 남을 DML 의 유형을 뜻하는 column이다. INSERT / UPDATE / DELETE가 남는다.

IUD_TIME

TIMESTAMP 이며, DML 이 수행되어 history 가 남은 시간을 뜻한다.

RECORD_HISTORY

해당 인스턴스에서 DML history 기능을 사용할지에 대한 여부를 결정한다. (Y|N)

  • Y : MAP RULE 로 지정된 history 테이블에 row by row로 DML이 남게 된다.

  • N : MAP RULE 로 지정된 history 테이블에 row by row로 DML이 남지 않는다. (기본값)

해당 파라미터를 Y 로 설정할 경우, MAP 파라미터를 history 를 남길 테이블로 설정해 주어야 하며, DDL 파라미터의 경우 exclude all 로 설정해 주어야 한다.

LEADING_PRS_USER

DML history 기능에 의해서 history를 기록할 선행되는 PRS_USER를 설정하는 파라미터이다.

선행되는 인스턴스에 동기화가 이루어져야 DML history가 남게 된다. 3초씩 10번 총 30초 동안 바라보며, 그 안에 동기화가 이루어지지 않을 경우 history는 남지 않는다.

참고

다음의 타입들에 대해선 이 기능을 제공하지 않는다.

아래의 타입이 있는 테이블의 경우에는 컬럼의 값이 NULL로 기록된다.

  • LONG

  • BLOB

  • CLOB

Data Conflict Rule (DCR)

MAP Rule에서 소개한 Data Conflict Rule의 시나리오들을 정리한다. 옵션을 설정하는 방법은 해당 문서를 참고한다.

DCR의 제약사항

Data Conflict를 확인하려면 Row를 특정할 수 있어야 한다. ProSync에서는 이에 대한 기준을 Primary key로 두고 있다. Primary key 로 인해 충돌이 발생할 경우, Source Database, Target Database, Column Min(Max) 기준으로 데이터 Conflict에 대한 처리를 결정한다.

ProSync는 where절에 lob column은 확인하지 않으므로, 비교 시 해당 column의 데이터가 다르더라도 다른 column 값이 동일하다면 성공적으로 dml을 수행한다.

DCR - MIN/MAX 설정 후 동일한 값으로 dml 수행 시, 비교 로직에서 충돌을 유발하지 않으므로 양측 노드에서 정상 dml을 수행한다.

시나리오

Resolve By Source

1. Insert

Insert문에서 충돌이 발생한다는 것은, 이미 데이터가 존재한다는 의미이다. 따라서 존재하는 데이터를 모두 Source Database 기준으로 맞춰주어야 한다.

Insert문을 Update로 변경하여 Conflict를 해소해준다.

2. Update

Update에서의 데이터 충돌은 원하는 Row가 없다는 의미이다.

Update문을 Insert로 변경하여 Conflict를 해소해준다.

3. Delete

Delete에서의 데이터 충돌 또한 마찬가지로 Row가 없다는 의미가 된다.

Delete에 대한 추가적인 처리가 없이 넘어가면 된다.

Resolve By Target

1. Insert

Insert문의 충돌은 이미 데이터가 있을 때 발생하는데, Target Database 기준으로 맞춰야 하므로, 별도의 작업 없이 해당 처리를 건너뛴다.

2. Update

Row가 없는 상황이 맞다고 판단하기 때문에 별도의 작업 없이 해당 처리를 건너뛴다.

3. Delete

Row가 없는 상황이 맞다고 판단하기 때문에 별도의 작업 없이 해당 처리를 건너뛴다.

Resolve By Min/Max

위 두 경우에 대한 조합으로 볼 수 있다. 상황에 따라 Source 기준 또는 Target 기준에 맞춰 수행하는 시나리오다. 기준이 되는 것이 Database 단위가 아닌 Column 내 데이터의 대소 비교로 이루어진다는 점이 다르고, 이에 따라 충돌 처리 동작은 위의 Source / Target과 동일하게 작동한다.

주의

Data Conflict Rule(DCR) 관련

Data Conflict Rule(DCR) 옵션을 사용할 경우 USE_PK_FOR_WHERE 옵션은 무시된다. 동기화의 논리 구조상 Conflict를 찾는 것이 우선이기 때문에 ProSync에선 두 옵션 간에 이와 같은 우선순위를 둔다.

지원 여부

COMPRESS (Basic Compression)

지원 Direct Path Insert(/*+ APPEND */ 힌트, CREATE TABLE AS SELECT 등)로 적재된 압축 데이터의 추출을 지원한다.

COMPRESS FOR OLTP (OLTP Compression)

지원 INSERT, UPDATE, DELETE 및 Multi Insert, Multi Delete를 포함한 DML 추출을 지원한다.

COMPRESS FOR QUERY, COMPRESS FOR ARCHIVE

미지원 컬럼 단위 압축(Tibero Columnar Compression)이 적용된 테이블은 동기화 대상에 포함할 수 없다.

지원 범위

압축 테이블 동기화를 지원하지 않는 버전의 Source DB와 함께 사용하는 경우, 압축 데이터의 원본 값 복원에 필요한 Supplemental Log 정보가 기록되지 않아 데이터 정합성이 깨질 수 있다.

Extract 프로세스 로그에 comp supp lookup miss 또는 decompress failed 메시지가 나타나면 해당 테이블의 Source DB와 Target DB 간 데이터 정합성 확인이 필요하다.

데이터베이스 별칭(Alias) 확인

ProSync 설치를 시작하기 전에 각 데이터베이스의 SID 설정 파일을 확인하여 접속 가능한 별칭(Alias)을 설정한다.

주의

데이터베이스가 클러스터 환경인 경우, 각 인스턴스에 대한 설정이 모두 포함되어야 한다.

또한, 접속하는 모든 DB에 대한 별칭 설정이 필요하며, 각 DB에 대한 client 바이너리가 PATH에 있어야 한다.

Tibero 별칭 설정

Tibero가 Source DB 또는 Target DB로 사용되는 경우, 다음 경로에 별칭을 설정한다.

일반 구성 예시


Oracle 별칭 설정

Oracle이 Source DB 또는 Target DB로 사용되는 경우, 다음 경로에 별칭을 설정한다.

구성 예시


PostgreSQL 별칭 설정

PostgreSQL이 Source DB 또는 Target DB로 사용되는 경우, 다음 경로에 별칭을 설정한다.

pg_service.conf 경로는 PGSERVICEFILE 환경 변수 값으로 지정하거나 시스템 전역(pg_config --sysconfdir/pg_service.conf) 파일을 사용 또는 PGSYSCONFDIR 환경 변수 값으로 지정된 디렉터리의 pg_service.conf 파일을 사용할 수 있다.

구성 예시

USE_TSC=Y
설정과 사전 준비 사항은
페이지를 참고한다.

위와 같이 DB 단위로 supplemental log를 설정하면 CREATE 문으로 생성된 테이블을 자동으로 동기화 대상에 등록하는 기능(AUTO_SYNC_ON_CREATE=Y)을 사용할 수 있다. 설치 config 파일의 SUPP_LOG_LVL_ALL=Y 설정으로도 동일하게 설정할 수 있으며, 자세한 내용은 동기화 대상 테이블 생성 및 등록 페이지의 '동기화 대상 자동 등록'을 참고한다.

AQ와 Archive Log 관련 파라미터는 다음과 같이 설정한다.

Redo Log 또는 Archive Log가 ASM Diskgroup에 저장되어 있는 경우, Extract 프로세스가 ASM 인스턴스에 접속하여 로그를 읽는다. 다음 조회 결과의 경로가 +로 시작하면 ASM 접속 정보 설정이 필요하다.

ASM 인스턴스 접속 별칭을 tnsnames.ora에 등록하고, SYSASM 권한을 가진 접속 계정을 준비한다. 설치 config 파일의 ASM_DB_NAME, ASM_USER, ASM_PWD 설정과 사전 준비 사항은 Source Oracle ASM 로그 추출 페이지를 참고한다.


동기화 대상 테이블 생성 및 등록

Source DB가 Tibero인 경우

Tibero 설정

데이터베이스 TIP 파일 설정

Archive 모드 설정

DB 단위 Supplemental Log 설정

TSC Standby 환경 구성

TSC Standby Synchronization

Source DB가 Oracle인 경우

Oracle 설정

Archive 모드 및 Supplemental Log 설정

파라미터 설정

ASM 환경 구성

Source DB가 PostgreSQL인 경우

PostgreSQL 설정

wal_level = logical 설정

SQL> CREATE TABLE TEST.T_COMP (C1 VARCHAR(2000), C2 NUMBER) COMPRESS FOR OLTP;
SQL> ALTER TABLE TEST.T_COMP ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
$TB_HOME/client/config/tbdsn.tbr
SOURCE_SID=(
    (INSTANCE=(HOST=SOURCE DB IP)
              (PORT=SOURCE DB PORT)
              (DB_NAME=SOURCE DB NAME))
)

TARGET_SID=(
    (INSTANCE=(HOST=TARGET DB IP)
              (PORT=TARGET DB PORT)
              (DB_NAME=TARGET DB NAME))
)
$ORACLE_HOME/network/admin/tnsnames.ora
SOURCE_ALIAS=
(DESCRIPTION=
    (ADDRESS=(PROTOCOL=TCP)
             (HOST=SOURCE DB IP)
             (PORT=SOURCE DB PORT))
    (CONNECT_DATA=(SERVER=DEDICATED)
                  (SERVICE_NAME=SOURCE DB SERVICE NAME))
)

TARGET_ALIAS=
(DESCRIPTION=
    (ADDRESS=(PROTOCOL=TCP)
             (HOST=TARGET DB IP)
             (PORT=TARGET DB PORT))
    (CONNECT_DATA=(SERVER=DEDICATED)
                  (SERVICE_NAME=TARGET DB SERVICE NAME))
)
~/pg_service.conf
[SOURCE_ALIAS]
host=SOURCE DB IP
port=SOURCE DB PORT
dbname=SOURCE DB NAME

[TARGET_ALIAS]
host=TARGET DB IP
port=TARGET DB PORT
dbname=TARGET DB NAME

[EXAMPLE_FOR_REPLICATION]
host=SOURCE DB IP
port=SOURCE DB PORT
dbname=SOURCE DB NAME
replication=database
_ENABLE_LOG_MINER=Y # ProSync가 사용하기 위한 추가적인 redo log를 남기기 위함
_SPAN_UNDO=N  # Tibero 6 FS07 이상에서 설정
_DDL_TRIGGER_ENABLE=Y # meta table 정보 관리를 위한 설정, 기본값은 Y이므로 설정하지 않아도 무방함
$ tbboot -t mount
$ tbsql sys/password
SQL> ALTER DATABASE ARCHIVELOG;
SQL> QUIT
$ tbdown
$ tbboot
SQL> ALTER SYSTEM SET _DDL_AUTO_SUPPLOG_CTBL=TRUE;
_DDL_AUTO_SUPPLOG_CTBL=TRUE
$ sqlplus / as sysdba
SQL> STARTUP MOUNT;
SQL> ALTER DATABASE ARCHIVELOG;
SQL> ALTER DATABASE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
SQL> ALTER DATABASE OPEN;
$ sqlplus / as sysdba
SQL> ALTER SYSTEM SET JOB_QUEUE_PROCESSES=4 SCOPE=SPFILE;
SQL> ALTER SYSTEM SET OPEN_LINKS=4 SCOPE=SPFILE;
SQL> ALTER SYSTEM SET AQ_TM_PROCESSES=1 SCOPE=SPFILE;
SELECT MEMBER FROM V$LOGFILE;
SHOW PARAMETER log_archive_dest
SHOW PARAMETER db_recovery_file_dest
$ cat postgresql.conf | grep wal_level
wal_level = logical                     # minimal, replica, or logical
Source Tibero에서 Sequence의 NEXTVAL이 호출되면, 해당 값이 Target Tibero의 동일 Sequence에 실시간으로 반영된다.
  1. Source와 Target에 동일한 이름의 유저 아래에 동일한 이름의 Sequence가 생성되어 있어야 한다.

  2. ProSync 설치 스크립트가 정상적으로 수행되어 있어야 한다.

  3. 동기화 대상 리스트 파일(기본값: prs_obj_group1.list) 파일에 SYS._DD_SEQ 테이블이 기재돼 있어야 한다.

  4. 동기화 대상 리스트 파일(기본값: prs_obj_group1.list) 파일에 동기화하고자 하는 SEQUENCE가 기재돼 있어야 한다.

  5. Source Tibero 의 데이터베이스 초기화 파라미터로 _DDL_SEQ_SUPPLOG=Y 를 설정해야 한다. ProSync 의 config 파일에 기재하는 파라미터가 아니다.

  6. Target Tibero 의 데이터베이스 초기화 파라미터로 SEQ_GET_NEXTVAL_FROM_DD_TABLE=Y 를 설정해야 한다. ProSync 의 config 파일에 기재하는 파라미터가 아니다.

  1. Sequence 생성 시 NOCACHE 옵션으로 생성 필요하다.

  2. Source, Target DB 의 동기화 대상이 되는 SEQUENCE 짝의 설정값은 일치해야 한다.

  3. 프로싱크에서 Sequence ALTER 수행 시 타겟 DB에서 SYS._DD_SEQ NEXTVAL 값을 기준으로 Boundary Check를 수행하기 때문에, 타겟 NextVal 값보다 MAX/MIN 값이 더 작은/큰 경우, TBR-7134 에러가 발생한다.

Source Oracle에서 Sequence의 NEXTVAL이 호출되면, 해당 값이 Target Tibero의 동일 Sequence에 반영된다. Target의 Sequence 값이 Source 와 겹치지 않고, 동일하거나 앞서가도록 동기화가 진행된다.

  1. Source Oracle과 Target Tibero에 동일한 이름의 Sequence가 생성되어 있어야 한다.

  2. ProSync 설치 스크립트가 정상적으로 수행되어 있어야 한다.

  3. 동기화 대상 리스트 파일(기본값: prs_obj_group1.list) 파일에 SYS.SEQ$ 테이블이 기재돼 있어야 한다.

  4. 동기화 대상 리스트 파일(기본값: prs_obj_group1.list) 파일에 동기화하고자 하는 SEQUENCE가 기재돼 있어야 한다.

  1. Source, Target DB 의 동기화 대상이 되는 SEQUENCE 짝의 설정값은 일치해야 한다.

  2. SEQUENCE 값의 정합성을 위해 ORDER 옵션의 사용이 권장된다.


항목
설명

설치 준비

Instance 설치 과정에서 DB 의 PRS_INSTALL_USER 는 SYS.SEQ$(SYS._DD_SEQ) 테이블 및 동기화 하고자 하는 SEQUENCE 에 대한 SELECT 권한이 필요하다.

동기화 시점

NEXTVAL 호출 시에만 동기화된다. CURRVAL 조회는 동기화되지 않는다.

Sequence 존재 필수

Target에 동일한 이름의 Sequence가 미리 생성되어 있어야 한다.

ALTER SEQUENCE

Sequence 속성 변경(INCREMENT BY, MAXVALUE 등)은 DDL 동기화를 통해 처리된다.

대량 호출 시

빈번한 NEXTVAL 호출은 동기화 부하로 이어질 수 있으며, CACHE 옵션의 취급은 적용 환경에 따라 다르다. [Oracle to Tibero] CACHE 를 사용하면 동기화 호출 빈도를 낮출 수 있다. Target 의 CACHE 도 지원되며, 동기화 시점에만 내부적으로 조정된 뒤 원래 설정으로 복원된다. [Tibero to Tibero] CACHE 를 사용하면 호출 단위 동기화가 성립하지 않으므로 NOCACHE 로 운용한다.

Tibero

Tibero

지원

Oracle

Tibero

지원

개요

지원 환경

Tibero to Tibero 환경

동기화 방식

사전 준비사항

제약사항

Oracle to Tibero 환경

동기화 방식

사전 준비사항

제약사항

주의사항

APPLY_REPORT_FILE_SIZE

각 프로세스 별 DML error report 파일의 최대 크기를 설정한다. report 파일의 크기가 APPLY_REPORT_FILE_SIZE를 넘으면 APPLY_REPORT_BACKUP_DIR로 옮긴 후 새로운 report 파일을 생성한다. (기본값: 100MB, 범위: 1MB ~ 1GB)

APPLY_REPORT_BACKUP_DIR

DML error report 파일의 백업 파일이 저장되는 디렉터리 위치를 설정한다.

APPLY_REPORT_BACKUP_SIZE

APPLY_REPORT_BACKUP_DIR에 백업되는 report 파일들의 최대 크기를 설정한다. 각 프로세스 별로 백업된 총 report 파일의 크기가 APPLY_REPORT_BACKUP_SIZE를 넘으면 가장 오래된 파일부터 순차적으로 삭제한다. (기본값: 0, 범위: 0 ~ 128GB)

APPLY_TO_REPORT

Dml Error Report 기능의 사용 여부를 결정한다. (Y|N)

  • Y : report file에 row by row로 DML이 남게 된다. (기본값)

  • N : report file에 row by row로 DML이 남지 않는다.

APPLY_DML_ERR_REPORT_CNT

Dml Error Report 기능에 의해서 report file write가 시작되기 전 재시도 횟수를 설정하는 파라미터이다. (기본값: 20)

APPLY_REPORT_DIR

report 파일이 남겨질 디렉터리를 설정한다. (기본값: [prosync_directory]/var/[inst_id]/dml_err)

참고

다음의 타입들에 대해선 이 기능을 제공하지 않는다.

아래의 타입이 있는 테이블의 경우에는 컬럼의 값이 NULL로 기록된다.

  • NCHAR

  • NVARCHAR

🔎 ProSync 소개 바로가기
🔎 설치 안내서 바로가기
🔎 운영 가이드 바로가기
🔎 패치 가이드 바로가기
🔎 롤백 가이드 바로가기
🔎 장애 대응 가이드 바로가기
🔎 파라미터 바로가기

시스템 환경변수 설정

ProSync를 설치하기 위해 필요한 환경변수를 설명한다.

ProSync를 설치하기 위해 필요한 환경변수는 다음과 같다.

환경변수
설명

TB_HOME

TB_HOME은 Tibero DB가 설치된 홈 디렉토리이다. Tibero가 Source DB 또는 Target DB에 포함된 경우 해당 경로로 설정한다. Tibero를 사용하지 않는 경우에도 변수 자체는 반드시 설정되어야 하며, 이 경우 공백이나 dummy 경로 등으로 설정한다.

ORACLE_HOME

Oracle DB가 Source DB 또는 Target DB에 포함된 경우에만 설정한다.

PRS_HOME

ProSync가 설치된 최상위 디렉토리를 설정한다.

설치 스크립트는 SQL 실행 결과를 prs_install.log에 기록한 뒤, 그 텍스트에서 오류 코드를 추출하여 무시해도 되는 오류인지 판단한다. 예를 들어 설치 초기의 기존 객체 정리 단계에서는 객체가 존재하지 않아 발생하는 오류(TBR-7071, ORA-00942, ORA-02289, ORA-04043 등)가 정상적으로 발생하며, 설치 스크립트는 이를 무시하고 진행한다.

따라서 오류 메시지가 설치 로그에 깨지지 않고 기록되도록, 설치를 수행하는 shell의 locale과 DB 클라이언트의 Character Set 설정을 서로 일치시켜야 한다. 설정이 서로 다르면 DB가 반환한 오류 메시지가 깨진 문자로 기록되고, 설치 스크립트가 오류 코드를 정확히 추출하지 못해 무시해도 되는 오류까지 설치 실패로 처리되어 설치가 중단된다.

다음은 오류 메시지가 깨져 설치가 중단된 예시이다. 무시 대상인 ORA-00942가 실패로 처리되었다.

  • 설치를 수행하는 shell의 locale(LANG, LC_*)과 DB의 CHARSET, NCHARSET 설정이 서로 맞는지 확인한다.

  • DB 클라이언트의 Character Set 변수(Tibero TB_NLS_LANG, Oracle NLS_LANG, PostgreSQL PGCLIENTENCODING)를 shell locale의 encoding과 일치시킨다.

  • 설정은 Source DB와 Target DB 구분 없이

설치 시 Source/Target DB에 모두 접속하기 때문에 DB별 환경변수가 모두 설정되어야 한다.

  • tbsql 바이너리 경로가 PATH 환경변수에 존재해야 한다.

  • Tibero 데이터베이스를 사용하지 않는 경우, 참고하여 dsn파일 생성 후 TB_DSN_FILE 환경변수에 해당 파일 경로를 설정한다.

  • sqlplus 바이너리 경로가 PATH 환경변수에 존재해야 한다.

  • Oracle 데이터베이스를 사용하지 않는 경우, 참고하여 tnsnames.ora 파일 생성 후 TNS_ADMIN 환경변수에 해당 파일이 존재하는 폴더 경로를 설정한다.

  • psql 바이너리 경로가 PATH 환경변수에 존재해야 한다.

  • PostgreSQL 데이터베이스를 사용하지 않는 경우, 참고하여 service 파일 생성 후 PGSERVICEFILE 환경변수에 해당 파일 경로를 설정한다.

Extract

성능

Extract 프로세스는 Redo Log 파일을 읽어 변경 데이터를 추출하기 때문에, 디스크 읽기 속도가 성능에 영향을 줄 수 있으며 변경 데이터는 Chunk 형태로 Apply 프로세스에 전송하기 때문에, 네트워크 속도가 영향을 줄 수 있다.

ProSync 파라미터에 따라 성능이 변화할 수 있다.

  1. 로그 레벨(LOG_LEVEL)이 높다면, disk write가 많아짐에 따라 성능이 저하될 수 있다.

  2. 데이터 압축 기능을 사용한다면, 데이터 압축을 위한 동작이 추가됨에 따라 성능이 저하될 수 있다.

  3. 데이터 암호화 기능을 사용한다면, 데이터 암호화를 위한 동작이 추가됨에 따라 성능이 저하될 수 있다.


장애

패키지 수행 실패

ProSync는 적절한 반영 쿼리 생성을 위해 테이블의 DD image 변경이 발생하는 시점에 Trigger를 통해 내부 패키지를 수행하여 메타 테이블을 업데이트한다.

DDL 메타데이터는 DML 변경 데이터와 별도의 경로로 전달된다. Source에서 DDL이 수행되면 설치 시 생성된 trigger(PRS_DDL_TRG, PostgreSQL은 event trigger)가 PRS_DD_META 패키지/함수를 호출하여 PRS_DDL_HIST 테이블에 기록하고, Extract가 PRS_DDL_HIST를 polling하여 DD version을 갱신한 뒤 Apply로 전달한다. 자세한 흐름은 제품 설계의 를 참고한다.

메타 테이블 업데이트는 필요한 정보가 있는 시스템 테이블을 조회하여 동기화할 Object들의 정보를 메타 테이블에 insert하는 방식으로 설치 시점에 PRS_USER에 적절한 권한이 부여되지만, 사용 중인 PRS_USER에게서 필요한 권한을 회수한다면 해당 동작을 수행하지 못해 장애가 발생할 수 있다.

ProSync가 사용하는 PRS_DDL_HIST에서 오류가 발생했는지 확인할 수 있으며 해당 테이블에 오류가 발생한 경우, PRS_USER의 권한 변경이 있는지 확인이 필요하다.

다음 항목을 점검하면 DDL 메타데이터 경로의 장애를 진단할 수 있다.

  1. PRS_DDL_HIST에 오류 내용이 기록되어 있는지 확인한다.

  2. 최근 수행한 DDL이 PRS_DDL_HIST에 기록되고 있는지(기록 정체 여부)를 확인한다.

  3. 설치 시 생성된 trigger와 package(PRS_DDL_TRG, PRS_DD_META 등)가 유효한 상태인지 확인한다.

Extract 프로세스는 여러 파일에 대한 읽기 또는 쓰기 권한이 필요하다.

  • 변경 데이터 읽기 위해 Redo Log와 Archive Log들에 대한 읽기 권한이 필요하다.

  • 로그 작성을 위해 LOG_DIR, LOG_BACKUP_DIR 파라미터 경로에 대한 쓰기 권한이 필요하다.

  • 이전 Redo Log에서 commit되지 않은 tx정보를 저장하는 tlr(olr) 파일을 작성하기 위해 $PRS_HOME/var/[instance_name]/lr[node_num] 경로에 대한 읽기/쓰기 권한이 필요하다.

Log Reader가 특정 변경 데이터에 대한 처리를 하지 못한다면, 버그 리포트 후 새로운 바이너리로 교체가 필요하다.

정합성 불일치를 감수하고 동기화를 진행하려면 설치 안내서의 을 참고하여 문제되는 Redo Log를 넘기거나 corrupted lcr이 추출된 경우 _LR_SKIP_CORRUPTED_LCR 파라미터를 통해 넘길 수 있다.

파라미터
설명

Bug Report

ProSync 운영 중 장애 발생 시, 분석을 위해 현상 발생한 프로세스의 5레벨 로그와 config를 첨부해야 하며 장애 유형에 따라 다음 정보를 추가적으로 요청할 수 있다.

프로세스
config 파일 위치

Extract

$PRS_HOME/config/[INST_ID]_ext[NODE_NUM].cfg

Apply

$PRS_HOME/config/[INST_ID]_apply[NODE_NUM].cfg

Llob

$PRS_HOME/config/[INST_ID]_llob.cfg

다른 프로세스에서 전달한 정보에 오류가 의심되는 경우 요청할 수 있다.

config 파일의 LOG_DIR 경로에 위치한다.

현상 발생한 프로세스와 동일하게 5레벨 로그(LOG_LEVEL=5)를 첨부해야 한다.

Log Reader 오동작이 의심되는 경우 요청할 수 있다. 자세한 분석을 위해, Extract 프로세스의 파라미터를 LR_TRACE_LVL=5 로 설정한 뒤, 현상 재현을 요청한다.

$PRS_HOME/var/[INST_ID]/lr[NODE_NUM]/ 경로에 생성되는 tli[NODE_NUM].log/[INST_ID]_ext[NODE_NUM]_li.log 파일을 첨부해야 한다.

여러 Redo Log에 Chaining된 TX에 대해, 잘못된 값을 추출한 것으로 의심되는 경우 요청할 수 있다.

Extract 프로세스를 기동한 장비의 $PRS_HOME/var/[INST_ID]/lr[NODE_NUM]/ 경로에 생성된다.

Log Reader에서 잘못된 값을 추출한 것으로 의심되는 경우, 마지막으로 읽은 Redo Log를 요청할 수 있다.

Extract 프로세스에서 마지막으로 출력한 redo log found 또는 redo/archived log found 로그를 통해 마지막으로 읽은 로그를 알 수 있다.

기동 실패, 파라미터 동적 변경 실패, 동기화 테이블 추가 실패 등 Agent 프로세스에서 요청을 보내는 기능이 실패하는 경우, 실패한 지점을 분석하기 위해 5레벨 Agent 로그를 요청할 수 있다.

config 파일의 LOG_DIR 경로에 위치한다.

Apply 프로세스에서 메모리 관리를 위해 파일로 내린 TX 데이터의 손상이 의심되는 경우 요청할 수 있다.

Apply 프로세스를 기동한 장비의 $PRS_HOME/var/[INST_ID]/tx 경로에 생성되며 config파일에 TX_HASH_FILE_DIR 파라미터 설정 시, 해당 경로에 생성된다.

User Filtering

ProSync는 특정 사용자에 의해서 발생된 DML 및 DDL을 동기화에서 제외할 수 있는 기능을 제공한다.

양방향 동기화

같은 테이블에 대해 Source DB에서 Target DB로, Target DB에서 Source DB로 동기화 하도록 2개의 ProSync 인스턴스를 사용하여 구성할 수 있다. 이 경우, 별다른 설정이 없다면 상대방의 PRS_USER가 반영한 동기화 데이터가 다시 추출되어 Source DB로 전송될 수 있다.

Redo Log에는, tx에 대해 이를 수행한 User를 알 수 있는 정보가 있으며 ProSync는 이 정보를 활용해 상대방의 PRS_USER로 EXCLUDE_USER 파라미터를 설정하여 이미 반영한 데이터를 재반영하는 현상을 막을 수 있다.

사용

다음은 TEST 사용자와 PRS_USER 사용자를 동기화에서 제외하는 예제이다.

EXCLUDE_USER=PRS_USER,TEST

파라미터
설명

Parallel Execution (Parallel Replay)

커밋이 요청된 트랜잭션은 반영을 할 수 있으면 반영을 하고, 반영을 할 수 없으면 큐에서 대기하게 된다. 반영 가능 여부는 반영하고자 하는 트랜잭션과 반영 중인 트랜잭션 간의 의존성 체크를 통해 서로 독립적일 경우 반영이 가능하다고 판단한다.

의존성 체크는 Table과 Row 단위 모두 확인을 한다. 트랜잭션은 레코드로 이루어져 있고, 레코드에는 레코드가 접근하는 Row가 정해져 있기 때문에, 해당 데이터를 기반으로 다른 트랜잭션과 의존 관계인지 여부를 판단한다.

의존성 확인 동작은 RedBlack Tree(RBT)와 Linked List로 관리가 되고 있다. Table 단위로 RBT를 확인하고, Table이 확인되면, 해당 Table 노드 내의 RBT에서 Row를 확인한다. 이 위치엔 Linked List가 존재하며, 트랜잭션은 해당 List에 의존성 객체(TX Dependency)를 달아 놓는다.

이 동작을 통해 트랜잭션이 접근하는 모든 Row에 대한 Linked List에 TX Dependency가 등록이 된다. 반영 중인 트랜잭션이나 반영 대기 중인 트랜잭션 모두 이 구조 안에서 관리된다.

반영 가능 여부는 트랜잭션의 모든 TX Dependency가 Linked List의 front에 존재하는지의 여부로 확인한다. 하나라도 front에 존재하지 않는다면 반영이 불가능하고, 앞서 반영 중인 트랜잭션의 완료를 대기하게 된다.

그림 1. 반영이 가능한 경우

반영이 가능한 경우는 위 그림과 같이 모든 의존성 체크를 했을 때 Linked List 상에 TX Dependency 가 가장 앞선 경우이다.

그림 2. 반영이 불가능한 경우

만약 위 그림과 같이 xid: 111인 트랜잭션이 아직 반영이 끝나지 않았다면 대기하게 된다. 반영이 완료된 트랜잭션은 위 Linked list에서 제거가 되고, xid: 112가 반영 가능하게 되면 반영 작업을 진행한다.

참고

의존성 판단 기준

그림을 보면 확인이 가능하듯이, Row 단위의 비교가 가능해야 한다. 오라클과 티베로와 같은 RDBMS 에는 ROWID라는 Row별 고유 식별자가 존재한다.

ROWID를 구성하는 요소는 데이터 파일 번호, 데이터 파일 내 블록 번호, 블록 내 Row데이터 위치로 구성이 되고 이 데이터는 Row의 고유 ID가 된다. ProSync는 기본적으로 이 데이터를 통해 의존성을 확인한다.

또한 Primary key, Foreign key 관계에 있는 두 Row데이터의 경우 시간 순서를 반드시 맞춰주어야 한다. 따라서 이 경우도 위 Row에 대한 RedBlack Tree와는 별개의 Tree로써 관리가 된다.

관련 파라미터는 REPLAY_THREAD_CNT 로, 해당 값이 올라가면 병렬 세션의 수가 많아진다. 하지만 위 로직에서 알 수 있듯이 결국 RBT 내에서 Table, Row단위로 TX Dependency가 잘 풀려야 병렬 반영이 가능하다. 이로 인해 숫자를 올린다고 반드시 올린 숫자만큼 정비례하게 증가하지 못하는 경우도 발생한다.

제품 설계

ProSync 제품 이해를 위한 기본적인 설계 자료를 안내한다.

ProSync는 위와 같은 설계를 가지고 있다. 전체 설계에 대한 간단한 요약을 하면 아래와 같다.

Extract 프로세스는 추출 데이터베이스( SRC DB )에서 데이터베이스 변경 로그(database change log)를 추출한다. 변경 로그는 DB 종류에 따라 다르다. Tibero와 Oracle은 Redo Log를 읽고, PostgreSQL은 WAL(logical decoding)을 읽는다. 추출은 각 DB별 Log Reader Library를 통해 진행하며, 필요한 경우, 각 DB별로 제공하는 별도의 로그 분석 기능을 통해 추출을 진행하기도 한다. 추출된 데이터는 Apply 프로세스로 전달된다.

데이터는 보통 레코드 단위 (쉽게 말해 DML 단위)로 남게 되며, 해당 데이터는 Apply 프로세스에서 트랜잭션별로 취합해 반영해주어야 한다. 따라서 Apply 프로세스는 레코드들을 전달받아 트랜잭션별로 모아둔다. commit에 해당하는 레코드가 오게 되면, 트랜잭션을 반영시킨다.


ProSync의 Data Flow를 기준으로 살펴보면 조금 더 상세한 과정을 볼 수 있다.

Extract 프로세스는 레코드를 chunk 단위로 모아 Apply 프로세스로 전달한다. 전달받은 Apply 프로세스는 각 레코드들을 트랜잭션 단위로 모아준다. commit 레코드가 올 경우 반영 데이터베이스(TAR DB) 로 반영하게 된다.

위의 Data Flow는 DML 변경 데이터(change log) 기준의 경로이다. DDL의 메타데이터는 이와 분리된 별도의 경로로 전달된다.

DDL 동기화가 정상적으로 동작하려면 설치 시 Source DB에 생성되는 trigger와 package가 유효해야 한다. 관련 오류와 정체 상태의 진단 방법은 를 참고한다.


ProSync는 프로세스 간 통신은 TCP를 사용하고, 스레드 간 통신은 Pipe를 사용한다.

Memory Control

ProSync의 데이터 흐름도를 상세히 이해하고, 이를 통해 Memory 사용량 조절방식을 안내한다.

데이터가 처음 생성되는 위치는 Source DB의 Redo Log이다. Redo Log에서 발생된 데이터를 Extract 가 추출하여 Chunk 단위로 데이터를 적재한다.

적재된 데이터는 TCP Socket을 통해 전송이 된다. Non Blocking 통신이기 때문에 전체 데이터에 대한 전송이 실패하면, 이후의 데이터들은 Non Blocking Queue에 쌓이게 된다. 이 Queue에 쌓인 데이터는 커널로부터 반대쪽 TCP Recv Buffer가 비어있다는 신호가 올 때, 순서대로 다시 데이터를 보내게 된다.

Apply는 받은 데이터를 모두 객체화 (역직렬화) 하여 TX_HASH에 쌓이게 된다. xid 는 트랜잭션 고유의 id 를 의미하며, ACID를 지켜주기 위해 트랜잭션의 커밋까진 이 위치에서 데이터를 계속 보관한다. 트랜잭션의 커밋이 들어오면 해당 트랜잭션은 Target Database에 반영이 가능한 상태로 판단하고 Replay Queue로 데이터를 넘겨준다.

Wait Queue에 쌓인 데이터는 트랜잭션들이 커밋된 순서에 맞게 Target Database로 반영이 된다. 이때 반영 중인 트랜잭션과 반영 대기 중인 트랜잭션이 있을 텐데, 이들간의 의존성 검사를 통하여 시간 순서에 맞고, 의존성이 없는 트랜잭션들은 병렬 처리하여 성능을 높인다.

TX_HASH 에 데이터가 계속 쌓인다면 Out of Memory 를 피할 수가 없다. 따라서 특정 임계치를 넘어갈 경우 Part File이라는 이름으로 된 파일을 생성하여 이 위치로 데이터를 옮겨준다.

데이터를 옮기는 기준은 현재 TX_HASH에 있는 데이터들 중 가장 용량이 큰 트랜잭션 기준으로 파일로 내려가게 되며, 내려간 파일은 실제 반영이 되는 시점까진 계속 Disk에 남게 된다

이에 대한 기준이 되는 파라미터가 TX_HASH_SIZE

Extract Process

Extract 프로세스는 Source DB의 변경 로그를 추출하여 Apply 프로세스로 전달하는 동작을 수행한다.

Source DB가 Tibero 또는 Oracle인 경우, redo log를 읽어 변경 로그를 추출하므로 반드시 redo log에 접근 가능한 위치(일반적으로 Source DB가 존재하는 장비)에서 기동되어야 한다.

Source DB가 PostgreSQL인 경우에는 WAL logical replication 연결(network)을 통해 변경 로그를 추출하므로 반드시 Source DB 서버에 기동될 필요는 없으며, Source DB에 network로 접속할 수 있고 replication 권한이 있는 위치라면 기동할 수 있다.

변경의 최소 단위는 LCR로, 레코드 단위의 변경을 의미하며 네트워크 부하를 고려하여 여러 LCR을 Chunk로 만들어 Apply 프로세스에 전달한다.


기동 시 다른 Thread 시작, 메시지 수신 및 전송 등의 작업을 수행한다.

프로세스의 CPU/Memory 사용량을 수집한다. ProSync 매니저 사용 시, Agent 프로세스를 통해 수집한 값을 ProSync 매니저로 전송한다.

동기화 테이블 추가, 동기화할 테이블 및 컬럼들의 정보인 DD image 조회, DB의 상태 파악을 위한 dummy tx 생성 등 변경 데이터 추출과는 상관없는 메타데이터 조회나 수정과 같은 작업을 수행한다.

또한 Apply 프로세스로 나가는 연결(connect)은 Worker Thread가 수행하며, 연결된 소켓은 Control Thread에 전달되어 이후 통신에 사용된다.

추출한 변경을 Text 파일로 출력하는 SAM 기능을 수행한다.

변경 데이터를 추출하고 이를

참고자료_파라미터

An initialization parameter describes a ProSync configuration. It is provided with a text file and required to create a ProSync.

An initialization parameter file is a text file, with a filename in the form prosync.cfg needed when starting a ProSync. It can be edited using a document editor provided with the operating system. Once the initialization parameter file is modified, the ProSync must be restarted to apply the modification to the entire system.

However, not all initialization parameters require the restarting of the ProSync after their modification. Some parameters can be modified while being used by an instance. These parameters are applied only to the current instance, not the initialization parameter file.


This section explains the class attributes necessary for users to understand the information configured in the initialization parameter file.

Group
Class
Description

Multi thread

성능 향상을 위해, Apply 프로세스의 요청에 따라 Source DB에서 데이터 조회를 수행할 Read Thread 의 개수를 설정할 수 있다.

LLOB_THREAD_CNT=[1-4]

파라미터
설명

LONG

  • BLOB

  • CLOB

  • Active-Active 환경 지양

    Target DB 에서 SEQUENCE 의 사용을 지양한다. NEXTVAL을 통해 Target DB 에서 SEQUENCE 를 사용하게 되면 동기화 중인 SEQUENCE 의 정합성, 특히 고유성에 문제가 생길 가능성이 높다.

    LLOB_THREAD_CNT

    기동 시 생성할 Read Thread 의 개수를 설정한다

    PRS_USER의 권한이 회수되었는지 확인한다.

    _LR_SKIP_CORRUPTED_LCR

    Log Reader에서 corrupted lcr이 추출되어도 추출을 정지하지 않도록 설정한다.

    DDL Metadata Flow
    이력조절

    주의

    DDL 메타데이터가 PRS_DDL_HIST에 반영되지 않으면 Extract/Apply가 보유한 DD 정보와 실제 테이블 구조가 불일치하게 되어, 이후 동기화 오류로 이어질 수 있다.

    권한 없음

    Log Reader 오류

    Agent

    $PRS_HOME/config/prs_agent_[AGENT_ID].cfg

    타 프로세스 로그

    TLI(OLI) 로그

    TLR(OLR) 로그

    Redo Log

    Agent 로그

    Tx Hash

    Static/Dynamic

    Static

    A parameter that cannot be modified during system operation.

    Dynamic

    A parameter that can be modified during system operation.

    Mandatory/Optional

    Mandatory

    A parameter required to start up a system. If these parameters are not defined in the initialization parameter file, the system cannot be booted.

    Optional

    A parameter that uses a default value if not defined in the initialization parameter.

    Overview

    Class Attributes

    Llob

    Llob 프로세스는 Apply 프로세스의 요청에 따라 read Thread 에서 해당 시점(TSN 또는 SCN)의 llob 데이터에 대한 select 쿼리를 수행하기 때문에, 해당 시점에 대한 정보가 없는 경우(flashback 쿼리 실패) 현재 시점을 기준으로 조회하며 이때, 현재 시점에 해당 row가 존재하지 않는다면 조회를 실패할 수 있다.

    성능

    Apply 프로세스에서 최대 20개의 Replay Thread 를 사용하여 동기화를 수행할 수 있고, 모든 Thread 에서 llob 데이터가 존재하는 테이블을 동기화 한다면 Llob 프로세스에서 모든 요청을 처리하는데 지연이 발생할 수 있다.

    이때, LLOB_THREAD_CNT 파라미터를 사용하여 Apply 프로세스의 요청을 분배해 성능을 개선할 수 있다.


    장애

    추출한 시점의 TSN(SCN)으로 flashback 쿼리를 수행할 수 없으면서 현재 해당 row가 존재하지 않는다면 llob 데이터 조회가 실패하고 ProSync는 해당 row 동기화를 계속해서 재시도한다.

    Key Features

    본 장에선 Apply 프로세스의 주요 기능들을 설명한다. Apply 프로세스 운영을 위한 핵심적인 요소들로서 원활한 운영에 도움이 될 수 있다.

    설치에 사용하는 모든 shell에 동일하게
    적용한다.

    PATH

    파일 시스템을 통해 특정 파일에 접근하기 위한 디렉토리 경로를 설정하는 환경변수이다. 아래와 같이 설정한다.

    LD_LIBRARY_PATH

    DB 접속을 위해 클라이언트 라이브러리에 대한 접근 경로를 설정한다.

    OS에 따라 LIBPATH, SHLIB_PATH 등으로 다를 수 있으며, 아래와 같이 설정한다.

    LANG, LC_*

    설치를 수행하는 shell의 locale을 설정한다. 설정값에 따라 설치가 실패할 수 있으므로 아래 'Locale 및 Character Set 설정'을 참고한다.

    DB 클라이언트 Character Set 변수

    DB 클라이언트가 사용할 Character Set을 설정한다. DB 종류에 따라 변수명이 다르며, Tibero는 TB_NLS_LANG, Oracle은 NLS_LANG, PostgreSQL은 PGCLIENTENCODING을 사용한다. 설정값에 따라 설치가 실패할 수 있으므로 아래 'Locale 및 Character Set 설정'을 참고한다.

    별칭 설정 가이드
    별칭 설정 가이드
    별칭 설정 가이드

    Locale 및 Character Set 설정

    확인 항목

    설치 시 DB 별 주의사항

    Tibero

    Oracle

    PostgreSQL

    export PATH=$PRS_HOME/bin:$PRS_HOME/client/bin:$PATH
    export LD_LIBRARY_PATH=$PRS_HOME/lib:$PRS_HOME/client/lib:$LD_LIBRARY_PATH
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking Oracle Version... ok : 19
    Dropping ProSync objects... failed 00942읶 ORA-00942: 읶
    그림 3. Inter process & Inter thread communication in ProSync.

    어떤 종류의 프로세스건, Main 스레드는 반드시 존재하고 (ProSync에선 CTH 혹은 Control Thread 라고 부른다.) 해당 스레드가 다른 스레드와의 통신을 모두 담당한다. 즉, A라는 스레드에서 B라는 스레드와 직접 통신하는 것은 불가능하고, 반드시 Main 스레드를 거쳐서 통신하게 되어 있다.

    또한 프로세스 간 통신은 TCP로만 진행된다. 소켓의 accept는 각 프로세스의 Main 스레드가 담당하지만, 모든 connect를 Main 스레드가 수행하는 것은 아니다. 예를 들어 Extract 프로세스에서 Apply 프로세스로 나가는 연결은 Write Thread(WTHR)가 connect를 수행한 뒤, 연결된 소켓을 Main 스레드에 전달하여 이후의 통신을 관리하게 한다.


    전체 프로세스들의 기능과 구조를 간단하게 설명한다.

    Data Flow 를 기준으로 설명했던 프로세스는 주로 Extract 프로세스와 Apply 프로세스이다. 이 두 프로세스가 ProSync의 핵심 프로세스이나, 프로세스 전체를 관리하고 데이터를 수집하여 모니터링 툴에 전달해주는 등의 기능을 해주는 Agent 프로세스나 Long 혹은 Lob 데이터 처리를 위해 별도로 구성된 Llob 프로세스, Agent 프로세스를 통해 실제 프로세스에 명령을 내리는 Admin 프로세스의 구성을 이해하면 이후에 언급되는 내용을 이해하기 쉽다.

    전체 구성을 보면 아래와 같다.

    그림 4. ProSync Processes

    각 프로세스에 대한 역할은 아래와 같다.

    Agent 프로세스를 통해 다른 프로세스에게 명령을 내린다. Agent 에게 내린 명령과 리턴을 터미널에서 출력한다고 이해할 수 있다.

    명령어 목록은 Admin 매뉴얼을 참고한다.

    프로세스 관리에 들어가는 다양한 업무를 여기서 모두 수행한다. 대표적으로 아래와 같은 작업들이 있다.

    • 프로세스 기동 / 종료

    • 프로세스 별 리소스 모니터링

    • 프로세스 설정 변경

    이외에도 관리에 해당하는 작업은 모두 이곳에서 작업을 수행해준다.

    CDC 에 있어서 변경 데이터를 캡쳐하는 프로세스이다. RDBMS의 변경 로그(Tibero/Oracle: Redo Log, PostgreSQL: WAL)를 보고 데이터를 추출하는 작업을 수행한다.

    변경된 데이터를 peer쪽에 반영하는 작업을 수행한다.

    RDBMS에서 사용되는 Long 혹은 Lob 과 같은 큰 단위의 데이터는 변경분의 데이터도 크다. 따라서 데이터가 리두에 남는다 하여도, 트랜잭션 말미에는 데이터가 삭제가 되거나 혹은 크게 변경될 가능성이 있다.

    트랜잭션 단위로 봤을 땐, 마지막 형상의 데이터만 알아도 ACID를 유지하는 데에는 아무 문제가 없다. 모든 변경분의 데이터를 추적하지 않아도 ACID가 유지가 된다는 뜻은 처리 성능(Throughput)을 불필요하게 희생하면서까지 연산을 수행할 필요는 없다는 의미이다.

    Llob 프로세스에서 주로 수행하는 일은 Commit 이 들어온 시점에 Flashback 쿼리를 수행하여 해당 시점 즉 트랜잭션이 종료되는 시점에서의 데이터만 조회하여 Apply 에서 발생하는 데이터 처리량을 줄이고, 전체 동기화 과정에서의 부하를 줄여주는 프로세스이다.

    Source DDL 수행
      -> PRS_DDL_TRG (Tibero/Oracle trigger) / PostgreSQL event trigger
      -> PRS_DD_META package/function 호출
      -> PRS_DDL_HIST 테이블에 기록
      -> Extract가 PRS_DDL_HIST를 polling하여 DD version 갱신
      -> Extract가 DD 정보를 Apply로 전달
      -> Apply의 Construct/Replay Thread가 DD 교체
    장애 대응 가이드
    그림 1. ProSync Architecture
    그림 2. ProSync DataFlow

    ProSync Architecture

    Data Flow

    참고

    더욱 상세한 내용은 'Memory Control'를 참고한다.

    DDL Metadata Flow

    Inter Processes/Threads Communication

    ProSync Processes

    참고

    각 프로세스에 대한 내용은 를 참고한다.

    Admin Process

    Agent Process

    Extract Process

    Apply Process

    Llob Process

    파라미터이다.
    TX_HASH_SIZE
    라는 임계치보다 더 많이 데이터가 쌓이게 될 경우 아래와 같은 동작이 수행된다고 생각하면 된다.
    그림 2. TX_HASH 크기가 TX_HASH_SIZE 파라미터보다 큰 경우

    Part File은 반영이 완료되면 제거가 되며, 반영이 되기 전까진 Disk에 남는다. 실제 트랜잭션 반영 시점에도 Part File로 내려간 DML 데이터들이 시간 상 더 앞서기 때문에, 파일에 있는 데이터를 먼저 반영한 후 메모리에 남은 트랜잭션 데이터를 반영한다.

    ProSync는 ACID를 지켜주기 위해 데이터를 순서에 맞게 반영해야 한다. 즉, 앞선 트랜잭션이 반영되지 않는 경우 데이터는 반영될 수 없다는 의미이다. 따라서 Target Database에 장애가 발생하여 트랜잭션 처리가 지연된다면 그만큼 Queue에는 데이터가 쌓이게 된다.

    Queue에 영구적으로 데이터가 쌓이는 것을 방지하기 위해 ProSync는 Queue 내에서 대기 혹은 반영 중인 트랜잭션들의 크기를 모두 확인한다. 이 크기가 너무 크다면 Memory 할당을 멈춰야 한다.

    Memory 할당을 멈추기 위해 ProSync는 데이터가 추가적으로 생산되는 것을 막는다. 즉, Extract로부터 수신되는 데이터를 일시적으로 차단함으로써, 현재 보유 중인 데이터가 일정 수준 이상 처리될 때까지 대기 상태를 유지하도록 강제하는 방식이라고 볼 수 있다.

    Extract는 앞에서 설명한 내용대로 Non Blocking Queue에 데이터를 쌓다가 실제 추출을 멈춤으로써 추가적인 데이터 생산을 멈추게 된다.

    임계치에 해당하는 파라미터는 아래와 같다.

    • MEMORY_CTRL_STOP_SIZE Wait Queue에 이 크기 이상 만큼의 데이터가 쌓이면 Socket 으로 부터 추가적으로 들어오는 데이터를 막는다.

    • MEMORY_CTRL_RESUME_SIZE Wait Queue에 이 크기 이하만큼 데이터가 줄어들면, Socket 으로 부터 데이터를 다시 받는다.

    그림으로 나타내면 아래와 같다.

    그림 3. Socket Block in ProSync

    Active-Active Cluster인 RDBMS들은 Physical Disk를 공유하고 있다. 따라서 같은 공간에 서로 순서에 적합하게 데이터를 입력한다. Redo Log는 서로 다른 곳에 작성하더라도 Change Data들의 시간은 순서에 맞게 끔 작성이 된다. ProSync 입장에서 보면 서로 다른 위치에 남은 Redo Log들을 모아 직렬화를 하면 결국 DB Time 순서대로 데이터 정렬이 가능하다는 의미이다.

    따라서 ProSync의 Apply 입장에선 추출이 Cluster인지 아닌지는 관심사가 아니다. 어차피 DB Time 기준으로 정렬이 가능한 데이터라면 단순히 한 줄로 세워 놓고 하나씩 쿼리로 변경해주면 된다. 다만 문제는 장애 상황이나 지연 상황에서 발생한다.

    만약에 한쪽 노드에서 아무런 부하가 없거나 장애로 멈춰버리게 되면 Redo Log 작성이 멈추게 된다. 읽을 것이 없는 Extract 프로세스는 아무런 데이터를 보낼 수가 없다. 이렇게 되면 Apply 프로세스 입장에선 현재 Cluster 중 하나가 장애가 나서 못 보내고 있는 것인지, 부하가 없어서 데이터를 못 보내는 것인지 확인할 방법이 없다.

    따라서 Extract 에서는 장애가 발생했다는 메시지를 TCP Socket으로 전달해주고, 부하가 없는 상황을 대비하여 ProSync용 Dummy Table에 강제로 부하를 만들어 데이터를 생산해서 전달해준다.

    이 과정을 통해 Apply 프로세스는 서로 다른 Cluster Node의 데이터들을 항상 정렬할 수 있다. 하지만 정렬을 하기 위해선 정렬을 위한 공간이 필요하며, 이 위치는 아래 그림과 같다.

    그림 4. Merge Queue

    위와 같이 Extract가 여러 개인 상황 (Active Cluster) 에선 각 Extract 별로 데이터를 먼저 Merge Queue에 쌓아 놓는다. 쌓인 데이터가 직렬화가 되려면 모든 Extract 별 데이터가 1개라도 있어야 하기 때문에 이때까진 Merge Queue에 데이터가 쌓이게 된다.

    다만 네트워크 장애나 모종의 이유로 한쪽에서 데이터가 들어오는 행위가 매우 지연될 수 있기 때문에, 마찬가지로 여기서도 추가적인 데이터가 들어오지 못하게 TCP Socket으로 부터 데이터를 막는 동작이 사용된다.

    여기에 사용되는 파라미터는 아래와 같다.

    • MERGE_BLOCK_CNT 특정 노드로부터 데이터가 이 개수 이상만큼 쌓이면 해당 TCP Socket을 막는다.

    • MERGE_RESUME_CNT 특정 노드로부터 데이터가 이 개수 보다 작다면 해당 TCP Socket을 다시 열어준다.

    그림으로 보면 아래와 같다.

    그림 5. Socket Block in ProSync 2

    Extract 별로 연결이 따로 존재하므로 이와 같이 별도로 관리하게 된다.

    그림 1. ProSync DataFlow

    ProSync Data Flow

    Case 1. TX_HASH 에 데이터가 지나치게 많이 쌓이는 경우

    Case 2. Wait Queue에 데이터가 지나치게 많이 쌓이는 경우

    주의

    Wait Queue 관련

    Replay 쪽에선 많은 자료구조를 사용한다. 반드시 Wait Queue만 사용하는 것은 아니며, 여러 종류의 Queue나 Tree 등이 사용되는데, 여기선 설명을 위해 모두 Wait Queue로 추상화하여 설명한다.

    Source DB가 Cluster인 경우의 고려사항

    Chunk
    형태로 만든 뒤 Control 스레드를 통해 Apply 프로세스에 전달한다.

    Source DB가 Tibero 또는 Oracle인 경우 Log Reader 라이브러리를 사용해 redo log에 접근하며, PostgreSQL인 경우 logical replication 연결을 통해 WAL을 읽는다. 비정상 종료, Apply 프로세스 재연결 등의 장애 상황 발생 시, 마지막으로 읽고 있던 redo를 처음부터 다시 읽기 시작한다.

    추출 시작 지점은 Apply 프로세스에 저장되어 있기 때문에, Apply 프로세스와 연결 전까진 추출을 시작하지 않는다.

    그림 1. Extract Process

    Process 설명

    Threads

    Control Thread

    Resource Thread

    Worker Thread

    Sam Thread

    Read Thread

    EXCLUDE_USER

    동기화에서 제외할 사용자 이름을 콤마(,)로 구분해 나열한다. 사용자 이름은 데이터베이스에 저장된 형태(일반적으로 대문자)로 입력한다.

    ProSync 4.7은 Oracle 세션 식별과 DML 필터링을 개선하여 EXCLUDE_USER로 지정한 사용자의 DML/DDL을 제외한다.

    다만 설치 이전에 트랜잭션을 수행한 세션을 재접속 없이 계속 사용하면 사용자 정보를 확보하지 못해 필터링되지 않을 수 있으므로, 해당 세션을 재접속한 뒤 제외 동작을 확인한다.

    참고

    양방향 과 Oracle 관련 제약사항

    ProSync 4.4.2 버전 이상의 Oracle 이 포함된 양방향 동기화에선 ROLLBACK_OBJECT_IDS 파라미터를 설정해야 한다.

    Redo상에 남는 세션 정보를 통해 필터링 하는 기존 방식과 다르게, ProSync가 동기화한 트랜잭션을 Object id(Segment id)로 감지하고 이를 통해 트랜잭션 자체를 롤백하는 기능이다.

    ProSync의 Apply프로세스는 PRS_COMMITTED_TX_LIST 테이블을 조작하게 되어 있으며, 이에 대한 Object id, Segment id를 위 파라미터에 모두 작성해주면 된다. 다음은 조회 쿼리 예시이다. (Tibero의 경우 추출 시 Supplemental Log로 Object id가 남으므로 Segment를 조회하거나 추가할 필요는 없다.)

    • Target Oracle Object ID 조회

    • Target Oracle SGMT ID 조회

    조회된 OBJ# 와 DATAOBJ# 를 모두 ROLLBACK_OBJECT_IDS 에 나열한다.

    • Target Tibero Object ID 조회

    Tables

    Extract 프로세스에서 Source DB에 생성하고 사용하는 메타 테이블에 대해 안내한다.

    PRS_OBJ_LIST

    동기화할 object들의 Type, Owner, Name, 등록 시기를 저장한다.

    PRS_TXINFO

    tlr(olr)파일의 위치, seq 정보를 저장한다.

    tlr(olr)파일은 Redo Log를 모두 읽고 다음 Log를 읽기 전 아직 commit되지 않은 tx 정보를 저장한 파일로 ProSync는 Begin이 없는 tx에 대해서는 추출하지 않기 때문에, 기동 시점에 따라 누락되는 tx가 없도록 이전 Redo Log를 읽었을 때 아직 commit되지 않은 tx정보를 저장한다.

    PRS_DDL_HIST

    발생한 DDL의 시점, DDL 종류, 메타 테이블 업데이트 여부, 이후 ProSync가 사용하는 DD의 Sequence 정보를 저장한다.

    PRS_DICT_HIST

    Source DB가 Oracle이며 Log Miner를 사용하여 동기화하는 경우 사용한다. DD 정보를 저장한 dict파일 정보를 저장한다.

    PRS_DD_USR

    Source DB에 존재하는 USER들의 이름과 USER_ID를 저장한다. User Filtering 기능을 사용하기 위해 저장한다.

    PRS_DD_TBL

    동기화 테이블의 DD sequence, object id, 테이블명 정보를 저장한다. Redo Log는 object id만 남기기 때문에, 해당 정보를 Apply 프로세스에 전달하여 적절하게 반영 쿼리를 생성한다.

    PRS_DD_SGMT

    특정 object_id가 어느 테이블에 속하는지 정보를 저장한다.

    파티션 등에 저장되는 데이터는 테이블과는 다른 object_id를 남기기 때문에, 해당 데이터를 문제없이 추출하기 위해 파티션의 object_id와 테이블의 object_id를 매핑한다.

    컬럼의 속성과 어느 테이블에 속하는지 정보를 저장한다. Redo Log는 컬럼 속성 정보를 남기지 않기 때문에, 해당 정보를 Apply 프로세스에 전달하여 적절하게 반영 쿼리를 생성한다.

    컬럼의 제약 조건 정보를 저장한다. Apply 프로세스의 Parallel Replay에서 적절하게 반영 순서를 조합하기 위하여 사용된다.

    테이블의 암호화 정보를 저장한다. Apply 프로세스에서 복호화하기 위해 저장한다.

    변경 데이터가 없는 경우에도 추출, 반영에 문제 없는지 확인용으로서 주기적으로 부하를 발생시키기 위한 목적으로 사용된다. 부하가 없는 경우, 주기적으로 해당 테이블에 대한 부하를 발생시킨다.

    Source DB가 Oracle이며 Log Miner를 사용하여 동기화하는 경우 사용한다. 마지막으로 추출한 시점 정보를 저장한다.

    시퀀스 동기화를 위한 정보를 저장한다.

    ProSync의 초기적재 기능을 사용하기 위한 정보를 저장한다.

    Source DB가 Oracle이며 Log Miner를 사용하여 동기화하는 경우 사용한다. instance 이름을 저장한다.

    CM 명령어 모음

    그룹 리소스를 추가하기 위한 명령어이다. 그룹은 클러스터라는 환경 위에서 agent 서비스를 관리하기 위한 개념이다

    Key
    Value Type
    설명

    환경설정

    ProSync Admin Utility의 환경을 설정하는 방법과 시스템 변수에 대해 안내한다.

    시스템 변수는 를 통해 변경할 수 있다.

    명령어 히스토리의 크기를 설정한다.

    항목
    설명

    화면상의 한 라인의 길이를 설정한다. 라인 길이의 최소값은 1이며, 최댓값은 운영체제에 따라 다르다.

    Llob Process

    Llob 프로세스는 Apply 프로세스의 요청에 따라 Source DB의 Long, Clob, Blob 등의 대용량 데이터를 전달하는 동작을 수행한다.


    기동 시 다른 Thread 시작, 메시지 수신 및 전송 등의 작업을 수행한다. Apply Thread의 요청이 오는 경우, 적절한 Read Thread 에 전달한다.

    Apply Thread의 요청에 따라 Source DB에 flashback query를 통해 llob 데이터를 조회하고 이를 Control Thread를 통해 요청한 Apply 프로세스에 전달한다.

    해당 시점으로 flashback query를 할 수 없는 경우의 동작은 LLOB_FLASHBACK_ERROR 파라미터 설정에 따라 다르다.

    설정값
    동작

    PRS_DD_COL

    PRS_DD_CON

    PRS_DD_ENC

    PRS_DUMMY_TBL

    PRS_LOGMNR_INFO

    PRS_DD_SEQ_TBL

    PRS_DD_ETL_HIST

    PRS_INSTALL_TOP

    참고

    본 페이지에 언급되지 않은 테이블은 Deprecated 되어 불필요한 테이블이다.

    소프트웨어 요구사항

    ProSync를 설치하고 운영하기 위해 필요한 소프트웨어 환경을 설명한다. 지원되는 데이터베이스 시스템과의 호환성, 운영체제 및 플랫폼, 컴파일러, JDK 등의 시스템 환경 요구사항에 대해 안내한다.

    Performance

    ProSync는 Apply 프로세스 지연 시 모든 곳에 지연이 발생하게 된다. 이 때문에 성능을 올릴 수 있는 수단들이 존재한다. 본 장에서는 Performance 측면에서 설정할 수 있는 Configuration들에 대해 알아본다.

    항목
    설명

    n

    화면상의 한 라인의 길이이다. (기본값: 80)

    NUMBER 타입을 출력할 길이를 설정한다. LINESIZE를 넘을 수 없다.

    항목
    설명

    n

    NUMBER 타입 데이터의 기본 출력 길이이다. (기본값: 10)

    한 화면에 출력할 라인 수를 설정한다.

    항목
    설명

    n

    한 페이지의 라인 개수이다. (기본값: 24)

    화면상의 프롬프트 문자를 설정한다.

    항목
    설명

    prompt_string

    프롬프트로 사용할 문자열이다. (기본값: "Admin>")

    이 문자열을 중괄호({ })로 감싸면 환경변수로 인식된다.

    예를 들어 '{PRS_PROMPT}'이라고 지정하면 환경변수 $PRS_PROMPT의 값이 치환되어 프롬프트로 사용된다. 이때 환경변수의 이름은 대소문자를 구분한다.

    파일 확장자를 생략했을 때 사용할 파일 확장자를 설정한다.

    항목
    설명

    extension

    기본으로 사용할 파일 확장자이다. (기본값: sql)

    n

    명령어 히스토리의 크기이다. (기본값: 50)

    SET 명령어

    시스템 변수

    HISTORY

    LINESIZE

    NUMWIDTH

    PAGESIZE

    PROMPT

    SUFFIX

    SET HIS[TORY] {n}
    SET LINE[SIZE] {n}
    SET NUM[WIDTH] {n}
    SET PAGE[SIZE] {n}
    SET PROM[PT] {prompt_string}
    SET SUF[FIX] {extension}

    string

    그룹의 종류를 나타내기 위한 용도이다. (필수)

    failover

    string

    agent가 종료되었을 때 failover 기능 사용 여부이다. (default: true)

    Agent 리소스를 추가하는 명령어이다.

    Key
    Value Type
    설명

    name

    string

    agent 리소스 이름이다. (unique, 필수)

    grpname

    string

    agent 리소스가 속할 그룹 리소스 이름이다 (필수)

    script

    string(file path)

    agent cmd를 실행시킬 script 파일의 절대경로이다 (필수)


    특정 리소스를 삭제하기 위한 명령어이며, DOWN 또는 DEACT 상태의 리소스만 삭제 가능하다.


    CM에 등록된 리소스의 정보를 확인하기 위한 명령어이다.


    리소스를 시작하기 위한 명령어이다. 그룹 리소스를 start하는 경우 해당 그룹에 속한 모든 agent를 기동시킨다.


    리소스를 중지하기 위한 명령어이다. 그룹 리소스를 stop하는 경우 해당 그룹에 속한 모든 agent를 중지시킨다.


    다음의 이유로 인해 deactivate된 리소스를 다시 activate시켜주기 위한 명령어이다.

    • agent를 추가할 때 입력한 retry_cnt(기본값: 3) 이상 start를 수행했는데도 실패한 경우

    • 사용자가 cmrctl deact 명령어를 명시적으로 사용하여 비활성화시킨 경우

    • agent를 추가할 때 입력한 script에 문제가 있는 경우

      • 위치에 script가 없는 경우

      • script의 권한이 없는 경우

      • script가 문제가 생겨 timeout될 경우


    리소스를 deactivate시켜주기 위한 명령어이다. deact되어 있는 동안 agent는 script를 수행시키지 않는다.


    그룹 리소스의 failover 기능 사용 여부를 수정하기 위한 명령어이다.

    cmrctl add group --name <group_name> --cname <cluster_name> 
    --grptype <type> --failover <true|false>

    name

    string

    그룹 리소스 이름이다. (unique, 필수)

    cname

    string

    해당 그룹 리소스가 속할 cluster 리소스 이름이다. (필수)

    cmrctl add

    cmrctl add group

    grptype

    cmrctl add agent --name <agent_name> --grpname <group_name> --script <directory_path>
    --pubnet <public_network_resource_name> --retry_cnt <retry_cnt>
    $ cmrctl del <resource_type> --name <resource_name>
    $ cmrctl show <resource_type> --name <resource_name>
    $ cmrctl start <resource_type> --name <resource_name>
    $ cmrctl stop <resource_type> --name <resource_name>
    $ cmrctl act <resource_type> --name <resource_name>
    $ cmrctl deact <resource_type> --name <resource_name>
    $ cmrctl modify group --name <group_name> --failover <true|false>

    cmrctl add agent

    cmrctl del

    주의

    모든 agent가 down된 상태이면, group을 삭제할 경우 agent도 같이 삭제된다.

    cmrctl show

    참고

    cmrctl show all을 입력하는 경우 같은 cm group의 모든 정보를 확인할 수 있다.

    cmrctl start

    cmrctl stop

    cmrctl act

    cmrctl deact

    cmrctl modify

    CURRENT (기본값)

    flashback query의 AS OF 절을 제거하고 현재 시점의 데이터로 다시 조회한다.

    SKIP

    해당 데이터의 조회를 건너뛴다.

    그림1. Llob 프로세스

    Process 설명

    Threads

    Control Thread

    Read Thread

    주의

    SKIP으로 설정하면 flashback query에 실패한 데이터가 동기화되지 않으므로 데이터 정합성에 영향을 줄 수 있다.

    SELECT O.OBJ#
    FROM SYS.OBJ$ O, SYS.USER$ U
    WHERE O.OWNER# = U.USER#
    AND O.TYPE# = 2
    AND U.TYPE# = 1
    AND U.NAME = 'Target Prosync Instance Meta User'
    AND O.NAME = 'PRS_COMMITTED_TX_LIST';
    SELECT DATAOBJ#, OBJ#
    FROM SYS.OBJ$ O, SYS.USER$ U
    WHERE O.OWNER# = U.USER#
    AND O.TYPE# IN (2, 19, 34)
    AND U.TYPE# = 1
    AND U.NAME = 'Target Prosync Instance Meta User'
    AND O.NAME = 'PRS_COMMITTED_TX_LIST'
    AND O.DATAOBJ# IS NOT NULL;
    SELECT O.OBJ_ID
    FROM SYS._DD_OBJ O, SYS._DD_USER U
    WHERE O.OWNER_ID = U.USER_ID
    AND O.TYPE_NO = 1
    AND U.TYPE_NO = 1
    AND U.NAME = 'Target Prosync Instance Meta User'
    AND O.NAME = 'PRS_COMMITTED_TX_LIST';
    '운영 가이드'

    명령어

    ProSync Admin Utility가 제공하는 명령어의 사용법과 실행 방법을 안내한다.

    다음은 ProSync Admin Utility 명령어를 표현하는 사용법의 예이다.

    COM[MAND] param {choice1|choice2} [option] [arg]*

    위의 예를 기준으로 ProSync Admin Utility에서 사용하는 명령어의 문법을 해석하는 방법은 다음과 같다.

    항목
    설명

    대괄호([ ])

    대괄호([ ])에 포함된 내용은 입력하지 않아도 명령어를 실행할 수 있다.

    위의 예에서 COMMAND 명령어의 뒷부분(MAND)과 option, arg는 명령 프롬프트에 포함되지 않을 수 있다.

    중괄호({ })

    중괄호({ })에 포함된 내용은 반드시 입력해야 명령어를 실행할 수 있다.

    위의 예에서 choice1과 choice2는 중괄호({ }) 내에 있고 버티컬 바(|)로 분리되어 있으므로 둘 중 하나는 명령 프롬프트에 포함되어야 한다.

    버티컬 바(|)

    ProSync Admin Utility에서 사용할 수 있는 명령어는 다음과 같다.

    명령어
    설명

    롤백 가이드

    백업이 존재하는 경우에만 롤백이 가능하다. 아래는 4.4.x로의 패치 이후 문제가 발생했을 때, 이전 버전으로 롤백하기 위한 단계다.

    1. 프로세스 강제 종료 (SRC / TAR)

    ADMIN> shutd agent;

    2. 디렉토리 복구

    rm -rf prosync;
    mv old_prosync prosync

    참고

    3단계(재설치 수행)부터 5단계(메타데이터 복구)까지의 과정은 메타 테이블 구조 변경으로 인해 필요한 절차이며, 백업 시점의 버전과 현재 설치된 버전 사이에 메타 테이블 구조 변경이 있는 경우에만 수행한다. 메타 테이블 구조는 4.5.0에서 변경되었으므로 다음 두 경우가 이에 해당한다.

    • 4.5.0 이상에서 4.4.x 이하로 내려가는 롤백

    • 4.0, FS01, 4.2.x 버전으로의 롤백

    3. 재설치 수행

    $PRS_HOME/install/prs_install.sh -c prs_install.cfg

    4. 기존 메타데이터 삭제

    주의

    4단계와 5단계에 나열된 메타 테이블 목록은 백업 시점 버전(구버전)의 스키마를 기준으로 한 것이므로, 현재 설치된 버전의 테이블 목록으로 바꾸면 절차가 깨진다. 백업 스크립트(prs_backup.sh)가 구버전의 create_src_tbl.sql을 기준으로 백업 테이블을 생성하고, 5단계의 INSERT ... SELECT *는 원본 테이블과 백업 테이블의 컬럼 구성이 동일해야 성공하기 때문이다. 따라서 현재 버전에는 없고 구버전에만 존재하는 테이블(예: PRS_IMPORTED_ARCHIVE_LOG)이 목록에 포함되어 있어도 그대로 둔다.

    SRC DB

    TRUNCATE TABLE $PRS_USER.PRS_TXINFO;
    TRUNCATE TABLE $PRS_USER.PRS_OBJ_LIST;
    TRUNCATE TABLE $PRS_USER.PRS_DDL_HIST;
    TRUNCATE TABLE $PRS_USER.PRS_DD_CON;
    TRUNCATE TABLE $PRS_USER.PRS_DD_ENC;
    TRUNCATE TABLE $PRS_USER.PRS_DUMMY_TBL;
    TRUNCATE TABLE $PRS_USER.PRS_LOGMNR_INFO;
    TRUNCATE TABLE $PRS_USER.PRS_IMPORTED_ARCHIVE_LOG;
    TRUNCATE TABLE $PRS_USER.PRS_DD_ETL_HIST;
    TRUNCATE TABLE $PRS_USER.PRS_DICT_HIST;
    TRUNCATE TABLE $PRS_USER.PRS_DD_USR;
    TRUNCATE TABLE $PRS_USER.PRS_DD_TBL;
    TRUNCATE TABLE $PRS_USER.PRS_DD_SGMT;
    TRUNCATE TABLE $PRS_USER.PRS_DD_COL;
    TRUNCATE TABLE $PRS_USER.PRS_IPARAM;  -- Rule DB를 사용한 구성에서만 해당한다. 해당 테이블이 없으면 건너뛴다.

    TAR DB

    TRUNCATE TABLE $PRS_USER.PRS_CONST_HIST;
    TRUNCATE TABLE $PRS_USER.PRS_LCT;
    TRUNCATE TABLE $PRS_USER.PRS_DUMMY_TBL;
    TRUNCATE TABLE $PRS_USER.PRS_COMMITTED_TX_LIST;
    TRUNCATE TABLE $PRS_USER.PRS_INSTALL_HIST;

    5. 메타데이터 복구

    SRC DB

    INSERT INTO $PRS_USER.PRS_TXINFO SELECT * FROM prs_backup.PRS_TXINFO;
    INSERT INTO $PRS_USER.PRS_OBJ_LIST SELECT * FROM prs_backup.PRS_OBJ_LIST;
    INSERT INTO $PRS_USER.PRS_DDL_HIST SELECT * FROM prs_backup.PRS_DDL_HIST;
    INSERT INTO $PRS_USER.PRS_DD_CON SELECT * FROM prs_backup.PRS_DD_CON;
    INSERT INTO $PRS_USER.PRS_DD_ENC SELECT * FROM prs_backup.PRS_DD_ENC;
    INSERT INTO $PRS_USER.PRS_LOGMNR_INFO SELECT * FROM prs_backup.PRS_LOGMNR_INFO;
    INSERT INTO $PRS_USER.PRS_IMPORTED_ARCHIVE_LOG SELECT * FROM prs_backup.PRS_IMPORTED_ARCHIVE_LOG;
    INSERT INTO $PRS_USER.PRS_DD_ETL_HIST SELECT * FROM prs_backup.PRS_DD_ETL_HIST;
    INSERT INTO $PRS_USER.PRS_DICT_HIST SELECT * FROM prs_backup.PRS_DICT_HIST;
    INSERT INTO $PRS_USER.PRS_DD_USR SELECT * FROM prs_backup.PRS_DD_USR;
    INSERT INTO $PRS_USER.PRS_DD_TBL SELECT * FROM prs_backup.PRS_DD_TBL;
    INSERT INTO $PRS_USER.PRS_DD_SGMT SELECT * FROM prs_backup.PRS_DD_SGMT;
    INSERT INTO $PRS_USER.PRS_DD_COL SELECT * FROM prs_backup.PRS_DD_COL;
    INSERT INTO $PRS_USER.PRS_IPARAM SELECT * FROM prs_backup.PRS_IPARAM;  -- Rule DB를 사용한 구성에서만 해당한다. 해당 테이블이 없으면 건너뛴다.
    DELETE FROM PRS_DD_CON
     WHERE (DD_SEQ#, BO_ID) IN (
           SELECT DD_SEQ#, OBJ_ID FROM PRS_DD_TBL
            WHERE OWNER = '$PRS_USER' AND NAME = 'PRS_DUMMY_TBL');
    DELETE FROM PRS_DD_COL
     WHERE (DD_SEQ#, BO_ID) IN (
           SELECT DD_SEQ#, OBJ_ID FROM PRS_DD_TBL
            WHERE OWNER = '$PRS_USER' AND NAME = 'PRS_DUMMY_TBL');
    DELETE FROM PRS_DD_SGMT
     WHERE (DD_SEQ#, BO_ID) IN (
           SELECT DD_SEQ#, OBJ_ID FROM PRS_DD_TBL
            WHERE OWNER = '$PRS_USER' AND NAME = 'PRS_DUMMY_TBL');
    DELETE FROM PRS_DD_ENC
     WHERE OBJ_ID IN (
           SELECT OBJ_ID FROM PRS_DD_TBL
            WHERE OWNER = '$PRS_USER' AND NAME = 'PRS_DUMMY_TBL');
    DELETE FROM PRS_DD_TBL
     WHERE OWNER = '$PRS_USER' AND NAME = 'PRS_DUMMY_TBL';
    COMMIT;
    
    DECLARE
      v_seq NUMBER;
    BEGIN
      v_seq := PRS_DD_META.INSERT_HIST(0, 'refresh PRS_DUMMY_TBL dd only');
      PRS_DD_META.UPDATE_TBL(v_seq, '$PRS_USER', 'PRS_DUMMY_TBL', NULL, NULL);
      PRS_DD_META.UPDATE_HIST(v_seq, 1, NULL);
    END;
    /
    COMMIT;

    TAR DB

    INSERT INTO $PRS_USER.PRS_CONST_HIST SELECT * FROM prs_backup.PRS_CONST_HIST;
    INSERT INTO $PRS_USER.PRS_LCT SELECT * FROM prs_backup.PRS_LCT;
    INSERT INTO $PRS_USER.PRS_COMMITTED_TX_LIST SELECT * FROM prs_backup.PRS_COMMITTED_TX_LIST;
    INSERT INTO $PRS_USER.PRS_INSTALL_HIST SELECT * FROM prs_backup.PRS_INSTALL_HIST;

    주의

    복구 후 반드시 COMMIT을 수행해야 한다.

    참고

    • $PRS_USER.PRS_DUMMY_TBL에 대해서는 INSERT 작업을 진행하지 않는다.

    • prosync 롤백 과정에서 재설치가 수행되는데 이때 $PRS_USER.PRS_DUMMY_TBL은 재설치 과정에서 obj_id

    6. Config 파일 검토 및 수정

    각 설정 파일의 파라미터를 기존 설정과 비교하여 알맞게 수정한다.

    • <$instance_ID>_ext#.cfg

    • <$instance_ID>_apply1.cfg

    • <$instance_ID>_llob1.cfg

    • prs_agent_<$Agent_ID>.cfg → prs_mgr.cfg

    • prs_instance.map → prs_top.map

    공통 진단

    프로세스 종류와 관계없이 공통으로 적용되는 crash/thread 진단 방법과 wallet 운영을 설명한다.

    프로세스 Crash / Thread 장애

    ProSync 프로세스의 signal 처리에는 일반적인 Unix 데몬과 다른 특성이 있다.

    • SIGSEGV, SIGBUS, SIGILL, SIGFPE 등의 fault가 발생하면 core 파일 대신 $PRS_HOME/var 하위의 prosync.out.<pid> 파일에 callstack이 기록된다.

    • Control Thread가 아닌 worker thread에서 crash가 발생하면 해당 thread만 종료될 수 있다. 따라서 프로세스 PID가 살아 있어도 필수 thread가 DEAD 상태일 수 있다.

    • SIGINT, SIGTERM, SIGHUP 신호는 무시된다. 지원되는 종료 방법은 Admin의 SHUTDOWN 명령이다.

    프로세스가 비정상 동작하거나 응답하지 않는 경우 다음 순서로 점검한다.

    1. $PRS_HOME/var 하위에서 prosync.out.<pid> 파일을 찾아 callstack을 확인한다.

    2. STATUS <inst_id> 명령으로 모든 thread의 상태를 확인한다. 프로세스가 running이라도 개별 thread가 죽어 있을 수 있다.

    3. 필요 시 ALLOCDUMP, TRACEDUMP, JCDUMP


    설치 시 생성되는 cfg 파일에는 PRS_PWD=#encrypted와 같이 기록되는데, #encrypted는 암호화된 암호 문자열이 아니라 실제 암호를 wallet 파일에서 읽으라는 표시(sentinel)다.

    암호가 저장되는 wallet 파일은 다음과 같다.

    파일
    용도

    운영 시 다음 사항을 지켜야 한다.

    • 설정 파일(config)만 다른 노드로 복사해서는 프로세스를 기동할 수 없다. 노드 이관 시에는 wallet 파일을 함께 이관해야 한다.

    • wallet 파일은 백업 대상에 포함해야 하며, 파일 권한은 ProSync 운영 계정만 읽을 수 있도록 관리한다.

    • DB 비밀번호를 변경한 경우에는 wallet을 다시 생성해야 한다.

    • TDE를 사용하는 경우 .wallet과 별도로 .wallet_tde

    Batch Execution

    Batch Execution은 RDBMS 상에서 우리가 사용하는 Batch 관련 API라고 이해하는 것이 용이하다. DML 각각을 모두 쿼리 형태로 변환하여 전달하기보단, 같은 형태의 쿼리라면 데이터를 Batch단위로 모아서 서버에서 사용하도록 하는 기능이다.

    이 기능을 사용하면 Insert 와 같은 DML이 연속해서 들어올 때, Target Database 의 성능을 향상 시킬 수 있다. 이를 통해 데이터 처리 속도를 증가 시키고 동기화 속도를 끌어올려줄 수 있다.

    하지만 제약사항도 존재하는 기능으로, 아래와 같은 두 가지 관점에서 고려할 수 있다.

    • 같은 형태의 쿼리

    • Batch로 모았을 때의 한계

    같은 형태의 쿼리

    ProSync는 한 트랜잭션에서 DML이 연속해서 들어올 때 이 순서를 임의대로 바꾸지 않는다. 입력되는 모든 쿼리를 순서대로 적용해야 정합성이 깨지지 않는다는 대전제 때문에 이와 같이 처리가 된다.

    문제는 이렇게 되면 Insert * 3, Update*3, Delete* 3의 순서로 데이터가 들어올 때와 (Insert, Update, Delete) * 3의 순서로 데이터가 들어올 때 Batch Execution 입장에서 큰 차이가 발생한다.

    유사한 쿼리가 연속해서 들어온다면 ProSync는 이를 Batch로 묶어서 처리를 할 수가 있지만, 쿼리들의 형태가 연속적이지 않게 들어온다면 Batch로 처리할 수가 없다. 따라서 두 트랜잭션의 결과가 동일하더라도 하나는 Batch 처리가 가능하고 다른 하나는 Batch 처리가 불가능하다.

    트랜잭션 내에 같은 형태의 쿼리들이 연속해서 들어온다고 가정을 하여도 성능 향상이 미미한 경우도 존재한다. 예를 들어 Insert의 경우 Batch 동작을 통해 데이터의 개수나 크기 등을 Target Database에 미리 알려준다면 Database는 이에 맞는 플랜을 세워서 최적화 하여 처리가 가능하다. 하지만 Delete나 Update 처럼 각 row 별로 Where Clause에 의해 따로 탐색을 해야 하는 형태로 들어온다면 아무리 모아 보내도 서버 입장에선 하나씩 처리하나, 모아서 들어온걸 하나씩 처리하나 큰 차이가 없다고 볼 수 있다.

    따라서 ProSync는 특별한 설정이 없다면 Insert에 대한 Batch만 처리하는 것이 기본 동작이다. 하지만 Database 별로 처리하는 방식이 달라질 수 있기 때문에 Batch 사용 여부는 파라미터로 모두 관리가 된다.

    Parameter 별 제공하는 기능이다.

    • USE_BATCH_MODE 기본 값은 Y 로, Batch는 항상 동작하도록 되어 있다.

    • BATCH_MEM_SIZE 기본 값은 10MB로 서버에 보낼 때 최대 10MB의 데이터까지만 쌓고 쿼리에 대한 처리를 요청한다.

    • USE_ONLY_INSERT_BATCH Insert 만 Batch 로 처리할 것 인지에 대한 파라미터로 기본 값은 Y 이다.

    Llob

    Llob 프로세스에 관한 설명 및 운영 방법을 안내한다.

    참고

    TSC Standby 동기화 환경에서 Llob 프로세스는 Standby DB에서 Flashback 조회를 수행하고, 쓰기 작업은 Primary DB로 라우팅한다. 관련 설정과 동작은 페이지를 참고한다.

    Source Oracle ASM 로그 추출

    Source Oracle이 ASM(Automatic Storage Management)을 사용하는 환경에서 Redo Log와 Archive Log를 추출하는 구성과 운영 방법을 안내한다.

    ProSync는 Source Oracle이 ASM(Automatic Storage Management)을 사용하는 환경에서 ASM Diskgroup에 저장된 Redo Log와 Archive Log를 추출할 수 있다.

    ASM Diskgroup의 파일은 운영체제 파일 시스템에 그대로 노출되지 않으므로 일반적인 파일 읽기로는 접근할 수 없다. Extract 프로세스는 ASM 인스턴스에 직접 접속하여 Diskgroup 경로(+로 시작하는 경로)의 로그 파일을 읽는다.

    구분
    지원 대상

    pubnet

    string

    public 용도로 사용할 네트워크 리소스 이름이다. dependency를 추가하려면 입력해야 한다.

    retry_cnt

    integer

    최대 retry 시도 횟수이다. (default: 3)

    TSC Standby Synchronization

    Batch로 모았을 때의 한계

    Parameter 관련

    Key Features

    Llob 프로세스에서 사용 가능한 기능에 대해 설명한다. 주로 사용하는 파라미터로서 Multi Thread용 파라미터 내용을 안내한다.

    가 변경되는 경우가 발생하여
    $PRS_USER.PRS_DUMMY_TBL
    에 대해
    dd image
    갱신 작업을 수행해야 한다.

    7. ProSync 재기동

    ADMIN> start man {AGENT_ID}
    ADMIN> start {INSTANCE_ID}

    버티컬 바(|)로 분리된 내용은 그 중 하나를 선택한다.

    애스터리스크(*)

    애스터리스크(*)로 표시된 내용은 포함되지 않을 수도 있고, 여러 번 포함될 수도 있다. 위의 예에서 arg는 대괄호([ ]) 바로 뒤에 애스터리스크(*)가 있으므로 포함되지 않을 수도 있고, 한 번 이상 포함될 수도 있다.

    대소문자

    명령어는 대소문자를 구분하지 않는다.

    운영체제의 명령어를 실행한다.

    스크립트를 실행한다.

    현재 버퍼 내의 명령문을 실행한다.

    ProSync의 동기화 대상 테이블을 추가/제거하거나 파라미터 값을 변경한다.

    참고

    각 명령어에 대한 자세한 설명은 에서 확인할 수 있다.

    등의 dump 명령으로 in-memory 상태를 수집한다. 명령 문법은
    을 참고한다.
  • 종료 제어는 prs_adm의 SHUTDOWN 명령을 사용한다.

  • 일반 kill 신호(SIGINT/SIGTERM/SIGHUP)는 무시되므로, SHUTDOWN으로도 종료되지 않는 경우 최종 수단으로 SIGKILL(kill -9)을 사용한다.

  • (및 HSM 사용 시
    .wallet_tde_hsm
    )가 필요하다.

    var/<instance>/.wallet

    일반 DB 접속 암호

    var/<instance>/.wallet_asm

    Oracle ASM 인스턴스 접속 암호 (ASM 구성 시 생성)

    var/<instance>/.wallet_tde

    TDE wallet 암호

    var/<instance>/.wallet_tde_hsm

    HSM PIN

    진단 절차

    참고

    수집된 prosync.out.<pid> 파일과 dump 파일은 버그 리포트 시 함께 전달한다. 를 참고한다.

    Wallet 운영

    참고

    #encrypted sentinel과 생성되는 설정 파일의 예시는 의 '설치 결과 확인'을 참고한다.

    Extract 프로세스는 읽으려는 로그 파일의 경로를 보고 읽기 경로를 결정한다.

    로그 파일 경로
    읽기 경로

    경로에 따라 읽기 경로가 결정되므로 Redo Log와 Archive Log 중 일부만 ASM Diskgroup에 저장된 혼합 구성에서도 사용할 수 있다. ASM 사용 여부를 지정하는 별도의 파라미터는 없으며, ASM 접속 정보를 설정하면 ASM 경로의 파일에 대해 ASM 읽기가 사용된다.

    ASM 경로의 로그를 읽을 때 Extract 프로세스는 ASM 인스턴스에 ASM_IO_WORKERS 개수만큼 병렬 I/O Worker 세션을 만든다. 각 Worker는 로그 파일 읽기만 수행하고, 읽어온 Redo의 분석은 로그 리더가 별도로 수행한다.

    ASM_IO_WORKERS는 Extract 프로세스 기동 시에만 반영되므로, 값을 변경한 경우 Extract 프로세스를 재기동해야 한다.

    Extract 프로세스가 ASM 인스턴스에 접속할 별칭을 tnsnames.ora에 등록한다. 이 별칭을 ASM_DB_NAME에 설정한다.

    ASM 접속 계정은 ASM 인스턴스에 접속하여 Diskgroup의 파일을 읽을 수 있어야 하므로 SYSASM 권한을 가진 계정을 사용한다.

    등록한 별칭으로 접속이 되는지 확인한다.

    Redo Log와 Archive Log가 ASM Diskgroup에 저장되어 있는지 확인한다. 경로가 +로 시작하면 ASM 로그 추출 설정이 필요하다.

    파라미터
    설명

    ASM_PWD=#encrypted는 암호화된 문자열 자체가 아니라, 실제 비밀번호를 wallet 파일에서 읽으라는 표시(sentinel)이다. 따라서 config 파일만 다른 노드로 복사해서는 프로세스를 기동할 수 없으며 wallet 파일(var/<instance>/.wallet_asm)을 함께 이관해야 한다.

    설치 config 파일에 ASM 접속 정보를 설정하면 설치 과정에서 ASM 구성이 반영된다.

    ASM 접속 정보를 설정하고 설치하면 다음이 수행된다.

    • ASM_PWD 암호화 및 wallet 파일 저장

    • 생성되는 Extract config에 ASM 파라미터 자동 기입

    설치 후 생성된 Extract config에 다음 값이 기입되어 있는지 확인한다.

    Extract 프로세스는 활성 Online Redo Log의 경로가 ASM Diskgroup 경로인 경우 ASM 인스턴스 접속을 통해 해당 파일을 읽는다. 읽기는 I/O Worker 세션이 병렬로 수행하고, 로그 리더는 읽어온 블록의 Redo를 분석하여 LCR을 생성한다.

    Archive Log는 다음 순서로 위치를 결정한다.

    1. ARCHIVE_LOG_DIR이 설정된 경우 해당 디렉터리에서 Archive Log 파일을 먼저 찾는다.

    2. 해당 디렉터리에서 찾지 못하거나 ARCHIVE_LOG_DIR이 설정되지 않은 경우 V$ARCHIVED_LOG 조회 결과의 ASM 경로(+DISKGROUP/...)로 접근한다.

    ARCHIVE_LOG_DIR은 절대 경로의 디렉터리만 유효한 값이다. 따라서 log_archive_dest가 FRA(USE_DB_RECOVERY_FILE_DEST)이거나 ASM Diskgroup(+...)인 표준 ASM 구성에서는 설치 과정에서 ARCHIVE_LOG_DIR에 값이 기입되지 않으며, Archive Log 위치는 위의 순서에 따라 운영 중에 결정된다.

    ASM_PWD는 암호화되어 인스턴스의 wallet 파일(var/<instance>/.wallet_asm)에 저장된다. wallet 파일은 백업 대상에 포함해야 하며, ASM 접속 계정의 비밀번호를 변경한 경우 wallet을 다시 생성해야 한다.

    • ASM 로그 추출은 Source Oracle 전용이다.

    • ASM_IO_WORKERS는 Extract 프로세스 기동 시에만 적용된다. 운영 중 변경하려면 프로세스를 재기동해야 한다.

    • ASM_IO_WORKERS는 최대 8까지 설정할 수 있다.

    • ASM 접속 정보를 설정하지 않으면 ASM 경로의 로그 파일을 읽을 수 없다.

    Source DB

    Oracle (ASM 구성)

    대상 프로세스

    지원 범위

    ProSync Admin Utility를 정지한다.

    HELP

    도움말을 출력한다.

    PAUSE

    사용자가 입력한 INST_ID에 속한 Extract 프로세스의 작업을 멈춘다.

    RESUME

    사용자가 입력한 INST_ID에 속한 Extract 프로세스의 작업을 재개한다.

    SET

    ProSync Admin Utility의 시스템 변수를 설정한다.

    SHOW

    ProSync Admin Utility의 시스템 변수 및 각 프로세스의 파라미터를 출력한다.

    SHUTDOWN

    사용자가 입력한 INST_ID의 프로세스 혹은 매니저 프로세스를 정지한다.

    STARTUP

    사용자가 입력한 INST_ID의 프로세스 혹은 매니저 프로세스를 실행한다.

    STATUS

    전체 프로세스, 사용자가 입력한 INST_ID의 프로세스 혹은 매니저 프로세스의 상태를 확인하는 명령어이다.

    MONITOR

    Instance의 apply 프로세스가 Target DB에 반영 중인 Query의 정보를 출력한다.

    ALLOCDUMP

    프로세스의 메모리 할당 현황을 파일로 출력한다.

    TRACEDUMP

    Apply 프로세스의 내부 상태(DD/MERGE/DEPENDENCY/QUEUE)를 파일로 출력한다.

    JCDUMP

    프로세스 상태 스냅샷 dump를 생성하거나 비교 분석한다.

    ! / HOST
    @
    /
    ALTER
    EXIT / QUIT
    명령어 목록
    명령어 목록
    Bug Report
    Instance 설치

    Extract

    추출 대상 로그

    Online Redo Log, Archive Log

    +로 시작하는 ASM Diskgroup 경로

    ASM 인스턴스 접속(ASM_DB_NAME)을 통해 읽는다.

    절대 경로의 파일 시스템 경로

    파일 시스템에서 직접 읽는다.

    ASM_DB_NAME

    로그 리더가 사용할 Oracle ASM 인스턴스의 별칭(Alias)을 설정한다. ASM 경로(+...)의 Redo Log 및 Archive Log 접근에 필요하다. (적용: Extract)

    ASM_USER

    로그 리더가 사용할 Oracle ASM 접속 계정을 설정한다. (적용: Extract)

    ASM_PWD

    ASM_USER의 비밀번호를 설정한다. 암호화되어 wallet에 저장되며, config 파일에는 #encrypted로 표시된다. (적용: Extract)

    ASM_IO_WORKERS

    ASM Redo를 읽을 때 사용할 병렬 I/O Worker 세션 수를 설정한다. 기본값은 4이며 1 ~ 8 범위로 설정할 수 있다. Extract 프로세스 기동 시에만 적용된다. (적용: Extract)

    동작 구조

    I/O Worker 세션

    사전 준비

    ASM 인스턴스 접속 별칭 등록

    참고

    ASM 인스턴스는 MOUNTED 상태로만 기동되므로, 접속 별칭에 (UR = A)를 설정해야 접속이 제한되지 않는다.

    RAC 환경에서는 Extract 프로세스별로 해당 노드의 ASM 인스턴스에 직접 접속하는 별칭을 사용한다.

    계정 권한 확인

    로그 파일 위치 확인

    설정 파라미터

    설정 예시

    Extract 설정

    설치 구성

    참고

    ASM_DB_NAME, ASM_USER, ASM_PWD 세 값을 모두 기입해야 ASM 구성이 반영된다. 하나라도 비어 있으면 별도 프롬프트 없이 ASM 구성이 생략되므로 주의한다.

    동작 방식

    Redo Log 읽기

    Archive Log 경로 결정

    주의

    ASM 구성에서 ARCHIVE_LOG_DIR에 ASM Diskgroup 경로나 USE_DB_RECOVERY_FILE_DEST와 같은 값을 직접 기입하면 Extract 프로세스 기동이 실패하거나 Archive Log 추출이 진행되지 않을 수 있다. 파일 시스템 경로에 별도의 Archive Log가 있는 구성이 아니라면 ARCHIVE_LOG_DIR을 비워 둔다.

    ASM 접속 비밀번호 저장

    제약사항

    +ASM =
      (DESCRIPTION =
        (ADDRESS = (PROTOCOL = TCP)(HOST = 192.168.0.10)(PORT = 1521))
        (CONNECT_DATA =
          (SERVICE_NAME = +ASM)
          (INSTANCE_NAME = +ASM1)
          (UR = A)
        )
      )
    $ sqlplus asm_user/asm_password@+ASM as sysasm
    SQL> SELECT INSTANCE_NAME, STATUS FROM V$INSTANCE;
    SQL> SELECT NAME, STATE FROM V$ASM_DISKGROUP;
    SELECT MEMBER FROM V$LOGFILE;
    SHOW PARAMETER log_archive_dest
    SHOW PARAMETER db_recovery_file_dest
    SRC_DB_TYPE=ORACLE
    SRC_DB_NAME=src_oracle
    
    ASM_DB_NAME=+ASM
    ASM_USER=sys
    ASM_PWD=#encrypted
    ASM_IO_WORKERS=4
    SRC_DB_TYPE=ORACLE
    SRC_DB_NAME=src_oracle
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=oracle
    
    # (for Oracle ASM only)
    ASM_DB_NAME=+ASM
    ASM_USER=sys
    ASM_PWD=asm_password
    ASM_DB_NAME=+ASM
    ASM_USER=sys
    ASM_PWD=#encrypted

    Discard

    DML DISCARD

    ProSync가 동기화 과정 속에 DML을 Target DB에 반영 중 에러가 발생할 수 있다. 일반적인 경우에는 ProSync가 해당 DML에 대한 반영을 성공할 때까지 재시도하게 된다.

    해당 기능을 사용하면 특정한 에러에 대해 재시도하는 대신 해당 DML에 대한 반영을 생략하고 이후의 동기화를 진행하도록 설정할 수 있다.

    또한 DISCARD 기능이 발생한 이력을 기록하는 Discard file 을 작성할 수 있다.

    해당 기능을 사용하기 위해선 config 파일에 다음과 같은 Parameter를 설정해야 한다.

    DISCARD_YN=[Y|N]
    DISCARD_EC=2 10007 8033
    DISCARD_FILE_YN=[Y|N]
    
    DISCARD_FILE_DIR=/directory/to/save/file
    DISCARD_FILE_SIZE=200M
    DISCARD_BACKUP_DIR=/directory/to/save/backup/file
    DISCARD_BACKUP_SIZE=10G
    파라미터 이름
    설명

    DISCARD_YN

    동기화 중 에러가 발생하는 경우에 스킵할지 여부를 설정한다. Y 상태에선 발생한 에러가 DISCARD_EC 에 작성된 에러코드에 속해있는 경우 재시도를 생략한다.

    • 유형: Y/N

    • 범위: Y/N

    • 기본값: N

    DISCARD_EC


    ProSync가 Source DB의 값을 Target DB의 데이터 타입으로 변환하지 못하면(지원하지 않는 timestamp 지역 정보 등) 해당 DML은 반영에 실패하고, 일반적인 경우에는 성공할 때까지 재시도하게 된다.

    DISCARD_CAST_ERR=Y로 설정하면 변환에 실패한 DML을 재시도하지 않고 건너뛴 뒤 이후의 동기화를 진행한다. 건너뛴 DML은 Target DB에 반영되지 않는다.

    파라미터 이름
    설명

    DDL도 DML과 마찬가지로 Target DB에 반영 중 에러가 발생할 수 있다. 일반적인 경우에는 ProSync가 해당 DDL에 대한 반영을 성공할 때까지 재시도하게 된다.

    해당 기능을 사용하면 재시도하는 대신 해당 DDL에 대한 반영을 생략하고 이후의 동기화를 진행하도록 설정할 수 있다.

    또한 DISCARD 기능이 발생한 이력을 기록하는 Discard file 을 작성할 수 있다.

    해당 기능을 사용하기 위해선 config 파일에 다음과 같은 Parameter를 설정해야 한다.

    파라미터 이름
    설명

    Apply Process

    Apply 프로세스에 대하여 설명한다.

    Process 설명

    Apply 프로세스는 architecture에서도 언급했듯이 Chunk 단위로 레코드를 전달받고 해당 레코드를 트랜잭션별로 모아준다. 트랜잭션에 Commit이 오면 해당 트랜잭션은 실제 반영 단계에 들어가 대상이 되는 데이터베이스로 반영된다.

    본 장에서는, 실제 apply 프로세스의 구조를 상세히 설명한다.


    Threads

    그림 1. Apply Process Architecture

    Apply 프로세스는 위와 같은 구조를 가지고 있다. 앞서 Inter Processes/Threads Communication에서 ProSync의 기본 Thread 구조를 언급한 바 있는데, Apply도 마찬가지로 Main이 되는 Control Thread가 있고 이외에 Worker Thread들이 Control Thread 하위 계층에 구성되어 있다.

    동기화에 필요한 Thread는 Construct Thread와 Replay Thread로 크게 두 가지이며, 나머지는 모두 Worker Thread로 구분된다.

    참고

    Worker Thread는 종류가 많은 관계로 하단에 간단히 언급한다.

    Control Thread

    Control Thread는 다른 프로세스와 마찬가지로 모든 통신과 관련된 Multiplexing I/O를 담당한다. 리눅스에선 epoll을 사용하며, 플랫폼별로 k-queue나 pollset 등 각 운영체제에 알맞은 Mux I/O 기능을 사용하도록 설계되어 있다.

    Construct Thread

    Construct Thread는 Chunk 로 들어오는 레코드 데이터들에 대해 트랜잭션으로 재조립한다. Construct라는 말의 의미는 트랜잭션을 다시 조립(Construct)하기 때문에 사용된다고 생각하면 된다.

    각 레코드에는 본인이 속한 트랜잭션을 구분할 수 있는 일종의 key 값이 존재하는데, 이게 트랜잭션의 ID 일명 (xid)라고 불린다.

    Construct는 레코드의 xid 값을 보고 트랜잭션별로 재조립한다.

    그림 2. Construct의 트랜잭션 Hash

    참고

    Construct의 이력 정보 관리

    Construct는 레코드별로 어떤 redo 로그 파일에서 나온 건지에 해당하는 로그 시퀀스 정보와 해당 로그 파일의 몇 번째 레코드에 해당하는지에 대한 정보(wrap#)를 메모리에 계속 저장하게 된다.

    redo 로그는 주기적으로 로그 스위치가 일어나고, 이때마다 로그 시퀀스 값이 1개씩 올라가며 새로운 로그파일에 레코드를 작성하게 되는데, 이때마다 메모리에 들고 있던 레코드 정보 및 이력 정보(로그 시퀀스, wrap#)가 물리 디스크 및 데이터베이스에 저장된다.

    Replay Thread

    Replay Thread는 Commit 레코드가 도달하여 Construct로부터 조립이 완료된 트랜잭션을 전달받는다. 전달받은 트랜잭션은 Commit 레코드의 DB Time(Oracle의 SCN / Tibero의 TSN / ..)에 맞게 직렬화되어 반영되거나, 트랜잭션 내 레코드들의 의존성을 모두 체크하여 병렬로 처리된다.

    병렬로 처리하게 될 경우 Replay Thread의 개수가 많아지게 되며, 각 스레드가 DB의 한 세션을 담당하게 된다. 병렬 처리 가능 여부는 Control Thread에서 실시간으로 판단하며, 병렬 처리가 가능할 때 여러 Replay Thread에 일감을 부여하게 된다.

    프로세스의 CPU / Memory 사용량을 실시간으로 수집한다. 수집된 내용은 로그상에 계속해서 남게 되며, ProSync 매니저와 연동 중일 경우, Agent 프로세스를 통해 수집한 값을 ProSync 매니저로 전송한다.

    프로세스에서 발생하는 트랜잭션의 시간당 처리량, 일종의 Throughput을 계산한다. ProSync 매니저와 연동 중일 경우, Agent 프로세스를 통해 수집한 값을 ProSync 매니저로 전송한다.


    Apply는 재기동이나 재연결 이후에도 중복 반영 없이 이어서 동기화할 수 있도록 복구 상태를 여러 저장소에 나누어 관리한다.

    저장소
    위치
    역할

    재연결 시 Apply는 저장된 이력 정보를 Ext에 전달하여(handshake) 재추출 시작점을 결정한다. Ext는 그 지점부터 다시 추출하므로 일부 레코드가 재전송될 수 있으며, Apply는 PRS_COMMITTED_TX_LIST를 통해 이미 반영이 완료된 트랜잭션을 건너뛴다.

    재기동 유형별 복구 절차와 장애 시나리오는 를 참고한다.

    암호화 테이블 추출

    Source DB가 Tibero, Oracle인 경우, 암호화된 테이블에 대한 동기화를 지원한다. 암호화된 테이블 동기화를 위해서는 복호화를 위한 Wallet file 접근 권한이 필요하다.

    TDE_FOR_EXT=[Y|N] TDE_WALLET_FILE=file_path TDE_WALLET_PWD=wallet_password TDE_FOR_APPLY=[Y|N] TDE_FOR_TABLESPACE=[Y|N]

    파라미터
    설명

    동기화 대상 테이블 생성 및 등록

    ProSync에서 테이블을 동기화하기 전에, 먼저 지원되는 데이터 타입을 확인한다. Source DB에 따라 지원하는 컬럼 타입이 다르므로 주의한다.

    구분
    지원 타입

    ProSync 4.7은 Oracle 확장 데이터 타입을 자동으로 인식한다. 컬럼의 선언 길이를 바이트 기준으로 확인하며, VARCHAR2·NVARCHAR2는 4,000바이트 초과, RAW는 2,000바이트 초과인 컬럼을 확장 타입으로 처리한다. USE_ORACLE_EXTENDED_TYPE 파라미터는 사용하지 않는다.

    패치 가이드

    이 절차의 1단계부터 3단계까지는 패치 전 구버전 환경에서 구버전 바이너리로 수행하며, 명령 문법도 구버전 기준이다.

    4.0 기준 Abort 종료 시 이력을 저장하지 않기 때문에 로그를 처음부터 읽는다. 이를 위해 로그 스위치를 먼저 수행해야 한다.

    4.0 버전의 경우 abort 종료가 반드시 필요하다.

    기존 메타데이터를 백업하기 위해 별도의 백업 전용 유저를 생성하고 필요한 권한을 부여한다.

    기존 환경의 데이터를 보존하면서 새 버전 바이너리로 마이그레이션하기 위해 디렉토리를 재구성한다.

    prosync/prs_install.cfg 파일을 생성하고 아래 내용을 포함한다.

    기존 ProSync 환경에서 메타 정보를 백업한다.

    메타데이터 수집을 위해 SRC DB에서 필요한 권한을 부여한다.

    prs_meta.sh는 Source DB의 ProSync DDL 트리거와 패키지를 다시 생성하고, 새 버전에서 추가된 메타 테이블과 컬럼을 만든다. Target DB가 Oracle 또는 Tibero인 경우에는 새 버전에서 추가된 메타 객체를 만들고 PRS_APPLY 패키지를 다시 생성한다. 설치 시 DB에 생성되는 객체에 포함된 변경은 바이너리 교체만으로 반영되지 않으므로 이 단계를 반드시 수행한다.

    Apply

    Apply 프로세스는 Extract 프로세스가 전달한 변경 데이터를 TX별로 정리 후 commit 요청된 시점부터 Target DB에 반영하며 주로 DB에 쿼리를 수행한 후 결과를 기다리는 과정에서 지연이 발생한다.

    지연을 방지하기 위해, Target DB에 반영 쿼리를 수행하는 REPLAY_THREAD_CNT 파라미터를 조절하여 Thread 수를 늘려 성능을 개선할 수 있다.


    Source DB에서 추출한 변경 데이터에 대해 Target DB에 반영할 수 없는 경우, ProSync는 실패한 DML을 성공할 때까지 다시 시도한다.

    사용자는 해당 데이터가 반영될 수 있도록 Target DB를 수정하거나 DCR 기능 또는 DISCARD 기능을 사용하여 우회할 수 있다.

    ProSync는 TX에 대해 commit 또는 rollback 이전까지 반영을 시작하지 않기 때문에 commit 없이 변경 데이터를 계속해서 전달받는 경우, Apply 프로세스에서 사용하는 메모리가 증가할 수 있다.

    이때, 메모리 조절용 파라미터를 설정하여 사용하는 메모리를 조절할 수 있다.

    Replay Thread 에서 완료되지 않은 TX들의 총 메모리 크기가 MEMORY_CTRL_STOP_SIZE 파라미터의 값을 넘는 경우 extract 프로세스에서 보내는 chunk를 수신하지 않는다.

    이후, Replay Thread 에서 동기화를 수행하여 완료되지 않은 TX들의 총 메모리 크기가 MEMORY_CTRL_RESUME_SIZE 값보다 낮아지는 경우 다시 Extract 프로세스에서 보내는 chunk를 수신한다.

    TAC/RAC 환경에서 특정 extract 프로세스의 chunk만 계속해서 수신 받는 경우, stmt수가 MERGE_BLOCK_CNT 파라미터의 값을 넘는 경우 해당 extract 프로세스에서 보내는 chunk를 수신하지 않는다.

    이후, 다른 extract 프로세스들에게 chunk를 수신 받아 처리되지 못한 stmt수가 MERGE_RESUME_CNT 값보다 낮아지는 경우 다시 extract 프로세스에서 보내는 chunk를 수신한다.

    extract 프로세스에서 수신한 chunk에 대해, const Thread 에서 처리하지 못한 TX들의 총 메모리 크기가 CHUNK_TOTAL_SIZE 파라미터의 값을 넘는 경우 extract 프로세스에서 보내는 chunk를 수신하지 않는다.

    TDE_FOR_EXT

    데이터 복호화 기능 사용 여부를 설정한다.

    설치 config 파일에 USE_TDE=Y를 설정하면 설치 과정에서 Source DB의 Wallet 비밀번호를 입력받고, TDE_FOR_EXT와 TDE_FOR_APPLY를 Y로 설정한다. 암호화된 테이블에 대하여 Sam 기능을 사용하려면 반드시 Y로 설정해야 한다. source db가 oracle 인 경우, TDE_FOR_TABLESPACE를 설정하지 않아도 암호화된 Tablespace 동기화를 수행한다.

    TDE_WALLET_FILE

    Source DB에서 생성한 Wallet file의 경로를 설정한다. 반드시 절대 경로를 포함하여 입력해야 한다. Source DB가 Oracle인 경우 wallet 파일(ewallet.p12)을 지정한다. 설치 config 파일에 USE_TDE=Y를 설정해 설치하면 이 값에 인스턴스 디렉터리($PRS_HOME/var/<인스턴스>/)가 기록되므로, 설치 후 Extract · Apply 설정 파일에서 wallet 파일의 절대 경로로 수정해야 한다. wallet 파일이 아닌 경로가 지정되어 있으면 Extract와 Apply가 기동하지 않는다. ProSync가 Source DB와 다른 호스트에서 실행되는 경우 wallet 파일을 ProSync 호스트로 복사해 그 경로를 지정한다.

    TDE_WALLET_PWD

    Source DB에서 생성한 Wallet file의 Password를 입력한다. 설치 과정에서 입력했다면, 자동적으로 ProSync가 해당 정보를 암호화하여 저장하여 #encrypted 값으로 나타나며, 설치 과정에서 입력하지 않았다면 비밀번호를 직접 입력하거나 수동으로 ProSync Wallet을 생성해주어야 한다.

    TDE_FOR_APPLY

    데이터 복호화 기능 사용 여부를 설정한다. Apply 프로세스에서 설정하며 TDE_FOR_EXT와 동일하게 동작한다. Source DB가 Oracle인 경우 암호화된 컬럼의 값은 Apply 프로세스가 복호화하므로, 암호화된 컬럼이 있는 테이블을 동기화하려면 반드시 Y로 설정하고 Wallet을 지정해야 한다. 설정하지 않으면 해당 테이블의 메타데이터를 처리할 때 Apply 프로세스가 중단된다.

    TDE_FOR_TABLESPACE

    암호화된 Tablespace 동기화를 수행하려면 사용한다. 만약 동기화 대상에 암호화된 Tablespace 를 추가하고 본 파라미터를 활성화 하지 않을 시 에러가 발생한다. source db가 oracle 인 경우, 설정하지 않아도 동작한다.

    Source DB가 Oracle인 경우 3DES168, AES128, AES192, AES256 알고리즘을 지원한다.

    History

    ProSync에는 DML 이력을 확인할 수 있는 다양한 기능들이 있다. config파일에서 로그 레벨을 5레벨로 높이면, 반영하고 있는 SQL과 Bind할 Value들이 byte array 형태로 남게 된다. 다만 로그 레벨을 반드시 높여야 한다는 점과, bind value들이 별도로 남으므로 실제 SQL로 바로 처리할 수 없다는 단점이 있다.

    본 장에서는 위와 같은 상황에서 확인할 수 있는 SAM(Sequential Access Method) 파일 기능과 DML 에러 발생 시의 report 파일, DML 이력 확인 기능 등에 대하여 기술한다.

    prosync process

    DISCARD_DDL_BACKUP_SIZE

    backup 디렉토리의 최대 크기를 지정하는 파라미터.

    • 유형: uint64

    • 범위: 0 - 128G

    • 기본값: 0

    재시도를 하지 않고 건너뛰고자 하는 에러코드를 입력한다.

    • 유형: 에러코드

    • 범위: 최대 256개

    • 기본값:

    DISCARD_FILE_YN

    DISCARD 동작이 발생했을 때 해당 내용을 discard 파일에 남기는 기능을 활성화 하는 파라미터이다.

    • 유형: Y/N, dynamic

    • 범위: Y/N

    • 기본값: N

    DISCARD_FILE_DIR

    discard file의 저장 위치를 지정하는 파라미터.

    • 유형: 디렉토리

    • 범위: -

    • 기본값: (LOG_DIR과 같은 디렉토리)

    DISCARD_FILE_SIZE

    discard 파일의 최대 크기를 지정하는 파라미터.

    • 유형: int32, dynamic

    • 범위: 1M - 1G

    • 기본값: 100M

    DISCARD_BACKUP_DIR

    discard 파일의 크기가 설정한 최대 크기를 초과하게 되면 생성하는 백업파일의 위치를 지정하는 파라미터.

    • 유형: 디렉토리

    • 범위: -

    • 기본값: (LOG_BACKUP_DIR과 같은 디렉토리)

    DISCARD_BACKUP_SIZE

    backup 디렉토리의 최대 크기를 지정하는 파라미터.

    • 유형: uint64, dynamic

    • 범위: 0 - 128G

    • 기본값: 0(무제한)

    DISCARD_CAST_ERR

    데이터 변환에 실패한 DML을 재시도하지 않고 건너뛸지 여부를 설정한다. DISCARD_YN, DISCARD_EC 설정과 무관하게 동작한다.

    • 유형: Y/N

    • 범위: Y/N

    • 기본값: N

    DISCARD_DDL_YN

    동기화 중 에러가 발생하는 경우에 스킵할지 여부를 설정한다.

    • 유형: Y/N

    • 범위: Y/N

    • 기본값: N

    DISCARD_DDL_FILE_YN

    DISCARD 동작이 발생했을 때 해당 내용을 discard 파일에 남기는 기능을 활성화 하는 파라미터이다.

    • 유형: Y/N

    • 범위: Y/N

    • 기본값: N

    DISCARD_DDL_FILE_DIR

    discard file의 저장 위치를 지정하는 파라미터.

    • 유형: 디렉토리

    • 범위: -

    • 기본값: $PRS_HOME/var/<인스턴스명>/ddl_err

    DISCARD_DDL_FILE_SIZE

    discard 파일의 최대 크기를 지정하는 파라미터.

    • 유형: int32

    • 범위: 1M - 1G

    • 기본값: 100M

    DISCARD_DDL_BACKUP_DIR

    discard 파일의 크기가 설정한 최대 크기를 초과하게 되면 생성하는 백업파일의 위치를 지정하는 파라미터.

    • 유형: 디렉토리

    • 범위: -

    • 기본값: $PRS_HOME/var/<인스턴스명>/ddl_err/backup

    주의

    • DISCARD 기능을 활성화하면 batch apply 기능이 사용 불가능하다.

    • DML을 반영할 때 발생하는 에러에 대해서만 DISCARD 기능을 지원한다.

    • (12032)Deadlock detected. 에러는 DISCARD 기능을 지원하지 않는다.

    • SAM_BIND_VALUE=Y 를 사용하면, discard log에 실패한 query의 value 값이 함께 저장된다.

    변환 실패 DISCARD

    주의

    • 건너뛴 DML은 Apply 로그에 skip insert stmt because of cast error.(xid: <xid>) 형태의 경고로 남는다. UPDATE, DELETE도 같은 형식으로 남는다.

    • DISCARD_FILE_YN=Y이면 discard 파일에 cast error discarded와 함께 해당 DML의 xid, seqno, tsn, obj_id가 기록된다. SQL 문은 기록되지 않는다.

    DDL DISCARD

    주의

    단, TABLE 관련 DDL은 해당 기능을 사용하더라도 실패하는 경우 생략할 수 없다.

    DISCARD_CAST_ERR=[Y|N]
    DISCARD_FILE_YN=[Y|N]
    DISCARD_DDL_YN=[Y|N]
    DISCARD_DDL_FILE_YN=[Y|N]
    
    DISCARD_DDL_FILE_DIR=/directory/to/save/file
    DISCARD_DDL_FILE_SIZE=200M
    DISCARD_DDL_BACKUP_DIR=/directory/to/save/backup/file
    DISCARD_DDL_BACKUP_SIZE=10G

    확장 타입 컬럼이 있는 소스 테이블에는 PRIMARY KEY가 필요하며, UNIQUE 제약조건이나 ROWID로 대신할 수 없다. 별도로 저장된 확장 값은 Llob 프로세스가 소스 DB에 Flashback Query를 수행하여 읽는다.

    Llob 프로세스의 동작은 Llob Process를 참고한다.


    동기화 대상 테이블은 Source DB와 Target DB 각각에 존재해야 한다. MAP Rule을 사용하지 않는 기본 구성에서는 Source와 Target에 동일한 사용자 계정과 동일한 스키마 구조로 생성하는 것을 전제로 한다.

    다음은 TEST 사용자 계정에 테이블 T1, T2, T3을 생성하는 예제이다. Source DB와 Target DB 모두에 수행한다.


    동기화 대상 테이블은 아래 경로의 파일에 등록한다.

    등록 형식은 OWNER_NAME.TABLE_NAME 형태로 작성한다.

    #으로 시작하는 줄과 빈 줄은 무시된다. 그 외의 줄은 OWNER_NAME.TABLE_NAME 형식이어야 하며, 구분자 .가 없거나 둘 이상이거나 OWNER 또는 TABLE이 비어 있으면 잘못된 항목으로 판단해 설치를 중단한다.

    동기화 대상을 지정할 때 Table명과 User(Owner)명 모두에 % 와일드카드를 사용할 수 있다.

    지정 예시
    대상

    TEST.%

    TEST 소유의 모든 테이블 (Table 와일드카드)

    TEST.TB%

    TEST 소유의 테이블 중 이름이 TB로 시작하는 테이블

    TEST%.%

    이름이 TEST로 시작하는 모든 소유자의 모든 테이블 (User 와일드카드)

    %.%

    Source DB의 모든 소유자의 모든 테이블 (User 와일드카드)

    사용 예시는 다음과 같다.

    Source DB가 Tibero 또는 Oracle인 경우, 다음 객체는 동기화 대상에서 자동으로 제외된다. 제외 대상에 따라 적용 범위가 다르다.

    제외 대상
    적용 범위
    설명

    시스템 스키마의 객체

    OWNER를 %가 포함된 패턴으로 지정한 경우에만

    Oracle 12c 이상은 DB가 관리하는 계정(ALL_USERS.ORACLE_MAINTAINED = 'Y', SYS · SYSTEM 등)이 제외된다. Oracle 11g는 이 컬럼이 없으므로 Oracle 기본 계정과 옵션 계정의 고정 목록(SYS, SYSTEM, OUTLN, DBSNMP, DIP, ORACLE_OCM, APPQOSSYS, ANONYMOUS, XS$NULL, XDB, CTXSYS

    ProSync 운영 계정과 메타 객체

    항상

    PRS_USER 소유의 객체와 PRS_OBJ_LIST, PRS_DD_*, PRS_LCT 등 ProSync가 생성한 메타 객체가 제외된다.

    AQ 관련 테이블

    항상

    이름이 AQ$_ 로 시작하는 테이블이 제외된다.

    또한 등록되는 객체 타입은 TABLE과 SEQUENCE로 한정되며, 그 외의 객체 타입은 등록되지 않는다.


    Source DB가 Tibero 또는 Oracle인 경우, 설치 config 파일에 AUTO_SYNC_ON_CREATE=Y를 설정하면 설치 이후 CREATE 문으로 생성된 테이블과 시퀀스가 자동으로 동기화 대상에 등록된다. prs_obj_group#.list에 미리 적지 못한 테이블을 매번 Admin 명령으로 등록하거나 재설치할 필요가 없다.

    자동 등록을 사용하려면 Source DB에 DB 단위 supplemental log가 설정되어 있어야 한다. 테이블 단위로만 supplemental log를 건 경우, 자동 등록된 테이블은 supplemental log가 없는 상태가 되어 변경분을 추출할 수 없다.

    Source DB가 Oracle인 경우 DB 단위로 supplemental log를 설정한다. 설치 config 파일에 SUPP_LOG_LVL_ALL=Y를 설정하면 설치 과정에서 database level로 설정된다.

    Source DB가 Tibero인 경우 _DDL_AUTO_SUPPLOG_CTBL을 TRUE로 설정하여 DB 단위 supplemental log를 활성화한다. 운영 중인 DB에는 ALTER SYSTEM으로 바로 적용할 수 있으나 이 변경은 DB 재기동 후 유지되지 않으므로, TIP 파일에도 같은 값을 설정한다. TAC 환경에서는 모든 노드에 동일하게 설정한다.

    설치 config 파일에 AUTO_SYNC_ON_CREATE=Y를 설정하면 설치 과정에서 이 값을 확인하며, 설정되어 있지 않으면 안내 메시지와 함께 설치를 중단한다.

    Tibero

    VARCHAR2, NVARCHAR2, NUMBER, FLOAT, LONG, DATE, BINARY_FLOAT, BINARY_DOUBLE, TIMESTAMP, TIMESTAMP WITH TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND, RAW, CHAR, NCHAR, CLOB, NCLOB, BLOB, XMLTYPE

    Oracle

    VARCHAR2, NVARCHAR2, NUMBER, FLOAT, LONG, DATE, BINARY_FLOAT, BINARY_DOUBLE, TIMESTAMP, TIMESTAMP WITH TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND, RAW, CHAR, NCHAR, CLOB, NCLOB, BLOB, XMLTYPE

    PostgreSQL

    CHAR, VARCHAR, INT, SMALLINT, BIGINT, DECIMAL, REAL, DOUBLE PRECISION, BYTEA, TEXT, DATE, TIMESTAMP

    지원 데이터 타입

    참고

    • GEOMETRY 컬럼 타입은 Tibero to Tibero 동기화만 지원된다.

    • CLOB, BLOB 컬럼의 경우, Target PostgreSQL의 OID 컬럼에 저장할 수 있으며 MAPPING RULE에 LARGEOBJECT 설정이 필요하다.

    주의

    서로 다른 Character Set 간의 데이터 처리

    • Source DB와 Target DB의 Character Set이 다른 경우, ProSync 제품 내부에서 자동으로 Character Set을 Target DB Character Set에 맞게 변환하여 데이터를 삽입한다.

    • 단, Source DB에서 지원하는 Character Set의 범위가 Target DB에서 지원하는 Character Set의 범위보다 넓을 경우, 변환 과정에서 Target DB에서 표현할 수 없는 문자가 발생할 수 있으며, 이 경우 해당 데이터는 깨지거나 손실될 수 있다.

    • 따라서 이와 같은 문제를 방지하기 위해서는 양쪽 DB의 Character Set 호환성을 사전에 검토하고, 필요 시 Target DB의 Character Set을 상위 호환되는 문자 집합으로 설정하는 것이 권장된다.

    IDENTITY COLUMN

    IDENTITY COLUMN의 경우 ALWAYS 옵션을 사용하면 동기화가 불가능하다. 그 외 BY DEFAULT, BY DEFAULT ON NULL 옵션의 경우 동기화가 가능하지만, target의 identity 칼럼 sequence를 사용하지 않고 source에 저장된 값을 동기화한다.

    4바이트 문자(이모지 등) 처리

    • Target DB가 Tibero인 경우 CLOB 컬럼에는 4바이트로 인코딩되는 문자(U+10000 이상, 이모지 등)를 저장할 수 없다. Tibero가 CLOB을 UCS-2로 저장하기 때문이며(데이터베이스 제약), 해당 문자는 대체 문자(U+FFFD)로 저장된다. 4바이트 문자를 보존해야 하는 컬럼은 NCLOB, VARCHAR2, NVARCHAR2, LONG 등으로 생성한다.

    Oracle 확장 데이터 타입

    $ tbsql sys/password
    
    SQL> CREATE USER TEST IDENTIFIED BY PASSWORD;
    SQL> GRANT RESOURCE, CONNECT TO TEST;
    
    SQL> CREATE TABLE TEST.T1 (C1 NUMBER PRIMARY KEY, C2 VARCHAR(10));
    SQL> CREATE TABLE TEST.T2 (C1 NUMBER PRIMARY KEY, C2 VARCHAR(10));
    SQL> CREATE TABLE TEST.T3 (C1 NUMBER PRIMARY KEY, C2 VARCHAR(10));
    $PRS_HOME/install/prs_obj_group1.list
    TEST.T1
    TEST.T2
    TEST.T3
    TEST.%
    TEST%.%
    %.%
    SQL> ALTER DATABASE ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;
    SQL> ALTER SYSTEM SET _DDL_AUTO_SUPPLOG_CTBL=TRUE;
    _DDL_AUTO_SUPPLOG_CTBL=TRUE
    # Source Tibero
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=src_tibero
    AUTO_SYNC_ON_CREATE=Y
    # Source Oracle
    SRC_DB_TYPE=ORACLE
    SRC_DB_NAME=src_oracle
    AUTO_SYNC_ON_CREATE=Y
    SUPP_LOG_LVL_ALL=Y

    ALTER MODIFY로 기존 컬럼의 길이를 확장한 뒤, 큰 값이 chained row 형태로 기록되어 로그 리더가 조각을 병합하지 못하는 변경은 지원하지 않는다. 이 경우 Extract가 경고 로그를 남기고 해당 변경을 건너뛴다.

    테이블 생성

    참고

    Source와 다른 database/owner/table/column으로 반영해야 하는 경우에는 MAP Rule을 설정하여 매핑할 수 있다. 자세한 내용은 의 MAP Rule 설명을 참고한다.

    테이블 등록

    특정 테이블 등록 예시

    참고

    prs_obj_group#.list 파일 내의 OWNER_NAME과 TABLE_NAME은 대소문자를 구분한다.

    와일드카드 등록

    자동으로 제외되는 대상

    주의 — OWNER를 이름으로 명시한 경우

    시스템 스키마 제외는 %.%, TEST%.%처럼 OWNER에 %를 사용해 여러 스키마를 한 번에 지정할 때만 적용된다. TEST.%처럼 OWNER를 이름으로 명시하면 적용되지 않으며, 지정한 스키마의 객체가 그대로 등록된다.

    Oracle CDB 환경에서 C##

    참고

    위의 자동 제외는 prs_obj_group#.list를 처리하는 설치 과정에 적용된다. Admin 명령으로 테이블을 직접 등록할 때는 적용되지 않는다.

    Source DB가 PostgreSQL인 경우에도 위의 자동 제외가 적용되지 않으며 일반 테이블과 파티션 테이블만 등록된다. 와일드카드로 지정할 때는 시스템 스키마가 포함되지 않도록 소유자 패턴을 명시적으로 지정한다.

    주의 — 와일드카드 사용과 Instance 구성

    와일드카드로 동기화 대상을 지정하면 다른 Instance가 동기화하고 있는 테이블까지 대상에 포함될 수 있으며, 이 경우 같은 테이블이 여러 Instance를 통해 중복으로 동기화된다.

    특히 User 와일드카드(%.%, TEST%.%)는 Table 와일드카드보다 범위가 넓어 다른 소유자의 테이블까지 한 번에 포함하므로, User 와일드카드를 사용하는 경우 단일 Instance로 구성할 것을 권장한다.

    주의 — 동기화 대상이 등록되지 않은 경우

    prs_obj_group#.list의 어떤 항목도 실제 객체를 찾지 못하면 설치가 실패로 종료된다.

    설치 과정에서 항목별로 조회 결과가 0건이면 * warning: no object matched [TEST.%] - nothing registered for this entry 형태의 경고를 출력하고, 등록된 동기화 대상이 하나도 없으면 Checking registered sync objects... none registered를 출력하며 설치를 중단한다.

    주의

    prs_obj_group#.list 파일은 설치 시점에만 처리되어 Source의 동기화 대상 목록(PRS_OBJ_LIST)을 구성하는 데 사용된다. 설치 이후에 이 파일만 수정하는 것으로는 운영 중인 인스턴스에 반영되지 않는다.

    설치 이후에 생성한 테이블을 동기화 대상에 추가하려면 아래의 '동기화 대상 자동 등록'을 사용하거나, Admin 명령 ALTER <instance> ADD TABLE <owner>.<table> GROUP=<n>으로 등록한다. 수동으로 등록하는 경우 Tibero/Oracle은 해당 테이블의 supplemental logging 설정을, PostgreSQL은 replica identity 및 publication 설정을 함께 확인해야 한다.

    동기화 대상 자동 등록

    사전 준비 — DB 단위 Supplemental Log

    설정 예시

    주의

    자동 등록은 Source DB의 동기화 대상 목록에 등록하는 것까지를 수행한다. Target DB에 동일한 테이블이 없으면 반영 단계에서 실패하므로, CREATE TABLE에 대한 DDL 동기화를 함께 구성하거나 Target DB에 테이블을 미리 생성해야 한다.

    또한 자동 등록은 대상을 가리지 않고 생성되는 모든 테이블과 시퀀스를 등록하므로 다른 Instance의 동기화 대상과 중복될 수 있다. 와일드카드 등록과 마찬가지로 단일 Instance 구성에서 사용할 것을 권장하며, 동기화하지 않아야 할 객체가 생성되는 환경에서는 사용에 유의한다.

    • LISTENER_PORT 제거

    • TOP_ID 제거

    • Log 및 Backup Log 경로 수정

    4.4.x 이후 Agent 포트는 cfg 가 아니라 prs_instance.map 의 (PORT=...) 로 지정되며, TOP_ID 는 인스턴스 이름으로 대체되었다.

    4.4.x 버전 이후(4.7 포함)에는 Agent 설치가 Instance 설치와 분리되었기 때문에, 패치 작업 전에 반드시 Agent 설치를 완료해야 한다. Agent 설치를 건너뛰고 Instance 설치를 진행하면 prs_install.sh 가 Operation of prs_install_agent.sh should be preceded. 를 출력하며 즉시 종료한다. 자세한 설치 방법은 Agent 설치 문서를 참고한다.

    4.4.x 부터는 prs_top.map에서 prs_instance.map으로 변경되었다.

    위 예시의 PROGRAM 값은 Tibero 에서 Tibero 로 동기화하는 경우이며, PROGRAM 은 DB 종류에 따라 접두사가 붙는다. 무접두사는 Tibero, o 는 Oracle, p 는 PostgreSQL 이고 ext/llob 은 소스 DB, apply 는 타겟 DB 를 기준으로 선택된다. 예를 들어 Oracle 에서 Tibero 로 동기화하는 경우 EXT1 의 PROGRAM 은 prs_oext, APPLY1 의 PROGRAM 은 prs_apply 가 된다.

    • localhost 제약 제거

    • Instance에서 Host 제거 및 MGR → Agent로 변경

    • ext process에서 Port 제거

    • verify process삭제

    4.4.x 이후(4.7 포함)는 manager 대신 agent를 사용하기 때문에 agent 기동 명령어도 man(ager)에서 age(nt)로 변경되었다.

    ALTER SYSTEM SWITCH LOGFILE;
    ADMIN> shutd man (abort);
    CREATE USER [백업유저이름] IDENTIFIED BY "[백업유저암호]";
    GRANT CONNECT, RESOURCE, CREATE SESSION TO [백업유저이름];
    GRANT INSERT ANY TABLE TO [백업유저이름];
    GRANT CREATE ANY SYNONYM TO [백업유저이름];
    GRANT CREATE ANY VIEW TO [백업유저이름];
    mv prosync/var prosync_new/var
    mv prosync/config prosync_new/config
    mv prosync old_prosync
    mv prosync_new prosync
    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=instance
    PRS_USER=prosync_user
    PRS_PWD=prosync_user_password
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=1
    EXT_AGENT_ID_LIST_0=agent1
    #EXT_AGENT_ID_LIST_1=agent1,agent2
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent1
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1
    
    ...
    export PREVIOUS_PRS_HOME=[old_prosync의 절대경로]
    $PRS_HOME/install/prs_backup.sh \
      -c prs_install.cfg \
      -u [백업유저이름] \
      -p [백업유저암호]
    GRANT SELECT ANY DICTIONARY TO $PRS_USER;
    -- 4.1.0 이후 PRS_TARGET_MIN_PRIVILEGE, 초기적재 사용시 적용
    GRANT LOCK ANY TABLE TO $PRS_USER;
    
    -- source db oracle인 경우
    GRANT SELECT ON SYS.USER$ TO $PRS_USER;
    GRANT SELECT ON SYS.ENC$ TO $PRS_USER;
    GRANT SELECT ON SYS.OBJ$ TO $PRS_USER;
    -- 4.1.0 이후 PRS_TARGET_MIN_PRIVILEGE, 초기적재 사용시 적용
    GRANT DELETE ANY TABLE TO $PRS_USER;
    
    GRANT CREATE ANY TABLE TO $PRS_USER;
    GRANT CREATE ANY SEQUENCE TO $PRS_USER;
    GRANT CREATE ANY INDEX TO $PRS_USER;
    GRANT CREATE ANY TRIGGER TO $PRS_USER;
    GRANT CREATE ANY SYNONYM TO $PRS_USER;
    GRANT CREATE ANY VIEW TO $PRS_USER;
    GRANT CREATE ANY PROCEDURE TO $PRS_USER;
    GRANT SELECT ANY DICTIONARY TO $PRS_USER;
    GRANT ALTER ANY TABLE TO $PRS_USER;
    GRANT ALTER ANY INDEX TO $PRS_USER;
    GRANT ALTER ANY TRIGGER TO $PRS_USER;
    GRANT ALTER ANY SEQUENCE TO $PRS_USER;
    GRANT ALTER ANY PROCEDURE TO $PRS_USER;
    GRANT DROP ANY TABLE TO $PRS_USER;
    GRANT DROP ANY INDEX TO $PRS_USER;
    GRANT DROP ANY TRIGGER TO $PRS_USER;
    GRANT DROP ANY SEQUENCE TO $PRS_USER;
    GRANT DROP ANY VIEW TO $PRS_USER;
    GRANT DROP ANY PROCEDURE TO $PRS_USER;
    GRANT DROP ANY SYNONYM TO $PRS_USER;
    GRANT COMMENT ANY TABLE TO $PRS_USER;
    
    -- target db oracle인 경우
    GRANT SELECT ON SYS.OBJ$ TO $PRS_USER;
    GRANT SELECT ON SYS.USER$ TO $PRS_USER;
    GRANT SELECT ON SYS.COL$ TO $PRS_USER;
    GRANT SELECT ON SYS.SEQ$ TO $PRS_USER;
    cp /dev/null $PRS_HOME/install/prs_obj_group1.list
    $PRS_HOME/install/prs_meta.sh -c prs_install.cfg

    1. 로그 스위치 수행 (SRC DB)

    2. 프로세스 강제 종료 (SRC / TAR)

    3. 메타데이터 백업을 위한 유저 생성 (SRC / TAR)

    4. var / config 디렉토리 이관

    장애로 인해 업그레이드 패치에 실패할 경우를 대비하여 기존 시점으로 롤백 태스크 수행 시 원본 데이터 파일이 존재해야 하므로 기존 바이너리는 백업해둔다.

    5. prs_install.cfg 작성

    6. 메타데이터 백업 수행

    Oracle DB의 경우, 백업 수행하는 TABLESPACE 에 대한 쓰기 권한이 필요할 수 있다.

    ALTER USER [백업유저이름] QUOTA [필요크기] ON [TABLESPACE 명];

    쿼리를 통하여 충분한 크기를 할당한다.

    7. SRC DB 권한 부여

    Source DB가 Oracle인 경우 4.7의 Extract 프로세스는 기동 시 SYS.ENC$를 조회한다. Oracle 12c 이상에서는 SELECT ANY DICTIONARY 권한으로 SYS.USER$, SYS.ENC$를 조회할 수 없으므로 별도로 부여해야 하며, 권한이 없으면 Extract 프로세스가 기동하지 못한다.

    9단계의 prs_meta.sh는 설치 config 파일의 SRC_INSTALL_USER 계정으로 Source DB의 ProSync 유저 권한을 다시 부여한다.

    8. TAR DB 권한 부여

    9. prs_obj_group1.list 생성 및 메타 정보 이관

    참고

    prs_meta.sh는 목록 파일(prs_obj_group#.list)의 항목을 실행 시점의 Source DB에서 다시 조회해, 동기화 대상 목록(PRS_OBJ_LIST)에 아직 없는 객체만 새로 등록한다. 이미 등록된 객체는 그룹 번호를 포함해 그대로 유지되고, 목록 파일에 없는 기존 등록 객체도 삭제되지 않는다. prs_backup.sh로 백업 유저 스키마에 저장한 메타데이터는 prs_meta.sh가 참조하지 않으며, 롤백 가이드에서 메타데이터를 복구할 때 사용한다.

    따라서 동기화 대상을 바꾸지 않으려면 위 예시처럼 항목이 없는 빈 목록 파일을 만든다. 설치 이후 Admin 명령 ALTER <instance> ADD TABLE, ALTER <instance> DELETE TABLE로 바꾼 동기화 대상도 PRS_OBJ_LIST에 이미 반영되어 있으므로 목록 파일에 적을 필요가 없다. 패치와 함께 동기화 대상을 추가하려면 추가할 객체만 목록 파일에 적는다.

    설치 당시의 목록 파일이나 $PRS_HOME/install/templates/prs_obj_group1.list.template을 복사해 쓰지 않는다. 설치 이후 DELETE TABLE로 제외한 객체도 목록 항목에 맞으면 다시 등록되고, TEST.%처럼 %가 들어간 항목은 패턴에 맞지만 동기화 대상이 아니던 테이블과 시퀀스(설치 이후 생성한 객체 등)까지 등록한다. 템플릿에는 TIBERO.% 항목이 들어 있어, Source DB가 Tibero이면 TIBERO 스키마의 모든 테이블과 시퀀스가 등록된다. 이렇게 새로 등록된 객체는 Target DB에 같은 객체가 없으면 반영 단계에서 실패한다.

    prs_meta.sh에 -c로 지정한 설치 config 파일(5단계의 prs_install.cfg)에 GROUP_NUM을 2 이상으로 지정했다면 prs_obj_group2.list부터 prs_obj_group<GROUP_NUM>.list까지도 같은 방법으로 빈 파일을 만든다. 하나라도 없으면 prs_meta.sh가 not found를 출력하고 Source DB 메타를 갱신하는 도중에 중단되며 Target DB 메타는 갱신되지 않으므로, 파일을 모두 만든 뒤 prs_meta.sh를 다시 수행한다. 설치 시 -l 옵션으로 다른 목록 파일을 사용했더라도 prs_meta.sh에는 -l

    주의

    prs_meta.sh는 5단계에서 작성한 prs_install.cfg의 값으로 Source DB의 DDL 트리거와 supplemental log를 다시 설정하므로, AUTO_SYNC_ON_CREATE, AUTO_ADD_SUPP_LOG, SUPP_LOG_LVL_ALL은 기존 설치에 사용한 설치 config 파일과 같은 값으로 둔다. AUTO_SYNC_ON_CREATE=Y가 없으면 동기화 대상 자동 등록이 꺼진다. Source DB가 Oracle이고 AUTO_ADD_SUPP_LOG가 N이 아니면, SUPP_LOG_LVL_ALL=Y가 없을 때 설정되어 있던 database level supplemental log(ALL)를 해제하고 동기화 대상 테이블에만 테이블 단위로 설정한다.

    메타 정보 이관 예시

    MGR=(ID=lmgr)(HOST=localhost)(PORT=7600)
    
    Prosync=(
        EXT1=(MGR=lmgr)(HOST=localhost)(PORT=7610)(PROGRAM=prs_ext)
        APPLY1=(MGR=lmgr)(HOST=localhost)(PORT=7620)(PROGRAM=prs_apply)
        LLOB=(MGR=lmgr)(HOST=localhost)(PORT=7630)(PROGRAM=prs_llob)
        VF=(MGR=lmgr)(HOST=localhost)(PORT=7640)(PROGRAM=prs_vf)
    )
    AGENT=(ID=agent1)(HOST=172.19.0.11)(PORT=7600)
    
    Prosync=(
        EXT1=(AGENT=agent1)(PROGRAM=prs_ext)
        APPLY1=(AGENT=agent1)(PORT=7620)(PROGRAM=prs_apply)
        LLOB=(AGENT=agent1)(PORT=7630)(PROGRAM=prs_llob)
    )
    
    
    ADMIN> start age(nt) {AGENT_ID}
    ADMIN> start {INSTANCE_ID}

    10. Config 파일 수정

    10.1. 각 process별 cfg 파일 내 파라미터 수정

    10.2. vf.cfg 삭제 확인

    10.3. prs_mgr.cfg → prs_agent_{agent_id}.cfg 으로 변경

    11. Agent 설치

    12. prs_top.map 변경 사항

    4.0 형식

    4.4.x 이후 형식

    13. ProSync 재기동

    이후, const Thread 가 처리하지 못한 메모리 크기가 파라미터 값의 절반 이하로 낮아지는 경우 다시 extract 프로세스에서 보내는 chunk를 수신한다.

    apply 프로세스의 Const Thread 메모리에서 관리하는 tx정보들의 크기를 관리하는 파라미터로 commit이 오지 않은 stmt들 정보가 TX_HASH_SIZE를 넘어가는 경우 가장 큰 TX부터 part파일 생성 후 메모리에서 제거하며 해당 값보다 사용하는 메모리가 낮아질 때까지 반복한다.

    Log Switch 감지 시, const Thread 에서 아직 commit되지 않은 tx정보를 재기동 상황에서도 유지하기 위해 txh 파일을 생성한다. 이때, txh 파일의 최대 개수 또는 파일들의 합의 최대 크기를 설정할 수 있다.

    TX_HASH_FILE_MODE 파라미터를 통해 제한 방식을 설정할 수 있으며, 각 Extract별로 txh의 크기나 개수를 계산한다.

    TX_HASH_SIZE 이상으로 const Thread 에서 TX 정보들이 쌓이게 되는 경우, 메모리 관리를 위해 part파일을 작성하고 메모리에서 제거하게 되며 관련된 TX가 commit 또는 rollback되기 전까지 partfile은 제거되지 않는다. 따라서, 한 TX가 끝나지 않는 경우 디스크 사용량이 계속해서 증가할 수 있다.


    Apply의 복구 상태는 Target DB의 PRS_LCT(마지막 반영 TX 정보), PRS_COMMITTED_TX_LIST(commit 완료 TX 목록), 그리고 $PRS_HOME/var/<instance>/tx의 txh_*/txl_* 파일(미완료 TX)로 나누어 관리된다. 각 저장소의 역할은 Apply Process의 '복구와 Checkpoint'를 참고한다.

    Apply를 재기동하면 Ext와의 재연결 과정(handshake)에서 Apply에 저장된 이력 정보를 Ext에 전달하여 재추출 시작점을 결정한다. Ext는 그 지점부터 다시 추출하므로 일부 구간의 레코드가 재전송될 수 있으며, 이미 반영이 완료된 트랜잭션은 PRS_COMMITTED_TX_LIST를 통해 중복 반영 여부를 판정하여 건너뛴다.

    또한 반영 오류로 특정 DML이 계속 재시도되는 동안에는 해당 TX가 반영 완료로 기록되지 않으므로, 복구 기준점(PRS_LCT)도 그 이전 상태로 유지된다.

    log switch 시점에 아직 commit이 도달하지 않은 트랜잭션은 $PRS_HOME/var/<instance>/tx의 txh_*/txl_* 파일로 export되며, 재기동 시 import되어 이어서 처리된다.


    Source DB에 데이터를 삽입할 때는 해당 DB의 Character Set과 일치하는 Terminal 및 OS의 LANG 환경변수 설정이 반드시 필요하다.

    LANG 설정이 Source DB의 Character Set과 일치하지 않으면, ProSync가 데이터를 추출할 때 잘못된 인코딩으로 인식하게 되어, Target DB로 전송 시 문자 깨짐 또는 손상된 데이터가 저장될 수 있다.

    따라서, Source DB에 데이터를 입력하는 시스템의 LANG 환경 변수는 Source DB의 Character Set과 정확히 일치시켜야 하며, 시스템 관리자 또는 사용자 환경에서도 일관된 문자셋 설정이 유지되어야 한다.

    Trigger가 설정된 테이블을 동기화할 경우, Trigger로 인해 예상치 못한 데이터 중복이 발생할 수 있다. 예를 들어, 다음과 같은 Trigger가 Source DB와 Target DB에 존재한다고 가정한다.

    위와 같은 환경에서 TEST.T1 테이블을 동기화할 경우, 다음과 같은 흐름이 발생할 수 있다.

    1. Source DB에서 TEST.T1 테이블에 INSERT 수행 -> Trigger 작동 -> TEST.T2에도 데이터 삽입

    2. 동기화 과정에서 Target DB에 TEST.T1 INSERT 반영 -> Target DB의 Trigger 작동 -> TEST.T2에도 동일한 데이터 삽입

    3. 또한, Source DB에서 추출된 TEST.T2의 INSERT 문이 Target DB에 반영되면서 중복 삽입 발생

    이로 인해 Target DB의 TEST.T2 테이블에는 중복된 데이터가 저장될 수 있다.

    따라서 ProSync 동기화 로직 상 정합성이 틀어질 수 있기 때문에 Target DB에는 Trigger가 존재해서는 안 된다.

    Oracle To Tibero 동기화의 경우, 이미 데이터가 존재하는 테이블에 ALTER TABLE DDL 수행 시 오라클 내부 동작으로 인해 DPI(Direct Path Insert)가 발생하며 Unique Constraints Violation이 발생할 수 있다.

    예를 들어, 아래와 같은 형상의 테이블이 존재하며, 다음과 같은 흐름으로 진행된다고 가정한다.

    이때, ALTER TABLE 구문으로 인해 오라클 내부에서 DPI가 발생하며 데이터를 복사하는 과정이 수행되는데, 해당 DPI 구문이 동기화 테이블과 같은 OBJ_ID를 가지고 있어 함께 동기화가 진행되며 Unique Constraints Violation이 발생한다.

    해당 오류 발생 시 DISCARD_EC 파라미터에 UNIQUE VIOLATION Error code를 기재하여 우회할 수 있다.

    성능

    장애

    반영 실패

    메모리 과점유

    MEMORY_CTRL_STOP_SIZE/MEMORY_CTRL_RESUME_SIZE

    MERGE_BLOCK_CNT/MERGE_RESUME_CNT

    CHUNK_TOTAL_SIZE

    SQL> CREATE OR REPLACE TRIGGER trg_test
    AFTER INSERT ON TEST.T1
    FOR EACH ROW
    BEGIN
    INSERT INTO TEST.T2 VALUES (:NEW.C1, 'Trigger Fired');
    END;
    /
    SQL> CREATE TABLE TEST.T1 (
        ROWCNT NUMBER PRIMARY KEY,
        C1 NUMBER,
        C2 VARCHAR2(4000)
    ) ROW STORE COMPRESS ADVANCED;
    
    SQL> INSERT INTO TEST.T1 VALUES (1, 1001, RPAD('C', 4000, 'C'));
    SQL> INSERT INTO TEST.T1 VALUES (2, 1002, RPAD('B', 4000, 'B'));
    SQL> COMMIT;
    
    SQL> ALTER TABLE TEST.T1 MOVE ONLINE NOCOMPRESS;
    -- Unique Constraints Violation 발생

    TX_HASH_SIZE

    디스크 사용

    TX_HASH_FILE_CNT/TX_HASH_FILE_TOTAL_SIZE

    partfile

    재기동과 복구

    재기동 시 동작

    미완료 트랜잭션 복구

    주의

    • $PRS_HOME/var/<instance>/tx 디렉토리를 삭제하거나 유실하면 미완료 트랜잭션 정보를 복구할 수 없다.

    • Target DB를 재설치하거나 PRS_LCT

    주의사항

    Character Set 설정 주의사항

    Source DB의 Character Set과 OS 환경 변수(LANG) 불일치 시 주의사항

    참고

    예시

    • Source Database Character Set: UTF-8

    • Terminal 및 OS LANG 설정: EUC-KR 이 경우, 사용자가 입력한 한글 데이터는 실질적으로 EUC-KR로 인코딩되어 저장된다. 그러나 ProSync는 해당 데이터를 UTF-8로 간주하고 Target DB의 문자셋에 맞게 변환을 시도하게 되므로, 결과적으로 잘못된 문자 변환이 발생할 수 있다.

    Trigger가 설정된 테이블 동기화 시 주의 사항

    주의

    제약 조건이 설정된 테이블 동기화 시 주의 사항

    Trigger뿐만 아니라 ON DELETE, ON UPDATE와 같은 제약 조건(Constraint) 또한 동일한 이유로 Target DB에 설정되어서는 안 된다.

    이러한 제약 조건이 존재할 경우, 동기화 시 데이터의 삽입·삭제·갱신 작업이 중복 반영되어 데이터 정합성이 깨질 수 있다.

    Oracle To Tibero 동기화 시 주의 사항

    주의

    오라클 내부 동작이므로, 어떤 구문 실행 시 DPI가 발생하는지는 정확히 알 수 없다.

    PRS_LCT

    Target DB

    반영 스레드가 마지막으로 반영한 TX의 정보. replay/checkpoint의 기준이 된다.

    PRS_COMMITTED_TX_LIST (PRS_CTL)

    Target DB

    commit이 완료된 트랜잭션 목록. 재전송된 트랜잭션의 중복 반영 여부 판정에 사용된다.

    txh_*, txl_* 파일

    $PRS_HOME/var/<instance>/tx

    아직 commit이 도달하지 않은 미완료 트랜잭션의 export/import에 사용된다.

    장애 대응 가이드
    그림 3. Replay로 넘어간 트랜잭션

    Worker Threads

    Resource Thread

    Stat Thread

    복구와 Checkpoint

    주의

    • Target DB를 재설치하거나 PRS_LCT 등 메타 테이블이 삭제되면 복구 기준점이 사라져 이어서 반영할 수 없다.

    • $PRS_HOME/var/<instance>/tx 디렉터리를 삭제하거나 유실하면 미완료 트랜잭션 정보를 복구할 수 없다.

    티베로 | 대한민국 대표 데이터베이스 전문 기업티베로
    을 지정하지 않는다.
    등 메타 테이블을 삭제하면 복구 기준점이 사라져 이어서 반영할 수 없으며, 초기 동기화 기준점부터 다시 구성해야 한다.
    Target DB가 Tibero이고 Apply가 Tibero 7 클라이언트 라이브러리를 사용하는 경우, 4바이트 문자가 포함된
    LONG
    값이 65,532바이트를 넘으면 해당 문자가 대체 문자(U+FFFD)로 바뀌고 값의 길이도 줄어든다. 이때 Apply 로그에 경고(
    LONG value has 4-byte characters but is longer than 65532 bytes
    )가 남는다. 65,532바이트 이하의 값은 그대로 반영된다.
  • Tibero NCLOB에 저장된 4바이트 문자는 DBMS_LOB.SUBSTR, TO_CHAR 등으로 조회하면 대체 문자(U+FFFD)로 보일 수 있다. 저장된 값은 TO_NCHAR로 변환해 확인한다.

  • ,
    MDSYS
    ,
    MDDATA
    ,
    ORDSYS
    ,
    ORDDATA
    ,
    ORDPLUGINS
    ,
    SI_INFORMTN_SCHEMA
    ,
    OLAPSYS
    ,
    EXFSYS
    ,
    WMSYS
    ,
    SYSMAN
    ,
    MGMT_VIEW
    ,
    OWBSYS
    ,
    OWBSYS_AUDIT
    ,
    SPATIAL_CSW_ADMIN_USR
    ,
    SPATIAL_WFS_ADMIN_USR
    ,
    TSMSYS
    ,
    DMSYS
    ,
    WKSYS
    ,
    WKPROXY
    ,
    WK_TEST
    ,
    LBACSYS
    ,
    DVSYS
    ,
    DVF
    ,
    FLOWS_FILES
    ,
    APEX_PUBLIC_USER
    )과,
    APEX_030200
    ·
    FLOWS_030000
    처럼
    APEX_
    또는
    FLOWS_
    뒤에 숫자 6자리가 붙는 계정이 제외되며, 목록에 없는 계정은 제외되지 않는다. Tibero는
    SYS
    ,
    SYSCAT
    ,
    SYSGIS
    ,
    OUTLN
    ,
    LBACSYS
    및 일반 사용자가 아닌 계정이 제외된다.
    접두어 없이 만든 계정이나
    ALTER SESSION SET "_ORACLE_SCRIPT"=TRUE
    를 사용해 만든 계정은
    ALL_USERS.ORACLE_MAINTAINED
    가
    'Y'
    로 표시된다. 이런 계정도 OWNER로 명시하면 동기화 대상으로 등록된다.
    Table 와일드카드(TEST.%)를 사용하는 경우에도 동일한 문제가 발생할 수 있으므로, 다중 Instance 환경에서는 Instance별 동기화 대상이 서로 겹치지 않는지 확인한 뒤 사용한다.
    OWNER와 TABLE 이름의 대소문자가 맞는지, 그리고 해당 객체가 설치 시점에 Source DB에 이미 존재하는지 확인한 뒤 다시 설치한다.

    IOT overflow 세그먼트

    항상

    이름이 SYS_IOT_OVER_ 로 시작하는 테이블이 제외된다.

    Recycle Bin 객체

    항상

    이름이 BIN$ 로 시작하는 객체가 제외된다.

    운영 가이드
    Logo
    prosync, 프로싱크 Llob 프로세스

    CPU 요구사항

    CPU는 64bit 명령어 집합을 사용하는 CPU가 요구된다. 32bit 명령어 집합을 사용하는 CPU 상에서 사용되는 시나리오는 현재 고려되고 있지 않다.

    ProSync는 대체로 CPU를 많이 점유하는 프로그램은 아니다. 일련의 데이터 스트림을 전송하고, 이를 쿼리형태로 변환하여 peer쪽의 저장장치에 저장 명령을 내리는 동작을 하기 때문에, 저장하고자 하는 소프트웨어(RDBMS)나 하드웨어의 영향을 많이 받는다.

    ProSync가 CPU를 점유할만한 시나리오는 크게 2가지가 있다.

    • 데이터 송신 부분에서 발생하는 여러 처리과정으로 인한 부하

    • 데이터 수신 부분에서 트랜잭션 병렬처리를 위해 발생하는 병렬 확인 부분

    각각에 대해 설명을 하면 아래와 같다.

    데이터 송신 부분

    ProSync는 TCP 스택에 데이터를 전송하기 전에, 자체 프로토콜을 사용하여 데이터를 직렬화한다. 데이터를 전송하는 측에서는 당연히 자체 프로토콜을 저장할 데이터 버퍼가 필요하고, 이 버퍼에 데이터를 저장한 뒤 Non-Blocking으로 데이터를 전송해주어야 대기 없이 다음 데이터를 처리할 수 있다.

    또한 데이터는 네트워크 환경에 따라서 압축이 될 수도 있고, 암호화가 되어 전송이 될 수도 있다. 이런 경우에 데이터 송신 전에 전처리할 작업들이 많아져서 CPU 점유량이 높아질 수 있다.

    데이터 수신 부분

    송신 부분에서 설명한 것과 마찬가지로, 수신부분에서도 소켓으로부터 데이터를 받은 뒤, 복호화 작업이나 압축된 데이터에 대한 해제과정이 필요하다. 이 부분에서 CPU 점유량을 사용할 수 있다.

    하지만 CPU가 가장 많이 사용되는 부분은 역직렬화된 트랜잭션 데이터들에 대한 중복 확인 과정이다. CDC 제품 특성상 데이터 정합성을 위해선 Change Data 들에 대한 시간 순서를 엄밀히 지켜주어야 한다. 이 때문에 N명의 사용자가 데이터를 생산했다 하더라도, 별도의 처리 없인 시간 순으로 데이터를 처리하는 1개의 프로세스만이 존재하게 되어 많은 성능 손실이 야기된다.

    ProSync는 이에 대한 처리를 위해 Change Data 각각에 대해 서로가 같은 데이터에 접근한지에 대한 확인을 하게 된다. 트랜잭션 단위의 ACID만을 유지하면 되기 때문에, 두 트랜잭션 내에 있는 모든 Change Data(=레코드, DML, ...) 들이 서로 다른 데이터에 접근했다면, 병렬로 반영해도 아무런 문제가 없다.

    이에 대한 처리를 위해서 ProSync는 자체 자료구조를 사용하여 이를 검사하게 된다. 트랜잭션이 처리하는 데이터량이 많다면 이에 대한 처리도 많아지고, 그만큼 자료구조를 탐색하는 시간도 길어지게 된다. 따라서 이 부분을 탐색하는 비용에서 ProSync는 CPU 사용량이 많아지게 된다.

    ProSync는 수많은 로그가 사용된다. 프로그램의 로그를 포함하여, SAM(Sequential Access Method) 파일을 내리는 기능이나 Error가 발생한 DML을 확인하는 기능 등이 대표적이다. 이들은 Blocking I/O로 되어 있어서, Disk의 write 동작을 반드시 대기하고 다음 작업을 수행한다. 따라서 로그 레벨이 높거나 작성할 로그 파일이 많아지면 CPU동작이 그만큼 지연될 수 있다.

    뿐만 아니라 ProSync는 특정 시점마다 이력정보를 저장한다. 대표적인 경우가 RDBMS의 Redo Log Switch (이하 Log Switch) 이다. Log Switch가 발생하면 이력정보와 관련된 데이터를 모두 Disk로 write하게 되는데, 이때도 마찬가지로 지연이 발생할 수 있다.

    Agent Parameters

    CONN_MAX specifies the max number of connections between processes.

    Property
    Description

    데이터 병렬화 부분

    파일 I/O 관련

    LOG_BACKUP_DIR specifies the directory where the ProSync log files are backed up. It must be specified as an absolute path.

    Property
    Description

    LOG_BACKUP_SIZE specifies the maximum size of all backup files in the process. If this limit is exceeded, the oldest log files in the directory are deleted.

    Property
    Description

    LOG_DIR specifies the directory where the ProSync log files are stored. It must be specified as an absolute path.

    Property
    Description

    LOG_FILE_SIZE specifies the maximum log file size. If a log file exceeds this limit, it is moved to the backup directory and a new log file is created.

    Property
    Description

    LOG_LEVEL specifies the log level of the process. A higher log-level produces more detailed logs.

    Property
    Description

    cm probe timeout. when it's 0, indefinitely wait returns from cm. works only when USE_CM=Y

    Property
    Description

    time interval to check whether child process is dead or not.

    Property
    Description

    maximum fail count to calibrate process status internally. works only when USE_CM=Y

    Property
    Description

    STARTUP 명령이나 자동 재기동으로 프로세스 기동을 요청한 뒤 해당 프로세스가 Agent 에 접속할 때까지 기다리는 최대 시간(초)을 설정한다. 이 시간 안에는 기동 중인 것으로 보고 재기동하지 않으며, 시간이 지나도 접속하지 않으면 남아 있는 프로세스를 강제 종료한 뒤 다시 기동한다. 누적 자동 재기동 횟수가 PRS_AGENT_PROC_MAX_FAIL_CNT 에 이르면 더 이상 재기동하지 않고 CM 에 Agent 중지를 요청한다. USE_CM=Y 일 때만 동작한다. 값은 PRS_AGENT_PROC_STATUS_REPLY_TIMEOUT 이하로 설정해야 하며, 이보다 크면 USE_CM 설정과 관계없이 Agent 가 파라미터 오류로 기동하지 않는다.

    Property
    Description

    proc status check interval. works only when USE_CM=Y

    Property
    Description

    read idle timeout seconds, for status reply. works only when USE_CM=Y

    Property
    Description

    time interval to get statistic information. agent sends info req msg to ext and apply.

    Property
    Description

    This parameter decides how often to insert resource data into repoDB.

    Property
    Description

    USE_CM specifies whether use cm management for failover or not.

    Property
    Description

    Parameter type

    Integer

    Default Value

    128

    Class

    Optional, Static

    Range

    CONN_MAX

    Parameter Format

    32 - 1024

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Integer

    Default Value

    3

    Class

    Mandatory, Dynamic

    Range

    1 - 5

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - PRS_AGENT_CM_PROBE_TIMEOUT < PRS_AGENT_PROC_STATUS_INTERVAL

    Parameter type

    Integer

    Default Value

    1

    Class

    Optional, Static

    Range

    1 - 3600

    Parameter type

    Integer

    Default Value

    5

    Class

    Optional, Static

    Range

    1 - 3600

    Parameter type

    Integer

    Default Value

    10

    Class

    Optional, Static

    Range

    5 - 256

    Parameter type

    Integer

    Default Value

    3

    Class

    Optional, Static

    Range

    2 - 256

    Parameter type

    Integer

    Default Value

    10

    Class

    Optional, Static

    Range

    6 - 256

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    1 - 3600

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    60 - 3600

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    LOG_BACKUP_DIR

    Parameter Format

    LOG_BACKUP_SIZE

    Parameter Format

    LOG_DIR

    Parameter Format

    LOG_FILE_SIZE

    Parameter Format

    LOG_LEVEL

    Parameter Format

    PRS_AGENT_CM_PROBE_TIMEOUT

    Parameter Format

    PRS_AGENT_PROC_CHECK_INTERVAL

    Parameter Format

    PRS_AGENT_PROC_MAX_FAIL_CNT

    Parameter Format

    PRS_AGENT_PROC_STARTUP_TIMEOUT

    Parameter Format

    PRS_AGENT_PROC_STATUS_INTERVAL

    Parameter Format

    PRS_AGENT_PROC_STATUS_REPLY_TIMEOUT

    Parameter Format

    PRS_AGENT_TIME_INTERVAL

    Parameter Format

    REPO_RESOURCE_INSERT_INTERVAL

    Parameter Format

    USE_CM

    Parameter Format

    Agent 설치

    1. 설치 파라미터 설정

    Agent 프로세스를 설치하기 위해 각 계정의 설정 정보를 $PRS_HOME/install/prs_install_agent.cfg 파일에 작성한다.

    설정 템플릿 예시

    ############################################
    #
    # ProSync Agent Configurations (Template)
    #
    ############################################
    # ID have to be unique in prs_instance.map.
    # It will be checked when executing prs_install_agent.sh.
    # Because of multi-agent environment,
    # HOSTNAME(defined in /etc/hosts) is not recommended, IP will be better.
    # AGENT_HOST[%d]=192.xxx.xxx.xxx
    
    # AGENT_ID is unique key in prosync
    # All nodes have to use same AGENT_ID in same agent.
    
    AGENT_CNT=1
    AGENT_ID_0=agent
    AGENT_HOST_0=localhost
    AGENT_PORT_0=7600
    #AGENT_CM_GROUP_0=0
    #AGENT_CM_ID_0=0
    
    #AGENT_ID_1=agent2
    #AGENT_HOST_1=localhost
    #AGENT_PORT_1=7601
    #AGENT_CM_GROUP_1=1
    #AGENT_CM_ID_1=1

    파라미터 설명

    파라미터
    설명

    AGENT_CNT

    설치할 Agent의 개수를 지정한다. 지정한 수만큼 아래 항목을 추가로 작성해야 한다. (필수)

    AGENT_ID_[n]

    각 Agent의 고유 ID를 지정한다. 숫자로 시작할 수 없으며, 고유하게 식별 가능한 이름을 설정해야 한다. (필수)

    AGENT_HOST_[n]

    Agent가 설치될 호스트를 지정한다. Hostname보다 IP 주소를 사용하는 것을 권장한다. (필수)

    아래는 4개의 Agent를 설정한 예시이다:


    설정 파일(prs_install_agent.cfg)이 준비된 후에는 다음과 같이 설치 스크립트를 실행한다.

    옵션
    설명

    옵션 없이 기본 설정 파일로 설치를 수행하는 경우

    설치가 진행되면 시스템 환경 체크, 설정 파일 검증, agent 파일 생성 등의 단계가 자동으로 수행된다.

    중간에 기존 설정 파일이 존재할 경우 덮어쓸지 여부를 묻는 메시지가 표시되며, 사용자가 Y/N으로 응답해야 한다.

    설치 예시


    설치가 완료되면 다음 디렉터리에서 결과 파일을 확인할 수 있다.

    • prs_agent_<agent_id>.cfg: 개별 Agent의 설정 파일

    • prs_instance.map: 전체 Agent들의 연결 정보를 관리하는 매핑 파일


    CM Failover 기능을 사용하기 위해 AGENT_CM_GROUP[n] 및 AGENT_CM_ID[n]을 설정한 경우, 설치 시 $PRS_HOME/bin 경로에 prs_<AGENT_CM_ID>.sh 형식의 스크립트 파일이 자동 생성된다.

    이 스크립트 파일에는 Agent 기동을 위한 환경 변수를 설정해야 하며, 반드시 TB_HOME, AGENT_ID 등을 환경에 맞게 수정해야 한다.

    MAP Rule

    테이블, 컬럼 매핑 기능을 사용하기 위한 MAP 파라미터 설정 방법을 설명한다.

    테이블, 컬럼 매핑 기능을 사용하기 위해서는 $PRS_HOME/config 디렉터리의 Apply config file인 '[INST_ID]_apply1.cfg'를 설정한다.

    다음은 설정해야 할 파라미터에 대한 설명이다.

    기본 MAP 파라미터에 Source DB의 특정 테이블을 Target DB의 특정 테이블로 동기화하기 위한 규칙을 설정한다.

    MAP=([SYNC OPTION] SOURCE_USER.SOURCE_TABLE [SOURCE_COLUMNS]
         [COLUMN FILTERING OPTION],
         [TARGET_DATABASE.]TARGET_USER.TARGET_TABLE [TARGET_COLUMNS]
         [RESOLVE OPTION] [SKIP OPTION])
    인자
    설명

    SYNC OPTION

    TABLE : 동기화할 테이블을 지정하는 경우 설정한다. OBJECT : 동기화 대상이 아닌 오브젝트의 DDL 매핑을 지정하는 경우 설정한다. EXCLUDE : 동기화를 제외할 테이블을 지정하는 경우 설정한다.

    SOURCE_USER

    다음은 MAP 파라미터를 이용해서 동기화 대상 반영 기능을 사용하는 방법에 대한 예제이다.

    다음은 Source DB의 PROSYNC1 사용자의 T1 테이블을 Target DB의 PROSYNC2 사용자의 T2 테이블로 동기화하는 예제이다.

    다음은 Source DB의 PROSYNC1 사용자의 T1 테이블에 컬럼 C1, C2, C3가 있고, 이중 C1와 C2 컬럼만 Target DB의 PROSYNC2 사용자의 T2 테이블의 C1, C2 컬럼과 동기화하는 예제이다.

    다음은 Source DB의 PROSYNC1 사용자의 T1 테이블에 컬럼 C1, C2, C3가 있고, 이중 C1와 C2 컬럼만 Target DB의 PROSYNC2 사용자의 T2 테이블의 D1, D2 컬럼과 동기화하는 예제이다.


    동기화 테이블 사용 여부를 설정한다.

    동기화 테이블을 지정하는 경우 SYNC OPTION에 TABLE을 설정한다.

    동기화 대상이 아닌 오브젝트의 DDL 매핑을 지정하는 경우 SYNC OPTION에 OBJECT를 설정한다.

    동기화 대상 테이블에 대해서는 앞서 설명한 TABLE 규칙을 따라 DDL 매핑이 지원되며, TABLE 규칙이 명시되지 않은 경우 매핑 없이 동기화된다. 동기화 대상으로 설정할 수 없는 INDEX 등의 OBJECT나 동기화 대상이 아닌 테이블에 대해서만 해당 규칙으로 설정할 수 있다. OBJECT 규칙에 대해서는 반드시 위의 형태로만 사용 가능하다. OBJECT_NAME에 와일드 카드로 '%'를 입력할 수 있다. 이 경우 [SOURCE_USER]의 임의의 OBJECT [SOURCE_USER].[OBJECT_NAME]을 [TARGET_USER].[OBJECT_NAME]에 DDL 매핑하여 DDL을 동기화한다.

    동기화를 제외할 테이블을 지정하는 경우 SYNC OPTION에 EXCLUDE를 설정한다.

    Source DB의 PROSYNC 사용자의 TMP_TBL 테이블을 제외하고 동기화할 때 다음과 같이 '[INST_ID]_apply1.cfg'의 MAP 파라미터를 설정한다.


    COLUMN FILTERING OPTION을 사용하여 일부 컬럼에 대한 동기화를 제거할 수 있다. 다만 Constraint가 걸려있는 컬럼에 대해서는 해당 옵션을 사용할 수 없다.

    다음과 같이 COLUMN FILTERING OPTION을 사용할 수 있다.

    Source DB의 PROSYNC1 사용자의 T1 테이블에 컬럼 C1, C2, C3가 있고, 이중 C1 컬럼만 제외하고 Target DB의 PROSYNC2 사용자의 T2 테이블의 C2, C3 컬럼과 동기화할 경우 다음과 같이 '[INST_ID]_apply1.cfg'의 MAP 파라미터를 설정한다.


    동기화 시 충돌 상황에서 Source DB에 정합성 기준을 맞출지, Target DB에 정합성 기준을 맞출지, 아니면 특정 컬럼의 Min 혹은 Max 값 기준으로 데이터 정합성을 맞출지를 결정하는 옵션이다. 필수 옵션은 아니며 주로 양방향 동기화에 사용된다.

    정해진 Rule에 따라 DML 들이 변경되거나 생략된다.

    다음은 RESOLVE OPTION에 설정할 수 있는 RESOLVE_RULE의 종류이다.

    RESOLVE_RULE
    설명

    MAX와 MIN RESOLVE_RULE의 경우에는 반드시 DEFAULT OPTION을 설정해야 한다. 컬럼 값이 null인 경우에 설정한 DEFAULT 값으로 비교한다. 단, 동기화는 설정한 DEFAULT 값이 아니라 실제 컬럼 값으로 수행한다.

    UPDATE을 동기화하는 경우 MIN, MAX Rule을 사용한다면 비교 대상 컬럼의 변경 유무에 따라 다르게 비교를 수행한다. 비교 대상 컬럼이 변경되었다면 변경된 값, 변경되지 않았다면 기존 값으로 Target DB의 row와 비교를 진행한다. 비교 대상 컬럼이 NULL인 상태에서 UPDATE가 발생하는 경우 비교가 불가능하기 때문에 비교 없이 Source DB 값을 우선으로 DML을 수행한다.

    예를 들어 DB1과 DB2간의 양방향 동기화하는 경우 DB1의 PROSYNC 사용자의 T1 테이블을 DB2의 PROSYNC 사용자의 T1 테이블로 동기화하고, column c3의 값이 더 큰 값을 우선하고자 하는 경우 마지막으로 INSERT할 때 DCR 컬럼인 c3에 null이 들어가는 경우 10으로 비교할 경우 다음과 같이 설정한다.


    SKIP OPTION에는 동기화하지 않길 원하는 row들을 특정하기 위한 조건을 설정한다.

    Database
    Supported Column Types

    SKIP OPTION은 다음과 같이 설정한다. SKIP_CONDITION이 True인 Row들은 동기화하지 않는다.

    Source DB의 PROSYNC 사용자의 T1 테이블을 Target DB의 PROSYNC 사용자의 T1 테이블로 동기화하고, column c1의 값이 'example'이 아니면 DML을 skip할 경우 다음과 같이 MAP 파라미터를 설정한다.

    위의 조건에 추가로 Source DB의 PROSYNC 사용자의 T2 테이블을 Target DB의 PROSYNC 사용자의 T2 테이블로 동기화하고, column c2의 값이 'example2'이면 DML을 skip할 경우 다음과 같이 MAP 파라미터를 설정한다.

    AGENT_PORT_[n]

    Agent가 사용할 포트를 지정한다. (필수)

    AGENT_CM_GROUP_[n]

    CM Failover 기능을 사용하는 경우, 해당 Agent가 속한 CM 그룹 이름을 지정한다.

    AGENT_CM_ID_[n]

    CM Failover 기능을 사용하는 경우, Agent가 연결될 CM의 ID를 지정한다. 각 그룹 내에서는 중복되지 않아야 하며, 그룹이 다를 경우 중복 가능하다.

    -h

    도움말 출력

    -c

    사용할 환경설정 파일 지정 (기본값: prs_install_agent.cfg)

    -y

    기존 Agent 설정을 제거하고 새로 생성. prs_instance.map의 중복 항목도 교체됨

    설정 예시

    주의

    AGENT_ID, AGENT_HOST, AGENT_PORT는 반드시 설정해야 하며, 중복되지 않도록 주의해야 한다.

    멀티 노드 환경에서는 IP 기반 설정을 권장한다.

    IP 주소 입력 시 VIP(Virtual IP) 대신 실제 IP 주소를 사용할 것을 권장한다.

    2. Agent 설치

    참고

    prs_install_agent.sh는 독립 실행 스크립트이다. . prs_install_agent.sh처럼 dot-source 방식으로 실행하면 오류 처리 과정의 exit가 현재 사용자의 셸을 종료시킬 수 있으므로 반드시 ./prs_install_agent.sh로 실행한다.

    사용 가능 옵션

    예시

    3. 설치 결과 확인

    주요 파일 설명

    생성된 설정 파일 예제

    prs_instance.map 예시

    prs_agent_agent1.cfg 예시

    4. CM Failover 스크립트 설정

    $PRS_HOME/bin/prs_0.sh 예시

    AGENT_CNT=4
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.17.0.1
    AGENT_PORT_0=7600
    AGENT_CM_GROUP_0=CM1
    AGENT_CM_ID_0=0
    
    AGENT_ID_1=agent2
    AGENT_HOST_1=172.17.0.2
    AGENT_PORT_1=7601
    AGENT_CM_GROUP_1=CM1
    AGENT_CM_ID_1=1
    
    AGENT_ID_2=agent3
    AGENT_HOST_2=172.17.0.3
    AGENT_PORT_2=7602
    AGENT_CM_GROUP_2=CM2
    AGENT_CM_ID_2=0
    
    AGENT_ID_3=agent4
    AGENT_HOST_3=172.17.0.4
    AGENT_PORT_3=7603
    AGENT_CM_GROUP_3=CM2
    AGENT_CM_ID_3=1
    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh [option] [config file]
    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.17.0.1
        AGENT_PORT: 7600
        AGENT_CM_GROUP: CM1
        AGENT_CM_ID: 0
    parameter check for Agent[0] Done 
    parameter check for Agent[1] Started 
        AGENT_ID: agent2
        AGENT_HOST: 172.17.0.2
        AGENT_PORT: 7601
        AGENT_CM_GROUP: CM1
        AGENT_CM_ID: 1
    parameter check for Agent[1] Done 
    parameter check for Agent[2] Started 
        AGENT_ID: agent3
        AGENT_HOST: 172.17.0.3
        AGENT_PORT: 7602
        AGENT_CM_GROUP: CM2
        AGENT_CM_ID: 0
    parameter check for Agent[2] Done 
    parameter check for Agent[3] Started 
        AGENT_ID: agent4
        AGENT_HOST: 172.17.0.4
        AGENT_PORT: 7603
        AGENT_CM_GROUP: CM2
        AGENT_CM_ID: 1
    parameter check for Agent[3] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [4] 
    ********************************************************************************
    * Writing all agents.. cnt: 4
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.17.0.1
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  CM1
    * Writing Agent.. AGENT_CM_ID:     0
    * Writing Agent configuration... 
    File already exists... 
    [/home/prosync/example/config/prs_agent_agent1.cfg]
    Want to Delete ? (Y/N)
    n
    Skip deleting...
    
    * Writing Agent information... 
    Agent information already exist
    Want to Replace ? (Y/N)
    n
    Skipped... 
    
    
    * Writing Agent.. Index:           1
    * Writing Agent.. AGENT_ID:        agent2
    * Writing Agent.. AGENT_HOST:      172.17.0.2
    * Writing Agent.. AGENT_PORT:      7601
    * Writing Agent.. AGENT_CM_GROUP:  CM1
    * Writing Agent.. AGENT_CM_ID:     1
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent2.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           2
    * Writing Agent.. AGENT_ID:        agent3
    * Writing Agent.. AGENT_HOST:      172.17.0.3
    * Writing Agent.. AGENT_PORT:      7602
    * Writing Agent.. AGENT_CM_GROUP:  CM2
    * Writing Agent.. AGENT_CM_ID:     0
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent3.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           3
    * Writing Agent.. AGENT_ID:        agent4
    * Writing Agent.. AGENT_HOST:      172.17.0.4
    * Writing Agent.. AGENT_PORT:      7603
    * Writing Agent.. AGENT_CM_GROUP:  CM2
    * Writing Agent.. AGENT_CM_ID:     1
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent4.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    AGENT_CM_ID detected
    generating prs_0.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent1
    prs_0.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_1.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent2
    prs_1.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_0.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent3
    prs_0.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_1.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent4
    prs_1.sh has created in $PRS_HOME/bin/
    Agent installation Done.
    $ cd $PRS_HOME/config
    $ ls -al
    total 51
    drwxr-xr-x  3 users users 4096 Apr 16 15:42 .
    drwxr-xr-x 15 users users 4096 Apr 14 15:08 ..
    -rw-r--r--  1 users users  367 Feb 27 19:22 prs_agent_agent1.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent2.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent3.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent4.cfg
    -rw-r--r--  1 users users 1272 Apr 16 15:32 prs_instance.map
    drwxr-xr-x  2 users users 4096 Apr 14 15:08 templates
    -rw-r--r--  1 users users    5 Feb 27 13:06 variant
    #--------------------------------------------------------
    # ProSync Instances Map (prs_instance.map)
    #
    # Generated by Dummy Time: 04-16T14:22:21.920319
    #
    
    AGENT=(ID=agent1)(HOST=172.17.0.1)(PORT=7600)(CM_GROUP=CM1)(CM_ID=0)
    
    #--------------------------------------------------------
    # Appended by prs_install_agent.sh at Wed Apr 16 03:32:37 PM KST 2025
    #
    
    AGENT=(ID=agent2)(HOST=172.17.0.2)(PORT=7601)(CM_GROUP=CM1)(CM_ID=1)
    
    #--------------------------------------------------------
    # Appended by prs_install_agent.sh at Wed Apr 16 03:32:37 PM KST 2025
    #
    
    AGENT=(ID=agent3)(HOST=172.17.0.3)(PORT=7602)(CM_GROUP=CM2)(CM_ID=0)
    
    #--------------------------------------------------------
    # Appended by prs_install_agent.sh at Wed Apr 16 03:32:37 PM KST 2025
    #
    
    AGENT=(ID=agent4)(HOST=172.17.0.4)(PORT=7603)(CM_GROUP=CM2)(CM_ID=1)
                                                                              
    ################################################################################
    # ProSync Agent Configurations (Template)
    ################################################################################
    LISTENER_PORT=7600
    LOG_LEVEL=3
    LOG_DIR=/home/prosync/example/var/agent/agent1/log
    LOG_BACKUP_DIR=/home/prosync/example/var/agent/agent1/log/backup
    #!/bin/sh
    
    export TB_HOME=
    export PRS_HOME=/home/prosync/example
    AGENT_ID=agent1
    TIMEOUT_CNT=7
    source $PRS_HOME/bin/prs_cm.sh
    export logdir=$PRS_HOME/var
    
    echo "------------------------------------------------------------" >> $logdir/cmagent.log
    echo "`date +%Y/%m/%d\ %H:%M:%S` cm agent Start (Agent Command $1)" >> $logdir/cmagent.log
    case $1 in
    START)
        echo "start $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        start $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    PROBE)
        echo "probe $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        probe $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    DOWN)
        echo "stop $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        stop $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    KILL)
        echo "stop $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        stop $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    NOTI)
        rc=0
        ;;
    COMMIT)
        echo "send $TIMEOUT_CNT $AGENT_ID ${@:2}" >> $logdir/cmagent.log
        send $TIMEOUT_CNT $AGENT_ID ${@:2}
        rc=$?
        ;;
    
    *)
        ;;
    esac
    echo "result :  $rc" >> $logdir/cmagent.log
    echo "`date +%Y/%m/%d\ %H:%M:%S` cm agent End  (Agent Command $1)" >> $logdir/cmagent.log
    
    
    exit $rc
    

    동기화할 Source DB 테이블의 사용자 이름을 설정한다.

    SOURCE_TABLE

    동기화할 Source DB 테이블의 테이블 이름을 설정한다.

    SOURCE_COLUMNS

    동기화할 Source DB 테이블의 컬럼들을 설정한다. (Column1, Column2, Column3)과 같은 방식으로 설정한다.

    COLUMN FILTERING OPTION

    동기화하지 않을 Source DB 테이블의 컬럼들을 설정한다.

    TARGET_DATABASE

    동기화시킬 Target DB의 데이터베이스 이름을 설정한다.

    TARGET_USER

    동기화시킬 Target DB 테이블의 사용자 이름을 설정한다.

    TARGET_TABLE

    동기화시킬 Target DB 테이블의 테이블 이름을 설정한다. 인자에 대한 자세한 내용은 각 절의 설명을 참고한다.

    RESOLVE OPTION

    충돌(Conflict) 발생 시 적용할 RESOLVE 동작(DCR Rule)을 설정한다. RESOLVE BY 구문으로 SOURCE, TARGET, MAX(컬럼), MIN(컬럼) 중 하나를 지정한다. 인자에 대한 자세한 내용은 각 절의 설명을 참고한다.

    SKIP OPTION

    동기화할 때 동기화를 하지 않을 row의 조건을 설정한다.

    TARGET_COLUMNS

    동기화시킬 Target DB 테이블의 컬럼들을 설정한다. SOURCE_COLUMNS와 순서대로 매핑되고 컬럼 개수는 일치해야 한다. (Column1, Column2, Column3)과 같은 방식으로 설정한다.

    MAP=(TABLE PROSYNC1.T1, PROSYNC2.T2)
    MAP=(TABLE PROSYNC1.T1(C1, C2), PROSYNC2.T2)
    MAP=(TABLE PROSYNC1.T1(C1, C2), PROSYNC2.T2(D1, D2))
    MAP=(TABLE [SOURCE_USER].[SOURCE_TABLE]... )
    MAP=(OBJECT [SOURCE_USER].[OBJECT_NAME], [TARGET_USER].[OBJECT_NAME])
    MAP=(EXCLUDE [SOURCE_USER].[SOURCE_TABLE]...)
    MAP=(TABLE DEFAULT EXCLUDE PROSYNC.TMP_TBL)
    MAP=(... EXCEPT FOR ([COLUMN_NAME], ..., [COLUMN_NAME])...)
    MAP=(TABLE PROSYNC1.T1 EXCEPT FOR (C1), PROSYNC2.T2)
    MAP=(... RESOLVE BY [RESOLVE_RULE] ...)

    SOURCE

    Source 테이블의 Row를 우선으로 한다.

    TARGET

    Target 테이블의 Row를 우선으로 한다.

    MAX(COLUMN_NAME)

    해당 컬럼의 값이 더 큰 Row를 우선으로 한다.

    반드시 DEFAULT OPTION을 설정해야 한다.

    MIN(COLUMN_NAME)

    해당 컬럼의 값이 더 작은 Row를 우선으로 한다.

    반드시 DEFAULT OPTION을 설정해야 한다.

    MAP=(... RESOLVE BY MAX(COLUMN_NAME) DEFAULT (COLUMN_VALUE) ...)
    MAP=(TABLE PROSYNC.T1, PROSYNC.T1 RESOLVE BY MAX(c3) DEFAULT (10))

    TIBERO

    CHAR, VARCHAR, NUMBER, TIME, DATE, TIMESTAMP

    ORACLE

    CHAR, VARCHAR, NUMBER

    POSTGRESQL

    CHAR, VARCHAR, NUMBER

    CHAR, VARCHAR

    EQUAL (=), NOT_EQUAL (!=)

    NUMBER, TIME, DATE, TIMESTAMP

    EQUAL (=), NOT_EQUAL (!=), INEQUALITY (<, <=, >, >=)

    MAP=(... SKIP=(SKIP_CONDITION))
    MAP=(TABLE PROSYNC.T1, PROSYNC.T1 SKIP=(c1!="example"))
    MAP=(TABLE PROSYNC.T1, PROSYNC.T1 SKIP=(c1!="example")
        TABLE PROSYNC.T2, PROSYNC.T2 SKIP=(c2="example2"))

    주의

    다음 키워드는 MAP Rule 의 예약어이므로 table 등 대상을 명시하는 용도로 사용 불가하다.

    "ALL" "BY" "DEFAULT" "EXCEPT FOR" "EXCLUDE" "FILTER" "INCLUDE" "MAX" "MIN" "RESOLVE" "SOURCE" "SKIP" "SYNC" "TABLE" "TARGET" "TYPE" "OBJECT" "INSERT" "DELETE" "UPDATE"

    동기화 대상 반영 기능 사용

    서로 다른 오너 / 다른 이름을 가진 테이블 동기화

    테이블의 특정 컬럼들만 동기화

    테이블간 컬럼 이름을 다르게 동기화

    SYNC OPTION

    TABLE

    OBJECT

    주의

    DB 버전, 비표준 쿼리 등으로 인해 DDL의 OBJECT의 인식이 불가능할 수 있다. 따라서 MAP 파라미터를 사용해서 DDL 매핑을 할 때 TABLE과 OBJECT에 schema를 명시하는 것을 권장한다.

    또한, 동기화 테이블 T1에 대해 DROP TABLE T1 실행 후 CREATE TABLE T1를 실행할 때 T1은 OBJECT로써 매핑될 것이고, 생성될 컬럼은 동기화 테이블 컬럼 MAP 파라미터에 영향을 받지 않는다.

    EXCLUDE

    예제

    COLUMN FILTERING OPTION

    예제

    RESOLVE OPTION (Data Conflict Rule, DCR)

    참고

    보다 상세한 사항은 Flow Control 을 참고한다.

    RESOLVE_RULE

    예제

    참고

    RESOLVE OPTION이 정상 작동하기 위해서는 설정할 Source와 Target 테이블에 primary key가 필요하다.

    MIN, MAX 룰을 사용하는 경우 비교 대상 컬럼에 NULL이 들어가는 경우에 대비 사용될 DEFAULT OPTION을 반드시 사용해야 한다.

    SKIP OPTION

    지원 컬럼 타입

    지원 비교 조건

    예제

    참고

    SKIP RULE를 사용할 때 UPDATE의 경우에서는 SET 절에 있는 값을 기준으로 skip을 할 것인지, 아니면 WHERE 절의 값을 기준으로 skip을 할 것인지 설정할 수 있다.

    Apply Process Parameter 중에서 MAP_SKIP_UPD_WHERE의 값이 N 일 때 먼저 SET 절에 기준 컬럼이 있는지 확인 후 있으면 SET 절의 값을 기반으로, 없으면 WHERE 절에 있는 기준 컬럼의 값을 기반으로 skip한다. 해당 파라미터가 Y인 경우에는 무조건 WHERE에 있는 기준 컬럼의 값을 기반으로 Skip한다.

    SKIP OPTION은 단방향 동기화에서만 지원한다. 양방향의 경우 정합성 문제로 지원하지 않는다.

    참고

    MAP=( ... ) 안에는 여러 종류의 MAP RULE을 함께 작성할 수 있다.

    한 블록 안에서 서로 다른 역할의 규칙(테이블 매핑, 동기화 제외, DCR, SKIP등)을 조합하여 사용할 수 있다.

    예)

    MAP=(TABLE PROSYNC.T1, PROSYNC.T2 RESOLVE BY SOURCE)

    단, 같은 소스 테이블에 대해 TABLE 규칙을 여러 줄로 나누어 적은 경우에는 규칙이 합쳐지지 않고, 매칭되는 규칙 중 마지막 줄만 적용된다.

    잘못된 예)

    MAP=(
      TABLE TIBERO.TEST_DUMMY, TIBERO.TEST_DUMMY SKIP=(C3 = "ch")
      TABLE TIBERO.TEST_DUMMY, TIBERO.TEST_DUMMY SKIP=(C3 = "ch1")
    )

    위와 같이 작성 시 SKIP=(C3 = "ch")가 있는 rule은 무시되고 마지막 줄인 SKIP=(C3 = "ch1") rule만 적용된다.

    올바른 예)

    DDL Rule

    ProSync 사용자는 적용 프로세스의 설정 파일에서 DDL 파라미터를 설정할 수 있다. DDL 파라미터는 동기화할 DDL에 대한 설정이다.

    DDL 파라미터는 하나 이상의 DDL Rule 문장으로 구성된다. DDL Rule에는 DDL 동기화를 포함/배제할 대상과 DDL 종류를 명시할 수 있다.

    사용법

    DDL=([SET] [RANGE], TYPE=('[DDL OPERATION] [DDL OBJECT]', ...))
    항목
    설명

    [SET]

    INCLUDE 또는 EXCLUDE를 명시할 수 있다.

    • INCLUDE: 기술된 규칙에 대해 동기화한다.

    • EXCLUDE: 기술된 규칙에 대해 동기화하지 않는다. 어떠한 INCLUDE보다 EXCLUDE를 우선시한다.

    [RANGE]

    ALL 또는 DEFAULT 중 하나를 명시하거나, DB의 오브젝트 이름을 직접 명시할 수 있다.

    • ALL: 모든 스키마, 테이블에 대해 적용된다.

    • DEFAULT: 모든 동기화 대상 테이블에 대해 적용된다.

    • 오브젝트 이름을 직접 명시: 대상에 대해 적용된다.

    TYPE

    다음은 설정 가능한 [DDL OPERATION]과 [DDL OBJECT]의 조합이다. Source DB가 Tibero인 경우와 Oracle인 경우 동일하게 지원한다.

    • O : 지원

    • △ : 특정 조건에서만 지원 (비고 참조)

    • X : 미지원

    DDL OBJECT
    CREATE
    ALTER
    DROP
    비고

    위 조합 외에 COMMENT ON과 TRUNCATE TABLE을 지원한다.

    다음 DDL은 동기화를 지원하지 않으며, 추출 단계에서 skip 처리된다.

    • GRANT, REVOKE

    • RENAME (ALTER ... RENAME 구문은 ALTER로 동기화 설정하여 사용할 수 있다.)

    • ALTER DATABASE LINK, ALTER PUBLIC DATABASE LINK

    다음은 모든 스키마에 대해서 모든 종류의 DDL 동기화를 하지만, 스키마 EXCLUDED_USR의 모든 테이블에 대한 DDL 동기화는 배제하는 예제이다.

    다음은 동기화 대상 테이블에 대해 TABLE을 대상으로 하는 DDL을 동기화하고, INCLUDED_USR의 모든 오브젝트 이름에 대해 INDEX를 대상으로 하는 DDL을 동기화한다. 반면, 오브젝트 이름이 EXCLUDED_USR.IDX1일 경우 INDEX를 대상으로 하는 DDL을 동기화하지 않는다.

    다음은 SRCUSR의 모든 테이블에 대해 TYPE에 해당되는 DDL을 동기화하지만, SRCUSR.T1에 대해서는 DROP TABLE과 CREATE TABLE에 해당되는 DDL을 동기화하지 않는다.

    • DDL 문장 크기 동기화할 DDL 문장의 각 요소는 128글자를 넘을 수 없다.

    • 설정 전 확인 DDL 파라미터의 대상과, 동기화할 DDL 종류가 정확한지 Wildcard를 고려하여 확인하고 설정한다. 다른 DB나 대상에게 먼저 적용해보고 설정하는 것을 권장한다.

    • CREATE TABLE 이후 동기화 CREATE TABLE에 대한 DDL 동기화 후 생성된 테이블을 DML 동기화 하려면 동기화 대상에 추가해야 한다. Admin 명령으로 수동 등록하거나 AUTO_SYNC_ON_CREATE=Y로 자동 등록할 수 있다. 반면 DDL은 Rule에 의해 생성된 직후부터 동기화 될 수 있으므로 주의한다.

    • implicit DDL CREATE TABLE에 대한 DDL 동기화 실행 중 컬럼의 PRIMARY KEY로 인해 INDEX 생성이 되는 것처럼 명시되지 않은 DDL을 implicit DDL이라 하며, 동기화 설정할 때 이를 주의한다.

    O

    O

    VIEW

    O

    O

    O

    MATERIALIZED VIEW

    O

    △

    O

    ALTER MATERIALIZED VIEW는 추출·전달되며, Target DB가 Tibero인 경우에만 반영(apply) 단계에서 skip된다.

    MATERIALIZED VIEW LOG

    O

    O

    O

    SEQUENCE

    O

    O

    O

    SYNONYM

    O

    X

    O

    PUBLIC SYNONYM도 SYNONYM과 동일한 종류로 처리된다.

    PROCEDURE

    O

    O

    O

    FUNCTION

    O

    O

    O

    PACKAGE

    O

    O

    O

    PACKAGE BODY

    O

    O

    O

    TRIGGER

    O

    O

    O

    TYPE

    O

    O

    O

    TYPE BODY

    O

    O

    O

    USER

    O

    O

    O

    ROLE

    △

    △

    △

    스키마 비종속 객체로 INCLUDE ALL에서만 동기화된다. CREATE / ALTER는 비밀번호를 명시하지 않은 경우에만 지원한다.

    TABLESPACE

    △

    △

    △

    스키마 비종속 객체로 INCLUDE ALL에서만 동기화된다. Target DB가 Oracle CDB-PDB 구성인 경우 아래 유의사항의 제약을 함께 확인한다.

    DATABASE LINK

    △

    X

    △

    스키마 비종속 객체로 INCLUDE ALL에서만 동기화된다. PUBLIC DATABASE LINK도 DATABASE LINK와 동일한 종류로 처리된다.

    DIRECTORY

    △

    X

    △

    스키마 비종속 객체로 INCLUDE ALL에서만 동기화된다.

    LIBRARY

    △

    X

    △

    스키마 비종속 객체로 INCLUDE ALL에서만 동기화된다.

  • RENAME 지원 DDL 중 RENAME은 지원하지 않는다. ALTER ... RENAME을 이용한 DDL 구문은 ALTER를 동기화 설정하여 사용할 수 있다.

  • ORACLE LOGMNR Source DB가 Oracle, logmnr 를 사용할 때 동기화 대상에 대한 DDL 동기화만 지원한다.

  • INDEX / CONSTRAINTS 관련 주의사항 INDEX / CONSTRAINTS의 경우 SRC/TAR DB에서 이름이 다를 경우 동기화가 불가능하다.

  • DDL 설정 조합 복수 개의 DDL 룰에 대한 설정 시 아래와 같은 형태로 명시한다.

  • OBJECT 동기화 DDL 동기화의 경우 INCLUDE DEFAULT 사용 시 오브젝트에 대한 DDL 동기화는 수행되지 않으며, 오브젝트에 대한 DDL 동기화 수행을 원하는 경우 직접 명시해야한다

  • 스키마 미명시 DDL 구문의 동기화 제한 DDL 구문에서 대상 객체의 스키마(Schema) 가 명시되지 않은 경우, 해당 구문은 동기화가 수행되지 않는다. 따라서 스키마를 명시한 형태의 DDL 구문으로 작성해야만 동기화가 가능하다.

    예시

  • SYS 스키마 DDL 동기화 제약사항 스키마가 SYS인 경우, 해당 스키마를 대상으로 수행되는 모든 DDL은 동기화 시 Skip 처리된다.

  • 스키마 비종속 객체(Non-Schema Object) 동기화 제약사항

    TABLESPACE, DIRECTORY, DATABASE LINK, ROLE, LIBRARY 객체는 특정 스키마에 종속되지 않는 객체로, DDL 동기화 시 INCLUDE ALL 옵션이 설정된 경우에만 동기화를 지원한다. INCLUDE DEFAULT인 경우 동기화를 지원하지 않는다.

  • Password 포함 DDL 동기화 제약사항

    CREATE ROLE, ALTER ROLE, CREATE [PUBLIC] DATABASE LINK 등 비밀번호 정보가 포함될 수 있는 DDL 문장은 비밀번호를 명시하지 않는 경우에만 DDL 동기화를 지원한다.

  • Target Oracle CDB-PDB 환경의 TABLESPACE 동기화 제약사항

    ProSync는 DDL 문장을 Target DB 세션에서 그대로 수행하며, DATAFILE 경로를 Target DB 기준으로 변환하지 않는다. Target DB가 Oracle CDB-PDB 구성인 경우 TABLESPACE 관련 DDL은 다음 제약을 갖는다.

    • TABLESPACE는 Target 접속 정보(TAR_DB_NAME)가 가리키는 컨테이너에 생성된다. 접속 서비스가 PDB가 아닌 CDB(CDB$ROOT)를 가리키면 TABLESPACE도 CDB에 생성되므로, 동기화 대상 PDB의 서비스로 접속하도록 설정해야 한다.

    • DATAFILE을 파일명만(상대 경로) 명시한 DDL은 PDB 전용 디렉터리가 아니라 CDB와 모든 PDB가 공유하는 디렉터리($ORACLE_HOME/dbs)에 데이터 파일을 생성한다. Target에 DB_CREATE_FILE_DEST가 설정되어 있는 경우에만 해당 위치에 PDB별로 생성된다. 공유 디렉터리에 생성되므로 다른 컨테이너가 같은 이름의 데이터 파일을 이미 사용 중이면 ORA-01537, 이전에 생성된 파일이 남아 있으면 ORA-01119 / ORA-27038로 CREATE TABLESPACE가 실패한다. Source DB 기준의 절대 경로가 명시된 경우에도 Target에 동일한 경로가 없으면 실패한다.

    • CREATE TABLESPACE가 실패한 뒤 해당 TABLESPACE를 참조하는 CREATE TABLE이 동기화되면 ORA-00959: tablespace ... does not exist로 실패한다. 반영에 실패한 DDL은 기본 설정(DISCARD_DDL_YN=N)에서 계속 재시도되므로 이후 동기화가 진행되지 않는다. DISCARD_DDL_YN=Y로 설정하면 실패한 TABLESPACE DDL은 discard되지만, CREATE TABLE은 discard 대상이 아니므로 동일하게 재시도된다.

    따라서 Target이 CDB-PDB 구성인 환경에서는 Target PDB에 TABLESPACE를 미리 생성해 두고 DDL Rule에서 TABLESPACE 관련 DDL을 동기화 대상에서 제외하거나, Target에 DB_CREATE_FILE_DEST를 설정하여 데이터 파일이 PDB별 경로에 생성되도록 구성할 것을 권장한다.

  • TYPE은 하나 이상의 DDL OPERATION과 DDL OBJECT 쌍으로 구성된다. 지정되어 있지 않는 경우, Wildcard로 처리한다.

    [DDL OPERATION]

    Rule에 적용할 DDL 종류를 명시한다.

    [DDL OBJECT]

    Rule에 적용할 DDL 종류에 대한 대상을 명시한다.

    TABLE

    O

    O

    O

    TRUNCATE TABLE도 지원한다.

    INDEX

    참고

    [RANGE]의 오브젝트 이름이나 [DDL OPERATION], [DDL OBJECT]에 %를 포함시켜 wildcard로 처리할 수 있다.

    Source DB가 Oracle인 경우 [DDL OPERATION]과 [DDL OBJECT]에 '%'를 사용할 수 없다.

    지원 DDL 종류

    참고

    TYPE에는 위 표의 이름을 그대로 명시해야 한다. 예를 들어 Materialized View는 TYPE=('CREATE MATERIALIZED VIEW')와 같이 명시하며, MVIEW와 같은 약어는 인식되지 않는다.

    지원하지 않는 DDL

    예제

    DDL 동기화 설정 시 유의사항

    주의 DDL=(INCLUDE ALL, TYPE=('%')) 설정 시, Source DB의 모든 스키마에서 수행되는 모든 타입의 DDL이 동기화된다. 동기화 대상 여부와 관계없이 모든 DDL이 적용되므로 사용 시 주의가 필요하다. 추가적으로 INCLUDE ALL로 설정하는 경우 설치될 Instance 는 단일 Instance 로 구성되어야 한다.

    O

    MAP=(
      TABLE TIBERO.TEST_DUMMY, TIBERO.TEST_DUMMY SKIP=(C3 = "ch", C3 = "ch1")
    )
    DDL=([SET] [RANGE], TYPE=('[DDL OPERATION] [DDL OBJECT]', ...)
                    [SET] [RANGE], TYPE=('[DDL OPERATION] [DDL OBJECT]', ...) ....)
    CREATE TABLE TEST_TABLE2 (
        c1 NUMBER,
        CONSTRAINT fk_test FOREIGN KEY (c1) REFERENCES [스키마명].TEST_TABLE1 (c1)
    );
    DDL=(
        INCLUDE ALL, TYPE=('%')
        EXCLUDE EXCLUDED_USR.%, TYPE=('%')
    )
    DDL=(
        INCLUDE DEFAULT, TYPE=('% TABLE')
        INCLUDE INCLUDED_USR.%, TYPE=('% INDEX')
        EXCLUDE EXCLUDED_USR.IDX1, TYPE=('% INDEX')
    )
    DDL=(
        INCLUDE SRCUSR.%, TYPE=('DROP TABLE', 'ALTER TABLE', 'TRUNCATE TABLE')
        EXCLUDE SRCUSR.T1, TYPE=('DROP TABLE', 'CREATE TABLE')
    )

    LLOB Parameters

    CONN_MAX

    CONN_MAX specifies the max number of connections between processes.

    Parameter Format

    Property
    Description

    Parameter type

    Integer

    Default Value

    128

    Class

    Optional, Static

    Range

    DSN_DIR specifies the directory where the dsn file located. It must be specified as an absolute path.

    Property
    Description

    DSN_FILE specifies name of dsn file.

    Property
    Description

    ENABLE_TSC_STANDBY enables TSC standby source mode. In this mode, ProSync reads from SRC_DB_NAME and sends source-side writes to SRC_PRIMARY_DB_NAME.

    Property
    Description

    LLOB_FLASHBACK_ERROR specifies how to handle an error during a flashback query on a LONG/LOB column. If set to 'SKIP', the column is not synchronized; if set to 'CURRENT', the query is re-executed for the latest value.

    Property
    Description

    Number of llob thread cnt when starting prosync.

    Property
    Description

    LOG_BACKUP_DIR specifies the directory where the ProSync log files are backed up. It must be specified as an absolute path.

    Property
    Description

    LOG_BACKUP_SIZE specifies the maximum size of all backup files in the process. If this limit is exceeded, the oldest log files in the directory are deleted.

    Property
    Description

    LOG_DIR specifies the directory where the ProSync log files are stored. It must be specified as an absolute path.

    Property
    Description

    LOG_FILE_SIZE specifies the maximum log file size. If a log file exceeds this limit, it is moved to the backup directory and a new log file is created.

    Property
    Description

    LOG_LEVEL specifies the log level of the process. A higher log-level produces more detailed logs.

    Property
    Description

    OCI_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. for Oracle, enter a path to the libclntsh.so file.

    Property
    Description

    ODBC_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. Set a path to the proper library file.

    Property
    Description

    connection timeout from process to agent. if a process cannot connect to agent while this timeout, kill itself

    Property
    Description

    PRS_PWD specifies the database user password. If the password is encrypted, append the string '#encrypted'.

    Property
    Description

    PRS_USER specifies the database user.

    Property
    Description

    SRC_DB_IP specifies the database IP Address.

    Property
    Description

    SRC_DB_NAME specifies the name(Alias) of the source database. For TIBERO, UPDB, or K-DB, use the value specified in the dsn file. For ORACLE, use the value specified in the tnsname file.

    Property
    Description

    SRC_DB_PORT specifies the database port.

    Property
    Description

    SRC_DB_TYPE specifies the type of the source database to extract data from. Options are TIBERO, UPDB, KDB, or ORACLE.

    Property
    Description

    SRC_PRIMARY_DB_NAME specifies the writable primary database alias used when ENABLE_TSC_STANDBY is enabled.

    Property
    Description

    USE_LOGMNR specifies whether to use oracle logminer or to use oracle log reader, when analyzing redo logs.

    Property
    Description

    TSC Standby Synchronization

    Tibero Standby Cluster(TSC) 환경에서 Standby DB를 Source로 하는 동기화 구성과 운영 방법을 안내한다.

    ProSync는 Tibero Standby Cluster(이하 TSC) 환경에서 Standby DB를 Source로 하는 동기화를 지원한다.

    TSC 환경에서 Extract 프로세스와 Llob 프로세스는 Redo Log 읽기와 Flashback 조회를 Standby DB에서 수행하고, Source DB에 쓰기가 필요한 메타데이터 작업은 쓰기 가능한 Primary DB로 라우팅한다. Failover로 Standby DB가 Primary로 승격되면 쓰기 라우팅을 승격된 DB로 자동 전환한다.

    Standby DB에서 추출을 수행하므로 운영 중인 Primary DB의 부하를 줄일 수 있고, Source DB의 장애 전환 이후에도 재설치 없이 동기화를 이어갈 수 있다.

    지원 범위

    구분
    지원 대상

    Source DB

    Tibero (Single TSC, TAC-TSC — Primary와 Standby의 노드 수가 동일한 구성)

    대상 프로세스

    TSC Standby 동기화에서 각 접속 별칭(Alias)의 역할은 다음과 같다.

    파라미터
    역할

    정상 TSC 상태와 Failover 이후의 작업별 라우팅은 다음과 같다.

    작업
    정상 TSC 상태
    Failover 이후

    TAC-TSC 환경에서는 Primary TAC의 Redo Thread 수만큼 Extract 프로세스를 기동한다. 이때 별칭은 다음과 같이 배치한다.

    • 모든 Extract 프로세스와 Llob 프로세스의 SRC_DB_NAME은 같은 Standby 별칭을 사용한다.

    • Extract 프로세스별 SRC_LOCAL_SID는 해당 Redo Thread의 로그를 기록하는 Standby 인스턴스로 직접 접속하는 별칭으로 설정한다. Extract 프로세스는 이 접속에서 인스턴스 번호를 조회하여 활성 Standby Log를 읽을 접속 지점을 결정하므로, 이 별칭이 다른 인스턴스를 가리키면 활성 Standby Log의 변경분을 읽지 못한다.

    • Extract 프로세스별 SRC_PRIMARY_LOCAL_SID는 해당 Redo Thread를 소유한 Primary 인스턴스로 직접 접속하는 별칭으로 설정한다.

    TSC 환경을 Source로 사용하는 경우 ProSync용 TIP 파일 설정은 Primary DB와 Standby DB 모두(TAC-TSC는 모든 노드)에 적용되어 있어야 한다. Failover 이후에는 승격된 Standby DB가 Redo를 생성하는 추출 소스가 되기 때문이다. 설정 항목은 페이지를 참고한다.

    Standby DB는 read-only 모드로 open되어 있어야 한다. read-only 모드가 아니면 접속이 거부된다.

    RECOVERY 모드로 운영 중인 Standby DB는 다음 명령으로 복구를 중단하지 않고 read-only 세션을 허용하도록 전환할 수 있다.

    Standby 별칭으로 접속하여 역할을 확인한다. 정상 TSC 상태의 기대값은 STANDBY이다.

    Primary 별칭으로 접속하여 역할이 PRIMARY인지 함께 확인한다.

    ProSync Source 계정은 TSC 역할과 Standby 복구 상태를 조회할 수 있어야 한다.

    TAC-TSC 환경에서는 GV$INSTANCE, GV$PARAMETERS 조회 권한도 필요하다. 두 뷰는 활성 Standby Log를 읽을 인스턴스별 접속 지점을 결정하는 데 사용한다. 권한이 없으면 기동 시 역할 검증, Failover 감지, 복구 상태 대기 등이 실패하거나 재시도 상태에 머무를 수 있다.

    PRS_OBJ_LIST, PRS_TXINFO 등 ProSync가 Source DB에 생성하는 메타데이터 객체는 쓰기 가능한 Primary DB에 생성되어 있어야 한다. 설치 구성에서 USE_TSC=Y를 설정하면 설치 과정의 Source DB 측 객체 생성 작업이 Primary에서 수행된다.

    ENABLE_TSC_STANDBY=[Y|N]

    파라미터
    설명

    Single TSC 구성의 예시는 다음과 같다.

    TAC-TSC(2 Thread) 구성에서는 Extract 프로세스별로 인스턴스 직결 별칭을 다르게 설정한다.

    SRC_PRIMARY_LOCAL_SID는 Extract 전용 파라미터이므로 Llob 설정에는 넣지 않는다.

    설치 config 파일에 USE_TSC=Y를 설정하면 설치 과정에서 TSC 구성이 자동으로 반영된다.

    USE_TSC=Y로 설치하면 다음이 수행된다.

    • Primary 별칭 접속 확인 및 별칭 중복 검증

    • Source DB 측 설치 DDL/DML의 Primary 수행 (Archive Log 정보 조회는 Standby에서 수행)

    • 생성되는 Extract/Llob config에 TSC 파라미터 자동 기입

    설치 후 생성된 process config에 다음 값이 기입되어 있는지 확인한다.

    Standby DB에서 추출할 때 Extract 프로세스는 전체 Redo Thread의 MIN(RECOVERED_TSN)(안전 추출 TSN)까지만 LCR을 전송한다. Failover 승격 시 복구로 재적용되지 않을 수 있는 Redo가 Target DB에 먼저 반영되는 것을 막기 위한 경계이다.

    LCR의 TSN이 안전 추출 TSN을 넘으면 Standby 복구가 따라올 때까지 대기한 뒤 전송하며, 대기는 _TCP_CONNECT_INTERVAL 주기로 재시도한다.

    PRS_TXINFO의 조회/저장, 동기화 테이블 추가/삭제 시의 Source DB 측 작업(PRS_OBJ_LIST 등록, Supplemental Log 변경 등), Dummy Transaction, Logfile Switch는 쓰기 가능한 라우팅 경로에서 수행된다. 정상 TSC 상태에서는 Primary 별칭에서 수행되고, Failover 이후에는 승격된 Standby 별칭에서 수행된다.

    조회와 저장은 항상 같은 DB 접속(쓰기 라우팅이 가리키는 DB)을 사용한다. 정상 TSC 상태에서는 조회도 Primary 별칭에서 수행하며 Standby에서 조회하지 않는다. 이는 Standby 복구 지연으로 인해 Primary에 저장한 메타데이터를 Standby에서 조회하지 못하는 불일치를 막기 위한 동작이다.

    Llob 프로세스는 Standby DB에서 Flashback 조회를 수행한다. Standby 복구가 Flashback 조회 시점(AS OF SCN)보다 늦으면 잘못된 값을 읽을 수 있으므로, 조회 전에 전체 Redo Thread의 MIN(RECOVERED_TSN)이 조회 시점 이상이 될 때까지 대기한다.

    Failover 이후 Source 별칭이 이미 PRIMARY인 경우에는 대기를 생략한다.

    SRC_DB_NAME의 역할이 STANDBY, SRC_PRIMARY_DB_NAME의 역할이 PRIMARY인 상태이다. 쓰기 라우팅은 Primary 별칭을 가리킨다.

    SRC_DB_NAME이 여전히 STANDBY인데 Primary 역할 조회가 실패하면 ProSync는 Standby에 쓰기 작업을 보내지 않는다. 쓰기 라우팅은 Primary 방향을 유지한 채 재접속을 재시도한다. 이는 Standby에 메타데이터 쓰기를 보내지 않기 위한 안전 동작이다.

    쓰기 작업 직전, 로그 대기 중, 안전 추출 TSN 대기 중에 SRC_DB_NAME의 역할이 PRIMARY로 확인되면 Failover 승격으로 판단한다. 이후 쓰기 라우팅과 읽기 라우팅이 모두 승격된 SRC_DB_NAME으로 통합되고, 기존 DB 접속은 새 라우팅 기준으로 재연결된다.

    Extract 프로세스는 승격을 감지하면 읽고 있던 로그를 마지막 안전 지점부터 다시 열고 트랜잭션 추적 상태를 초기화하여, 승격 이전 로그 기준의 상태가 이월되어 변경분이 유실되는 것을 방지한다.

    한 번 승격 상태로 전환되면 이전 Primary가 다시 PRIMARY로 돌아와도 ProSync는 실행 중 자동으로 라우팅을 되돌리지 않는다(자동 Switchback 미지원). 이전 Primary로 복귀하려면 TSC 구성 상태와 ProSync 설정을 확인한 뒤 명시적으로 재기동해야 한다.

    • TSC Standby 동기화는 Tibero Source 전용이다.

    • TAC-TSC는 Primary와 Standby의 노드 수가 동일해야 한다.

    • Standby DB는 read-only 모드로 open되어 있어야 한다.

    • Failover 이후 이전 Primary로의 자동 Switchback은 지원하지 않는다.

    • 복구 상태 대기(안전 추출, Llob Flashback)는 별도 timeout 없이

    운영 중 다음 로그 키워드로 TSC 동작 상태를 확인할 수 있다.

    • SRC_DB_TYPE=TIBERO인지 확인한다.

    • ENABLE_TSC_STANDBY=Y일 때 SRC_PRIMARY_DB_NAME이 설정되어 있는지 확인한다.

    • Standby DB가 read-only 모드로 open되어 있는지 확인한다.

    waiting for TSC safe extraction TSN 또는 waiting for TSC standby recovery 로그가 지속되면 Standby 복구가 지연되고 있는 것이다.

    • Standby에서 SELECT MIN(RECOVERED_TSN) FROM V$STANDBY 값이 전진하는지 확인한다.

    • 특정 Redo Thread의 복구만 지연되고 있는지 확인한다. 전체 Thread의 최솟값 기준으로 대기하므로 한 Thread만 늦어도 대기한다.

    • Redo 전송 또는 Standby 복구 지연 여부를 확인한다.

    • SRC_DB_NAME의 역할이 아직 STANDBY인지 확인한다. Standby가 승격되지 않았다면 쓰기 작업을 보내지 않는 것이 정상 동작이다.

    • Failover가 완료되어 SRC_DB_NAME의 역할이 PRIMARY가 되었는지 확인한다.

    특정 Extract 프로세스의 변경분만 Target DB에 반영되지 않으면 활성 Standby Log를 잘못된 접속 지점으로 읽고 있을 수 있다.

    • 해당 Extract 프로세스의 SRC_LOCAL_SID가 그 Redo Thread의 로그를 기록하는 Standby 인스턴스 직결 별칭인지 확인한다.

    32 - 1024

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "CURRENT"

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    1

    Class

    Optional, Static

    Range

    1 - 4

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Integer

    Default Value

    3

    Class

    Mandatory, Dynamic

    Range

    1 - 5

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    180

    Class

    Optional, Static

    Range

    0 - 86400

    Parameter type

    String

    Default Value

    "#encrypted"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    "localhost"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    "7600"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "TIBERO"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    DSN_DIR

    Parameter Format

    DSN_FILE

    Parameter Format

    ENABLE_TSC_STANDBY

    Parameter Format

    LLOB_FLASHBACK_ERROR

    Parameter Format

    LLOB_THREAD_CNT

    Parameter Format

    LOG_BACKUP_DIR

    Parameter Format

    LOG_BACKUP_SIZE

    Parameter Format

    LOG_DIR

    Parameter Format

    LOG_FILE_SIZE

    Parameter Format

    LOG_LEVEL

    Parameter Format

    OCI_DRIVER

    Parameter Format

    ODBC_DRIVER

    Parameter Format

    PRS_PROC_AGENT_CONNECTION_TIMEOUT

    Parameter Format

    PRS_PWD

    Parameter Format

    PRS_USER

    Parameter Format

    SRC_DB_IP

    Parameter Format

    SRC_DB_NAME

    Parameter Format

    SRC_DB_PORT

    Parameter Format

    SRC_DB_TYPE

    Parameter Format

    SRC_PRIMARY_DB_NAME

    Parameter Format

    USE_LOGMNR

    Parameter Format

    SRC_PRIMARY_DB_NAME

    SRC_DB_NAME

    Supplemental Log 변경

    SRC_PRIMARY_DB_NAME

    SRC_DB_NAME

    Dummy Transaction

    SRC_PRIMARY_LOCAL_SID

    SRC_LOCAL_SID

    Logfile Switch

    SRC_PRIMARY_LOCAL_SID

    SRC_LOCAL_SID

    _TCP_CONNECT_INTERVAL
    주기로 계속 재시도한다.
    SRC_DB_NAME
    과
    SRC_PRIMARY_DB_NAME
    별칭이 서로 바뀌지 않았는지 확인한다.

    Extract, Llob

    SRC_DB_NAME

    Standby 별칭. Redo Log 읽기, Llob Flashback 조회, 복구 상태 조회에 사용한다.

    SRC_LOCAL_SID

    Standby 인스턴스 직결 별칭. Archive Log 정보 조회와 TAC-TSC의 인스턴스 판별에 사용한다.

    SRC_PRIMARY_DB_NAME

    Primary 별칭. Source DB 측 메타데이터 조회/변경 작업에 사용한다.

    SRC_PRIMARY_LOCAL_SID

    Primary 인스턴스 직결 별칭(Extract 전용). Dummy Transaction, Logfile Switch에 사용한다.

    Redo Log 읽기

    SRC_DB_NAME

    SRC_DB_NAME

    Llob Flashback 조회

    SRC_DB_NAME

    SRC_DB_NAME

    PRS_TXINFO 조회/저장

    SRC_PRIMARY_DB_NAME

    SRC_DB_NAME

    ENABLE_TSC_STANDBY

    TSC Standby 동기화 사용 여부를 설정한다. Y로 설정하면 읽기 별칭과 쓰기 별칭을 분리하여 동작한다. 기본값은 N이며, SRC_DB_TYPE=TIBERO에서만 사용할 수 있다. (적용: Extract, Llob)

    SRC_PRIMARY_DB_NAME

    정상 TSC 상태에서 Source DB 측 메타데이터 작업을 수행할 Primary 별칭을 설정한다. ENABLE_TSC_STANDBY=Y인 경우 반드시 설정해야 한다. (적용: Extract, Llob)

    SRC_PRIMARY_LOCAL_SID

    Dummy Transaction, Logfile Switch와 같이 특정 인스턴스에서 수행해야 하는 작업에 사용할 Primary 인스턴스 직결 별칭을 설정한다. 설정하지 않으면 SRC_PRIMARY_DB_NAME을 사용한다. TAC-TSC 환경에서는 Extract 프로세스별로 해당 Redo Thread를 소유한 Primary 인스턴스의 별칭을 설정한다. (적용: Extract)

    데이터베이스 설정

    주의

    TSC Standby 동기화는 Tibero Source에서만 사용할 수 있다. Oracle, PostgreSQL Source에서는 ENABLE_TSC_STANDBY=Y를 사용할 수 없다.

    또한 ProSync가 연동하는 Standby DB는 Primary DB에 직접 연결된 1개여야 하며, TAC-TSC는 Primary와 Standby의 노드 수가 동일한 구성만 지원한다. 1:N(Broadcasting) Standby 구성과 Cascading Standby 구성의 제약은 아래 '제약사항'을 참고한다.

    동작 구조

    참고

    Dummy Transaction과 Logfile Switch는 인스턴스 직결 별칭이 설정되어 있지 않으면 각각 SRC_PRIMARY_DB_NAME(정상 상태), SRC_DB_NAME(Failover 이후)을 사용한다.

    TAC-TSC 구성의 별칭 배치

    사전 준비

    TIP 파일 설정 확인

    Standby DB 상태 확인

    계정 권한 확인

    참고

    여기에 나열한 조회 권한은 Source DB가 Tibero인 경우 SRC_INSTALL_USER에 부여해야 하는 최소 권한으로 설치했다면 설치 과정에서 ProSync 계정에 자동으로 부여되므로, 별도로 추가 부여할 필요가 없다. 최소 권한 목록은 Instance 설치 페이지를 참고한다.

    메타데이터 객체 위치 확인

    설정 파라미터

    설정 예시

    Extract 설정

    Llob 설정

    설치 구성

    동작 방식

    안전 추출 경계

    메타데이터 라우팅

    Llob Flashback 조회 대기

    Failover 동작

    정상 TSC 상태

    Primary 장애, Standby 미승격

    Standby 승격 감지

    Old Primary 복귀

    제약사항

    주의

    1:N(Broadcasting) Standby 구성과 Cascading Standby 구성의 하위 Standby 연동은 지원하지 않는다.

    ProSync는 SRC_DB_NAME과 SRC_PRIMARY_DB_NAME 두 별칭의 1:1 역할 전환만 추적하므로, 연동하지 않은 다른 DB로 역할 전환이 일어나면 이를 감지하지 못하고 Primary Routing(쓰기 라우팅 전환)이 불가능하다.

    • 1:N(Broadcasting) Standby: Primary 하나에 LOG_REPLICATION_DEST_N으로 Standby를 여러 개 연결하는 구성이다. Failover 시 TSN이 가장 높은 Standby가 Primary로 승격되어 승격 대상을 예측할 수 없으므로 New Primary를 감지할 수 없다. 또한 각 Standby가 동일한 Redo Log를 보유하므로 여러 Standby에 Extract 프로세스를 각각 기동하면 Target DB에 DML이 중복 반영될 수 있다. 이 구성은 지원하지 않는다.

    • Cascading Standby: STANDBY_ENABLE_CASCADING=Y로 Standby가 다른 Standby에 Redo Log를 중계하는 구성이다. Primary DB에 직접 연결된 최상단 Standby에 연동하는 것은 지원한다. 다만 하위 Standby(다른 Standby로부터 Redo Log를 중계받는 Standby)에 연동하는 것은 cascade 단계에 따른 지연이 있고 상위 Standby의 역할 전환을 감지할 수 없으므로 지원하지 않는다.

    로그 확인

    문제 상황별 확인 항목

    기동에 실패하는 경우

    추출 또는 Llob 조회가 지연되는 경우

    Primary 장애 후 쓰기 작업이 진행되지 않는 경우

    TAC-TSC에서 특정 Extract만 동기화가 반영되지 않는 경우

    동기화 테이블 추가/삭제

    ALTER DATABASE OPEN READ ONLY CONTINUE RECOVERY;
    SELECT DATABASE_ROLE FROM V$DATABASE;
    SELECT DATABASE_ROLE FROM V$DATABASE;
    SELECT MIN(RECOVERED_TSN) FROM V$STANDBY;
    SELECT INSTANCE_NUMBER FROM V$INSTANCE;
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero_s
    SRC_LOCAL_SID=tibero_s
    
    ENABLE_TSC_STANDBY=Y
    SRC_PRIMARY_DB_NAME=tibero_p
    SRC_PRIMARY_LOCAL_SID=tibero_p
    # ext1
    SRC_DB_NAME=tibero_s
    SRC_LOCAL_SID=tibero_s1
    ENABLE_TSC_STANDBY=Y
    SRC_PRIMARY_DB_NAME=tibero_p
    SRC_PRIMARY_LOCAL_SID=tibero_p1
    
    # ext2
    SRC_DB_NAME=tibero_s
    SRC_LOCAL_SID=tibero_s2
    ENABLE_TSC_STANDBY=Y
    SRC_PRIMARY_DB_NAME=tibero_p
    SRC_PRIMARY_LOCAL_SID=tibero_p2
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero_s
    
    ENABLE_TSC_STANDBY=Y
    SRC_PRIMARY_DB_NAME=tibero_p
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero_s              # Standby 별칭
    
    USE_TSC=Y
    SRC_PRIMARY_DB_NAME=tibero_p      # Primary 별칭
    
    # (TAC-TSC) SRC_DB_ALIAS_N과 병렬인 Primary 인스턴스별 별칭 (선택)
    SRC_PRIMARY_DB_ALIAS_0=tibero_p1
    SRC_PRIMARY_DB_ALIAS_1=tibero_p2
    
    # (Cluster) Thread별 Standby 인스턴스 직결 별칭
    SRC_DB_CNT=2
    SRC_DB_ALIAS_0=tibero_s1
    SRC_DB_ALIAS_1=tibero_s2
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero_s
    ENABLE_TSC_STANDBY=Y
    SRC_PRIMARY_DB_NAME=tibero_p
    TSC standby source enabled
    TSC source DB role transition detected
    waiting for TSC safe extraction TSN
    TSC promotion detected while waiting for safe TSN; reopen current log
    TSC promotion detected while waiting for log; reopen current log
    waiting for TSC standby recovery before LLOB flashback read
    TSC source DB is primary; skip recovered TSN wait
    TSC has no writable source DB route
    TSC primary source DB role validation failed
    TSC writable source DB connection failed
    TSC source DB role validation failed; ensure the TSC standby DB is open in read-only mode

    Sequential Access Method (SAM)

    ProSync는 동기화 과정 중에 전달하는 세그먼트를 파일에 순차적으로 기록할 수 있다. APPLY 프로세스에서 Target DB에 반영하는 STATEMENT 를 파일에 저장할 수 있는데, 이를 SAM 기능이라고 한다.

    다음은 SAM 기능을 지원하는 데이터 타입이다.

    구분
    지원 타입

    Tibero

    NUMBER, CHAR, VARCHAR, DATE, TIME, TIMESTAMP, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND, CLOB, TIMESTAMP WITH TIMEZONE, TIMESTAMP WITH LOCAL TIMEZONE, BINARY_FLOAT, BINARY_DOUBLE

    Oracle

    NUMBER, CHAR, VARCHAR, DATE, TIME, TIMESTAMP, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND, CLOB

    PostgreSQL

    SMALLINT, INTEGER, BIGINT, NUMERIC, DECIMAL, REAL, DOUBLE PRECISION, CHARACTER, CHARACTER VARYING, DATE, TIMESTAMP WITHOUT TIMEZONE

    SAM 기능에 사용되는 Parameters

    [INST_ID]_apply1.cfg 파일에 다음의 파라미터를 설정해야 한다.

    Parameter
    설명

    본 절에서는 TX_SAM_TEMPLATE, STMT_SAM_TEMPLATE, COL_SAM_TEMPLATE 파라미터에서 사용할 템플릿을 설정하는 방법에 대해 서술한다.

    템플릿 구성요소는 '% + 알파벳 하나(대소문자 구분)'으로 구성하며, 이렇게 구성된 표현값을 치환하여 Sam File에 출력한다.

    항목
    표현값
    의미
    항목
    표현값
    설명
    항목
    표현값
    설명
    APPLY_TO_SAM=[Y|N]
    SAM_BIND_VALUE=[Y|N]
    SAM_LOG_PREFIX=[Y|N]
    
    SAM_DIR=sam_dir_path
    SAM_FILE_SIZE=file_size(1M-16G)
    SAM_BACKUP_DIR=sam_backup_dir_path
    SAM_BACKUP_SIZE=file_size(0-128G)
    
    SQL_REDO_MODE=[Y|N]
    TX_SAM_TEMPLATE=tx_template_file_path
    STMT_SAM_TEMPLATE=stmt_template_file_path
    COL_SAM_TEMPLATE=col_template_file_path

    APPLY_TO_SAM

    APPLY 프로세스에서 DB로 반영하는 STATEMENT를 SAM 파일로 남길지 여부를 설정한다. (Y/N)

    SAM_BIND_VALUE

    SAM 파일에 남겨지는 Query 의 Value 값 저장 여부를 설정한다. (Y/N)

    • Y : Value 값을 저장한다. (기본값)

    • N : Value 값을 '?' 로 치환한다.

    SAM_LOG_PREFIX

    해당 Query가 수행된 시간과 스레드 데이터 정보를 SAM 파일 row의 시작 부분에 붙이는 기능이다. (Y|N)

    • Y : 해당 정보를 row의 시작 부분에 첨부한다. (기본값)

    • N : 해당 정보를 남기지 않는다.

    SAM_DIR

    프로세스의 SAM 파일이 저장되는 디렉터리 위치를 나타낸다.

    SAM_FILE_SIZE

    *transaction template file 설정*
    tx {
    xid: %X
    stmt count: %C
    commit tsn: %T
    }
    
    *EXT SAM FILE 출력 예제*
    tx {
    xid: 655403
    stmt count:
    commit tsn: 26362351
    }
    
    *APPLY SAM FILE 출력 예제*
    tx {
    xid: 655403
    stmt count: 100
    commit tsn: 26362351
    }

    xid

    %X

    트랜잭션의 xid

    statement count

    %C

    트랜잭션의 statement(dml) 개수, ext sam에서는 출력하지 않는다.

    commit tsn

    %T

    트랜잭션의 commit tsn

    *statement template file 설정*
    stmt {
        op: %O
        op code: %o
        owner: %W
        table name: %N
        sgmt id: %I
        tsn: %T
        wrap no: %R
        log seq: %L
        set: %s
        where: %w
        values: %v
        ddl/dml string: %D
    }
    
    *column template file 설정*
    col {
        name: %N
        values: %V
        column count: %n
    }
    
    *INSERT STATEMENT 결과 예제*
    INSERT)
    stmt {
        op:INSERT
        op code:0
        owner:PRS_TEST
        table name:VARCHAR_T
        sgmt id:26424
        tsn:26362394
        wrap no:43
        log seq:2102
        set:
        where:
        values:
            col {
                name:C1
                values:1
                column count:0
            }
            col {
                name:VCHAR_COL
                values:VARCHAR
                column count:1
            }
        ddl/dml string:INSERT INTO "PRS_TEST"."VARCHAR_T" ("C1", "VCHAR_COL") VALUES
                   (1, VARCHAR)
    }
    
    *UPDATE STATEMENT 결과 예제*
    UPDATE)
    stmt {
        op:UPDATE
        op code:2
        owner:PRS_TEST
        table name:NVARCHAR_T
        sgmt id:26436
        tsn:26362421
        wrap no:87
        log seq:2103
        set:
            col {
                name:NVCHAR_COL
                values:NVARCHAR2
                column count:1
            }
        where:
            col {
                name:C1
                values:10
                column count:0
            }
            col {
                name:NVCHAR_COL
                values:NVCHAR
                column count:1
            }
        values:
        ddl/dml string:UPDATE "PRS_TEST"."NVARCHAR_T" SET NVCHAR_COL = NVARCHAR2
                   WHERE C1 = 10 AND NVCHAR_COL = NVCHAR
    }
    
    *DELETE STATEMENT 결과 예제*
    DELETE)
    stmt {
        op:DELETE
        op code:1
        owner:PRS_TEST
        table name:NVARCHAR_T
        sgmt id:26436
        tsn:26362437
        wrap no:175
        log seq:2103
        set:
        where:
            col {
                name:C1
                values:10
                column count:0
            }
            col {
                name:NVCHAR_COL
                values:NVARCHAR2
                column count:1
            }
        values:
        ddl/dml string:DELETE FROM "PRS_TEST"."NVARCHAR_T" WHERE C1 = 10 AND
                   NVCHAR_COL = NVARCHAR2
    }
    
    *DDL STATEMENT 결과 예제*
    DDL)
    stmt {
        op:DDL
        op code:9
        owner:PRS_TEST
        table name:NVARCHAR_T
        sgmt id:
        tsn:26362654
        wrap no:332
        log seq:2103
        set:
        where:
        values:
        ddl/dml string:truncate table nvarchar_t
    }        

    op(string)

    %O

    dml : INSERT, UPDATE, DELETE, ddl : DDL

    op code

    %o

    insert, update, delete, ddl에 대한 opcode

    owner

    %W

    statement의 user name

    column name

    %N

    column 이름

    column value

    %V

    column 값

    column count

    %n

    column count

    Parameters 설명

    주의

    SAM_BIND_VALUE 를 사용하여 SAM 파일에 Query의 value 값을 저장할 시, 동기화를 진행중인 table의 column 유형에 따라 SAM 파일의 과도한 용량 증가를 주의해야 한다.

    SAM FILE TEMPLATE 설정

    TX_SAM_TEMPLATE

    STMT_SAM_TEMPLATE, COL_SAM_TEMPLATE

    STMT_SAM_TEMPLATE

    COL_SAM_TEMPLATE

    프로세스별 SAM 파일의 최대 크기를 설정한다.

    SAM 파일의 크기가 SAM_FILE_SIZE를 넘으면 SAM_BACKUP_DIR로 옮긴 후 새로운 SAM 파일을 생성한다. (기본값: 16GB, 범위: 1MB ~ 16GB)

    SAM_BACKUP_DIR

    SAM 파일의 백업 파일이 저장되는 디렉터리 위치를 설정한다.

    SAM_BACKUP_SIZE

    SAM_BACKUP_SIZE는 SAM_BACKUP_DIR에 백업되는 SAM 파일들의 최대 크기를 설정한다. (기본값: 0 (제한없음), 범위: 0 ~ 128GB)

    SQL_REDO_MODE

    SQL_REDO_MODE 파라미터는 Sam File에 적히는 내용을 full dml/ddl로 적어주는 기능이다. (Y|N)

    • Y : sam file에 row by row로 DML이 남게 된다. (기본값)

    • N : sam file에 row by row로 DML이 남지 않는다.

    TX_SAM_TEMPLATE

    TX_SAM_TEMPLATE 파라미터는 트랜잭션을 Sam File에 출력할 때 사용할 user_defined_template 파일의 경로를 설정하는 파라미터이다. SQL_REDO_MODE가 N인 경우에 동작한다.

    ProSync는 트랜잭션이 commit을 만날 때마다 본 파라미터 경로에 있는 템플릿을 읽어 해당 템플릿 형식대로 sam file에 트랜잭션 내용을 남긴다.

    STMT_SAM_TEMPLATE

    STMT_SAM_TEMPLATE 파라미터는 statement(dml/ddl) 내용을 Sam File에 남겨줄 때 사용할 user_defined_template 파일의 경로를 설정하는 파라미터이다. SQL_REDO_MODE가 N인 경우에 동작한다.

    ProSync는 DDL과 DML 내용을 Sam File에 남겨줄 때 본 파라미터 경로에 있는 템플릿을 읽어 해당 템플릿 형식대로 sam file에 DDL, DML 내용을 남긴다.

    COL_SAM_TEMPLATE

    COL_SAM_TEMPLATE 파라미터는 DML을 출력할 때 컬럼 내용을 남길 때 사용할 user_defined_template 파일의 경로를 설정하는 파라미터이다. SQL_REDO_MODE가 N인 경우에 동작한다.

    ProSync는 DML을 파일에 남겨줄 때 COL_SAM_TEMPLATE에 컬럼에 대한 정의가 되어 있다면 해당 템플릿 형식대로 sam file에 컬럼 정보를 남긴다.

    name

    %N

    statement의 table name

    sgmt id

    %I

    해당 object의 segment id

    tsn

    %T

    statement가 실행된 tsn

    wrap no

    %R

    statement의 wrap number

    log seq

    %L

    statement가 기록된 log sequence number

    set

    %s

    update 구문의 set 절에 대한 내용 (insert와 delete의 경우 empty string으로 치환)

    where

    %w

    update, delete 구문의 where 절에 대한 내용 (insert의 경우 empty string으로 치환)

    values

    %v

    insert 구문의 values 절에 대한 내용 (update, delete의 경우 empty string으로 치환)

    ddl/dml string

    %D

    statement의 full dml/ddl string

    Single to Single

    SRC DB와 TAR DB가 서로 같은 장비에 설치된 경우

    1. Agent 설치

    prs_install_agent.cfg 예시

    AGENT_CNT=1
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.19.0.11
    AGENT_PORT_0=7600

    agent 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7600
    parameter check for Agent[0] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [1] 
    ********************************************************************************
    * Writing all agents.. cnt: 1
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent1.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    Agent installation Done.
    

    2. Instance 설치

    prs_install.cfg 설정 예시

    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=instance
    PRS_USER=prosync_user
    PRS_PWD=prosync_user_password
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=1
    EXT_AGENT_ID_LIST_0=agent1
    #EXT_AGENT_ID_LIST_1=agent1,agent2
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent1
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    #SRC_DB_CNT=1
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    #SRC_DB_ALIAS_0=
    #SRC_DB_ALIAS_1=
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tar_tibero
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    #TAR_DB_CNT=1
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N

    instance 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install.sh
    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * topology information for instance was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 1
    * Delimiter: [,]
       * Ext[0] process's Agent Id List 
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    
    Checking INSTANCE_ID... instance
    Checking PRS_USER... prosync_user
    Checking PRS_TS_NAME... instance_ts
    Checking PRS_TS_FILE... instance_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 1
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tar_tibero
    Checking target connection [tar_tibero](1/2)... ok
    Checking target connection [tar_tibero](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [tibero]... ok
    Get Archive log directory [tibero]... ok
    Get Archive log format [tibero]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user prosync_user to uppercase PROSYNC_USER... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST.%... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 6, and one for prosync
      "PROSYNC_USER"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      "TEST"."T4" : supplemental log already exists, continue.
      "TEST"."T5" : supplemental log already exists, continue.
      prosync_user.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 6
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile... ok
    Querying current log sequence [tibero]... 196
    Querying current snapshot#... 4463078
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [tibero (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [tibero] configuration...  ok
    Generating Apply [tar_tibero] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    
    ********************************************************************************
    * ProSync is installed successfully on Mon, 21 Apr 2025 13:04:35 +0900.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = prosync_user
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 196
    *
    *   Initial change# (TSN) = 4463078 
    *
    ********************************************************************************
    

    2.1 config 수정 (PostgreSQL)

    아래 설정은 SRC DB 또는 TAR DB가 PostgreSQL인 경우에만 해당하며, 위 Tibero to Tibero 예시에서는 필요하지 않다.

    • ext

    LOG_LEVEL=3
    
    PRS_USER=example
    PRS_PWD=#encrypted
    
    ...
    
    # have to set
    ODBC_DRIVER=/example/path/psqlodbcw.so
    PQ_DRIVER=/example/path/libpq.so.5
    PQ_REP_CONN_NAME=example
    • apply

    LOG_LEVEL=3
    
    PRS_USER=example
    PRS_PWD=#encrypted
    
    ...
    
    # have to set
    ODBC_DRIVER=/example/path/psqlodbcw.so
    • llob

    LOG_LEVEL=3
    
    PRS_USER=example
    PRS_PWD=#encrypted
    
    ...
    
    # have to set
    ODBC_DRIVER=/example/path/psqlodbcw.so

    3. Prosync 실행

    실행 절차는 ProSync 실행 문서를 참고한다.


    SRC DB와 TAR DB가 서로 다른 장비에 설치된 경우

    1. Agent 설치

    SRC DB가 설치된 장비에서 Agent를 설치한다.

    SRC DB 장비에서 TAR DB Client 접근을 위한 tbdsn.tbr 설정으로, src db 장비에서 instance를 설치하기 위해서 src db 장비에서 tar db client에 접근할 수 있어야 한다. 이를 위해 src db 장비의 tbdsn.tbr 파일에 tar db 정보를 추가해야 한다.

    접근 확인 예시

    SRC DB가 설치된 장비에서 Instance를 설치한다.

    아래 출력은 다른 설정으로 수행한 설치의 예시이므로, 인스턴스명·사용자·Agent 배치 등 일부 값이 위 설정 파일과 다를 수 있다.

    TAR DB 장비 Prosync 디렉토리에 설치 파일 및 디렉토리를 옮긴다. ProSync는 SRC DB 장비에서만 설치되었기 때문에, TAR DB 장비에서도 ProSync를 기동하려면 SRC DB 장비에서 설치 후 생성된 파일 및 디렉토리를 TAR DB 장비로 복사해야 한다.

    • $PRS_HOME/config

      • prs_adm.cfg

      • <instance_id>_apply1.cfg

      • prs_agent_<agent_id>.cfg

    실행 절차는 문서를 참고한다.

    명령어 목록

    ProSync Admin Utility 내에서 운영체제의 명령어를 실행한다.

    항목
    설명

    운영체제의 명령어 없이 ! 명령어만 입력하면 운영체제의 명령 프롬프트로 나가서 운영체제의 명령어를 여러 번 입력할 수 있다.

    이때 다시 ProSync Admin Utility로 돌아오려면 EXIT 명령어를 입력한다.

    다음은 현재 디렉터리 내에 확장자가 ext인 모든 디렉터리와 파일 목록을 출력하는 예제이다.


    특정 스크립트 파일을 실행한다. 파일의 확장자가 SUFFIX 시스템 변수에 등록되어 있으면, 확장자를 생략하고 파일명을 지정할 수 있다.

    스크립트 실행 전에 SET 명령어로 설정된 시스템 변수는 실행 도중에도 유효하다. 스크립트 내에서 EXIT 또는 QUIT 명령어를 실행하면 ProSync Admin Utility가 정지한다.

    prs_instance.map
  • $PRS_HOME/var

  • ProSync 실행

    prs_install_agent.cfg 예시

    agent 설치 및 설치 결과 예시

    2. tbdsn.tbr 설정

    TAR DB tbdsn.tbr 파일 예시

    SRC DB 장비에 TAR DB 정보를 반영한 tbdsn.tbr 예시

    SRC DB 장비에서 TAR DB client로 접근 가능 여부 확인

    3. Instance 설치

    prs_install.cfg 설정 예시

    instance 설치 및 설치 결과 예시

    4. 설치 파일 및 디렉토리 이동

    주의

    설치 시 생성된 설정 파일들(*.cfg)에는 SRC DB 장비 기준의 경로가 포함되어 있으므로, TAR DB 장비로 복사한 후에는 경로를 TAR DB 장비 기준으로 수정해야 한다.

    복사 필요한 파일 및 디렉토리

    옮긴 파일 예시

    5. Prosync 실행

    AGENT_CNT=2
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.19.0.11
    AGENT_PORT_0=7600
    
    AGENT_ID_1=agent2
    AGENT_HOST_1=172.19.0.12
    AGENT_PORT_1=7700
    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7600
    parameter check for Agent[0] Done 
    parameter check for Agent[1] Started 
        AGENT_ID: agent2
        AGENT_HOST: 172.19.0.12
        AGENT_PORT: 7700
    parameter check for Agent[1] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [2] 
    ********************************************************************************
    * Writing all agents.. cnt: 2
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent1.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           1
    * Writing Agent.. AGENT_ID:        agent2
    * Writing Agent.. AGENT_HOST:      172.19.0.12
    * Writing Agent.. AGENT_PORT:      7700
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent2.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    Agent installation Done.
    
    #-------------------------------------------------
    # /home/tibero_tar/tibero/tibero7/client/config/tbdsn.tbr
    # Network Configuration File.
    # Generated by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    tar_tibero=(
        (INSTANCE=(HOST=172.19.0.12)
    	      (PORT=8620)
                  (DB_NAME=tibero)
        )
    )
    
    #-------------------------------------------------
    # /home/tibero/tibero/tibero7/client/config/tbdsn.tbr
    # Network Configuration File.
    # Generated by gen_tip_for_tac.sh at Thu Apr 17 10:19:44 UTC 2025
    tibero=(
        (INSTANCE=(HOST=172.19.0.11)
    	      (PORT=8620)
                  (DB_NAME=tibero)
        )
    )
    
    tar_tibero=(
        (INSTANCE=(HOST=172.19.0.12)
    	      (PORT=8620)
                  (DB_NAME=tibero)
        )
    )
           
    $ tbsql sys/tibero@tar_tibero
    tbSQL 7  
    
    TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
    
    Connected to Tibero using tar_tibero.
    
    SQL> 
    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=SINGLE2SINGLE
    PRS_USER=SINGLE2SINGLE
    PRS_PWD=SINGLE2SINGLE
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=1
    EXT_AGENT_ID_LIST_0=agent1
    # EXT_AGENT_ID_LIST_1=agent2,agent1
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent2
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    # SRC_DB_CNT=1
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    # SRC_DB_ALIAS_0=
    # SRC_DB_ALIAS_1=
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tar_tibero
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    # TAR_DB_CNT=1
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N
    $ cd $PRS_HOME/install
    $ ./prs_install.sh
    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * topology information for instance was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 1
    * Delimiter: [,]
       * Ext[0] process's Agent Id List 
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    
    Checking INSTANCE_ID... instance
    Checking PRS_USER... prosync_user
    Checking PRS_TS_NAME... instance_ts
    Checking PRS_TS_FILE... instance_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 1
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tar_tibero
    Checking target connection [tar_tibero](1/2)... ok
    Checking target connection [tar_tibero](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [tibero]... ok
    Get Archive log directory [tibero]... ok
    Get Archive log format [tibero]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user prosync_user to uppercase PROSYNC_USER... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST.%... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 6, and one for prosync
      "PROSYNC_USER"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      "TEST"."T4" : supplemental log already exists, continue.
      "TEST"."T5" : supplemental log already exists, continue.
      prosync_user.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 6
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile... ok
    Querying current log sequence [tibero]... 196
    Querying current snapshot#... 4463078
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [tibero (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [tibero] configuration...  ok
    Generating Apply [tar_tibero] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    
    ********************************************************************************
    * ProSync is installed successfully on Mon, 21 Apr 2025 13:04:35 +0900.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = prosync_user
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 196
    *
    *   Initial change# (TSN) = 4463078 
    *
    ********************************************************************************
    total 35
    drwxr-xr-x 3 tibero tibero 4096 Apr 18 02:15 ./
    drwxr-xr-x 8 tibero tibero 4096 Apr 18 02:24 ../
    -rw-r--r-- 1 tibero tibero  534 Apr 18 02:15 SINGLE2SINGLE_apply1.cfg
    -rw-r--r-- 1 tibero tibero  339 Apr 18 02:15 prs_adm.cfg
    -rw-r--r-- 1 tibero tibero  353 Apr 18 02:15 prs_agent_agent2.cfg
    -rw-r--r-- 1 tibero tibero 1262 Apr 18 02:07 prs_instance.map
    drwxr-xr-x 2 tibero tibero 4096 Apr 17 10:51 templates/
    -rw-r--r-- 1 tibero tibero    5 Feb  5 04:59 variant
    # var directory tree 예시
    .
    ├── admin
    │   └── log
    ├── agent
    │   └── agent1
    └── SINGLE2SINGLE
        ├── alloc
        ├── log
        ├── lr1
        ├── path
        └── sam
    
    항목
    설명

    filename

    스크립트 파일의 이름이다. ProSync Admin Utility는 파일을 현재 디렉터리에서 찾는다.

    다음은 현재 디렉터리 내의 스크립트 파일을 실행하는 예제이다.


    ProSync Admin Utility 내에서 히스토리 버퍼에 저장된 명령어를 재수행한다.

    다음은 히스토리 버퍼에 저장된 'HELP' 명령어를 재수행하는 예제이다:


    ProSync 운영 중에 동기화 대상 테이블을 추가/제거하거나, 기동 중인 ProSync 프로세스의 Parameter를 변경할 수 있다.

    동기화 테이블 추가/제거의 경우, 기동 전에 prs_obj_group1.list에 추가하지 못했던 테이블을 ProSync 운영 중에 동적으로 추가할 수 있다. Source DB를 오라클을 사용하고, 로그마이너를 통한 추출을 하는 경우 다음과 같은 동작을 수행해야 동적 동기화 테이블 추가가 가능하다.

    1. 소스 오라클, 타겟 티베로 동기화 대상 테이블 생성(CREATE 수행)

    2. Admin Utility에서 ALTER <inst_id> ADD TABLE 수행 (해당 테이블에 supplemental log가 함께 추가된다)

    3. 소스 오라클 ALTER SYSTEM SWITCH LOGFILE 수행

    4. DML/DDL 동기화 확인

    Parameter 변경의 경우, 수정을 원하는 Parameter의 유형이 Dynamic 인 경우에만 변경할 수 있다.


    ProSync Admin Utility를 정지한다. 현재 진행 중이던 프로세스에 영향을 전혀 주지 않고 Utility만 정지된다.


    Admin 명령어 사용에 대한 도움말을 화면에 출력한다.

    항목
    설명

    topic

    도움말을 출력할 단어를 지정한다.

    옵션을 지정하지 않으면 ProSync Admin Utility에서 사용할 수 있는 전체 명령어를 출력한다.

    다음은 SET 파라미터에 대한 도움말을 화면에 출력하는 예제이다.


    사용자가 입력한 INST_ID의 작업을 멈추는 명령어이다.

    모든 프로세스가 정지하는 것이 아닌, 추출이 더 이상 데이터를 추출하지 않도록 하는 기능이다. 즉 현재 반영중인 내용이나 이미 소켓을 타고 넘어간 데이터들에 대한 반영은 이루어진다.

    항목
    설명

    inst_id

    일시 정지할 inst_id이다.

    ALL

    등록된 모든 instance의 작업을 일시 정지한다.

    다음은 'prosync4'의 작업을 일시정지하는 예제이다.


    사용자가 입력한 INST_ID의 작업을 재개하는 명령어이다.

    PAUSE 의 동작을 되돌리는 것으로, 추출이 다시 시작되는 기능으로 볼 수 있다.

    항목
    설명

    inst_id

    재시작할 inst_id이다.

    ALL

    등록된 모든 instance의 작업을 재개한다.

    예제


    ProSync Admin Utility의 시스템 변수를 설정한다.

    SET 명령어로 설정된 시스템 변수는 SHOW 명령어를 사용하여 출력한다. 단, 변경된 시스템 변수는 현재 세션 내에서만 유효하다. 각각의 시스템 변수에 대해서는 시스템 변수 를 참고한다.

    항목
    설명

    parameter

    ProSync Admin Utility 시스템 변수의 이름이다.

    value

    ProSync Admin Utility 시스템 변수의 값이다.

    예제


    ProSync Admin Utility의 시스템 변수 및 각 프로세스의 파라미터를 출력한다.

    항목
    설명

    ALL

    모든 ProSync Admin Utility 시스템 변수를 출력한다.

    PARAM[ETER]

    파라미터의 값을 출력할 때 사용한다.

    instance_id

    파라미터를 확인하고자 하는 instance 의 instance_id.

    EXT[RACT] {num}

    {num} 번째 노드의 추출 프로세스에 속한 파라미터를 출력한다.

    APP[LY] {num}

    {num} 번째 노드의 적용 프로세스에 속한 파라미터를 출력한다.

    다음은 시스템 변수를 출력하는 예제이다.

    다음은 'prosync4' 에 속한 프로세스들의 파라미터를 출력하는 예제이다.

    다음은 'agent1' 에 속한 모든 파라미터를 출력하는 예제이다.


    사용자가 입력한 INST_ID의 프로세스 혹은 매니저 프로세스를 정지한다.

    항목
    설명

    ALL

    등록된 모든 instance를 정지한다.

    AGE[NT]

    Agent 프로세스를 정지할 때 사용한다.

    agent_id

    특정 agent_id 의 프로세스를 정지할 때 사용한다.

    inst_id

    특정 inst_id의 프로세스를 정지할 때 사용한다.

    EXT[RACT] [num]

    [num]번째 노드의 추출 프로세스를 정지할 때 사용한다.

    다음은 'pro'의 프로세스를 정지하는 예제이다.

    다음은 'agent1'의 매니저 프로세스를 정지하는 예제이다.


    사용자가 입력한 INST_ID의 프로세스를 실행한다.

    항목
    설명

    ALL

    등록된 모든 instance를 기동한다.

    AGE[NT]

    Agent 프로세스를 실행할 때 사용한다.

    agent_id

    특정 agent_id 의 프로세스를 실행할 때 사용한다.

    inst_id

    특정 inst_id의 프로세스를 실행할 때 사용한다.

    EXT[RACT] [num]

    [num]번째 노드의 추출 프로세스를 실행할 때 사용한다.

    다음은 'agent1'의 매니저 프로세스를 실행하는 예제이다.

    다음은 'pro' instance를 실행하는 예제이다.


    전체 프로세스, 사용자가 입력한 INST_ID의 프로세스 혹은 매니저 프로세스의 상태를 확인하는 명령어이다.

    항목
    설명

    inst_id

    특정 inst_id의 Ext, Apply, LONG/LOB 프로세스의 상태를 조회할 때 사용한다.

    전체 프로세스의 상태를 조회하는 경우 STATUS 명령어만 사용한다.

    다음은 모든 Instance(inst_id) 프로세스를 조회하는 예제이다.

    다음은 Instance(inst_id)가 'prosync4'인 모든 프로세스 및 스레드의 상태를 조회하는 예제이다.


    Instance의 apply 프로세스가 Target DB에 반영 중인 Query의 정보를 출력한다.

    다음은 MONITOR 명령어를 통해 현재 적용 중인 쿼리를 조회하는 예제이다.

    항목
    설명

    SQL_TEXT

    Replay 스레드가 현재 적용 중인 Query

    SQL_ET

    해당 Query문을 수행 시작하고 경과된 시간


    프로세스의 메모리 할당 현황을 파일로 출력하는 진단 명령어이다. 메모리 사용량 분석이나 장애 진단 시 기술 지원의 요청에 따라 사용한다.

    항목
    설명

    inst_id

    dump를 수행할 instance의 inst_id이다.

    EXT|APPLY|LLOB

    dump를 수행할 프로세스를 지정한다.

    결과 파일은 $PRS_HOME/var/<instance>/alloc/ 경로에 생성된다.


    Apply 프로세스의 내부 상태를 파일로 출력하는 진단 명령어이다. Apply 프로세스 전용이다.

    항목
    설명

    inst_id

    dump를 수행할 instance의 inst_id이다.

    DD

    Apply가 보유한 Data Dictionary 상태를 dump한다.

    MERGE

    merge 처리 상태를 dump한다.

    DEPENDENCY

    트랜잭션 의존성 처리 상태를 dump한다.

    QUEUE

    내부 queue 상태를 dump한다.

    결과 파일은 $PRS_HOME/var/<instance>/dump/ 경로에 생성된다.


    프로세스 내부 상태의 스냅샷 dump를 생성하거나, 생성된 dump 파일을 분석하는 진단 명령어이다.

    항목
    설명

    inst_id

    dump를 수행할 instance의 inst_id이다.

    EXT|APPLY|LLOB

    dump를 수행할 프로세스를 지정한다.

    label

    dump 파일을 구분하기 위한 이름표이다. 시점별 dump를 비교할 때 사용한다.

    COMPARE

    이미 생성된 dump 파일을 분석할 때 사용한다. file1, file2는 jcdump 디렉토리 내 파일 이름의 일부로 지정할 수 있으며, 여러 파일이 일치하면 번호로 선택한다. 두 파일을 지정하면 두 dump를 비교하고, file2를 생략하면 file1 하나에 대한 분석 결과를 출력한다.

    결과 파일은 $PRS_HOME/var/<instance>/jcdump/ 경로에 생성된다.


    ProSync Admin Utility에서 주로 사용하는 기능은 명령어를 직접 입력하여 프로세스를 실행하고 정지하고 일시정지하는 것이다. ProSync Admin Utility 명령어는 실행을 위한 명령어가 따로 없으며, 입력된 명령어는 버퍼에 저장된다. ProSync Admin Utility 명령어는 입력을 마침과 동시에 실행된다.

    위의 예는 INST_ID가 prosync4인 모든 프로세스를 실행하는 명령어의 입력 및 실행 결과를 보이고 있다. INST_ID의 추출, 적용, LONG/LOB 프로세스가 각각 기동된다. 예제의 명령어를 입력하기 이전에 해당 INST_ID에 연결되어 있는 매니저 프로세스를 실행시켜야 한다.

    INST_ID를 정지하면, 매니저 프로세스를 제외한 추출, 적용, LONG/LOB 프로세스가 중단된다.

    ! [command]
    HO[ST] [command]

    command

    운영체제의 명령어이다.

    Admin> ! dir *.ext
    Admin> !
    
    Admin> HOST dir *.ext
    Admin> HOST

    ! / HOST

    @

    @ {filename}
    Admin> @ run
    Admin> @ run.sql
    /
    Admin> HELP
    Admin> /
    #동기화 테이블 추가/제거
    ALTER inst_id {ADD|DEL[ETE]} TABLE table_owner.table_name GROUP=group_num
    
    #Parameter 변경
    ALTER inst_id {EXT|APP[LY]|LLOB} SET parameter='values'
    EXIT | Q[UIT]
    H[ELP] [topic]
    Admin> HELP SET
    PAUSE {inst_id|ALL}
    Admin> PAUSE prosync4
    prosync4 paused.
    RESUME {inst_id|ALL}
    Admin> RESUME prosync4
    prosync4 resumed.
    SET {parameter} {value}
    Admin> SET HISTORY 100
    SHO[W] ALL
    SHO[W] PARAM[ETER] instance_id {EXT[RACT] num | APP[LY] num | LLOB} [parameter_name]
    SHO[W] PARAM[ETER] AGE[NT] agent_id [parameter_name]
    Admin> SHOW ALL
    Admin> SHOW PARAM prosync4 EXT 1 LOG_LEVEL
    Admin> SHOW PARAM prosync4 APPLY 1 MAP
    Admin> SHOW PARAM prosync4 LLOB LLOB_FLASHBACK_ERROR
    Admin> SHOW PARAM AGENT agent1
    SHUTD[OWN] ALL
    SHUTD[OWN] AGE[NT] [agent_id] [ABORT]
    SHUTD[OWN] inst_id [EXT[RACT] [num] | APP[LY] [num] | LLOB] [ABORT]
    Admin> SHUTDOWN pro
    *** Shutdown Process... [pro_ext1]
    	Process 'pro_ext1' aborted.
    *** Shutdown Process... [pro_apply1]
    	Process 'pro_apply1' aborted.
    *** Shutdown Process... [pro_llob]
    	Process 'pro_llob' aborted.
    Admin> SHUTDOWN AGENT agent1
    *** Shutdown Agent Process... [agent1]
    	Process 'prs_agent' aborted.
    START[UP] ALL
    START[UP] AGE[NT] agent_id
    START[UP] inst_id [EXT[RACT] [num] | APP[LY] [num] | LLOB]
    Admin> STARTUP AGENT agent1
    *** Startup Agent Process... [agent1]
    	Process 'prs_agent' started.
    Admin> STARTUP pro
    *** Startup Process... [pro_ext1]
    	Process 'pro_ext1' started.
    *** Startup Process... [pro_apply1]
    	Process 'pro_apply1' started.
    *** Startup Process... [pro_llob]
    	Process 'pro_llob' started.
    STATUS
    STATUS inst_id
    Admin> STATUS
    prs_agent ID: agent1, HOST: 192.168.51.45, PORT: 7600 is running
    prs_agent ID: agent2, HOST: 192.168.51.54, PORT: 7601 is running
    prs_agent ID: agent3, HOST: 192.168.51.55, PORT: 7602 is stopped
    
    Instance ID: [prosync4]
    prosync4_ext1 (1) is running (prs_mgr ID : agent1, HOST: 192.168.51.45, PORT: 7600)
    prosync4_ext2 (2) is running (prs_mgr ID : agent1, HOST: 192.168.51.45, PORT: 7600)
    prosync4_apply1 (1) is running (prs_mgr ID : agent2, HOST: 192.168.51.54, PORT: 7601)
    prosync4_llob (1) is stopped (prs_mgr ID : agent1, HOST: 192.168.51.45, PORT: 7600)
    
    Instance ID: [prosync3]
    Agent Process for proc[Extract], num[1] is not running.
    Agent Process for proc[Extract], num[2] is not running.
    Agent Process for proc[Apply], num[1] is not running.
    Agent Process for proc[LONG/LOB], num[1] is not running.
    Agent Process for proc[Verify], num[1] is not running.
    Admin> STATUS prosync4
    prosync4_ext1 (20133) has 8 cores, started at 2020/09/09 15:44:19
      + control thread, running
      + worker thread, running
      + sam thread, recv waiting
      + read thread, recv waiting
    
    prosync4_apply1 (20154) has 8 cores, started at 2020/09/09 15:44:19
      + control thread, running
      + replay thread, recv waiting
      + construct thread, recv waiting
    
    prosync4_llob (20168) has 8 cores, started at 2020/09/09 15:44:19
      + control thread, running
      + long/lob thread, recv waiting
    
    prosync4_vf, stopped
    MON[ITOR] {inst_id}
    Thread #0
    sql_text:
    DELETE FROM "TEST"."T33" WHERE "C1" = :"C1" AND "C2" = :"C2" AND 
    "C3" = :"C3" AND "C4" = :"C4" AND "C5" = :"C5" AND "C6" = :"C6" 
    AND "C7" = :"C7" AND "C8" = :"C8" AND "C9" = :"C9" AND "C10" = 
    :"C10" AND "C11" = :"C11" AND "TIME" = :"TIME" AND ROWNUM = 1
    sql_et: 0 (ms)
    
    Thread #1
    sql_text:
    DELETE FROM "TEST"."T33" WHERE "C1" = :"C1" AND "C2" = :"C2" AND
    "C3" = :"C3" AND "C4" = :"C4" AND "C5" = :"C5" AND "C6" = :"C6"
    AND "C7" = :"C7" AND "C8" = :"C8" AND "C9" = :"C9" AND "C10" =
     :"C10" AND "C11" = :"C11" AND "TIME" = :"TIME" AND ROWNUM = 1
    sql_et: 0 (ms)
    
    Thread #2
    sql_text:
    UPDATE "TEST"."T31" SET "C2" = :"C2", "C3" = :"C3", "C9" = :"C9"
    , "C10" = :"C10", "C11" = :"C11" WHERE "C1" = :"C1" AND "C2" = :
    "C2" AND "C3" = :"C3" AND "C4" = :"C4" AND "C5" = :"C5" AND "C6"
    = :"C6" AND "C7" = :"C7" AND "C8" = :"C8" AND "C9" = :"C9" AND 
    "C10" = :"C10" AND "C11" = :"C11" AND "TIME" = :"TIME" AND ROWNUM
     = 1
    sql_et: 0 (ms)
    
    Thread #3
    sql_text:
    UPDATE "TEST"."T33" SET "C2" = :"C2", "C3" = :"C3", "C9" = :"C9"
    , "C10" = :"C10", "C11" = :"C11" WHERE "C1" = :"C1" AND "C2" = :
    "C2" AND "C3" = :"C3" AND "C4" = :"C4" AND "C5" = :"C5" AND "C6"
    = :"C6" AND "C7" = :"C7" AND "C8" = :"C8" AND "C9" = :"C9" AND "
    C10" = :"C10" AND "C11" = :"C11" AND "TIME" = :"TIME" AND ROWNUM
     = 1
    sql_et: 0 (ms)
    ALLOCDUMP {inst_id} [EXT|APPLY|LLOB]
    TRACEDUMP {inst_id} [DD|MERGE|DEPENDENCY|QUEUE]
    JCDUMP {inst_id} [EXT|APPLY|LLOB] [label]
    JCDUMP COMPARE {inst_id} {file1} [file2]
    Admin> START AGENT agent1
    *** Startup Agent Process... [agent1]
            Process 'prs_agent' started.
    
    Admin> STARTUP prosync4
    *** Startup Process... [prosync4_ext1]
            Process 'prosync4_ext1' started.
    *** Startup Process... [prosync4_apply1]
            Process 'prosync4_apply1' started.
    *** Startup Process... [prosync4_llob]
            Process 'prosync4_llob' started.
    Admin> SHUTDOWN prosync4
    *** Shutdown Process... [prosync4_ext1]
            Process 'prosync4_ext1' aborted.
    *** Shutdown Process... [prosync4_apply1]
            Process 'prosync4_apply1' aborted.
    *** Shutdown Process... [prosync4_llob]
            Process 'prosync4_llob' aborted.

    /

    ALTER

    참고

    prs_obj_group#.list 파일은 설치 시점에만 처리되므로, 설치 이후 생성한 테이블은 이 명령으로 등록해야 한다. 동적으로 테이블을 추가할 때 Tibero/Oracle은 해당 테이블의 supplemental logging 설정이 필요하며, Source가 PostgreSQL인 경우 replica identity와 publication 설정을 함께 확인해야 한다.

    주의

    • Parameter 변경은 각 프로세스가 실제로 ALTER 처리를 지원하는 파라미터에 대해서만 적용된다. 문서상 Dynamic으로 표기된 파라미터라도 해당 프로세스가 변경을 지원하지 않으면 not supported로 실패할 수 있다.

    • ALTER로 변경한 값은 프로세스 메모리에만 적용되고 cfg 파일에는 기록되지 않는다. 프로세스를 재기동하면 cfg 파일의 값으로 원복되므로, 영구적으로 반영하려면 cfg 파일도 함께 수정해야 한다.

    EXIT / QUIT

    HELP

    PAUSE

    RESUME

    SET

    SHOW

    SHUTDOWN

    주의

    현재 버전에서는 ABORT 옵션 지정 여부와 관계없이 SHUTDOWN이 강제 종료(abort) 방식으로 동작한다. 즉, 처리 중이던 작업을 마무리하는 정상 종료(graceful shutdown)로 동작하지 않는다. 재기동 시에는 checkpoint 기반으로 복구되며, 관련 내용은 를 참고한다.

    STARTUP

    STATUS

    참고

    프로세스의 PID가 살아 있어도 내부 worker thread만 비정상 종료된 상태일 수 있다. 장애 진단 시에는 STATUS inst_id로 각 thread의 상태까지 확인한다. 자세한 진단 절차는 를 참고한다.

    MONITOR

    ALLOCDUMP

    TRACEDUMP

    JCDUMP

    명령어 실행 및 정지

    진단 가이드

    ProSync 운영 중 문제가 발생하면 프로세스 로그, 로그 리더 트레이스, 덤프 파일 등 여러 곳의 진단 정보를 조합해 원인을 분석한다. 본 문서는 증상별로 어떤 진단 도구를 사용해야 하는지, 각 도구의 출력이 어디에 생성되고 어떻게 읽는지를 안내한다.

    증상별 진단 도구 선택

    증상 / 목적
    사용 도구
    출력 위치

    프로세스 오류 메시지, 동작 이상 확인

    프로세스 로그 (LOG_LEVEL)

    var/<인스턴스ID>/log/

    Redo Log 파싱 문제 (Extract 추출 오류)

    로그 리더 트레이스 (LR_TRACE_LVL)

    var/<인스턴스ID>/lr<N>/

    인스턴스의 모든 진단 정보는 $PRS_HOME/var/<인스턴스ID>/ 아래에 모인다. Agent 프로세스는 별도로 $PRS_HOME/var/agent/<Agent ID>/ 를 사용한다.

    로그 디렉터리는 각 프로세스 cfg 의 LOG_DIR 파라미터가 지정한다. 설치 시 기본값은 $PRS_HOME/var/<인스턴스ID>/log (Agent 는 $PRS_HOME/var/agent/<Agent ID>/log) 이다.

    프로세스
    로그 파일명

    프로세스 기동 시 로그 파일 앞부분에 OS 정보(uname -a)와 사용 중인 cfg 파일 전체 내용이 ProSync configurations 블록으로 기록된다. 문제 분석 시 실제 적용된 파라미터 값을 이 블록에서 먼저 확인한다.

    LOG_LEVEL 파라미터(1~5, 기본값 3)가 기록할 메시지의 상세 수준을 결정한다. 설정한 값 이하 레벨의 메시지만 기록된다.

    LOG_LEVEL
    기록되는 메시지
    표시 문자
    필드
    의미

    로그 파일이 LOG_FILE_SIZE(기본 100MB)를 넘으면 LOG_BACKUP_DIR 로 이동되고 새 파일이 열린다. 설치 시 기본 백업 디렉터리는 프로세스별로 분리된다 (Extract <LOG_DIR>/ext_backup, Apply <LOG_DIR>/apply_backup, Llob <LOG_DIR>/llob_backup, Agent <LOG_DIR>/backup). 백업 파일명은 원래 이름 뒤에 시각이 붙는다 (예: agent_trace.log.260721_143000.123456). 백업 파일들의 총 크기가 LOG_BACKUP_SIZE 를 넘으면 가장 오래된 파일부터 삭제되며, 기본값 0 은 삭제하지 않음(무제한 보관) 을 뜻하므로 디스크 용량 관리가 필요한 환경에서는 값을 지정한다.

    컬럼 값 깨짐을 분석할 때는 히든 파라미터 _PRS_FULL_HEX_DUMP=Y 를 cfg 파일에 직접 추가하고 (템플릿에 없는 파라미터다) 프로세스를 재기동한다. LOG_LEVEL=5 와 함께 사용하면 값 전체가 16바이트 단위 여러 줄로 출력되고, Apply 의 batch INSERT/UPDATE/DELETE 실행 직전에 바인드 값 전체 덤프(NEW COLS DUMP, OLD COLS DUMP 등)가 추가로 기록된다.

    LR_TRACE_LVL(1~5, 기본값 2) 이 로그 리더 트레이스의 상세 수준을 결정하며, 값이 높을수록 상세하다. 소스 DB 가 Oracle 또는 Tibero 인 Extract 에만 적용되고, PostgreSQL 소스에는 사용되지 않는다.

    트레이스 파일: $PRS_HOME/var/<인스턴스ID>/lr<N>/<인스턴스ID>_ext<N>_li.log

    위치는 LR_LOG_DIR, 크기·백업은 LR_LOG_FILE_SIZE / LR_LOG_BACKUP_DIR / LR_LOG_BACKUP_SIZE 파라미터로 제어한다. 트레이스 한 줄에는 공통 로그 형식 뒤에 트랜잭션 ID([xid])와 Redo 레코드 주소((0x<seq>.<blkno>.<offset>))가 포함되어 문제 레코드의 위치를 특정할 수 있다.

    트레이스 파일: $PRS_HOME/var/<인스턴스ID>/lr<N>/tli<N>.log

    재기동 없이 변경할 수 있다. 파싱 문제 분석 시 레벨을 올려 문제 구간을 재현한 뒤 기본값으로 되돌린다.

    prs_adm 에서 실행하는 진단 명령 요약이다. 명령어 기본 사용법은 을 참고한다.

    명령
    용도
    대상 프로세스
    출력

    Apply 가 느릴 때 어떤 replay 스레드가 어떤 SQL 에서 시간을 쓰고 있는지 확인한다.

    Applying... <경과시간>(ms) 인 스레드가 현재 SQL 을 적용 중인 것이다. Completed 스레드에도 Query 블록이 출력되는데, 이는 현재 실행 중이 아니라 마지막으로 실행한 SQL 이다. 특정 스레드의 경과시간이 계속 크다면 해당 SQL(대상 테이블의 인덱스 유무, lock 대기 등)을 점검한다. MONITOR 는 인스턴스의 1번 Apply 프로세스를 대상으로 한다.

    Apply 가 메모리에 들고 있는 상태를 파일로 남긴다. 소스·타겟 간 DD 불일치나 트랜잭션 대기 상태 분석에 사용한다.

    종류를 생략하면 전체를 덤프한다. 같은 이름의 기존 파일은 덮어쓴다.

    프로세스 내부의 스레드별 성능 카운터(호출 횟수·처리량·소요시간)를 스냅샷으로 남기고, 두 스냅샷의 차이를 리포트로 출력한다. "부하 구간에서 어느 스레드·어느 단계가 병목인가"를 확인하는 도구다.

    1

    부하 전 스냅샷

    var/<인스턴스ID>/jcdump/jcdump_<시각>_apply_before_load 파일이 생성된다. 라벨(마지막 인자)은 생략 가능하지만 붙여두면 COMPARE 때 파일을 찾기 쉽다.

    2

    부하 후 스냅샷

    분석하려는 구간이 지난 뒤 같은 명령을 라벨만 바꿔 실행한다.

    3

    차이 리포트 출력

    프로세스의 메모리 할당 현황(할당자 계층별 사용량)을 덤프한다. 메모리 사용량이 계속 증가할 때 어느 모듈이 점유 중인지 확인하는 용도다.

    var/<인스턴스ID>/alloc/ 에 PROSYNC_DUMP_<inst>_Apply.<PID>.<시각> 파일이 생성된다. 접속 DB 가 Tibero 인 경우 DB 클라이언트 라이브러리 메모리를 담은 CLI_DUMP_* 파일이 추가로 생성된다.

    다음 두 가지로 확인한다.

    1. 콜스택 덤프 파일 존재 여부 — $PRS_HOME/var/<인스턴스ID>/prosync.out.<PID> (Agent 는 var/agent/<Agent ID>/prosync.out.<PID>). 이 파일은 크래시가 있었을 때만 생성된다.

    2. 프로세스 로그의 FATAL 메시지 — 크래시 시 다음 순서로 기록된다.

    STATUS <인스턴스ID> 명령으로도 프로세스 내 스레드별 상태를 확인할 수 있다.

    같은 프로세스에서 크래시가 반복되면 한 파일에 누적(append)된다. 함수명은 근사 매칭이므로 오프셋이 실제와 다를 수 있다. 버그 리포트 시 이 파일과 로그의 Signal ... caught 메시지를 함께 전달한다. 리포트 항목은 를 참고한다.

    ProSync 프로세스는 SIGTERM/SIGINT/SIGHUP 을 무시한다. 일반 kill 이나 Ctrl-C 로는 종료되지 않으며, 정상 종료 수단은 prs_adm 의 SHUTDOWN 명령이다 (불가피한 경우에만 kill -9 를 사용한다).

    개발 지원이 필요한 크래시 분석 시, 히든 파라미터 _SLEEP_ON_SIG=Y 를 cfg 에 추가하고 재기동하면 크래시 시그널을 받은 스레드가 종료되지 않고 대기 상태로 남아 gdb attach 가 가능하다.

    진단 관련 파라미터 대부분은 재기동 없이 변경할 수 있다.

    • 프로세스 타입을 생략하면 인스턴스의 모든 프로세스에 전송된다. 파라미터를 지원하지 않는 프로세스는 not supported. 로 응답하므로, 대상 프로세스를 명시하는 것을 권장한다.

    • 변경값은 메모리에만 반영된다. 프로세스를 재기동하면 cfg 파일 값으로 되돌아가므로, 영구 변경은 cfg 파일도 함께 수정한다.

    • 성공 시 Process Apply(num :'1') changed parameter('LOG_LEVEL' = '5'). 형태로 출력된다.

    런타임 변경이 가능한 파라미터는 프로세스별로 다음과 같이 제한되며, 목록에 없는 파라미터는 not supported. 오류가 반환된다.

    프로세스
    런타임 변경 가능 파라미터

    각 파라미터의 의미와 유효 범위는 를 참고한다.

    LLOB

    LONG/LOB 프로세스에 속한 파라미터를 출력한다.

    AGE[NT]

    agent 프로세스의 파라미터를 출력할 때 사용한다.

    agent_id

    파라미터를 확인하고자 하는 agent 의 agent_id.

    parameter_name

    확인하고자 하는 parameter의 이름을 입력한다. 파라미터 이름을 입력하지 않으면 해당 프로세스에 속한 모든 파라미터의 값이 출력된다.

    APP[LY] [num]

    [num]번째 노드의 적용 프로세스를 정지할 때 사용한다.

    LLOB

    LONG/LOB 프로세스를 정지할 때 사용한다.

    ABORT

    강제로 정지할 때 사용한다.

    APP[LY] [num]

    [num]번째 노드의 적용 프로세스를 실행할 때 사용한다.

    LLOB

    LONG/LOB 프로세스를 실행할 때 사용한다.

    장애 대응 가이드
    장애 대응 가이드

    + TRACE

    [T]

    5

    + DEBUG

    [D]

    Apply

    var/<inst>/dump/

    JC[DUMP] <inst_id> [프로세스] [라벨]

    성능 통계 스냅샷

    Ext/Apply/Llob

    var/<inst>/jcdump/

    ALLOC[DUMP] <inst_id> [프로세스]

    메모리 할당 현황 덤프

    Ext/Apply/Llob

    var/<inst>/alloc/

    스레드별로 stat 이름(JC_*)·Count·Value·Time·Max 표가 출력된다. 파일 인자는 파일명의 일부만 입력해도 되며, 여러 개가 매칭되면 후보 목록에서 선택한다. 파일 하나만 주면 프로세스 기동 이후의 누적치를 출력한다.

    Apply 적용 지연, 오래 걸리는 SQL 확인

    MONITOR 명령

    prs_adm 화면

    프로세스·스레드 상태 확인

    STATUS 명령

    prs_adm 화면

    DD(테이블 메타데이터) 불일치, 트랜잭션 큐 상태

    TRACEDUMP 명령

    var/<인스턴스ID>/dump/

    구간별 성능 통계 (스레드별 처리량·소요시간)

    JCDUMP 명령

    var/<인스턴스ID>/jcdump/

    메모리 사용량 분석

    ALLOCDUMP 명령

    var/<인스턴스ID>/alloc/

    프로세스 크래시 (스레드 비정상 종료)

    콜스택 덤프 파일

    var/<인스턴스ID>/prosync.out.<PID>

    Agent

    agent_trace.log

    Extract

    <인스턴스ID>_ext<N>_trace.log

    Apply

    <인스턴스ID>_apply<N>_trace.log

    Llob

    <인스턴스ID>_llob_trace.log

    Admin

    adm_trace.log (기본 $PRS_HOME/var/admin/log)

    1

    FATAL + ERROR

    [F] [E]

    2

    + WARN

    [W]

    3 (기본)

    + INFO

    [I]

    ① 시각

    월-일T시:분:초.마이크로초 (연도는 기록되지 않음)

    ② 기록 주체

    스레드 종류 약어 + 스레드 번호. REA(read), CON(const), MER(merge), REP(replay), LLO(llob), CTH/MTH/WTH(control/monitor/worker), SAM, DMP(dump) 등

    ③ 레벨

    F/E/W/I/T/D

    ④ 메시지

    로그 본문

    ⑤ 소스 위치

    FATAL/ERROR/WARN 메시지에만 붙는다. 버그 리포트 시 함께 전달한다

    STATUS [inst_id]

    프로세스·스레드 상태 확인

    전체

    prs_adm 화면

    MON[ITOR] <inst_id>

    Replay 스레드별 실행 중 SQL·경과시간

    Apply(1번)

    prs_adm 화면

    TRACE[DUMP] <inst_id> [종류]

    종류

    내용

    파일명 (var/<inst>/dump/)

    DD

    테이블 메타데이터 (const/replay 스레드용 2벌)

    <inst>_const_dd_<PID>_<TID>.dump, <inst>_replay_dd_<PID>_<TID>.dump

    MERGE

    다중 소스 merge 큐의 대기 stmt

    <inst>_merge_<PID>_<TID>.dump

    QUEUE

    병렬 replay 의 wait/replay 큐

    <inst>_queue_<PID>_<TID>.dump

    DEPENDENCY

    replay 스레드별 트랜잭션 의존성 표

    Extract

    LOG_LEVEL, LOG_FILE_SIZE, LOG_BACKUP_SIZE, LR_TRACE_LVL, ENABLE_NETWORK_COMPRESS, EXT_TO_SAM, SAM_BIND_VALUE, SAM_LOG_PREFIX, SAM_FILE_SIZE, SAM_BACKUP_SIZE, LR_FILE_RETENTION_DAY, RETENTION_FILE_CLEANUP_INTERVAL

    Apply

    LOG_LEVEL, LOG_FILE_SIZE,

    LOG_BACKUP_SIZE, TX_HASH_SIZE, APPLY_TO_SAM, SAM_BIND_VALUE, SAM_LOG_PREFIX, SAM_FILE_SIZE, SAM_BACKUP_SIZE, APPLY_REPORT_FILE_SIZE, APPLY_REPORT_BACKUP_SIZE, DISCARD_FILE_YN, DISCARD_FILE_SIZE, DISCARD_BACKUP_SIZE, TX_HASH_FILE_RETENTION_DAY, RETENTION_FILE_CLEANUP_INTERVAL,

    DISCARD_DDL_FILE_YN , DISCARD_DDL_FILE_SIZE , DISCARD_DDL_BACKUP_SIZE

    Llob

    LOG_LEVEL, LOG_FILE_SIZE, LOG_BACKUP_SIZE

    명령어 목록
    Bug Report
    참고자료_파라미터

    런타임 디렉터리 구조

    Apply 의 동기화 체크포인트(TSN)는 디스크가 아니라 타겟 DB 의 PRS_LCT 테이블에 저장된다. 현재 체크포인트는 타겟 DB 에서 SELECT TSN FROM PRS_LCT 로 확인할 수 있으며, Apply 로그에는 UPDATE LCT SUCCESS (<이전값> -> <새값>) 형태로 전진 이력이 남는다. 재설치 시 이 테이블이 재생성되므로 동기화 기준점이 리셋된다는 점에 유의한다.

    프로세스 로그

    위치와 파일명

    로그 레벨 (LOG_LEVEL)

    LOG_LEVEL 은 재기동 없이 변경할 수 있다. 문제 재현 시에만 잠시 올렸다가 되돌리는 사용을 권장한다.

    변경값은 메모리에만 반영되므로 프로세스를 재기동하면 cfg 값으로 되돌아간다. 자세한 내용은 본 문서 하단의 '런타임 파라미터 변경' 절을 참고한다.

    로그 한 줄 읽는 법

    로그 파일 순환

    컬럼 값 전체 확인 (_PRS_FULL_HEX_DUMP)

    LOG_LEVEL=5 에서 출력되는 컬럼 값 hex dump 는 기본적으로 첫 16바이트 한 줄만 출력되며, 잘렸다는 표시가 없다. 값이 짧아 보여도 실제로는 뒷부분이 생략된 것일 수 있다.

    로그 리더 트레이스 (LR_TRACE_LVL)

    Redo Log 파싱 과정은 LOG_LEVEL 을 올려도 보이지 않는다. 로그 리더는 별도 파라미터 LR_TRACE_LVL 과 별도 트레이스 파일을 사용한다.

    lr<N>/ 디렉터리의 redo_data_*.olr 파일(Tibero 는 *.tlr)은 트레이스가 아니라 미커밋 트랜잭션 스냅샷이다. Extract 재기동 시 이 파일을 읽어 추출을 재개하므로 임의로 삭제하면 안 된다. 자동 삭제 방식은 LR_FILE_DELETE_MODE(SIZE|CNT|RETENTION, 기본값 CNT)가 결정하며, 선택된 모드에 해당하는 파라미터(LR_FILE_TOTAL_SIZE / LR_FILE_CNT / LR_FILE_RETENTION_DAY)만 적용된다. 해당 파라미터의 기본값 0 은 자동 삭제를 하지 않는다.

    Admin 진단 명령

    MONITOR — Apply 지연 분석

    TRACEDUMP — DD·트랜잭션 큐 덤프

    MERGE 는 소스 DB 가 2개 이상일 때만, QUEUE 는 병렬 replay 모드일 때만 내용이 기록된다. 해당 구성이 아니면 내용(큐 항목) 없이 빈 파일 또는 헤더만 있는 파일이 생성되는 것이 정상이다.

    JCDUMP — 구간 성능 통계

    스냅샷 원본 파일은 stat 번호와 16진수 카운터라 직접 읽기 어렵다 — 반드시 JCDUMP COMPARE 로 리포트를 생성한다. 또한 프로세스가 재기동되면 스냅샷 식별자가 바뀌어 재기동 전후의 파일은 비교할 수 없다 (id mismatch 오류).

    ALLOCDUMP — 메모리 사용 분석

    크래시 진단

    ProSync 는 크래시 시 OS core 파일을 만들지 않는다. 자체 시그널 핸들러가 콜스택을 파일로 남기고 문제가 발생한 스레드만 종료하므로 (단, control 스레드에서 크래시가 나면 프로세스 전체가 종료된다), 프로세스가 ps 에 살아 있어도 내부 스레드가 죽어 동기화가 멈춰 있을 수 있다.

    크래시 확인 방법

    콜스택 덤프 파일 (prosync.out)

    프로세스 종료와 시그널

    gdb 분석 (_SLEEP_ON_SIG)

    _SLEEP_ON_SIG=Y 상태에서 크래시가 나면 해당 스레드는 gdb 로 개입하기 전까지 무한 대기한다. SIGSEGV 등 일반 크래시에서는 대기가 콜스택 덤프보다 먼저라 개입 전까지 prosync.out 파일도 생성되지 않는다 (SIGABRT 는 덤프를 먼저 남긴 뒤 대기한다). 상시 운영 환경에는 설정하지 않는다.

    런타임 파라미터 변경 (ALTER ... SET)

    4

    in-memory DD·트랜잭션 큐 덤프

    <inst>_txdep_<PID>_<TID>.dump

    $PRS_HOME/var/<인스턴스ID>/
    ├── log/                  # 프로세스 로그 (ext/apply/llob)
    │   ├── ext_backup/       #   ├ 로그 순환 백업 (프로세스별 분리)
    │   ├── apply_backup/     #   │
    │   └── llob_backup/      #   ┘
    ├── lr<N>/                # Extract 로그 리더 작업 디렉터리 (N = Extract 번호)
    │   ├── *_li.log          #   ├ 로그 리더 트레이스 (Oracle 소스)
    │   ├── tli<N>.log        #   ├ 로그 리더 트레이스 (Tibero 소스)
    │   └── redo_data_*.olr   #   ┘ 미커밋 트랜잭션 스냅샷 (Tibero 는 *.tlr)
    ├── tx/                   # Apply 트랜잭션 체크포인트(txh_*.dat, txl_*.dat)·대형 tx 임시파일(part_*.dat)
    ├── dump/                 # TRACEDUMP 출력
    ├── jcdump/               # JCDUMP 출력
    ├── alloc/                # ALLOCDUMP 출력
    ├── path/                 # Admin 명령 수신용 FIFO (extd001, applyd001, llobd 형식)
    ├── prosync.out.<PID>     # 크래시 시 콜스택 덤프 (크래시가 없으면 존재하지 않음)
    └── .wallet               # DB 접속 비밀번호 지갑 파일 (TDE 사용 시 .wallet_tde 추가)
    [07-21T14:03:22.123456] [REP-12] [W] Failed to update Lowerbound Commit Tsn [prs_apply_replay.c:7912]
     └─ ①                    └─ ②     └─ ③ └─ ④                                  └─ ⑤
    Admin> ALTER <인스턴스ID> EXT SET LR_TRACE_LVL = '5'
    Admin> MONITOR <인스턴스ID>
    
    =========
    Thread #0  Applying... 1523(ms)
    =========
    
    Query:
    UPDATE "OWNER"."TABLE1" SET ...
    
    =========
    Thread #1  Completed
    =========
    
    Query:
    INSERT INTO "OWNER"."TABLE2" ...
    TRACE[DUMP] <inst_id> [DD | MER[GE] | QUE[UE] | DEP[ENDENCY]]
    Admin> JCDUMP <인스턴스ID> APPLY before_load
    Admin> JCDUMP <인스턴스ID> APPLY after_load
    Admin> JCDUMP COMPARE <인스턴스ID> before_load after_load
    Admin> ALLOCDUMP <인스턴스ID> APPLY
    [F] Signal 11 (SIGSEGV) caught (PID = 12345): si_addr = 0x...
    [F] callstack dumped to /prosync/var/tib2tib/prosync.out.12345
    [F] replay thread terminated abnormally.
    *** 2026/07/21 14:03:22.123 ***
        [00] 0x004a1b2c:0x7f... = prs_replay_bind_value + 0x01a4
        [01] 0x004a0f00:0x7f... = ??????
        [02] 0x00401234:0x7f... = start_thread + 0x00d5
    Admin> SHUTDOWN <인스턴스ID> [EXT|APPLY|LLOB] [ABORT]
    ALTER <inst_id> [EXT[RACT] | APP[LY] | LLOB] SET <파라미터> = <값>
    Admin> ALTER <인스턴스ID> APPLY SET LOG_LEVEL = '5'

    CM Failover 기능 사용

    1. Agent 설치

    ProSync Process에 대한 Failover 기능을 CM에서 사용할 경우 각 Node ProSync Ext Process가 Failover로 변경되었을 때, Source DB의 Redo/Archive File을 읽을 수 있는 위치에 있어야 한다.

    prs_install_agent.cfg 예시

    AGENT_CNT=4
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.19.0.11
    AGENT_PORT_0=7600
    AGENT_CM_GROUP_0=CM1
    AGENT_CM_ID_0=0
    
    AGENT_ID_1=agent2
    AGENT_HOST_1=172.19.0.12
    AGENT_PORT_1=7700
    AGENT_CM_GROUP_1=CM1
    AGENT_CM_ID_1=1
    
    AGENT_ID_2=agent3
    AGENT_HOST_2=172.19.0.13
    AGENT_PORT_2=7800
    AGENT_CM_GROUP_2=CM2
    AGENT_CM_ID_2=0
    
    AGENT_ID_3=agent4
    AGENT_HOST_3=172.19.0.14
    AGENT_PORT_3=7900
    AGENT_CM_GROUP_3=CM2
    AGENT_CM_ID_3=1

    agent 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7600
        AGENT_CM_GROUP: CM1
        AGENT_CM_ID: 0
    parameter check for Agent[0] Done 
    parameter check for Agent[1] Started 
        AGENT_ID: agent2
        AGENT_HOST: 172.19.0.12
        AGENT_PORT: 7700
        AGENT_CM_GROUP: CM1
        AGENT_CM_ID: 1
    parameter check for Agent[1] Done 
    parameter check for Agent[2] Started 
        AGENT_ID: agent3
        AGENT_HOST: 172.19.0.13
        AGENT_PORT: 7800
        AGENT_CM_GROUP: CM2
        AGENT_CM_ID: 0
    parameter check for Agent[2] Done 
    parameter check for Agent[3] Started 
        AGENT_ID: agent4
        AGENT_HOST: 172.19.0.14
        AGENT_PORT: 7900
        AGENT_CM_GROUP: CM2
        AGENT_CM_ID: 1
    parameter check for Agent[3] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [4] 
    ********************************************************************************
    * Writing all agents.. cnt: 4
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  CM1
    * Writing Agent.. AGENT_CM_ID:     0
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent1.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           1
    * Writing Agent.. AGENT_ID:        agent2
    * Writing Agent.. AGENT_HOST:      172.19.0.12
    * Writing Agent.. AGENT_PORT:      7700
    * Writing Agent.. AGENT_CM_GROUP:  CM1
    * Writing Agent.. AGENT_CM_ID:     1
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent2.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           2
    * Writing Agent.. AGENT_ID:        agent3
    * Writing Agent.. AGENT_HOST:      172.19.0.13
    * Writing Agent.. AGENT_PORT:      7800
    * Writing Agent.. AGENT_CM_GROUP:  CM2
    * Writing Agent.. AGENT_CM_ID:     0
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent3.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           3
    * Writing Agent.. AGENT_ID:        agent4
    * Writing Agent.. AGENT_HOST:      172.19.0.14
    * Writing Agent.. AGENT_PORT:      7900
    * Writing Agent.. AGENT_CM_GROUP:  CM2
    * Writing Agent.. AGENT_CM_ID:     1
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent4.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    AGENT_CM_ID detected
    generating prs_0.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent1
    prs_0.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_1.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent2
    prs_1.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_0.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent3
    prs_0.sh has created in $PRS_HOME/bin/
    AGENT_CM_ID detected
    generating prs_1.sh...
    PRS_HOME=/home/prosync/example
    AGENT_ID=agent4
    prs_1.sh has created in $PRS_HOME/bin/
    Agent installation Done.
    

    2. CM Failover 스크립트 설정

    이 스크립트 파일에는 Agent 기동을 위한 환경 변수를 설정해야 하며, 반드시 TB_HOME, AGENT_ID 등을 환경에 맞게 수정해야 한다.

    예시: $PRS_HOME/bin/prs_0.sh

    #!/bin/sh
    
    export TB_HOME=/home/tibero/tibero/tibero7   ## TB_HOME 입력
    export PRS_HOME=/home/prosync/example
    AGENT_ID=agent1                              ## agent_id 입력
    TIMEOUT_CNT=7
    source $PRS_HOME/bin/prs_cm.sh
    export logdir=$PRS_HOME/var
    
    echo "`date +%Y/%m/%d\\ %H:%M:%S` cm agent Start (Agent Command $1)" >> $logdir/cmagent.log
    case $1 in
    START)
        echo "start $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        start $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    PROBE)
        echo "probe $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        probe $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    DOWN)
        echo "stop $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        stop $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    KILL)
        echo "stop $TIMEOUT_CNT $AGENT_ID" >> $logdir/cmagent.log
        stop $TIMEOUT_CNT $AGENT_ID
        rc=$?
        ;;
    NOTI)
        rc=0
        ;;
    COMMIT)
        echo "send $TIMEOUT_CNT $AGENT_ID ${@:2}" >> $logdir/cmagent.log
        send $TIMEOUT_CNT $AGENT_ID ${@:2}
        rc=$?
        ;;
    
    *)
        ;;
    esac
    echo "`date +%Y/%m/%d\\ %H:%M:%S` cm agent End  (Agent Command $1)" >> $logdir/cmagent.log
    
    
    exit $rc

    참고

    script 내의 source 명령어는 POSIX 표준 sh에서는 존재하지 않는다.

    만약 CM에서 해당 스크립트를 실행하는데 권한에 문제가 없는데도 127 에러가 발생한다면, /bin/sh를 /bin/bash로 변경하면 해결된다.


    3. Agent Parameter 설정

    CM Failover 기능을 사용하기 위해 prs_agent_<agent_id>.cfg 파일에 다음과 같은 파라미터를 설정한다.

    파라미터
    설명

    예시 : $PRS_HOME/config/prs_agent_agent1.cfg



    $TB_HOME/config 예시

    <$CM_SID>.tip file들을 열어 맨 윗줄에 CM_ID를 추가해준다. CM_ID는 agent 설치 시 prs_install_agent.cfg에 작성한 내용을 기반으로 추가한다.

    cm_tibero1.tip 예시

    cm info 예시


    agent 설치 시, prs_install_agent.cfg에 작성한 내용을 기반으로 CM group을 추가한다.

    Key
    Value Type
    설명

    등록에 성공하면 다음과 같은 문구가 나온다.


    Key
    Value Type
    설명

    아래 cmrctl show all 예시는 스크립트를 $TB_HOME 으로 복사해 등록한 환경의 출력이다.

    등록에 성공하면 다음과 같은 문구가 나온다.

    CM을 확인해보면 다음과 같이 group과 agent가 등록된 info를 확인할 수 있다.

    cm info 예시

    CM을 통해 ProSync를 기동하고 Failover 기능을 사용하기 위해 CM group을 기동시킨다.

    결과 예시


    Admin process를 통해 ProSync의 기동을 확인한다.

    CM Failover 기능을 사용하는 경우 $PRS_HOME/var에 CM을 통해 agent를 기동한 로그 파일들이 생긴다.

    • cmagent.log

    • prs_cm_<$agent_id>.log

    • prs_cm_sh_err_<$agent_id>.log

    USE_CM

    CM 사용 여부를 설정한다. Y로 설정할 경우 하위 프로세스의 상태를 모니터링하고, 장애 발생 시 재기동을 수행한다. 내부 장애 발생 시 cmrctl을 통해 정지 요청을 수행한다. (기본값: N)

    PRS_AGENT_PROC_MAX_FAIL_CNT

    하위 프로세스 장애 발생 시 상태를 보정하기 위해 재시도하는 최대 횟수를 설정한다. (기본값: 5)

    PRS_AGENT_PROC_STARTUP_TIMEOUT

    프로세스 기동 요청 이후 정상적으로 처리되기까지 대기하는 최대 시간(초)을 설정한다. 기동 요청이 정상 처리되지 않을 경우, 설정한 시간만큼 대기한 후 재시도한다. (기본값: 10)

    PRS_AGENT_PROC_STATUS_REPLY_TIMEOUT

    하위 프로세스로부터 응답이 없을 경우 대기하는 최대 시간(초)을 설정한다. 초과 시 해당 프로세스에 hang이 발생한 것으로 판단하고 재기동을 수행한다.

    PRS_AGENT_PROC_STATUS_INTERVAL

    Agent 프로세스가 CM에게 cmrctl check 명령을 보내는 주기를 설정한다.

    PRS_AGENT_CM_PROBE_TIMEOUT

    CM 상태 확인 시 대기하는 최대 시간(초)을 설정한다. 0으로 설정할 경우 cmrctl 응답을 무한히 대기한다. 설정값을 초과할 경우 CM hang으로 판단하여 Agent 및 하위 프로세스를 정리한다. (기본값: 0) ※ 표준 출력을 우회하여 응답을 수신하므로, 응답 지연이 우려될 경우 0으로 설정한다.

    cd $PRS_HOME/config
    vi prs_agent_agent1.cfg
    ################################################################################
    # 
    # ProSync Agent Configurations (Template)
    #
    ################################################################################                                      
    
    #-------------------------------------------------------------------------------
    # LOG
    #-------------------------------------------------------------------------------
    LOG_LEVEL = 3
    LOG_DIR = /home/prosync/example/var/agent/agent1/log                  
    LOG_BACKUP_DIR = /home/prosync/example/var/agent/agent1/log/backup         
    #-------------------------------------------------------------------------------
    # CM
    #-------------------------------------------------------------------------------
    USE_CM = Y
    PRS_AGENT_PROC_MAX_FAIL_CNT = 10		#Dependency Param : USE_CM=Y
    PRS_AGENT_PROC_STARTUP_TIMEOUT = 10	        #Dependency Param : USE_CM=Y
    PRS_AGENT_PROC_STATUS_REPLY_TIMEOUT = 10	#Dependency Param : USE_CM=Y
    PRS_AGENT_PROC_STATUS_INTERVAL = 3		#Dependency Param : USE_CM=Y
    PRS_AGENT_CM_PROBE_TIMEOUT = 0			#Dependency Param : USE_CM=Y
    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=TAC2TAC
    PRS_USER=TAC2TAC
    PRS_PWD=TAC2TAC
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=2
    EXT_AGENT_ID_LIST_0=agent1,agent2
    EXT_AGENT_ID_LIST_1=agent2,agent1
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent3,agent4
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1,agent2
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    SRC_DB_CNT=2
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    SRC_DB_ALIAS_0=tibero1
    SRC_DB_ALIAS_1=tibero2
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tibero_tar
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    TAR_DB_CNT=2
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N
    
    $ cd $PRS_HOME/install
    $ ./prs_install.sh
    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... not available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * instance information for TAC2TAC was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 2
    * Delimiter: [,]
       * Ext[0] process's Agent Id List 
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
       * Ext[1] process's Agent Id List 
           * Agent ID[agent2]
           * [agent2] found.
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent3]
           * [agent3] found.
           * Agent ID[agent4]
           * [agent4] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
    
    Checking INSTANCE_ID... TAC2TAC
    Checking PRS_USER... TAC2TAC
    Checking PRS_TS_NAME... TAC2TAC_ts
    Checking PRS_TS_FILE... TAC2TAC_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 2
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tibero_tar
    Checking target connection [tibero_tar](1/2)... ok
    Checking target connection [tibero_tar](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [tibero1]... ok
    Checking log mining parameters [tibero2]... ok
    Get Archive log directory [tibero1]... ok
    Get Archive log format [tibero1]... ok
    Get Archive log directory [tibero2]... ok
    Get Archive log format [tibero2]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user TAC2TAC to uppercase TAC2TAC... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 4, and one for prosync
      "TAC2TAC"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      TAC2TAC.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 4
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile [tibero1]... ok
    Switching logfile [tibero2]... ok
    Querying current log sequence [tibero1]... 8
    Querying current log sequence [tibero2]... 8
    Querying current snapshot#... 93289
    
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE TAC2TAC_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [tibero1 (group 1)]... ok
    Generating initial construct history [tibero2 (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [tibero1] configuration...  ok
    Generating Extract [tibero2] configuration...  ok
    Generating Apply [tibero_tar] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    
    ********************************************************************************
    * ProSync is installed successfully on Fri, 18 Apr 2025 02:01:32 +0000.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = TAC2TAC
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Initial change# (TSN) = 94003 
    *
    ********************************************************************************
    $ tbdown
    $ tbcm -d
    $ cd $TB_HOME/config
    total 156
    drwxr-xr-x  2 tibero tibero  4096 Apr 21 05:54 ./
    drwxr-xr-x 13 tibero tibero  4096 Apr 17 10:19 ../
    -rw-r--r--  1 tibero tibero    72 Apr  1  2024 .gitignore
    -rw-r--r--  1 tibero tibero   474 Apr  1  2024 cm.template
    -rw-r--r--  1 tibero tibero   691 Apr 17 10:19 cm_tibero1.tip
    -rw-r--r--  1 tibero tibero   691 Apr 17 10:19 cm_tibero2.tip
    -rw-r--r--  1 tibero tibero   810 Apr  1  2024 common_tip.template
    -rwxr-xr-x  1 tibero tibero   982 Apr  1  2024 gen_QMS_store_dsn_for_sampler.sh*
    -rwxr-xr-x  1 tibero tibero  4433 Apr  1  2024 gen_psm_cmd.sh*
    -rwxr-xr-x  1 tibero tibero  4886 Apr  1  2024 gen_tip.sh*
    -rwxr-xr-x  1 tibero tibero  5938 Apr  1  2024 gen_tip_for_ssvr.sh*
    -rwxr-xr-x  1 tibero tibero 11797 Apr  1  2024 gen_tip_for_tac.sh*
    -rwxr-xr-x  1 tibero tibero 15732 Apr  1  2024 gen_tip_for_zeta.sh*
    -rw-r--r--  1 tibero tibero  1796 Apr  1  2024 ilog.map.example
    -rwxr-xr-x  1 tibero tibero  1628 Apr 17 10:19 psm_commands*
    -rw-r--r--  1 tibero tibero   567 Apr  1  2024 sampler.ssa.template
    -rw-r--r--  1 tibero tibero   488 Apr  1  2024 sampler.template
    -rw-r--r--  1 tibero tibero   434 Apr  1  2024 ssvr.template
    -rw-r--r--  1 tibero tibero   730 Apr  1  2024 tac.template
    -rw-r--r--  1 tibero tibero   572 Apr  1  2024 tas.template
    -rw-r--r--  1 tibero tibero   489 Apr  1  2024 tibero.template
    -rw-r--r--  1 tibero tibero   936 Apr 21 05:54 tibero1.tip
    -rw-r--r--  1 tibero tibero   936 Apr 21 05:54 tibero2.tip
    -rw-r--r--  1 tibero tibero   693 Apr  1  2024 tibero_dev.template
    -rw-r--r--  1 tibero tibero   344 Apr  1  2024 tibero_max.template
    -rw-r--r--  1 tibero tibero   582 Apr  1  2024 tip.ssa.template
    -rw-r--r--  1 tibero tibero   525 Apr  1  2024 tip.template
    -rw-r--r--  1 tibero tibero   689 Apr  1  2024 tip_dev.template
    -rw-r--r--  1 tibero tibero   528 Apr  1  2024 tip_jenkins.template
    -rw-r--r--  1 tibero tibero   340 Apr  1  2024 tip_max.template
    -rw-r--r--  1 tibero tibero     5 Apr  1  2024 variant
    
    # tip file generated from /home/tibero/tibero/tibero7/config/cm.template (Thu Apr 17 10:19:44 UTC 2025)
    #-------------------------------------------------------------------------------
    #
    # Cluster Manager initialization parameter
    #
    #-------------------------------------------------------------------------------
    CM_ID=0 # 여기에 CM_ID를 추가한다.
    CM_NAME=cm_tibero1
    CM_UI_PORT=8645
    CM_RESOURCE_FILE=/home/tibero/tibero/tibero7/cmfile/tibero/cm_tibero1.res
    
    CM_LOG_DEST=/home/tibero/tibero/tibero7/instance/tibero1/log/cm
    CM_GUARD_LOG_DEST=/home/tibero/tibero/tibero7/instance/tibero1/log/cm/guard
    
    #CM_HEARTBEAT_EXPIRE
    #CM_WATCHDOG_EXPIRE
    #LOG_LVL_CM
    
    #CM_ENABLE_FAST_NET_ERROR_DETECTION=Y
    #CM_FENCE=Y
    #_CM_CHECK_RUNLEVEL=Y
    
    tbcm -b
    tbboot
    cmrctl show all
    Resource List of Node cm_tibero1
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc1       UP (private) 172.19.0.11/8640
         COMMON  cluster     cls_tibero       UP inc: inc1, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero1 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
    =====================================================================
    Resource List of Node cm_tibero2
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc2       UP (private) 172.19.0.12/8670
         COMMON  cluster     cls_tibero       UP inc: inc2, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero2 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
    =====================================================================
    
    cmrctl add group --name <group_name> --cname <cluster_name> 
    --grptype <type> --failover <true|false>

    name

    string

    그룹 리소스 이름이다. (unique, 필수)

    cname

    string

    해당 그룹 리소스가 속할 cluster 리소스 이름이다. (필수)

    grptype

    string

    그룹의 종류. prosync의 경우 instance의 agent 이기 때문에 "prs_agent "로 등록해야 한다.

    cmrctl add group --name CM1 --cname cls_tibero --grptype prs_agent
    $ Resource add success! (group, CM1)
    cmrctl add agent --name <agent_name> --grpname <group_name> --script <directory_path>
    --pubnet <public_network_resource_name> --retry_cnt <retry_cnt>

    name

    string

    agent 리소스 이름이다. (unique, 필수)

    grpname

    string

    agent 리소스가 속할 그룹 리소스 이름이다 (필수)

    script

    string(file path)

    agent cmd를 실행시킬 script 파일의 절대경로이다 (필수)

    cmrctl add agent --name agent1 --grpname CM1 --script "$PRS_HOME/bin/prs_0.sh"
    $ Resource add success! (agent, agent1)
    cmrctl show all
    Resource List of Node cm_tibero1
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc1       UP (private) 172.19.0.11/8640
         COMMON  cluster     cls_tibero       UP inc: inc1, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero1 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
     cls_tibero    group            CM1     DOWN type: prosync (failover: ON)
     cls_tibero    agent         agent1     DOWN /home/tibero/tibero/tibero7/prs_0.sh, start retry cnt: 0
    =====================================================================
    Resource List of Node cm_tibero2
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc2       UP (private) 172.19.0.12/8670
         COMMON  cluster     cls_tibero       UP inc: inc2, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero2 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
     cls_tibero    group            CM1     DOWN type: prosync (failover: ON)
     cls_tibero    agent         agent2     DOWN /home/tibero/tibero/tibero7/prs_1.sh, start retry cnt: 0
    =====================================================================
    
    cmrctl start group --name CM1
    =================================== SUCCESS! ===================================
     Succeeded to request at each node to boot resources under the group(CM1).
     Please use "cmrctl show group --name CM1" to verify the result.
    ================================================================================
    Resource List of Node cm_tibero1
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc1       UP (private) 172.19.0.11/8640
         COMMON  cluster     cls_tibero       UP inc: inc1, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero1 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
     cls_tibero    group            CM1       UP type: prosync (failover: ON)
     cls_tibero    agent         agent1       UP /home/tibero/tibero/tibero7/prs_0.sh, start retry cnt: 0
    =====================================================================
    Resource List of Node cm_tibero2
    =====================================================================
      CLUSTER     TYPE        NAME       STATUS           DETAIL         
    ----------- -------- -------------- -------- ------------------------
         COMMON  network           inc2       UP (private) 172.19.0.12/8670
         COMMON  cluster     cls_tibero       UP inc: inc2, pub: N/A
     cls_tibero     file   cls_tibero:0       UP /home/tibero/tibero/tibero7/cmfile/tibero/cmdata
     cls_tibero  service         tibero       UP Database, Active Cluster (auto-restart: OFF)
     cls_tibero       db        tibero2 UP(NRML) tibero, /home/tibero/tibero/tibero7, failed retry cnt: 0
     cls_tibero    group            CM1       UP type: prosync (failover: ON)
     cls_tibero    agent         agent2       UP /home/tibero/tibero/tibero7/prs_1.sh, start retry cnt: 0
    =====================================================================
    
    $ prs_adm
    
    ProSync 4 - Admin Utility
    
    TmaxData Corporation Copyright (c) 2024-. All rights reserved.
    
    Admin> status
    
    prs_agent ID: agent1, HOST: 172.19.0.11, PORT: 7600, CM_GROUP: CM1, CM_ID: 0 is running
    prs_agent ID: agent2, HOST: 172.19.0.12, PORT: 7700, CM_GROUP: CM1, CM_ID: 1 is running
    prs_agent ID: agent3, HOST: 172.19.0.13, PORT: 7800, CM_GROUP: CM2, CM_ID: 0 is running
    prs_agent ID: agent4, HOST: 172.19.0.14, PORT: 7900, CM_GROUP: CM2, CM_ID: 1 is running
    
    
    Instance ID: [TAC2TAC]
    prosync_ext1 (1) is running (prs_agent ID : agent1, HOST: 172.19.0.11, PORT: 7600)
    prosync_ext2 (2) is running (prs_agent ID : agent2, HOST: 172.19.0.12, PORT: 7700)
    prosync_apply1 is running (prs_agent ID : agent3, HOST: 172.19.0.13, PORT: 7800)
    prosync_llob (1) is running (prs_agent ID : agent1, HOST: 172.19.0.11, PORT: 7600)
    

    참고

    USE_CM을 Y로 설정한 경우에만 PRS_AGENT_PROC_MAX_FAIL_CNT, PRS_AGENT_PROC_STARTUP_TIMEOUT, PRS_AGENT_PROC_STATUS_REPLY_TIMEOUT, PRS_AGENT_PROC_STATUS_INTERVAL, PRS_AGENT_CM_PROBE_TIMEOUT 파라미터가 동작한다.

    agent config file 설정 예시

    4. Instance 설치

    prs_install.cfg 설정 예시

    instance 설치 및 설치 결과 예시

    5. CM 설정

    5.1. tibero 기동 종료

    5.2. cm 기동 종료

    5.3. cm tip file에 cm_id 추가

    5.4. cm 기동

    5.5. tibero 기동

    5.6. cm 확인

    5.7. CM group 등록

    예시

    5.8. CM agent 등록

    예시

    주의

    prs_0.sh 파일은 기본적으로 $PRS_HOME/bin에 위치하고 있다.

    cm에서 해당 파일을 실행할 수 있는 권한이 있어야 한다.

    5.9. CM group 기동

    6. Prosync 기동 확인

    failover

    string

    agent가 종료되었을 때 failover 기능 사용 여부이다. (default: true)

    pubnet

    string

    public 용도로 사용할 네트워크 리소스 이름이다. dependency를 추가하려면 입력해야 한다.

    retry_cnt

    integer

    최대 retry 시도 횟수이다. (default: 3)

    Cluster to Cluster (TAC예시)

    SRC DB와 TAR DB가 서로 같은 장비에 설치된 경우

    1. Agent 설치

    prs_install_agent.cfg 예시

    AGENT_CNT=4
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.19.0.11
    AGENT_PORT_0=7600
    
    AGENT_ID_1=agent2
    AGENT_HOST_1=172.19.0.11
    AGENT_PORT_1=7700
    
    AGENT_ID_2=agent3
    AGENT_HOST_2=172.19.0.11
    AGENT_PORT_2=7800
    
    AGENT_ID_3=agent4
    AGENT_HOST_3=172.19.0.11
    AGENT_PORT_3=7900

    agent 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7600
    parameter check for Agent[0] Done 
    parameter check for Agent[1] Started 
        AGENT_ID: agent2
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7700
    parameter check for Agent[1] Done 
    parameter check for Agent[2] Started 
        AGENT_ID: agent3
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7800
    parameter check for Agent[2] Done 
    parameter check for Agent[3] Started 
        AGENT_ID: agent4
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7900
    parameter check for Agent[3] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [4] 
    ********************************************************************************
    * Writing all agents.. cnt: 4
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    File already exists... 
    [/home/prosync/example/config/prs_agent_agent1.cfg]
    Want to Delete ? (Y/N)
    n
    Skip deleteing...
    
    * Writing Agent information... 
    Agent information already exist
    Want to Replace ? (Y/N)
    n
    Skipped... 
    
    
    * Writing Agent.. Index:           1
    * Writing Agent.. AGENT_ID:        agent2
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7700
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent2.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           2
    * Writing Agent.. AGENT_ID:        agent3
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7800
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent3.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           3
    * Writing Agent.. AGENT_ID:        agent4
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7900
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent4.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    There's no AGENT_CM_ID, finishing installation
    Agent installation Done.

    2. Instance 설치

    prs_install.cfg 설정 예시

    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=TAC2TAC
    PRS_USER=TAC2TAC
    PRS_PWD=TAC2TAC
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=2
    EXT_AGENT_ID_LIST_0=agent1,agent2
    EXT_AGENT_ID_LIST_1=agent2,agent1
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent3
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1,agent2
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    SRC_DB_CNT=2
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    SRC_DB_ALIAS_0=tibero1
    SRC_DB_ALIAS_1=tibero2
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tibero_tar
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    TAR_DB_CNT=2
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N
    

    instance 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install.sh

    아래 출력은 다른 설정으로 수행한 설치의 예시이므로, 인스턴스명·사용자·Agent 배치 등 일부 값이 위 설정 파일과 다를 수 있다.

    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... not available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * instance information for TAC2TAC was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 2
    * Delimiter: [,]
       * Ext[0] process's Agent Id List 
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
       * Ext[1] process's Agent Id List 
           * Agent ID[agent2]
           * [agent2] found.
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent3]
           * [agent3] found.
           * Agent ID[agent4]
           * [agent4] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
    
    Checking INSTANCE_ID... TAC2TAC
    Checking PRS_USER... TAC2TAC
    Checking PRS_TS_NAME... TAC2TAC_ts
    Checking PRS_TS_FILE... TAC2TAC_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 2
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tibero_tar
    Checking target connection [tibero_tar](1/2)... ok
    Checking target connection [tibero_tar](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [tibero1]... ok
    Checking log mining parameters [tibero2]... ok
    Get Archive log directory [tibero1]... ok
    Get Archive log format [tibero1]... ok
    Get Archive log directory [tibero2]... ok
    Get Archive log format [tibero2]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user TAC2TAC to uppercase TAC2TAC... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 4, and one for prosync
      "TAC2TAC"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      TAC2TAC.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 4
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile [tibero1]... ok
    Switching logfile [tibero2]... ok
    Querying current log sequence [tibero1]... 8
    Querying current log sequence [tibero2]... 8
    Querying current snapshot#... 93289
    
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE TAC2TAC_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [tibero1 (group 1)]... ok
    Generating initial construct history [tibero2 (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [tibero1] configuration...  ok
    Generating Extract [tibero2] configuration...  ok
    Generating Apply [tibero_tar] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    
    ********************************************************************************
    * ProSync is installed successfully on Fri, 18 Apr 2025 02:01:32 +0000.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = TAC2TAC
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Initial change# (TSN) = 94003 
    *
    ********************************************************************************
    
    

    3. Prosync 실행

    실행 절차는 ProSync 실행 문서를 참고한다.


    SRC DB와 TAR DB가 서로 다른 장비에 설치된 경우

    1. Agent 설치

    SRC DB가 설치된 장비에서 Agent를 설치한다.

    prs_install_agent.cfg 예시

    AGENT_CNT=4
    
    AGENT_ID_0=agent1
    AGENT_HOST_0=172.19.0.11
    AGENT_PORT_0=7600
    
    AGENT_ID_1=agent2
    AGENT_HOST_1=172.19.0.12
    AGENT_PORT_1=7700
    
    AGENT_ID_2=agent3
    AGENT_HOST_2=172.19.0.13
    AGENT_PORT_2=7800
    
    AGENT_ID_3=agent4
    AGENT_HOST_3=172.19.0.14
    AGENT_PORT_3=7900

    agent 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install_agent.sh
    ********************************************************************************
    * Agent Install Step (1/4)
    * Check System Parameters 
    ********************************************************************************
    * Checking system type... 
    Linux
    
    * Checking PRS_HOME... 
    PRS_HOME: /home/prosync/example
    
    ********************************************************************************
    * Agent Install Step (2/4)
    * Check install agent config file   [prs_install_agent.cfg]  
    * Check Instance file               [prs_instance.map] 
    ********************************************************************************
    * Checking configuration file... 
    [/home/prosync/example/install/prs_install_agent.cfg] exists.
    
    * Checking Agent configuration... 
    parameter check for Agent[0] Started 
        AGENT_ID: agent1
        AGENT_HOST: 172.19.0.11
        AGENT_PORT: 7600
    parameter check for Agent[0] Done 
    parameter check for Agent[1] Started 
        AGENT_ID: agent2
        AGENT_HOST: 172.19.0.12
        AGENT_PORT: 7700
    parameter check for Agent[1] Done 
    parameter check for Agent[2] Started 
        AGENT_ID: agent3
        AGENT_HOST: 172.19.0.13
        AGENT_PORT: 7800
    parameter check for Agent[2] Done 
    parameter check for Agent[3] Started 
        AGENT_ID: agent4
        AGENT_HOST: 172.19.0.14
        AGENT_PORT: 7900
    parameter check for Agent[3] Done 
    
    * Checking prs_instance.map file... 
    [/home/prosync/example/config/prs_instance.map] exists.
    
    ********************************************************************************
    * Agent Install Step (3/4)
    * Writing agent config file         [/home/prosync/example/install/prs_install_agent.cfg]  
    * Writing Instance file             [/home/prosync/example/config/prs_instance.map] 
    * Total Agent Cnt                   [4] 
    ********************************************************************************
    * Writing all agents.. cnt: 4
    * Writing Agent.. Index:           0
    * Writing Agent.. AGENT_ID:        agent1
    * Writing Agent.. AGENT_HOST:      172.19.0.11
    * Writing Agent.. AGENT_PORT:      7600
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    File already exists... 
    [/home/prosync/example/config/prs_agent_agent1.cfg]
    Want to Delete ? (Y/N)
    n
    Skip deleteing...
    
    * Writing Agent information... 
    Agent information already exist
    Want to Replace ? (Y/N)
    n
    Skipped... 
    
    
    * Writing Agent.. Index:           1
    * Writing Agent.. AGENT_ID:        agent2
    * Writing Agent.. AGENT_HOST:      172.19.0.12
    * Writing Agent.. AGENT_PORT:      7700
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent2.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           2
    * Writing Agent.. AGENT_ID:        agent3
    * Writing Agent.. AGENT_HOST:      172.19.0.13
    * Writing Agent.. AGENT_PORT:      7800
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent3.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Writing Agent.. Index:           3
    * Writing Agent.. AGENT_ID:        agent4
    * Writing Agent.. AGENT_HOST:      172.19.0.14
    * Writing Agent.. AGENT_PORT:      7900
    * Writing Agent.. AGENT_CM_GROUP:  
    * Writing Agent.. AGENT_CM_ID:     
    * Writing Agent configuration... 
    /home/prosync/example/config/prs_agent_agent4.cfg not found. Writing files...
    Done.
    
    * Writing Agent information... 
    
    
    * Creating var directory...
       * Already Created.
    ********************************************************************************
    * Agent Install Step (4/4)
    * Creating files for CM
    ********************************************************************************
    There's no AGENT_CM_ID, finishing installation
    Agent installation Done.

    2. tbdsn.tbr 설정

    SRC DB 장비에서 TAR DB Client 접근을 위한 tbdsn.tbr 설정으로, src db 장비에서 instance를 설치하기 위해서 src db 장비에서 tar db client에 접근할 수 있어야 한다. 이를 위해 src db 장비의 tbdsn.tbr 파일에 tar db 정보를 추가해야 한다.

    TAR DB tbdsn.tbr 파일 예시

    #-------------------------------------------------
    # /home/tibero_tar/tibero/tibero7/client/config/tbdsn.tbr
    # Network Configuration File.
    # Generated by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    
    tibero_tar1=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8620)
                  (DB_NAME=tibero_tar)
        )
    )
    tibero_tar1priv=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8621)
                  (DB_NAME=tibero_tar)
        )
    )
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    
    tibero_tar2=(
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8650)
                  (DB_NAME=tibero_tar)
        )
    )
    tibero_tar2priv=(
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8651)
                  (DB_NAME=tibero_tar)
        )
    )
    
    tibero_tar=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8620)
                  (DB_NAME=tibero_tar)
        )
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8650)
                  (DB_NAME=tibero_tar)
        )
        #(LOAD_BALANCE=Y)
    )
    

    SRC DB 장비에 TAR DB 정보를 반영한 tbdsn.tbr 예시

    #-------------------------------------------------
    # /home/tibero/tibero/tibero7/client/config/tbdsn.tbr
    # Network Configuration File.
    # Generated by gen_tip_for_tac.sh at Thu Apr 17 10:19:44 UTC 2025
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:19:44 UTC 2025
    
    tibero1=(
        (INSTANCE=(HOST=172.19.0.11)
                  (PORT=8620)
                  (DB_NAME=tibero)
        )
    )
    tibero1priv=(
        (INSTANCE=(HOST=172.19.0.11)
                  (PORT=8621)
                  (DB_NAME=tibero)
        )
    )
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:19:44 UTC 2025
    
    tibero2=(
        (INSTANCE=(HOST=172.19.0.12)
                  (PORT=8650)
                  (DB_NAME=tibero)
        )
    )
    tibero2priv=(
        (INSTANCE=(HOST=172.19.0.12)
                  (PORT=8651)
                  (DB_NAME=tibero)
        )
    )
    
    tibero=(
        (INSTANCE=(HOST=172.19.0.11)
                  (PORT=8620)
                  (DB_NAME=tibero)
        )
        (INSTANCE=(HOST=172.19.0.12)
                  (PORT=8650)
                  (DB_NAME=tibero)
        )
        #(LOAD_BALANCE=Y)
    )
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    
    tibero_tar1=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8620)
                  (DB_NAME=tibero_tar)
        )
    )
    tibero_tar1priv=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8621)
                  (DB_NAME=tibero_tar)
        )
    )
    
    #-------------------------------------------------
    # Appended by gen_tip_for_tac.sh at Thu Apr 17 10:51:54 UTC 2025
    
    tibero_tar2=(
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8650)
                  (DB_NAME=tibero_tar)
        )
    )
    tibero_tar2priv=(
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8651)
                  (DB_NAME=tibero_tar)
        )
    )
    
    tibero_tar=(
        (INSTANCE=(HOST=172.19.0.13)
                  (PORT=8620)
                  (DB_NAME=tibero_tar)
        )
        (INSTANCE=(HOST=172.19.0.14)
                  (PORT=8650)
                  (DB_NAME=tibero_tar)
        )
        #(LOAD_BALANCE=Y)
    )            

    SRC DB 장비에서 TAR DB client에 접근할 수 있는지 확인

    $ tbsql sys/tibero@tibero_tar1

    접근 확인 예시

    tbSQL 7  
    
    TmaxTibero Corporation Copyright (c) 2020-. All rights reserved.
    
    Connected to Tibero using tibero_tar1.
    
    SQL> 

    3. Instance 설치

    SRC DB가 설치된 장비에서 Instance를 설치한다.

    prs_install.cfg 설정 예시

    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=TAC2TAC
    PRS_USER=TAC2TAC
    PRS_PWD=TAC2TAC
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=2
    EXT_AGENT_ID_LIST_0=agent1,agent2
    EXT_AGENT_ID_LIST_1=agent2,agent1
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent3
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1,agent2
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    SRC_DB_CNT=2
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    SRC_DB_ALIAS_0=tibero1
    SRC_DB_ALIAS_1=tibero2
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tibero_tar
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    TAR_DB_CNT=2
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N

    instance 설치 및 설치 결과 예시

    $ cd $PRS_HOME/install
    $ ./prs_install.sh

    아래 출력은 다른 설정으로 수행한 설치의 예시이므로, 인스턴스명·사용자·Agent 배치 등 일부 값이 위 설정 파일과 다를 수 있다.

    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... not available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * instance information for TAC2TAC was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 2
    * Delimiter: [,]
       * Ext[0] process's Agent Id List 
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
       * Ext[1] process's Agent Id List 
           * Agent ID[agent2]
           * [agent2] found.
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent3]
           * [agent3] found.
           * Agent ID[agent4]
           * [agent4] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
           * Agent ID[agent2]
           * [agent2] found.
    
    Checking INSTANCE_ID... TAC2TAC
    Checking PRS_USER... TAC2TAC
    Checking PRS_TS_NAME... TAC2TAC_ts
    Checking PRS_TS_FILE... TAC2TAC_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 2
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tibero_tar
    Checking target connection [tibero_tar](1/2)... ok
    Checking target connection [tibero_tar](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [tibero1]... ok
    Checking log mining parameters [tibero2]... ok
    Get Archive log directory [tibero1]... ok
    Get Archive log format [tibero1]... ok
    Get Archive log directory [tibero2]... ok
    Get Archive log format [tibero2]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user TAC2TAC to uppercase TAC2TAC... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 4, and one for prosync
      "TAC2TAC"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      TAC2TAC.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 4
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile [tibero1]... ok
    Switching logfile [tibero2]... ok
    Querying current log sequence [tibero1]... 8
    Querying current log sequence [tibero2]... 8
    Querying current snapshot#... 93289
    
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE TAC2TAC_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [tibero1 (group 1)]... ok
    Generating initial construct history [tibero2 (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [tibero1] configuration...  ok
    Generating Extract [tibero2] configuration...  ok
    Generating Apply [tibero_tar] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    
    ********************************************************************************
    * ProSync is installed successfully on Fri, 18 Apr 2025 02:01:32 +0000.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = TAC2TAC
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Archived Log Path     = /home/tibero/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 9
    *
    *   Initial change# (TSN) = 94003 
    *
    ********************************************************************************
    
    

    4. 설치 파일 및 디렉토리 이동

    TAR DB 장비 Prosync 디렉토리에 설치 파일 및 디렉토리를 옮긴다. ProSync는 SRC DB 장비에서만 설치되었기 때문에, TAR DB 장비에서도 ProSync를 기동하려면 SRC DB 장비에서 설치 후 생성된 파일 및 디렉토리를 TAR DB 장비로 복사해야 한다.

    주의

    설치 시 생성된 설정 파일들(*.cfg)에는 SRC DB 장비 기준의 경로가 포함되어 있으므로, TAR DB 장비로 복사한 후에는 경로를 TAR DB 장비 기준으로 수정해야 한다.

    복사 필요한 파일 및 디렉토리

    $PRS_HOME/config

    • prs_adm.cfg

    • <instance_id>_apply1.cfg

    • prs_agent_<agent_id>.cfg

    • prs_instance.map

    $PRS_HOME/var

    옮긴 파일 예시

    실행 절차는 문서를 참고한다.

    ProSync 실행

    5. Prosync 실행

    total 36
    drwxr-xr-x 3 tibero tibero 4096 Apr 18 02:15 ./
    drwxr-xr-x 8 tibero tibero 4096 Apr 18 02:24 ../
    -rw-r--r-- 1 tibero tibero  534 Apr 18 02:15 TAC2TAC_apply1.cfg
    -rw-r--r-- 1 tibero tibero  339 Apr 18 02:15 prs_adm.cfg
    -rw-r--r-- 1 tibero tibero  353 Apr 18 02:15 prs_agent_agent3.cfg
    -rw-r--r-- 1 tibero tibero  353 Apr 18 02:15 prs_agent_agent4.cfg
    -rw-r--r-- 1 tibero tibero 1262 Apr 18 02:07 prs_instance.map
    drwxr-xr-x 2 tibero tibero 4096 Apr 17 10:51 templates/
    -rw-r--r-- 1 tibero tibero    5 Feb  5 04:59 variant
    # var directory tree 예시
    .
    ├── admin
    │   └── log
    ├── agent
    │   ├── agent1
    │   └── agent2
    └── TAC2TAC
        ├── alloc
        ├── log
        ├── lr1
        ├── path
        └── sam
    

    Instance 설치

    $ cd $PRS_HOME/install
    $ ./prs_install.sh [option] [config file] [list file]
    $ cd $PRS_HOME/install
    $ ./prs_install.sh

    계정별 필요 권한

    ProSync 설치를 위해서는 아래 세 가지 계정 정보가 필요하다.

    • PRS_USER

    • SRC_INSTALL_USER

    • TAR_INSTALL_USER

    참고

    DB가 Oracle 이면서 CDB에서 설치하는 경우, 공통 권한이 필요하다 (예: GRANT CONNECT TO INSTALL_USER CONTAINER=ALL;).

    Log Miner를 사용하여 Source Oracle 추출하는 경우, SRC_INSTALL_USER는 sys 계정으로 설정해야 한다.

    PRS_USER

    ProSync가 내부적으로 운영에 사용하는 테이블들을 관리하기 위한 계정이다. Source DB와 Target DB 모두에 생성하며, 운영 시 사용된다.

    Source DB가 Tibero인 경우

    CONNECT                   RESOURCE                     ALTER SYSTEM
    CREATE TABLE              ALTER ANY TABLE              DROP ANY TABLE
    FLASHBACK ANY TABLE       SELECT ANY TABLE             LOCK ANY TABLE
    SELECT ON V$DATABASE      SELECT ON V$INSTANCE         SELECT ANY DICTIONARY
    EXECUTE ON SYS.SEAF

    Source DB가 Oracle인 경우

    CONNECT                       RESOURCE                        ALTER SYSTEM
    CREATE TABLE                  ALTER ANY TABLE                 DROP ANY TABLE
    FLASHBACK ANY TABLE           SELECT ANY TABLE                LOCK ANY TABLE
    ADMINISTER DATABASE TRIGGER   SELECT ANY DICTIONARY           EXECUTE ON SYS.DBMS_AQADM
    EXECUTE ON SYS.DBMS_AQ        EXECUTE ON SYS.DBMS_AQIN        AQ_ADMINISTRATOR_ROLE
    SELECT ON SYS.USER$           EXECUTE ON SYS.DBMS_AQADM_SYS
    SELECT ANY TRANSACTION        SELECT  ON SYS.ENC$             SELECT ON SYS.OBJ$
    
    # (12c 이상)
    LOGMINING                     CREATE ANY DIRECTORY
    READ, WRITE ON DIRECTORY PRS_DICT_$INSTANCE_ID
    
    # 권한 외 필요한 사전 설정
    ALTER USER PRS_USER QUOTA UNLIMITED ON PRS_TS_NAME
    CREATE OR REPLACE DIRECTORY PRS_DICT AS DICT_FILE_DIR

    Target DB가 Tibero 또는 Oracle이고 DML 동기화만 사용하는 경우

    CREATE SESSION           ALTER SESSION
    CREATE TABLE             CREATE SEQUENCE            CREATE VIEW
    CREATE SYNONYM           CREATE PROCEDURE
    INSERT ANY TABLE         UPDATE ANY TABLE           DELETE ANY TABLE
    SELECT ANY TABLE         SELECT ANY SEQUENCE        ALTER ANY SEQUENCE
    SELECT ANY DICTIONARY
    
    # 권한 외 필요한 사전 설정
    ALTER USER PRS_USER QUOTA UNLIMITED ON PRS_TS_NAME

    참고

    PRS_TARGET_MIN_PRIVILEGE=Y 로 설치하는 경우 부여되는 권한이다. CREATE 계열은 PRS_USER 자기 스키마 범위이고 ANY 범위의 DDL 권한이 없으므로, 이 구성에서는 DDL 동기화를 사용할 수 없다. SELECT ANY SEQUENCE, ALTER ANY SEQUENCE 는 시퀀스 동기화에 사용된다.

    Target DB가 Tibero 또는 Oracle인 경우

    DBA

    Target DB가 PostgreSQL인 경우

    SUPERUSER

    SRC_INSTALL_USER

    설치 과정과 prs_meta 스크립트를 수행할 때 사용하는 계정으로, PRS_USER 계정을 생성하고 권한을 부여하기 위한 역할을 한다. 설치 완료 후에는 운영과 무관하며, 마이너 버전 업그레이드 패치 간 prs_meta 스크립트를 수행할 때 사용하게 된다.

    Tibero인 경우

    CONNECT                          CREATE USER                       DROP USER
    CREATE TABLESPACE                DROP TABLESPACE                   ALTER DATABASE
    ALTER SYSTEM                     ADMINISTER DATABASE TRIGGER       ALTER ANY TABLE
    ALTER ANY TRIGGER                EXECUTE ANY PROCEDURE             DROP ANY PROCEDURE
    DROP ANY TABLE                   DROP ANY TRIGGER                  DROP ANY SEQUENCE
    GRANT ANY ROLE                   GRANT ANY PRIVILEGE               SELECT ANY TABLE
    INSERT ANY TABLE                 UPDATE ANY TABLE                  SELECT ON V$LOG
    SELECT ON V$PARAMETERS
    SELECT ON V$DATABASE WITH GRANT OPTION
    SELECT ON V$INSTANCE WITH GRANT OPTION
    SELECT ON SYS._DD_OBJ WITH GRANT OPTION
    SELECT ON SYS._DD_USER WITH GRANT OPTION
    SELECT ON SYS._DD_IDX WITH GRANT OPTION
    SELECT ON SYS._DD_IDXPART WITH GRANT OPTION
    SELECT ON SYS._DD_TBL WITH GRANT OPTION
    SELECT ON SYS._DD_TBLPART WITH GRANT OPTION
    SELECT ON SYS._DD_TBLSUBPART WITH GRANT OPTION
    SELECT ON SYS._DD_COL WITH GRANT OPTION
    SELECT ON SYS._DD_ICOL WITH GRANT OPTION
    EXECUTE ON SYS.SEAF WITH GRANT OPTION

    Oracle인 경우

    CONNECT                     CREATE SESSION                ALTER SESSION
    CREATE USER                 DROP USER                     CREATE TABLESPACE
    DROP TABLESPACE             ALTER DATABASE                ALTER SYSTEM
    ADMINISTER DATABASE TRIGGER ALTER ANY TABLE               ALTER ANY TRIGGER
    EXECUTE ANY PROCEDURE       DROP ANY PROCEDURE            DROP ANY TABLE
    DROP ANY TRIGGER            DROP ANY SEQUENCE             GRANT ANY ROLE
    GRANT ANY PRIVILEGE         SELECT ANY TABLE              INSERT ANY TABLE
    UPDATE ANY TABLE            ALTER USER                    SELECT ON SYS.V_$PARAMETER
    SELECT ON SYS.V_$DATABASE   SELECT ON SYS.V_$INSTANCE     SELECT ON SYS.V_$LOG
    SELECT ON SYS.USER$ WITH GRANT OPTION
    SELECT  ON SYS.ENC$ WITH GRANT OPTION
    SELECT ON SYS.OBJ$ WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_AQ WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_AQIN WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_AQADM WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_AQADM_SYS WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_LOGMNR WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_LOGMNR_D WITH GRANT OPTION
    EXECUTE ON SYS.DBMS_LOGMNR_INTERNAL WITH GRANT OPTION
    
    EXECUTE DBMS_AQADM.GRANT_SYSTEM_PRIVILEGE('MANAGE_ANY', 'PRS_INSTALL_USER')
    -- PDB의 경우 common user에 대해 수행 필요
    SET CONTAINER

    주의

    Oracle PDB에서 설치하는 경우, CDB로 container를 변경할 수 있는 common user여야 하며 CDB나 PDB에 위 권한이 없는 경우 설치에 실패할 수 있다.

    참고

    Oracle CDB에서 설치하는 경우, 사용자 생성 시 C## 접두어 제약이 존재한다. 설치 과정에서 이 제약을 해제하기 위해 ALTER SESSION SET "_ORACLE_SCRIPT"=TRUE; 명령을 실행하며, 해당 명령은 SYS 계정으로 접속한 세션에서만 수행 가능하므로, CDB 환경에서는 SYS 계정으로 설치를 진행해야 한다.

    PostgreSQL인 경우

    SUPERUSER

    TAR_INSTALL_USER

    SRC_INSTALL_USER와 마찬가지로, 설치 과정과 prs_meta 스크립트를 수행할 때 사용하는 계정이다.


    Instance를 설치하기 위해 각 계정의 설정 정보를 $PRS_HOME/install/prs_install.cfg 파일에 작성한다.

    파라미터
    설명

    TSC 소스의 실제 설치 구성은 의 설치 구성 절을 참고한다.

    아래는 파라미터를 설정한 예시이다.


    설정 파일(prs_install.cfg)이 준비된 후에는 다음과 같이 설치 스크립트를 실행한다.

    옵션
    설명

    옵션 없이 기본 설정 파일로 설치를 수행하는 경우


    설치가 완료되면 다음 디렉터리에서 결과 파일을 확인할 수 있다.

    • <instance_id>_ext1.cfg: ext process의 설정 파일

    • <instance_id>_apply1.cfg: apply process의 설정 파일

    • <instance_id>_llob.cfg: llob process의 설정 파일

    Instance 설치가 성공적으로 완료되면, $PRS_HOME/var 디렉토리 하위에 다음과 같은 서브 디렉토리가 자동으로 생성된다:

    • admin

    • instance_id

    이 디렉토리들 하위에는 해당 프로세스의 실행 로그 파일이나 dump 파일, prosync 운영에 필요한 파일들이 저장된다.

    설치가 완료되면 Source DB 및 Target DB에 ProSync 운영에 필요한 메타 테이블과 객체들이 생성된다.

    아래는 정상적으로 생성되었는지 확인해야 할 주요 메타 테이블 및 객체 목록이다.

    • 동기화 및 추출 이력 관리 테이블

    테이블명
    설명
    • 동기화 및 추출 관련 PACKAGE 및 TRIGGER

    객체명
    설명
    • 동기화 및 추출 이력 관리 테이블

    테이블명
    설명

    ProSync Manager 에서 instance 설치 시 tablespace 이름에 소문자 알파벳을 사용한 경우, 이후에 ProSync install 스크립트를 사용해 재설치 진행 시 사전에 관련 tablespace의 삭제가 필요하다.

    ProSync 운영 데이터를 저장할 테이블스페이스 이름. PostgreSQL의 경우, 파라미터 미지원. (기본값: [INSTANCE_ID]_ts)

    PRS_TS_FILE

    ProSync 운영 데이터를 저장할 테이블스페이스 파일명. PostgreSQL의 경우, 파라미터 미지원. (기본값:[INSTANCE_ID]_ts.dtf)

    PRS_TS_SIZE

    ProSync 운영 데이터를 저장할 테이블스페이스 크기. PostgreSQL의 경우, 파라미터 미지원. (기본값: 1G)

    PRS_SKIP_USER_CREATE

    ProSync 운영에 사용되는 데이터베이스 사용자를 생성하지 않고 기존 사용자를 사용할 경우 설정 (기본값: N)

    PRS_TARGET_MIN_PRIVILEGE

    Target DB 사용자에게 최소 권한만 부여해 DML 동기화만 수행할 경우 설정 (기본값: N)

    PRS_LOG_DIR

    ProSync 운영 중 생성되는 로그 파일의 저장 경로 (기본값: $PRS_HOME/var/{INSTANCE_ID}/log)

    LOG_BACKUP_DIR

    이전 로그 파일을 저장할 경로. 설정하지 않으면 프로세스별로 $PRS_HOME/var/{INSTANCE_ID}/log/ext_backup, log/apply_backup, log/llob_backup이 기본값으로 사용되며, 사용자가 명시하면 해당 경로로 대체된다.

    CREATE_DSN_FILE

    ProSync가 사용할 tbdsn.tbr/tnsnames.ora/pg_service.conf 파일을 생성하려는 경우 설정(기본값: N)

    DSN_DIR

    ProSync가 DB 접속에 사용할 tbdsn.tbr/tnsnames.ora/pg_service.conf 파일이 위치한 경로. 설정하지 않거나 존재하지 않는 경우, 시스템 기본값 사용

    DSN_FILE

    ProSync가 DB 접속에 사용할 tbdsn.tbr/pg_service.conf 파일 명. 설정하지 않거나 존재하지 않는 경우, 시스템 기본값 사용

    AGENT_LIST_DELIMITER

    Agent 정보가 2개 이상일 경우 구분자로 사용할 문자. 현재는 Agent 1개 사용 권장

    EXT_CNT

    Ext 프로세스 수. Source DB 수와 동일하게 설정 (필수 항목)

    EXT_AGENT_ID_LIST

    Ext 프로세스에 연결할 Agent ID. EXT_CNT 수만큼 입력 (필수 항목)

    APPLY_PORT

    Apply 프로세스의 포트 번호 (필수 항목)

    APPLY_AGENT_ID_LIST

    Apply 프로세스에 연결할 Agent ID (필수 항목)

    LLOB_PORT

    Llob 프로세스의 포트 번호 (필수 항목)

    LLOB_AGENT_ID_LIST

    Llob 프로세스에 연결할 Agent ID (필수 항목)

    SRC_DB_TYPE

    Source DB 종류. (TIBERO / ORACLE / POSTGRESQL) (필수 항목)

    SRC_DB_NAME

    Source DB의 별칭(Alias). PostgreSQL의 경우 pg_service.conf에 정의한 service 이름을 입력한다. (필수 항목)

    USE_TSC=Y인 경우 읽기 가능한 Standby 별칭을 지정한다.

    USE_TSC

    Tibero TSC Standby를 소스로 사용할지 지정한다. 기본값은 N이며, SRC_DB_TYPE=TIBERO에서만 사용할 수 있다.

    SRC_PRIMARY_DB_NAME

    쓰기 가능한 Primary 별칭. USE_TSC=Y이면 필수이며 SRC_DB_NAME과 달라야 한다.

    SRC_PRIMARY_DB_ALIAS_N

    TAC-TSC에서 SRC_DB_ALIAS_N에 대응하는 Primary 인스턴스 직결 별칭. 선택 항목이며 사용 시 0부터 SRC_DB_CNT-1까지 지정한다.

    SRC_INSTALL_USER

    Source DB 접속용 계정. 설치에 필요한 권한을 갖춘 계정이어야 함. (필수 항목)

    SRC_INSTALL_PWD

    SRC_INSTALL_USER의 암호. 설정하지 않으면 설치 중 입력받음.

    AUTO_ADD_SUPP_LOG

    동기화 대상 테이블에 supplemental log를 자동 추가할지 여부. (기본값: Y)

    SRC_SKIP_TS_CREATE

    테이블스페이스를 생성하지 않고 기존 것을 사용할 경우 설정. (기본값: N)

    SRC_DB_CNT

    클러스터 환경에서 노드 수. (기본값: 1)

    SRC_DB_REAL_NAME

    Source DB의 DB Name.

    SRC_DB_IP

    Source DB의 IP 주소.

    SRC_DB_PORT

    Source DB의 포트 번호.

    SRC_DB_ALIAS_[n]

    클러스터 환경에서 각 노드의 DB 별칭. SRC_DB_CNT 수만큼 입력.

    SUPP_LOG_LVL_ALL

    supplemental log를 걸 때 level 설정 여부. Y 설정 시 database level로 설정됨. (기본값: N )

    AUTO_SYNC_ON_CREATE

    ProSync 설치 이후 CREATE 문으로 생성된 테이블 및 시퀀스를 자동으로 동기화 대상에 등록할지 여부를 지정 (기본값: N)

    USE_LOGMNR

    Oracle LogMiner를 통해 로그를 추출할 경우 설정. (기본값: N)

    DICT_FILE_DIR

    Oracle LogMiner 사용 시 dict 파일 저장 위치. Oracle 유저가 접근 가능해야 함.

    PRS_EXT_IP

    MySQL 전용 파라미터. 현재 배포 빌드에서는 MySQL을 지원하지 않으므로 사용하지 않는다.

    TAR_DB_TYPE

    Target DB 종류. (TIBERO / ORACLE / POSTGRESQL) (필수 항목)

    TAR_DB_NAME

    Target DB 별칭(Alias). (필수 항목)

    TAR_INSTALL_USER

    Target DB 접속용 계정. 설치 권한을 갖춘 계정이어야 함. (필수 항목)

    TAR_INSTALL_PWD

    TAR_INSTALL_USER의 암호. 설정하지 않으면 설치 중 입력받음.

    TAR_SKIP_TS_CREATE

    테이블스페이스를 생성하지 않고 기존 것을 사용할 경우 설정. (기본값: N)

    TAR_DB_REAL_NAME

    Target DB의 DB Name.

    TAR_DB_IP

    Target DB의 IP 주소.

    TAR_DB_PORT

    Target DB의 포트 번호.

    PRS_APPLY_IP

    MySQL 전용 파라미터. 현재 배포 빌드에서는 MySQL을 지원하지 않으므로 사용하지 않는다.

    GROUP_NUM

    Multi-Grouping 모드에서 replay group 수. (기본값: 1)

    USE_TDE

    TDE_WALLET_PWD를 수동으로 입력받기 위한 설정. Y로 설정 시 설치 중 사용자 입력 요구.

    ASM_DB_NAME

    Source Oracle이 ASM을 사용하는 경우 접속할 ASM 인스턴스 별칭(Alias). ASM 경로(+DISKGROUP/...)의 redo/archive log 접근에 필요.

    ASM_USER

    ASM 인스턴스 접속 계정.

    ASM_PWD

    ASM_USER의 암호. 설치 시 암호화되어 $PRS_HOME/var/{INSTANCE_ID}/.wallet_asm에 저장되며, 생성되는 Extract config에는 #encrypted로 기입된다.

    prs_adm.cfg
    : admin process의 설정 파일

    PRS_DD_SGMT

    동기화 대상 테이블의 세그먼트 ID 정보를 저장

    PRS_DD_TBL

    동기화 대상 테이블 이름 정보를 저장

    PRS_DD_USR

    Source DB 사용자 정보를 저장

    PRS_DD_SEQ

    Data Dictionary용 시퀀스

    PRS_DICT_HIST

    TSN 기준 Dictionary 파일 이름 저장

    PRS_DUMMY_TBL

    Dummy log를 생성시키기 위해 dummy dml을 수행하는 테이블

    PRS_IMPORTED_ARCHIVE_LOG

    Oracle 로그마이너 모드에서 특정 archive log 지정 시 사용

    PRS_INSTALL_HIST

    설치한 유저 정보 및 설치 시간 저장

    PRS_IPARAM

    ProSync 파라미터 정보를 저장

    PRS_LOGMNR_INFO

    Oracle 로그마이너 추출 관련 정보를 저장

    PRS_OBJ_LIST

    동기화 대상 오브젝트 ID 정보를 저장

    PRS_TXINFO

    트랜잭션 정보 저장 테이블

    INSTANCE_ID

    ProSync를 설치하기 위한 ID. 사용자가 관리 목적으로 임의로 지정한 ID를 입력한다. 이 값은 Tablespace name으로 유효한 형식이어야 하며, 숫자로 시작할 수 없다. (필수 항목)

    PRS_USER

    ProSync 운영을 위해 소스 및 Target DB에 생성할 사용자 이름

    PRS_PWD

    PRS_USER의 암호. 설정하지 않으면 설치 중에 입력받는다.

    -h

    도움말 출력

    -c

    사용할 환경설정 파일 지정 (기본값: prs_install.cfg)

    -l

    동기화 리스트 파일 지정 (기본값: prs_obj_group1.list)

    PRS_DDL_HIST

    DDL 발생에 따른 DD 이미지 정보 관련 히스토리 테이블

    PRS_DD_COL

    동기화 대상 테이블의 컬럼 정보

    PRS_DD_CON

    DB constraint 정보를 저장

    PRS_DD_ENC

    암호화된 컬럼 관련 정보

    PRS_DD_SEQ_TBL

    PRS_DD_META

    PRS_DDL_TRG가 이미지 관리를 위해 사용

    PRS_DUMMY

    Dummy 부하 생성을 위한 PACKAGE

    PRS_DDL_TRG

    DD 이미지 관리를 위한 Trigger

    PRS_INSTALL_HIST

    설치 정보 저장

    PRS_CONST_HIST

    반영된 리두/아카이브 로그 정보 저장

    PRS_CONST_SEQ

    반영된 리두/아카이브 로그 정보의 시퀀스 저장

    PRS_LCT

    반영 스레드가 마지막으로 반영한 TX의 정보를 저장

    PRS_COMMITTED_TX_LIST

    Source DB에서 커밋된 TX 정보 저장

    TSC Standby Synchronization

    Tibero인 경우

    Oracle인 경우

    For Tibero, Oracle

    설치 시 PRS_TARGET_MIN_PRIVILEGE=Y 설정하여 Instance 설치하는 경우, TAR_INSTALL_USER 에게 ALTER USER 권한을 추가적으로 부여해야 한다.

    PostgreSQL인 경우

    1. 설치 파라미터 설정

    설정 템플릿 예시

    설치 파라미터

    참고

    특수문자 사용 시 이스케이프 처리가 필요하다.

    (예: PRS_PWD="example123!@#" -> PRS_PWD=\"example123\!\@\#\")

    또한, IP 주소 입력 시 VIP(Virtual IP) 대신 실제 IP 주소를 사용할 것을 권장한다.

    설정 예시

    2. Instance 설치

    주의 — 재실행 시 기존 운영 데이터 삭제

    prs_install.sh를 운영 중인 기존 인스턴스 환경에서 다시 실행하면 Source의 ProSync 내부 객체와 사용자, 테이블스페이스가 삭제 후 재생성되고, Target의 PRS_LCT, PRS_COMMITTED_TX_LIST, PRS_CONST_HIST 등 복구에 필요한 메타 테이블이 삭제되며, 초기 동기화 기준점이 새로 생성된다.

    따라서 prs_install.sh 재실행은 패치나 장애 복구 수단이 아니다. 패치는 패치 가이드를 따르고, 재설치가 불가피한 경우 프로세스를 정지하고 DB 메타 테이블과 config, var 디렉터리, wallet 파일을 백업한 뒤 진행한다.

    참고

    prs_install.sh는 독립 실행 스크립트이다. . prs_install.sh처럼 dot-source 방식으로 실행하면 오류 처리 과정의 exit가 현재 사용자의 셸을 종료시킬 수 있으므로 반드시 ./prs_install.sh로 실행한다.

    사용 가능한 옵션

    설치 예시

    참고

    prs_install.sh 파일을 실행한 후 prs_install.cfg에 패스워드 옵션을 입력하지 않은 경우 각 계정에 대한 패스워드를 순서대로 입력해야 한다.

    주의

    prs_install.sh 파일 실행 시, 메타 테이블 및 트리거 생성 중 DDL이 발생하는 경우 이를 감지하지 못할 수 있으며 이후 동기화에 실패할 수 있다.

    설치 결과 예시

    참고

    설치 중 오류가 발생하면, 오류가 발생한 지점과 관련된 메시지를 출력한 뒤 설치를 중단한다.

    자세한 오류 내용은 디버깅을 위해 로그 파일(prs_install.log)에 기록되며, 이를 통해 원인을 확인할 수 있다.

    3. 설치 결과 확인

    주요 파일 설명

    생성된 설정 파일 예제

    prs_instance.map 예시

    instance_ext1.cfg 예시

    참고 — PRS_PWD=#encrypted의 의미

    #encrypted는 암호화된 암호 문자열이 아니라, 실제 암호를 wallet 파일에서 읽으라는 표시(sentinel)다. 실제 DB 접속 암호는 var/<instance>/.wallet에 암호화되어 저장되며, TDE wallet 암호는 var/<instance>/.wallet_tde, HSM PIN은 var/<instance>/.wallet_tde_hsm에 저장된다.

    따라서 설정 파일(config)만 다른 노드로 복사해서는 프로세스를 기동할 수 없으며 wallet 파일을 함께 이관해야 한다. wallet 파일은 백업 대상에 포함해야 하며, DB 비밀번호 변경 시에는 wallet을 다시 생성해야 한다.

    instance_apply1.cfg 예시

    instance_llob.cfg 예시

    prs_adm.cfg 예시

    Var 디렉토리 확인

    메타 테이블 생성 확인

    Source DB

    Target DB

    PRS_TS_NAME

    Data Dictionary에 대한 시퀀스와 그 때의 오브젝트 정보를 가지고 있다. 이 테이블은 추가적으로 drop된 여부까지 판단한다.

    CONNECT                  CREATE USER               DROP USER
    CREATE TABLESPACE        DROP TABLESPACE           EXECUTE ANY PROCEDURE
    DROP ANY PROCEDURE       DROP ANY TABLE            DROP ANY SEQUENCE
    GRANT ANY ROLE           GRANT ANY PRIVILEGE       SELECT ANY TABLE
    INSERT ANY TABLE         SELECT ANY SEQUENCE       SELECT ON V$PARAMETERS
    CONNECT                  CREATE USER               DROP USER
    CREATE TABLESPACE        DROP TABLESPACE           EXECUTE ANY PROCEDURE
    DROP ANY PROCEDURE       DROP ANY TABLE            DROP ANY SEQUENCE
    GRANT ANY ROLE           GRANT ANY PRIVILEGE       SELECT ANY TABLE
    INSERT ANY TABLE         SELECT ANY SEQUENCE       SELECT ON SYS.V_$PARAMETER
    SUPERUSER
    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=
    PRS_USER=prosync
    PRS_PWD=
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=
    EXT_AGENT_ID_LIST_0=agent1
    #EXT_AGENT_ID_LIST_1=agent1,agent2
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent1
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=
    SRC_INSTALL_USER=
    SRC_INSTALL_PWD=
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    #SRC_DB_CNT=1
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    #SRC_DB_ALIAS_0=
    #SRC_DB_ALIAS_1=
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for Oracle ASM only)
    # Required when using ASM redo files (+DISKGROUP/...)
    #ASM_DB_NAME=
    #ASM_USER=
    #ASM_PWD=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=
    TAR_INSTALL_USER=
    TAR_INSTALL_PWD=
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    #TAR_DB_CNT=1
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N
    ############################################
    #
    # ProSync Installation Parameters
    #
    ############################################
    
    # (Mandatory)
    INSTANCE_ID=instance
    PRS_USER=prosync_user
    PRS_PWD=prosync_user_password
    
    # (Optional)
    #PRS_TS_NAME=
    #PRS_TS_FILE=
    #PRS_TS_SIZE=
    #PRS_SKIP_USER_CREATE=N
    #PRS_TARGET_MIN_PRIVILEGE=N
    #PRS_LOG_DIR=
    #LOG_BACKUP_DIR=
    #CREATE_DSN_FILE=N
    #DSN_DIR=
    #DSN_FILE=#need DSN_DIR
    
    ############################################
    #
    # ProSync Processes Informations for Instance Map
    #
    ############################################
    ### (Optional)
    AGENT_LIST_DELIMITER=,
    
    ### (Mandatory)
    # Ext process
    ## Ext cnt must be the same as SRC_DB_CNT
    EXT_CNT=1
    EXT_AGENT_ID_LIST_0=agent1
    #EXT_AGENT_ID_LIST_1=agent1,agent2
    
    # Apply process
    APPLY_PORT=7620
    APPLY_AGENT_ID_LIST=agent1
    
    # Llob process
    LLOB_PORT=7630
    LLOB_AGENT_ID_LIST=agent1
    
    ############################################
    #
    # Source database informations
    #
    ############################################
    
    # (Mandatory)
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=src_tibero
    SRC_INSTALL_USER=sys
    SRC_INSTALL_PWD=tibero
    
    # (Optional)
    #AUTO_ADD_SUPP_LOG=Y
    #SRC_SKIP_TS_CREATE=N
    #AUTO_SYNC_ON_CREATE=N
    
    # (for Tibero Standby Cluster source synchronization)
    # When USE_TSC=Y, set SRC_DB_NAME to the readable standby alias and
    # SRC_PRIMARY_DB_NAME to the writable primary alias.
    #USE_TSC=N
    #SRC_PRIMARY_DB_NAME=
    
    # (for TAC-TSC) per-instance writable primary aliases, parallel to
    # SRC_DB_ALIAS_N.
    #SRC_PRIMARY_DB_ALIAS_0=
    #SRC_PRIMARY_DB_ALIAS_1=
    
    # (Number Of Database Instances)
    #SRC_DB_CNT=1
    
    # (Dsn)
    #SRC_DB_REAL_NAME=
    #SRC_DB_IP_0=
    #SRC_DB_PORT_0=
    #SRC_DB_IP_1=
    #SRC_DB_PORT_1=
    
    # (for Cluster, only Extract Needed)
    #SRC_DB_ALIAS_0=
    #SRC_DB_ALIAS_1=
    
    # (for ORACLE DB Only)
    #SUPP_LOG_LVL_ALL=N
    
    # (for Oracle Logminer only)
    # Oracle 11g or less, use utl_file_dir instead of DICT_FILE_DIR
    #USE_LOGMNR=Y
    #DICT_FILE_DIR=
    
    # (for Oracle ASM only)
    # Required when using ASM redo files (+DISKGROUP/...)
    #ASM_DB_NAME=
    #ASM_USER=
    #ASM_PWD=
    
    # (for MySQL only)
    #PRS_EXT_IP=
    
    ############################################
    #
    # Target database informations
    #
    ############################################
    
    # (Mandatory)
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tar_tibero
    TAR_INSTALL_USER=sys
    TAR_INSTALL_PWD=tibero
    
    # (Optional)
    #TAR_SKIP_TS_CREATE=N
    
    # (Number Of Database Instances)
    #TAR_DB_CNT=1
    
    # (Dsn)
    #TAR_DB_REAL_NAME=
    #TAR_DB_IP_0=
    #TAR_DB_PORT_0=
    #TAR_DB_IP_1=
    #TAR_DB_PORT_1=
    
    # (for MySQL only)
    #PRS_APPLY_IP=
    
    # (for multi thread)
    #GROUP_NUM=1
    
    # (for TDE(transparent data encryption) synchronization)
    #USE_TDE=N
    
    $ cd $PRS_HOME/install
    $ ./prs_install.sh [option] [config file] [list file]
    $ cd $PRS_HOME/install
    $ ./prs_install.sh
    ********************************************************************************
    * Check System Parameters (1/5)
    ********************************************************************************
    Checking system type... Linux
    Checking PRS_HOME... /home/prosync/example
    Checking TB_HOME... /home/tibero/tibero7
    Checking ORACLE_HOME... not found
    Checking psql ... available
    Checking psql service ...not found
    
    ********************************************************************************
    * Check Installation Parameters (2/5)
    ********************************************************************************
    Checking configuration file... ok
    Checking prs_instance.map file... ok
    Checking Instance Id from prs_instance.map...
    * instance information for instance was not found. It will be written in this script...
    ok
    Checking processes infos...
    * Checking Ext processes Informations... EXT_CNT: 1
    * Delimiter: [,]
       * Ext[0] process's Agent Id List
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Apply process Informations...
    * Checking Apply Port..
       * APPLY_PORT=[7620]
    * Checking Apply process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    * Checking Llob process Informations...
    * Checking Llob Port..
       * LLOB_PORT=[7630]
    * Checking Llob process's Agent Id List..
           * Agent ID[agent1]
           * [agent1] found.
    
    Checking INSTANCE_ID... instance
    Checking PRS_USER... prosync_user
    Checking PRS_TS_NAME... instance_ts
    Checking PRS_TS_FILE... instance_ts.dtf
    Checking PRS_TS_SIZE... 1G
    Checking PRS_EXT_IP... %
    Checking PRS_APPLY_IP... %
    Checking SRC_DB_CNT... 1
    Checking SRC_DB_TYPE... TIBERO
    Checking SRC_INSTALL_USER... sys
    Checking SRC_DB_NAME... src_tibero
    Checking source connection(1/2)... ok
    Checking source connection(2/2)... ok
    Checking TAR_DB_TYPE... TIBERO
    Checking TAR_INSTALL_USER... sys
    Checking TAR_DB_NAME... tar_tibero
    Checking target connection [tar_tibero](1/2)... ok
    Checking target connection [tar_tibero](2/2)... ok
    
    ********************************************************************************
    * Install to Source Database (3/5)
    ********************************************************************************
    Checking archived log mode... ok
    Checking log mining parameters [src_tibero]... ok
    Get Archive log directory [src_tibero]... ok
    Get Archive log format [src_tibero]... ok
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Granting privileges for trigger... ok
    Creating ProSync internal tables... ok
    Creating ProSync internal package... ok
    Creating ProSync internal trigger... ok
    Prosync user prosync_user to uppercase PROSYNC_USER... ok
    Checking source object file(group num : 1)... ok
    Building source object for TEST.%... ok
    Building source object for TEST%.%... ok
    Adding table supplemental log... 6, and one for prosync
      "PROSYNC_USER"."PRS_DUMMY_TBL" : Supplemental logging set
      "TEST"."T1" : supplemental log already exists, continue.
      "TEST"."T2" : supplemental log already exists, continue.
      "TEST"."T3" : supplemental log already exists, continue.
      "TEST"."T4" : supplemental log already exists, continue.
      "TEST"."T5" : supplemental log already exists, continue.
      prosync_user.PRS_DUMMY_TBL : supplemental log already exists, continue.
    Counting total source objects... 6
    Generating initial DDL history... ok
    Checking initial DDL history... ok
    Insert default value in PRS_DUMMY_TBL...ok
    Querying NLS_CHARACTERSET... UTF8
    Querying NLS_NCHAR_CHARACTERSET... UTF16
    Switching logfile... ok
    Querying current log sequence [src_tibero]... 188
    Querying current snapshot#... 4306566
    
    ********************************************************************************
    * Install to Target Database (4/5)
    ********************************************************************************
    Dropping ProSync objects... ok
    Dropping ProSync tablespace... DROP TABLESPACE instance_ts INCLUDING CONTENTS AND DATAFILES;
    
    done
    
    ok
    Creating ProSync tablespace... ok
    Dropping ProSync user... ok
    Creating ProSync user... ok
    Granting privileges... ok
    Creating ProSync internal tables... ok
    Generating initial construct history [src_tibero (group 1)]... ok
    Generating initial commit history... ok
    
    ********************************************************************************
    * Generate Configuration Parameters (5/5)
    ********************************************************************************
    Generating Wallet... ok
    Generating Extract [src_tibero] configuration...  ok
    Generating Apply [tar_tibero] configuration...  ok
    Generating LONG/LOB configuration...  ok
    Generating instance map to prs_instance.map ...
    
    ********************************************************************************
    * ProSync is installed successfully on Thu, 17 Apr 2025 14:38:38 +0900.
    *
    *   PRS_HOME     = /home/prosync/example
    *   Binary Path  = /home/prosync/example/bin
    *   ProSync User = prosync_user
    *
    *   Archived Log Path     = /home/tibero/tibero7/database/tibero/archive/
    *   Archived Log Format   = log-t%t-r%r-s%s.arc
    *   Initial log sequence# = 188
    *
    *   Initial change# (TSN) = 4306566
    *
    ********************************************************************************
    $ cd $PRS_HOME/config
    $ ls -al
    total 55
    drwxr-xr-x  3 users users 4096 Apr 16 15:42 .
    drwxr-xr-x 15 users users 4096 Apr 14 15:08 ..
    -rw-r--r--  1 users users  547 Apr 17 14:38 instance_apply1.cfg
    -rw-r--r--  1 users users  574 Apr 17 14:38 instance_ext1.cfg
    -rw-r--r--  1 users users  470 Apr 17 14:38 instance_llob.cfg
    -rw-r--r--  1 users users  352 Apr  3 16:19 prs_adm.cfg
    -rw-r--r--  1 users users  367 Feb 27 19:22 prs_agent_agent1.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent2.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent3.cfg
    -rw-r--r--  1 users users  367 Apr 16 15:32 prs_agent_agent4.cfg
    -rw-r--r--  1 users users 1272 Apr 16 15:32 prs_instance.map
    drwxr-xr-x  2 users users 4096 Apr 14 15:08 templates
    -rw-r--r--  1 users users    5 Feb 27 13:06 variant
    #--------------------------------------------------------
    # Appended by prs_install.sh at Thu Apr 17 02:38:37 PM KST 2025
    #
    
    instance=(
        EXT1=(AGENT=agent1)(PROGRAM=prs_ext)
        APPLY1=(AGENT=agent1)(PORT=7620)(PROGRAM=prs_apply)
        LLOB=(AGENT=agent1)(PORT=7630)(PROGRAM=prs_llob)
    )
    ################################################################################
    #
    # ProSync (Ext) Initialization Parameters
    #
    ################################################################################
    
    LOG_LEVEL=3
    
    PRS_USER=prosync_user
    PRS_PWD=#encrypted
    
    EXTRACT_NUM=1
    
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=src_tibero
    
    ARCHIVE_LOG_DIR=/home/tibero/tibero7/database/tibero/archive/
    ARCHIVE_LOG_FORMAT=log-t%t-r%r-s%s.arc
    
    LOG_DIR=/home/prosync/example/var/instance/log
    LOG_BACKUP_DIR=/home/prosync/example/var/instance/log/ext_backup
    ################################################################################
    #
    # ProSync (Apply) Initialization Parameters
    #
    ################################################################################
    
    LOG_LEVEL=3
    
    PRS_USER=prosync_user
    PRS_PWD=#encrypted
    
    APPLY_NUM=1
    
    TAR_DB_TYPE=TIBERO
    TAR_DB_NAME=tar_tibero
    
    SRC_DB_CNT=1
    
    MAP=(TABLE DEFAULT)
    
    DDL=(INCLUDE DEFAULT, TYPE=('ALTER TABLE','TRUNCATE TABLE'))
    
    LOG_DIR=/home/prosync/example/var/instance/log
    LOG_BACKUP_DIR=/home/prosync/example/var/instance/log/apply_backup
    
    ################################################################################
    #
    # ProSync (llob) Initialization Parameters
    #
    ################################################################################
    
    LOG_LEVEL=3
    
    PRS_USER=prosync_user
    PRS_PWD=#encrypted
    
    SRC_DB_TYPE=TIBERO
    SRC_DB_NAME=src_tibero
    
    LLOB_FLASHBACK_ERROR=CURRENT
    
    LOG_DIR=/home/prosync/example/var/instance/log
    LOG_BACKUP_DIR=/home/prosync/example/var/instance/log/llob_backup
    ################################################################################
    #
    # ProSync (Admin) Initialization Parameters
    #
    ################################################################################
    LOG_LEVEL=3
    LOG_DIR=/home/prosync/example/var/admin/log
    LOG_BACKUP_DIR=/home/prosync/example/var/admin/log/backup
    # tree 결과 예제
    .
    ├── admin
    ├── agent
    └── instance

    Apply Parameters

    APPLY_DML_ERR_REPORT_CNT

    Number of retries to apply dml before leaving a log to report file.

    Parameter Format

    Property
    Description

    Parameter type

    Integer

    Default Value

    20

    Class

    Optional, Static

    Range

    APPLY_NUM specifies the number of the target database. It must be greater than or equal to 1. In 1:N topology, each apply process must be assigned a different number in sequential order (1, 2, 3...).

    Property
    Description

    APPLY_REPORT_BACKUP_DIR specifies the directory where the report files of apply process are backed up. It must be specified as an absolute path.

    Property
    Description

    APPLY_REPORT_BACKUP_SIZE specifies the maximum size of report backup files of apply process. If this limit is exceeded, the oldest report files in the directory are deleted.

    Property
    Description

    APPLY_REPORT_DIR specifies the directory where the report files are stored. It must be specified as an absolute path.

    Property
    Description

    APPLY_REPORT_FILE_SIZE specifies the maximum report file size of apply process. If a report file exceeds this limit, it is moved to the backup directory and a new report file is created.

    Property
    Description

    APPLY_TO_DB specifies whether the replay thread of the apply process actually executes the received changes on the target database. If set to 'N', neither the DML statements nor the DDL statements are executed on the target database, so this parameter is normally set to 'N' only together with APPLY_TO_SAM in order to record the statements into the SAM file without applying them.

    Property
    Description

    Determines whether to leave a log on the report file or not.

    Property
    Description

    This parameter sets whether to log the statements that the APPLY process applies to the database into the SAM file. (Y/N)

    Property
    Description

    This parameter determines the maximum value of LCR data to be stored for array bind.

    Property
    Description

    Apply control thread stops receiving msg from ext when total chunk size of un-constructed exceeded.

    Property
    Description

    The COL_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when outputting column content for DML statements. It works when SQL_REDO_MODE is set to N. When logging DML statements, if column definitions are present in the COL_SAM_TEMPLATE, ProSync logs the column information to the SAM file according to that template format.

    Property
    Description

    CONN_MAX specifies the max number of connections between processes.

    Property
    Description

    DDL specifies DDL filtering options. For more information, refer to ProSync DDL RULE in Administrator's Guide.

    Property
    Description

    DISCARD_BACKUP_DIR specifies the directory where the discard files of apply process are backed up. It must be specified as an absolute path.

    Property
    Description

    DISCARD_BACKUP_SIZE specifies the maximum size of discard backup files of apply process. If this limit is exceeded, the oldest discard files in the directory are deleted.

    Property
    Description

    DISCARD_CAST_ERR determines whether to skip a DML statement that fails because ProSync cannot convert a source value to the target data type (for example, an unsupported time zone region). A skipped statement is not applied to the target database. It works regardless of DISCARD_YN, and the skipped statement is recorded in the discard file only when DISCARD_FILE_YN is set to 'Y'.

    Property
    Description

    DISCARD_DDL_BACKUP_DIR specifies the directory where the discard files of apply process are backed up. It must be specified as an absolute path.

    Property
    Description

    DISCARD_DDL_BACKUP_SIZE specifies the maximum size of discard backup files of apply process. If this limit is exceeded, the oldest discard files in the directory are deleted.

    Property
    Description

    DISCARD_DDL_FILE_DIR specifies the directory where the discard files are stored. It must be specified as an absolute path.

    Property
    Description

    DISCARD_DDL_FILE_SIZE specifies the maximum discard file size of apply process. If a discard file exceeds this limit, it is moved to the backup directory and a new discard file is created.

    Property
    Description

    Y to make a file of error DDL that discarded during sync.

    Property
    Description

    Toggle Discard DDL feature.

    Property
    Description

    List error codes to ignore during sync. (max 256 codes)

    Property
    Description

    DISCARD_FILE_DIR specifies the directory where the discard files are stored. It must be specified as an absolute path.

    Property
    Description

    DISCARD_FILE_SIZE specifies the maximum discard file size of apply process. If a discard file exceeds this limit, it is moved to the backup directory and a new discard file is created.

    Property
    Description

    Y to make a file of error codes that discarded during sync.

    Property
    Description

    Toggle Discard feature.

    Property
    Description

    DML_WAIT_TIMEOUT specifies the timeout (in seconds) for a statement executed on the target database. When the timeout expires the statement is cancelled, the connection to the target database is dropped, and the transaction is retried from the beginning. If it is set to 0, no timeout is set and the apply process waits indefinitely for the statement to finish. It applies to a Tibero target (DML execution only) and to a target accessed through ODBC such as PostgreSQL; it has no effect on an Oracle target because the OCI path does not set a statement timeout.

    Property
    Description

    DSN_DIR specifies the directory where the dsn file located. It must be specified as an absolute path.

    Property
    Description

    DSN_FILE specifies name of dsn file.

    Property
    Description

    Apply 프로세스가 테이블 메타데이터(DD)의 추가·변경·삭제를 반영할 때 그 테이블의 Source 객체 ID(파티션 포함)를 연결된 모든 Extract 프로세스에 전달할지 여부를 설정한다. Extract 는 ENABLE_SYNC_TABLE_FILTER=Y 이고 Source DB 가 Oracle 이면서 USE_LOGMNR=N 일 때만 이 정보로 추출 대상 테이블 목록을 갱신하며, 그 외 구성에서는 설정해도 효과가 없다.

    Property
    Description

    GROUP_NUM specifies the number of replay groups in multi-grouping mode.

    Property
    Description

    The number of retries in a fault situation absence of primary key. Default value means infinite retries.

    Property
    Description

    This parameter decides how often to update the target meta tables PRS_COMMITTED_TX_LIST and PRS_LCT. The unit is in seconds.

    Property
    Description

    a leading prosync user in history topology

    Property
    Description

    LLOB_APPLY_MODE specifies how a LONG/LOB column is synchronized. If set to 'SKIP', the column is not synchronized; if set to 'SYNC', the column is synchronized during DML execution.

    Property
    Description

    LOG_BACKUP_DIR specifies the directory where the ProSync log files are backed up. It must be specified as an absolute path.

    Property
    Description

    LOG_BACKUP_SIZE specifies the maximum size of all backup files in the process. If this limit is exceeded, the oldest log files in the directory are deleted.

    Property
    Description

    LOG_DIR specifies the directory where the ProSync log files are stored. It must be specified as an absolute path.

    Property
    Description

    LOG_FILE_SIZE specifies the maximum log file size. If a log file exceeds this limit, it is moved to the backup directory and a new log file is created.

    Property
    Description

    LOG_LEVEL specifies the log level of the process. A higher log-level produces more detailed logs.

    Property
    Description

    MAP specifies the mapping information of the target table for synchronization. For more information, refer to ProSync Administrator's Guide.

    Property
    Description

    MAP_SKIP_UPD_WHERE specifies where clause or the set clause when check skipping update dml. If set 'Y', prosync skip using where clause and otherwise, prosync skip using set clause.

    Property
    Description

    Apply control threads resumes the receiving of msg from ext when total size of un-committed but fully constructed tx is smaller than this parameter.

    Property
    Description

    Apply control thread stops receiving msg from ext when total size of un-committed but fully constructed tx is larger than this parameter.

    Property
    Description

    BLOCK EXT STMT COUNT

    Property
    Description

    RESUME EXT STMT COUNT

    Property
    Description

    OCI_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. for Oracle, enter a path to the libclntsh.so file.

    Property
    Description

    ODBC_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. Set a path to the proper library file.

    Property
    Description

    connection timeout from process to agent. if a process cannot connect to agent while this timeout, kill itself

    Property
    Description

    PRS_PWD specifies the database user password. If the password is encrypted, append the string '#encrypted'.

    Property
    Description

    PRS_USER specifies the database user.

    Property
    Description

    Parallel Replay object id mode

    Property
    Description

    records history when DML occurred.

    Property
    Description

    Number of replay thread cnt when starting prosync.

    Property
    Description

    This parameter decides how often to insert resource data into repoDB.

    Property
    Description

    RETENTION_FILE_CLEANUP_INTERVAL specifies how often retention-based file cleanup is checked.

    Property
    Description

    SAM_BACKUP_DIR specifies the directory where the SAM files are backed up. It must be specified as an absolute path.

    Property
    Description

    SAM_BACKUP_SIZE specifies the maximum size of SAM backup files. If this limit is exceeded, the oldest SAM files in the directory are deleted.

    Property
    Description

    SAM_BIND_VALUE specifies whether to retain the values of the query in SAM files. If set to 'Y', the specific values of the query are retained. If set to 'N', every value in the query is replaced with '?'.

    Property
    Description

    SAM_DIR specifies the directory where the sam files are stored. It must be specified as an absolute path.

    Property
    Description

    SAM_FILE_SIZE specifies the maximum SAM file size. If a SAM file exceeds this limit, it is moved to the backup directory and a new SAM file is created.

    Property
    Description

    SAM_LOG_PREFIX specifies whether to include timestamp and thread information for each query in the SAM files, similar to how prosync logging works. If set to 'Y', this information is prepended to each row in the SAM files. If set to 'N', the timestamp and thread information is not included on each row.

    Property
    Description

    The SQL_REDO_MODE parameter specifies whether to log the full DML/DDL statements into the SAM files. Y: The DML statements are logged row-by-row into the SAM files. (This is the default setting). N: The DML statements are not logged row-by-row into the SAM files.

    Property
    Description

    SRC_DB_CHARSET specifies the character set of the source database.

    Property
    Description

    SRC_DB_CNT specifies the number of source database instances, that is the number of extract processes, from which the apply process receives changes. The value must be identical to the number of extract processes defined for the topology in prs_instance.map, otherwise the apply process fails to start. A value greater than 1 means that the source is a cluster (TAC or RAC), in which case the apply process keeps a transaction hash and a log position per source node and merges the transactions arriving from the nodes in commit order. The value cannot exceed 20 because the apply process reserves a fixed number of per-source-node slots internally.

    Property
    Description

    SRC_DB_NCHARSET specifies the national character set of the source database.

    Property
    Description

    The STMT_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when logging statement (DML/DDL) content to the SAM file. It works when SQL_REDO_MODE is set to N. ProSync reads the template from the specified path and logs the DDL and DML content to the SAM file according to that template format.

    Property
    Description

    TAR_DB_NAME specifies the name(Alias) of the target database. For TIBERO, UPDB, or K-DB, use the value specified in the dsn file. For ORACLE, use the value specified in the tnsname file.

    Property
    Description

    TAR_DB_TYPE specifies the type of the target database to apply data to. Options are TIBERO, UPDB, KDB, or ORACLE.

    Property
    Description

    TDE_FOR_APPLY specifies whether use data decryption from source database

    Property
    Description

    TDE_WALLET_FILE specifies the wallet file name of source db including absolute path

    Property
    Description

    TDE_WALLET_PWD specifies the password of wallet file for tde

    Property
    Description

    TX_HASH_FILE_CNT determines how many tx_hash_files to keep in PRS_TX_DIR

    Property
    Description

    TX_HASH_FILE_DIR specifies the directory where the ProSync tx hashes are saved. It must be specified as an absolute path.

    Property
    Description

    TX_HASH_FILE_MODE determines how to control tx_hash_files

    Property
    Description

    TX_HASH_FILE_RETENTION_DAY determines retention period(days) for tx_hash_files

    Property
    Description

    TX_HASH_FILE_TOTAL_SIZE determines max size of every tx_hash_files to keep in PRS_TX_DIR

    Property
    Description

    TX_HASH_SIZE specifies the maximum memory size that the apply process can use for transaction data. If this size is not sufficient, there will be frequent swapping between memory and disk which will affect performance.

    Property
    Description

    The TX_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when outputting transactions to the SAM file. It works when SQL_REDO_MODE is set to N. ProSync reads the template from the specified path whenever a transaction encounters a commit, and logs the transaction content to the SAM file according to that template format.

    Property
    Description

    UPDATE_LCT_WHEN_ADD_HIST determines whether to execute UPDATE_LCT or not when a replay thread inserts ADD_CONST_HIST information.

    Property
    Description

    This parameter determines whether the replay thread use the array bind or not.

    Property
    Description

    USE_LOGMNR specifies whether to use oracle logminer or to use oracle log reader, when analyzing redo logs.

    Property
    Description

    use batch mode for insert only

    Property
    Description

    USE_PK_FOR_WHERE specifies whether use only PK columns when replay thread generate and bind the where clause of dml(update and delete) or not.

    Property
    Description

    (Deprecated) VERIFY_TIMEOUT is no longer used. It used to specify the timeout (in seconds) after which the apply process released a table that it had blocked or frozen for a verify request. The verify feature was separated into a standalone tool and its code was removed, so this parameter no longer has any effect. It is kept only so that existing configuration files that still contain it remain loadable.

    Property
    Description

    0 - 100000

    Parameter type

    Integer

    Default Value

    1

    Class

    Mandatory, Static

    Range

    1 - 1024

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Dynamic

    Range

    Parameter type

    Integer

    Default Value

    10485760

    Class

    Optional, Static

    Range

    1024 - UINT64_MAX

    Parameter type

    Integer

    Default Value

    1073741824

    Class

    Optional, Static

    Range

    1 - UINT64_MAX

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    128

    Class

    Optional, Static

    Range

    32 - 1024

    Parameter type

    desc

    Default Value

    "(INCLUDE DEFAULT, TYPE=('ALTER TABLE','TRUNCATE TABLE'))"

    Class

    Mandatory, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    desc

    Default Value

    "()"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    0 - 1048576

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1

    Class

    Optional, Static

    Range

    1 - 20

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - UINT16_MAX

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    1 - INT32_MAX

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "SYNC"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Integer

    Default Value

    3

    Class

    Mandatory, Dynamic

    Range

    1 - 5

    Parameter type

    desc

    Default Value

    "(TABLE DEFAULT)"

    Class

    Mandatory, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1073741824

    Class

    Optional, Static

    Range

    1 - UINT64_MAX & MEMORY_CTRL_RESUME_SIZE < MEMORY_CTRL_STOP_SIZE

    Parameter type

    Integer

    Default Value

    2147483648

    Class

    Optional, Static

    Range

    1 - UINT64_MAX & MEMORY_CTRL_RESUME_SIZE < MEMORY_CTRL_STOP_SIZE

    Parameter type

    Integer

    Default Value

    1000

    Class

    Optional, Static

    Range

    1 - UINT32_MAX & MERGE_RESUME_CNT < MERGE_BLOCK_CNT

    Parameter type

    Integer

    Default Value

    100

    Class

    Optional, Static

    Range

    1 - UINT32_MAX & MERGE_RESUME_CNT < MERGE_BLOCK_CNT

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    180

    Class

    Optional, Static

    Range

    0 - 86400

    Parameter type

    String

    Default Value

    "#encrypted"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    "OBJ"

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    4

    Class

    Optional, Static

    Range

    1 - 20

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    60 - 3600

    Parameter type

    Integer

    Default Value

    3600

    Class

    Optional, Dynamic

    Range

    60 - 86400

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Dynamic

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    17179869184

    Class

    Optional, Dynamic

    Range

    1M - 16G

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "MSWIN949"

    Class

    Optional, Static

    Range

    "ASCII", "US7ASCII", "EUCKR", "KO16KSC5601", "MSWIN949","KO16MSWIN949", "UTF8", "AL32UTF8", "UTF16", "AL16UTF16", "SJIS", "JA16SJIS", "JA16SJISTILDE", "JA16EUC", "JA16EUCTILDE", "GBK", "ZHS16GBK", "VN8VN3", "WE8MSWIN1252", "ZHT16HKSCS", "CL8MSWIN1251", "WE8ISO8859P1", "EE8ISO8859P2", "WE8ISO8859P9", "WE8ISO8859P15", "CL8KOI8R", "CL8ISO8859P5", "RU8PC866", "TH8TISASCII", "EL8MSWIN1253", "EL8ISO8859P7", "AR8MSWIN1256", "AR8ISO8859P6"

    Parameter type

    Integer

    Default Value

    1

    Class

    Mandatory, Static

    Range

    1 - 20

    Parameter type

    String

    Default Value

    "UTF16"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    "TIBERO"

    Class

    Mandatory, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "#encrypted"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 32

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "CNT"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 36500

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 1000G

    Parameter type

    Integer

    Default Value

    2147483648

    Class

    Optional, Dynamic

    Range

    1M - 32G

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1800

    Class

    Optional, Static

    Range

    1 - 3600

    APPLY_NUM

    Parameter Format

    APPLY_REPORT_BACKUP_DIR

    Parameter Format

    APPLY_REPORT_BACKUP_SIZE

    Parameter Format

    APPLY_REPORT_DIR

    Parameter Format

    APPLY_REPORT_FILE_SIZE

    Parameter Format

    APPLY_TO_DB

    Parameter Format

    APPLY_TO_REPORT

    Parameter Format

    APPLY_TO_SAM

    Parameter Format

    BATCH_MEM_SIZE

    Parameter Format

    CHUNK_TOTAL_SIZE

    Parameter Format

    COL_SAM_TEMPLATE

    Parameter Format

    CONN_MAX

    Parameter Format

    DDL

    Parameter Format

    DISCARD_BACKUP_DIR

    Parameter Format

    DISCARD_BACKUP_SIZE

    Parameter Format

    DISCARD_CAST_ERR

    Parameter Format

    DISCARD_DDL_BACKUP_DIR

    Parameter Format

    DISCARD_DDL_BACKUP_SIZE

    Parameter Format

    DISCARD_DDL_FILE_DIR

    Parameter Format

    DISCARD_DDL_FILE_SIZE

    Parameter Format

    DISCARD_DDL_FILE_YN

    Parameter Format

    DISCARD_DDL_YN

    Parameter Format

    DISCARD_EC

    Parameter Format

    DISCARD_FILE_DIR

    Parameter Format

    DISCARD_FILE_SIZE

    Parameter Format

    DISCARD_FILE_YN

    Parameter Format

    DISCARD_YN

    Parameter Format

    DML_WAIT_TIMEOUT

    Parameter Format

    DSN_DIR

    Parameter Format

    DSN_FILE

    Parameter Format

    ENABLE_DDL_METADATA_BROADCAST

    Parameter Format

    GROUP_NUM

    Parameter Format

    KEY_VIOLATION_RETRY_CNT

    Parameter Format

    LCT_UPDATE_INTERVAL

    Parameter Format

    LEADING_PRS_USER

    Parameter Format

    LLOB_APPLY_MODE

    Parameter Format

    LOG_BACKUP_DIR

    Parameter Format

    LOG_BACKUP_SIZE

    Parameter Format

    LOG_DIR

    Parameter Format

    LOG_FILE_SIZE

    Parameter Format

    LOG_LEVEL

    Parameter Format

    MAP

    Parameter Format

    MAP_SKIP_UPD_WHERE

    Parameter Format

    MEMORY_CTRL_RESUME_SIZE

    Parameter Format

    MEMORY_CTRL_STOP_SIZE

    Parameter Format

    MERGE_BLOCK_CNT

    Parameter Format

    MERGE_RESUME_CNT

    Parameter Format

    OCI_DRIVER

    Parameter Format

    ODBC_DRIVER

    Parameter Format

    PRS_PROC_AGENT_CONNECTION_TIMEOUT

    Parameter Format

    PRS_PWD

    Parameter Format

    PRS_USER

    Parameter Format

    PR_MODE

    Parameter Format

    RECORD_HISTORY

    Parameter Format

    REPLAY_THREAD_CNT

    Parameter Format

    REPO_RESOURCE_INSERT_INTERVAL

    Parameter Format

    RETENTION_FILE_CLEANUP_INTERVAL

    Parameter Format

    SAM_BACKUP_DIR

    Parameter Format

    SAM_BACKUP_SIZE

    Parameter Format

    SAM_BIND_VALUE

    Parameter Format

    SAM_DIR

    Parameter Format

    SAM_FILE_SIZE

    Parameter Format

    SAM_LOG_PREFIX

    Parameter Format

    SQL_REDO_MODE

    Parameter Format

    SRC_DB_CHARSET

    Parameter Format

    SRC_DB_CNT

    Parameter Format

    SRC_DB_NCHARSET

    Parameter Format

    STMT_SAM_TEMPLATE

    Parameter Format

    TAR_DB_NAME

    Parameter Format

    TAR_DB_TYPE

    Parameter Format

    TDE_FOR_APPLY

    Parameter Format

    TDE_WALLET_FILE

    Parameter Format

    TDE_WALLET_PWD

    Parameter Format

    TX_HASH_FILE_CNT

    Parameter Format

    TX_HASH_FILE_DIR

    Parameter Format

    TX_HASH_FILE_MODE

    Parameter Format

    TX_HASH_FILE_RETENTION_DAY

    Parameter Format

    TX_HASH_FILE_TOTAL_SIZE

    Parameter Format

    TX_HASH_SIZE

    Parameter Format

    TX_SAM_TEMPLATE

    Parameter Format

    UPDATE_LCT_WHEN_ADD_HIST

    Parameter Format

    USE_BATCH_MODE

    Parameter Format

    USE_LOGMNR

    Parameter Format

    USE_ONLY_INSERT_BATCH

    Parameter Format

    USE_PK_FOR_WHERE

    Parameter Format

    VERIFY_TIMEOUT

    Parameter Format

    Extract Parameters

    ARCHIVE_LOG_DIR

    ARCHIVE_LOG_DIR specifies the directory where the archive logs are stored. It must be specified as an absolute path.

    Parameter Format

    Property
    Description

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    ARCHIVE_LOG_FORMAT specifies the archived log file format. Supported formats are %r:RESETLOGS_CHANGE#, %s:SEQUENCE#, %S:8byte SEQUENCE# padded with 0, and %t:THREAD#.

    Property
    Description

    ASM_DB_NAME specifies the Oracle ASM instance alias used by oracle log reader. Required for ASM redo file(+...) access.

    Property
    Description

    ASM_IO_WORKERS specifies the number of ASM parallel I/O worker sessions used by oracle log reader when reading ASM redo (+...). Applied at extract startup only (not dynamic). Effective workers = min(ASM_IO_WORKERS, compile-time OLR_ASM_PARA_WORKERS).

    Property
    Description

    ASM_PWD specifies the Oracle ASM user password used by oracle log reader. Required for ASM redo file(+...) access.

    Property
    Description

    ASM_USER specifies the Oracle ASM user used by oracle log reader. Required for ASM redo file(+...) access.

    Property
    Description

    BINLOG_INIT_POSITION specifies the starting position of mysql binlog.

    Property
    Description

    The COL_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when outputting column content for DML statements. It works when SQL_REDO_MODE is set to N. When logging DML statements, if column definitions are present in the COL_SAM_TEMPLATE, ProSync logs the column information to the SAM file according to that template format.

    Property
    Description

    CONNECT_TO_APPLY_CHECK_INTERVAL specifies the interval at which the connection is attempted when the connection between ext and apply is lost.

    Property
    Description

    CONN_MAX specifies the max number of connections between processes.

    Property
    Description

    DICT_FILE_DIR specifies the directory where user wants to make dictfile while using oracle logminer version.

    Property
    Description

    DSN_DIR specifies the directory where the dsn file located. It must be specified as an absolute path.

    Property
    Description

    DSN_FILE specifies name of dsn file.

    Property
    Description

    DUMMY_LOG_SEND_INTERVAL_COMMIT_TSN specifies the interval of sending dummy tx to prevent synchronization delay in TAC and RAC.

    Property
    Description

    DUMMY_TX_INTERVAL specifies the interval (in seconds) at which the extract process generates a dummy transaction on the source database. At each interval the extract process updates the row for its own extract number in PRS_DUMMY_TBL on the local source instance and commits, so that redo or WAL keeps being generated even while no user DML occurs. This prevents the apply process from delaying transaction merge because of an idle node in a cluster (TAC or RAC) environment. The interval is measured from the previous dummy transaction regardless of whether logs remain to be read, a value smaller than 5 is treated as 5, and the dummy transaction is generated only when EXT_TO_APPLY is Y.

    Property
    Description

    ENABLE_NETWORK_COMPRESS specifies whether to compress data when sending data from the extract process to the apply process. If set to 'Y', performance may be affected due to the compress/decompress process when sending/receiving data. This is useful when sending large amounts of data across a large network.

    Property
    Description

    ENABLE_NETWORK_ENCRYPT specifies whether to encrypt data when sending data from the extract process to the apply process. If set to 'Y', data is sent using the SSL protocol.

    Property
    Description

    determines whether to send only LCR of synchronization table to the apply process

    Property
    Description

    ENABLE_TSC_STANDBY enables TSC standby source mode. In this mode, ProSync reads from SRC_DB_NAME and sends source-side writes to SRC_PRIMARY_DB_NAME.

    Property
    Description

    EXCLUDE_USER specifies the name of a user to be excluded from extract operations. If bi-directional synchronization is used, enter a ProSync user name that uses reverse directional synchronization.

    Property
    Description

    EXTRACT_ARCHIVE_LOG_ONLY specifies to only extract archived log. If set to 'Y', redo log is archived and cannot be extracted until a new archived log is created.

    Property
    Description

    EXTRACT_NUM specifies the instance number of the source database. It must be greater than or equal to 1. For a database cluster, each extract process must be assigned a different number in sequential order (1, 2, 3...).

    Property
    Description

    EXT_TO_APPLY specifies whether the extract process sends the extracted change records to the apply process. If set to 'N', the chunks that the read threads produce are not transmitted to any apply process, so this parameter is normally set to 'N' only together with EXT_TO_SAM in order to write the extracted changes into the SAM file without replicating them. The periodic dummy transaction controlled by DUMMY_TX_INTERVAL is also generated only when this parameter is set to 'Y'.

    Property
    Description

    This parameter sets whether to log statements that are passed from the EXT process to the APPLY process into the SAM file. (Y/N)

    Property
    Description

    INSTANCE_FAILURE_CHECK_INTERVAL specifies instance status check interval (in seconds) in a cluster database environment. The extract process does not perform status checks at each interval. The check occurs at the set interval from the time when there are no more redo or archive logs to read (no new logs are generated).

    Property
    Description

    LOG_BACKUP_DIR specifies the directory where the ProSync log files are backed up. It must be specified as an absolute path.

    Property
    Description

    LOG_BACKUP_SIZE specifies the maximum size of all backup files in the process. If this limit is exceeded, the oldest log files in the directory are deleted.

    Property
    Description

    LOG_DIR specifies the directory where the ProSync log files are stored. It must be specified as an absolute path.

    Property
    Description

    LOG_FILE_SIZE specifies the maximum log file size. If a log file exceeds this limit, it is moved to the backup directory and a new log file is created.

    Property
    Description

    LOG_LEVEL specifies the log level of the process. A higher log-level produces more detailed logs.

    Property
    Description

    LOG_SWITCH_INTERVAL specifies interval of log switch.

    Property
    Description

    LR_FILE_CNT determines how many lr files to keep in LR directory

    Property
    Description

    LR_FILE_DELETE_MODE determines how to control lr files

    Property
    Description

    LR_FILE_RETENTION_DAY determines retention period(days) for lr files

    Property
    Description

    LR_FILE_TOTAL_SIZE determines max size of lr files to keep in LR directory

    Property
    Description

    LR_LOG_BACKUP_DIR specifies the directory where the LR_LOG files of ext process are backed up. It must be specified as an absolute path.

    Property
    Description

    LR_LOG_BACKUP_SIZE specifies the maximum size of LR_LOG backup files of ext process. If this limit is exceeded, the oldest LR_LOG files in the directory are deleted.

    Property
    Description

    LR_LOG_DIR specifies the directory where the LR_LOG files are stored. It must be specified as an absolute path.

    Property
    Description

    LR_LOG_FILE_SIZE specifies the maximum LR_LOG file size of ext process. If a LR_LOG file exceeds this limit, it is moved to the backup directory and a new LR_LOG file is created.

    Property
    Description

    LR_STOP_AT_CORRUPTED_LCR_0 determines whether to stop when extracting a corrupted LCR for a table with object id and segment id equal to 0

    Property
    Description

    LR_STOP_AT_CORRUPTED_LCR_ALL determines whether to stop when extracting all types of corrupted LCR

    Property
    Description

    LR_STOP_AT_CORRUPTED_LCR_TARGET determines whether to stop when a corrupted LCR is extracted for the synchronization table

    Property
    Description

    LR_TRACE_LVL specifies the logging level of the log reader. A higher log-level produces more detailed logs.

    Property
    Description

    LR_WARN_AT_CORRUPTED_LCR_0 determines whether the log type of a corrupted LCR with object id and segment id equal to 0 will be [W] or [F]

    Property
    Description

    LR_WARN_AT_CORRUPTED_LCR_ALL determines whether the log type for all types of corrupted LCR will be [W] or [F]

    Property
    Description

    LR_WARN_AT_CORRUPTED_LCR_TARGET determines whether the log type of a corrupted LCR for the synchronization table will be [W] or [F]

    Property
    Description

    MYSQLBINLOG_RETRY_CNT specifies how many consecutive times the extract process retries when the mysqlbinlog command that it runs to read the source binary log fails. Each retry switches to local mode, which copies the binary log file under $PRS_HOME/var/<instance>/binlog_backup and reads it locally, and the retry count is reset to 0 after a successful run. Extraction stops with an error once the retry count reaches this value, so 0 means that the extract process stops on the first failure.

    Property
    Description

    MYSQLBINLOG_RETRY_INTERVAL specifies the time (in seconds) that the extract process waits before retrying when the mysqlbinlog command that it runs to read the source binary log fails. The retry itself is repeated up to MYSQLBINLOG_RETRY_CNT times.

    Property
    Description

    MYSQL_BINLOG_PREFIX specifies the prefix of mysql binlog file name.

    Property
    Description

    NETWORK_COMPRESS_LEVEL specifies the zlib compression level that the extract process uses when it compresses a chunk before sending it to the apply process. 0 means no compression and 9 means maximum compression, so a higher level reduces the amount of data sent over the network but consumes more CPU. This parameter takes effect only when ENABLE_NETWORK_COMPRESS is set to 'Y'.

    Property
    Description

    OCI_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. for Oracle, enter a path to the libclntsh.so file.

    Property
    Description

    ODBC_DRIVER specifies a path to the client library used to access a database. An absolute path must be specified. Set a path to the proper library file.

    Property
    Description

    PQ_DRIVER specifies a path to the pq library used to access a database. An absolute path must be specified. For PostgreSQL, set a path to the libpq.so file.

    Property
    Description

    PQ_REP_CONN_NAME specifies the replication connection name.

    Property
    Description

    PREFETCH_SIZE specifies the number of rows to fetch for each oci fetch call. This parameter is used only in oracle logminer version.

    Property
    Description

    connection timeout from process to agent. if a process cannot connect to agent while this timeout, kill itself

    Property
    Description

    PRS_PWD specifies the database user password. If the password is encrypted, append the string '#encrypted'.

    Property
    Description

    PRS_USER specifies the database user.

    Property
    Description

    This parameter decides how often to insert resource data into repoDB.

    Property
    Description

    RESUME_WAIT_TIME specifies the interval (in seconds) at which the read thread of the extract process polls for a resume while its log reading is suspended. The read thread is suspended when it is paused by an administrator command, when it is paused by flow control from the apply process, or while an ADD TABLE, DEL TABLE, or DD reload request is being processed, and it sleeps for this interval on every polling iteration until the request is cleared.

    Property
    Description

    RETENTION_FILE_CLEANUP_INTERVAL specifies how often retention-based file cleanup is checked.

    Property
    Description

    If a transaction references any object ID listed in this parameter, skip the entire transaction.

    Property
    Description

    SAM_BACKUP_DIR specifies the directory where the SAM files are backed up. It must be specified as an absolute path.

    Property
    Description

    SAM_BACKUP_SIZE specifies the maximum size of SAM backup files. If this limit is exceeded, the oldest SAM files in the directory are deleted.

    Property
    Description

    SAM_BIND_VALUE specifies whether to retain the values of the query in SAM files. If set to 'Y', the specific values of the query are retained. If set to 'N', every value in the query is replaced with '?'.

    Property
    Description

    SAM_DIR specifies the directory where the sam files are stored. It must be specified as an absolute path.

    Property
    Description

    SAM_FILE_SIZE specifies the maximum SAM file size. If a SAM file exceeds this limit, it is moved to the backup directory and a new SAM file is created.

    Property
    Description

    SAM_LOG_PREFIX specifies whether to include timestamp and thread information for each query in the SAM files, similar to how prosync logging works. If set to 'Y', this information is prepended to each row in the SAM files. If set to 'N', the timestamp and thread information is not included on each row.

    Property
    Description

    The SQL_REDO_MODE parameter specifies whether to log the full DML/DDL statements into the SAM files. Y: The DML statements are logged row-by-row into the SAM files. (This is the default setting). N: The DML statements are not logged row-by-row into the SAM files.

    Property
    Description

    SRC_DB_IP specifies the database IP Address.

    Property
    Description

    SRC_DB_NAME specifies the name(Alias) of the source database. For TIBERO, UPDB, or K-DB, use the value specified in the dsn file. For ORACLE, use the value specified in the tnsname file.

    Property
    Description

    SRC_DB_PORT specifies the database port.

    Property
    Description

    SRC_DB_TYPE specifies the type of the source database to extract data from. Options are TIBERO, UPDB, KDB, or ORACLE.

    Property
    Description

    SRC_LOCAL_SID indicates specified instance name of the source database in RAC or TAC.

    Property
    Description

    SRC_PRIMARY_DB_NAME specifies the writable primary database alias used when ENABLE_TSC_STANDBY is enabled.

    Property
    Description

    SRC_PRIMARY_LOCAL_SID indicates the writable primary local instance name used when ENABLE_TSC_STANDBY is enabled.

    Property
    Description

    The STMT_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when logging statement (DML/DDL) content to the SAM file. It works when SQL_REDO_MODE is set to N. ProSync reads the template from the specified path and logs the DDL and DML content to the SAM file according to that template format.

    Property
    Description

    TDE_FOR_EXT specifies whether use data decryption from source database

    Property
    Description

    TDE_FOR_TABLESPACE specifies whether use tablespace decryption from source database

    Property
    Description

    Absolute library path with the library file name. It is used for linking with an HSM device.

    Property
    Description

    pin value for HSM. It is used for linking with an HSM device.

    Property
    Description

    Option to use the PKCS #11 wrapping key option for linking an HSM device.

    Property
    Description

    Option to use Hardware Security Module (HSM) to save data encryption keys.

    Property
    Description

    TDE_WALLET_FILE specifies the wallet file name of source db including absolute path

    Property
    Description

    TDE_WALLET_PWD specifies the password of wallet file for tde

    Property
    Description

    TX_FILTER_KEY specifies the key tables that the extract process uses to filter changes at the transaction level. The default value FILTER DEFAULT disables transaction filtering. With EXCLUDE FILTER <owner>.<table>, <INSERT|DELETE|UPDATE|ALL> the extract process skips the entire transaction as soon as it performs the specified operation on a key table, and emits an entire-rollback record so that the changes already sent for that transaction are discarded. With SYNC FILTER <owner>.<table>, <INSERT|DELETE|UPDATE|ALL> it extracts only the transactions whose first DML is the specified operation on a key table and skips all the other transactions. The EXCLUDE and SYNC keywords select a mode for the whole extract process, not for an individual rule: all the key tables listed share one mode, and the mode is taken from the first rule that carries a keyword, so mixing EXCLUDE and SYNC rules in a single value is not supported and the extract process logs a warning when it finds such a mix. A rule written without a keyword, FILTER <owner>.<table>, <INSERT|DELETE|UPDATE|ALL>, only registers a key table and leaves the mode at its default, SYNC. Every key table listed must exist in the data dictionary, otherwise loading the DD fails.

    Property
    Description

    The TX_SAM_TEMPLATE parameter sets the path to the user-defined template file to be used when outputting transactions to the SAM file. It works when SQL_REDO_MODE is set to N. ProSync reads the template from the specified path whenever a transaction encounters a commit, and logs the transaction content to the SAM file according to that template format.

    Property
    Description

    USE_LOGMNR specifies whether to use oracle logminer or to use oracle log reader, when analyzing redo logs.

    Property
    Description

    Range

    Parameter type

    String

    Default Value

    "log-t%t-r%r-s%s.arc"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    4

    Class

    Optional, Static

    Range

    1 - 8

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    120

    Class

    Optional, Static

    Range

    1 - INT32_MAX

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 3600

    Parameter type

    Integer

    Default Value

    128

    Class

    Optional, Static

    Range

    32 - 1024

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1000

    Class

    Optional, Static

    Range

    10 - UINT64_MAX

    Parameter type

    Integer

    Default Value

    5

    Class

    Optional, Static

    Range

    1 - 1000

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1

    Class

    Mandatory, Static

    Range

    1 - 1024

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Dynamic

    Range

    Parameter type

    Integer

    Default Value

    5

    Class

    Optional, Static

    Range

    5 - 3600

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    104857600

    Class

    Optional, Dynamic

    Range

    1M - 1G

    Parameter type

    Integer

    Default Value

    3

    Class

    Mandatory, Dynamic

    Range

    1 - 5

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - INT32_MAX

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 2147483647

    Parameter type

    String

    Default Value

    "CNT"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 36500

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 1000G

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Static

    Range

    0 - 128G

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    17179869184

    Class

    Optional, Static

    Range

    1M - 16G

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    2

    Class

    Optional, Dynamic

    Range

    1 - 5

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    3

    Class

    Optional, Static

    Range

    0 - 10000

    Parameter type

    Integer

    Default Value

    3

    Class

    Optional, Static

    Range

    1 - 120

    Parameter type

    String

    Default Value

    "bin"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1

    Class

    Optional, Static

    Range

    0 - 9

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    1

    Class

    Optional, Static

    Range

    1 - UINT32_MAX

    Parameter type

    Integer

    Default Value

    180

    Class

    Optional, Static

    Range

    0 - 86400

    Parameter type

    String

    Default Value

    "#encrypted"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    Integer

    Default Value

    60

    Class

    Optional, Static

    Range

    60 - 3600

    Parameter type

    Integer

    Default Value

    3

    Class

    Optional, Static

    Range

    1 - 120

    Parameter type

    Integer

    Default Value

    3600

    Class

    Optional, Dynamic

    Range

    60 - 86400

    Parameter type

    desc

    Default Value

    "()"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    0

    Class

    Optional, Dynamic

    Range

    0 - 128G

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Dynamic

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Integer

    Default Value

    17179869184

    Class

    Optional, Dynamic

    Range

    1M - 16G

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Dynamic

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "localhost"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    "7600"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "TIBERO"

    Class

    Mandatory, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    ""

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    Y

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    String

    Default Value

    "#encrypted"

    Class

    Optional, Static

    Range

    Parameter type

    desc

    Default Value

    "(FILTER DEFAULT)"

    Class

    Optional, Static

    Range

    Parameter type

    path

    Default Value

    "/"

    Class

    Optional, Static

    Range

    Parameter type

    Boolean

    Default Value

    N

    Class

    Optional, Static

    Range

    ARCHIVE_LOG_FORMAT

    Parameter Format

    ASM_DB_NAME

    Parameter Format

    ASM_IO_WORKERS

    Parameter Format

    ASM_PWD

    Parameter Format

    ASM_USER

    Parameter Format

    BINLOG_INIT_POSITION

    Parameter Format

    COL_SAM_TEMPLATE

    Parameter Format

    CONNECT_TO_APPLY_CHECK_INTERVAL

    Parameter Format

    CONN_MAX

    Parameter Format

    DICT_FILE_DIR

    Parameter Format

    DSN_DIR

    Parameter Format

    DSN_FILE

    Parameter Format

    DUMMY_LOG_SEND_INTERVAL_COMMIT_TSN

    Parameter Format

    DUMMY_TX_INTERVAL

    Parameter Format

    ENABLE_NETWORK_COMPRESS

    Parameter Format

    ENABLE_NETWORK_ENCRYPT

    Parameter Format

    ENABLE_SYNC_TABLE_FILTER

    Parameter Format

    ENABLE_TSC_STANDBY

    Parameter Format

    EXCLUDE_USER

    Parameter Format

    EXTRACT_ARCHIVE_LOG_ONLY

    Parameter Format

    EXTRACT_NUM

    Parameter Format

    EXT_TO_APPLY

    Parameter Format

    EXT_TO_SAM

    Parameter Format

    INSTANCE_FAILURE_CHECK_INTERVAL

    Parameter Format

    LOG_BACKUP_DIR

    Parameter Format

    LOG_BACKUP_SIZE

    Parameter Format

    LOG_DIR

    Parameter Format

    LOG_FILE_SIZE

    Parameter Format

    LOG_LEVEL

    Parameter Format

    LOG_SWITCH_INTERVAL

    Parameter Format

    LR_FILE_CNT

    Parameter Format

    LR_FILE_DELETE_MODE

    Parameter Format

    LR_FILE_RETENTION_DAY

    Parameter Format

    LR_FILE_TOTAL_SIZE

    Parameter Format

    LR_LOG_BACKUP_DIR

    Parameter Format

    LR_LOG_BACKUP_SIZE

    Parameter Format

    LR_LOG_DIR

    Parameter Format

    LR_LOG_FILE_SIZE

    Parameter Format

    LR_STOP_AT_CORRUPTED_LCR_0

    Parameter Format

    LR_STOP_AT_CORRUPTED_LCR_ALL

    Parameter Format

    LR_STOP_AT_CORRUPTED_LCR_TARGET

    Parameter Format

    LR_TRACE_LVL

    Parameter Format

    LR_WARN_AT_CORRUPTED_LCR_0

    Parameter Format

    LR_WARN_AT_CORRUPTED_LCR_ALL

    Parameter Format

    LR_WARN_AT_CORRUPTED_LCR_TARGET

    Parameter Format

    MYSQLBINLOG_RETRY_CNT

    Parameter Format

    MYSQLBINLOG_RETRY_INTERVAL

    Parameter Format

    MYSQL_BINLOG_PREFIX

    Parameter Format

    NETWORK_COMPRESS_LEVEL

    Parameter Format

    OCI_DRIVER

    Parameter Format

    ODBC_DRIVER

    Parameter Format

    PQ_DRIVER

    Parameter Format

    PQ_REP_CONN_NAME

    Parameter Format

    PREFETCH_SIZE

    Parameter Format

    PRS_PROC_AGENT_CONNECTION_TIMEOUT

    Parameter Format

    PRS_PWD

    Parameter Format

    PRS_USER

    Parameter Format

    REPO_RESOURCE_INSERT_INTERVAL

    Parameter Format

    RESUME_WAIT_TIME

    Parameter Format

    RETENTION_FILE_CLEANUP_INTERVAL

    Parameter Format

    ROLLBACK_OBJECT_IDS

    Parameter Format

    SAM_BACKUP_DIR

    Parameter Format

    SAM_BACKUP_SIZE

    Parameter Format

    SAM_BIND_VALUE

    Parameter Format

    SAM_DIR

    Parameter Format

    SAM_FILE_SIZE

    Parameter Format

    SAM_LOG_PREFIX

    Parameter Format

    SQL_REDO_MODE

    Parameter Format

    SRC_DB_IP

    Parameter Format

    SRC_DB_NAME

    Parameter Format

    SRC_DB_PORT

    Parameter Format

    SRC_DB_TYPE

    Parameter Format

    SRC_LOCAL_SID

    Parameter Format

    SRC_PRIMARY_DB_NAME

    Parameter Format

    SRC_PRIMARY_LOCAL_SID

    Parameter Format

    STMT_SAM_TEMPLATE

    Parameter Format

    TDE_FOR_EXT

    Parameter Format

    TDE_FOR_TABLESPACE

    Parameter Format

    TDE_HSM_LIB_FILE

    Parameter Format

    TDE_HSM_PIN

    Parameter Format

    TDE_HSM_USE_WRAPPING

    Parameter Format

    TDE_USE_HSM

    Parameter Format

    TDE_WALLET_FILE

    Parameter Format

    TDE_WALLET_PWD

    Parameter Format

    TX_FILTER_KEY

    Parameter Format

    TX_SAM_TEMPLATE

    Parameter Format

    USE_LOGMNR

    Parameter Format