Oracle ZDM 26.1 Instant Deploy: OKV(Oracle Key Vault)를 사용한 엔드투엔드 물리적 PDB 복제
소개
Oracle Zero Downtime Migration(ZDM) 26.1은 Instant Deploy를 도입하여 전용 ZDM 서버 없이도 소스 또는 대상 데이터베이스 호스트에서 직접 데이터베이스 마이그레이션을 수행할 수 있게 되었습니다. 또한 이 릴리스는 OKV(Oracle Key Vault)와의 통합을 향상시키고 TDE(Transparent Data Encryption) 전자 지갑 이전 기능을 개선합니다.
이전 ZDM 릴리스의 제한 사항
Oracle ZDM 26.1 이전 버전:
- Instant Deploy를 사용할 수 없습니다. 데이터베이스 마이그레이션에는 전용 ZDM 서버 설치 및 수명 주기 관리가 필요했습니다.
- OKV(Oracle Key Vault) 외부 키 저장소 전자 지갑의 자동 마이그레이션은 지원되지 않습니다. 소스 또는 대상 데이터베이스에서 OKV 외부 키 저장소를 사용한 경우 TDE 전자 지갑 이전 및 키 관리를 수동으로 수행해야 했습니다.
ZDM 26.1의 새로운 기능
- 소스 또는 대상 데이터베이스가 OKV(Oracle Key Vault) 외부 키 저장소를 사용하도록 구성된 경우 ZDM 26.1은 자동으로 외부 키 저장소 전자 지갑을 이전합니다.
ZDM 26.1은 다음과 같은 전자 지갑 이전 시나리오를 지원합니다.
- OKV 전자 지갑이 있는 소스 데이터베이스를 OKV 전자 지갑이 있는 대상 데이터베이스로
- OKV 전자 지갑이 있는 소스 데이터베이스와 파일 기반 전자 지갑이 있는 대상 데이터베이스
- 파일 기반 전자 지갑이 있는 소스 데이터베이스를 OKV 전자 지갑이 있는 대상 데이터베이스로
- 파일 기반 전자 지갑(wallet)이 있는 소스 데이터베이스를 파일 기반 전자 지갑(wallet)이 있는 대상 데이터베이스로
ZDM 26.1은 소스 데이터베이스가 OKV 전자 지갑을 사용하도록 구성되었는지 여부를 감지하고 TDE 키를 대상 데이터베이스로 이전하기 전에 다운로드합니다. 대상 데이터베이스도 OKV 전자 지갑으로 구성된 경우 ZDM은 이전된 TDE 키를 대상 OKV 전자 지갑으로 업로드합니다. ZDM이 이전 워크플로우 중 TDE 전자 지갑을 자동으로 이전할 수 있도록 하려면 ZDM_SKIP_TDE_WALLET_MIGRATION 매개변수를 기본값(FALSE)으로 둡니다.

목표
-
전용 ZDM 서버 없이도 ZDM 26.1 Instant Deployment를 활용할 수 있습니다.
-
중앙 집중식 TDE 키 관리를 위해 소스 및 대상 데이터베이스 모두에서 OKV(Oracle Key Vault)를 사용할 수 있습니다.
-
수동 TDE 전자 지갑 및 암호화 키 마이그레이션 작업을 제거합니다.
-
ZDM 26.1 PDB 복제 기능을 사용하여 TDE 사용 PDB의 엔드투엔드 이전을 보여줍니다.
-
ZDM 26.1에서 데이터베이스 링크 기반 이전 방법을 사용하여 새로고침 가능 PDB 복제본을 생성합니다.
버전 호환성
이 사용지침서에서는 엔드투엔드 물리적 PDB 복제 및 자동 TDE 전자 지갑 마이그레이션을 위한 Oracle Zero Downtime Migration(ZDM) 26.1 Instant Deploy와 Oracle AI Database 26ai 및 Oracle Key Vault(OKV) 21.14를 보여줍니다.
이 자습서의 기본 워크플로우는 다음을 사용하여 검증되었습니다.
- Oracle AI Database 26ai(릴리스 23.26 이상)
- Oracle Zero Downtime Migration(ZDM) 26.1
- OKV(Oracle Key Vault) 21.14
주: 이 자습서의 일부 섹션은 참조용으로 이전 Oracle Database 릴리스에만 적용할 수 있습니다. 이러한 절은 12.1 Only 또는 18c and 19c Only로 명확하게 표시되며, Oracle AI Database 26ai를 사용할 때 건너뛸 수 있습니다.
이전 전 현재 환경
ZDM(Oracle Zero Downtime Migration) 워크플로우를 시작하기 전에 소스 및 대상 환경이 모두 물리적 PDB 복제에 대해 올바르게 구성되었는지 확인하십시오. 다음 표에는 이 자습서에 사용된 환경과 마이그레이션 전 주요 구성 요소의 상태가 요약되어 있습니다.

필수 조건
주: 이 자습서를 시작하기 전에 사용자 환경이 모든 Oracle Zero Downtime Migration(ZDM) 26.1 필요 조건을 충족하는지 확인하십시오. 필요 조건의 전체 목록은 Oracle ZDM 설명서의 데이터베이스 이전 준비 섹션을 참조하십시오.
https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/zdmug/preparing-for-database-migration.html#GUID-25B07C59-8143-41CB-B431-3D9225CCFDD6
Oracle Zero Downtime Migration(ZDM) 26.1 Instant Deploy 설정
- Instant Deploy는 별도의 ZDM 서버를 설치하거나 유지 관리할 필요 없이 ZDM(Zero Downtime Migration)을 직접 실행할 수 있는 가볍고 다운로드 가능한 소프트웨어 패키지입니다.
- 그러나 영구 서비스를 설치하거나 시작하지 않고는 표준 ZDM과 동일한 zdmcli 명령 및 사용자 환경을 사용합니다.
- CLI는 마이그레이션을 실행하고 라이브 진행 업데이트를 제공합니다.
- 마이그레이션 중인 데이터베이스 호스트와 동일한 데이터베이스 호스트에서 ZDM 인스턴트 배포 도구를 실행할 수 있습니다.
- 인스턴트 배포 기능을 통해 Oracle은 최소한의 인프라 요구 사항으로 데이터베이스 마이그레이션을 용이하게 할 수 있습니다.
환경
이 사용지침서에서는 데모용으로 OCI Oracle Base Database Service와 Oracle AI Database 26ai 버전 23.26.2.0.0을 사용합니다.
소스: 호스트 이름: sourcedb, DB 이름: ORADB, DB 고유 이름: ORADB_src TDE는 OKV(Oracle Key Vault)에서 관리됩니다.

대상: hostname: targetdb, DB 이름: ORADB, DB 고유 이름: ORADB_tgt TDE는 파일 기반 전자 지갑을 사용합니다.

마이그레이션 워크플로우
1단계: Oracle ZDM 제품 페이지(버전 26.1)에서 최신 ZDM(Oracle Zero Downtime Migration) 26.1 릴리스를 다운로드합니다.
Oracle Zero Downtime Migration 다운로드 페이지에서 최신 Oracle Zero Downtime Migration(ZDM) 26.1 소프트웨어를 다운로드합니다. 이 소프트웨어는 OSDC(Oracle Software Delivery Cloud)를 통해 배포됩니다. Oracle SSO(Single Sign-On) 계정을 사용하여 사인인하고 사용권 계약에 동의한 다음 최신 ZDM 릴리스 패키지(예: V1055491-01.zip)를 다운로드합니다. 최신 다운로드 및 설명서는 다음 리소스를 참조하십시오.
Oracle Zero Downtime Migration Download:
https://www.oracle.com/database/technologies/rac/zdm-downloads.html
Oracle Zero Downtime Migration 26.1 Documentation:
https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/index.html
단계 2. 사용 가능한 저장소가 충분한 디렉토리에 V1055491-01.zip 파일을 복사합니다.
소프트웨어를 다운로드한 후 ZIP 아카이브를 소스 데이터베이스 호스트(또는 대상에서 Instant Deploy를 사용하려는 경우 대상 호스트)에 복사하고 다음 단계에서 추출을 진행합니다.

ZIP 파일을 추출하면 zdm26.1 하위 디렉토리가 생성됩니다. 추출된 ZDM 소프트웨어는 /opt/opc/zdm/zdm26.1에 있습니다.
3단계: 각 호스트의 /etc/hosts 파일을 다른 호스트의 이름과 IP 주소로 갱신합니다.
대상 호스트의 /etc/hosts 파일에 소스 호스트 이름 및 IP 정보를 추가합니다.

소스 호스트의 /etc/hosts 파일에 대상 호스트 이름 및 IP 정보를 추가합니다.

4단계: 소스 호스트에서 OS 유저(이 경우 opc)의 SSH 공개 키를 복사하여 대상 호스트의 OS 유저(이 경우 opc)에 대한 authorized_keys 파일에 추가합니다.
소스 호스트

대상 호스트

소스에서 대상 데이터베이스 호스트로의 SSH 연결을 테스트합니다.

SSH 권한 있는 사용자에 대해 TTY가 사용 안함으로 설정되었는지 확인합니다. TTY가 사용 안함으로 설정된 경우 다음 명령은 오류 없이 원격 호스트의 날짜를 반환합니다.

5단계: 소스 데이터베이스의 TDE가 OKV(Oracle Key Vault)에서 관리되는지 확인합니다.

6단계: 대상 데이터베이스에 대한 OKV(Oracle Key Vault) 구성
1: OKV(Oracle Key Vault) 끝점으로 대상 데이터베이스를 등록합니다.


2: OKV(Oracle Key Vault) 등록 토큰을 복사합니다.

3: 대상 데이터베이스 끝점을 등록하고 OKV(Oracle Key Vault) 끝점 소프트웨어를 다운로드합니다.

4: 대상 호스트에서 OKV에 필요한 디렉토리를 생성합니다.

5: Oracle Key Vault 끝점 JAR 파일을 설치합니다.

6: 대상 끝점에 소스 가상 전자 지갑(wallet) 할당:

7: OKV(Oracle Key Vault)로 현재 전자 지갑 업로드(파일 기반 전자 지갑에서 OKV로 이전):
OKV에 대한 연결이 확인되면 현재 전자 지갑을 OKV에 업로드합니다. 현재 WALLET_ROOT 위치를 확인하려면 다음 query를 실행합니다.

전자 지갑 위치를 식별한 후 기존 전자 지갑을 WALLET_ROOT/tde로 복사합니다.

복사가 완료되면 WALLET_ROOT/tde에 저장된 전자 지갑과 함께 WALLET_ROOT/okv/bin/okvutil를 사용하여 OKV에 전자 지갑을 업로드합니다.

8: OKV 키 저장소에 자동으로 로그인할 수 있도록 키 저장소에 OKV 암호를 추가합니다(모든 노드에서 실행).

9: 외부 저장소를 사용할 암호 키 추가(모든 노드에서 실행):

10: 데이터베이스 초기화 파라미터 갱신:
OKV 사용에 대한 wallet_root 및 tde_configuration 초기화 매개변수를 업데이트합니다. tde_configuration 초기화 매개변수는 wallet_root 매개변수에 따라 달라집니다. wallet_root 매개변수는 SPFILE 범위를 가지므로 변경사항을 적용하려면 데이터베이스를 재시작해야 합니다.
또한 wallet_root 및 tde_configuration을 설정하면 sqlnet.ora의 ENCRYPTION_WALLET_LOCATION 설정이 대체됩니다.
데이터베이스 초기화 매개변수를 업데이트하기 전에 spfile 백업을 실행하십시오.

11: sqlnet.ora 및 RAC 데이터베이스 환경 설정(12.1만 해당):
wallet_root 및 tde_configuration init.ora 매개변수는 12.1에 없으므로 sqlnet.ora 및 RAC 데이터베이스 환경 설정을 변경해야 합니다.
SQLnet.ora:
Change only the method under the ENCRYPTION_WALLET_LOCATION entry to HSM:
ENCRYPTION_WALLET_LOCATION=
(SOURCE=
(METHOD=HSM)
(METHOD_DATA=(DIRECTORY=/var/opt/oracle/dbaas_acfs/DBNAME/tde_wallet)))
RAC 데이터베이스 환경 설정: RAC 데이터베이스 환경 설정에 ORACLE_BASE 및 ORACLE_UNQNAME 환경 변수를 추가합니다.
[opc@targetdb ~]$ srvctl getenv database -d DBNAMEUNIQUE
DBNAMEUNIQUE:
TNS_ADMIN=/u02/app/oracle/product/12.1.0/dbhome_1/network/admin/DBNAME
bash-3.2$ srvctl setenv database -d DBNAMEUNIQUE -T "ORACLE_BASE=/u02/app/oracle"
bash-3.2$ srvctl setenv database -d DBNAMEUNIQUE -T "ORACLE_UNQNAME=DBNAMEUNIQUE"
bash-3.2$ srvctl getenv database -d DBNAMEUNIQUE
12: 데이터베이스를 재시작합니다.
[opc@targetdb ~]$ srvctl stop database -d DBNAMEUNIQUE
[opc@targetdb ~]$ srvctl start database -d DBNAMEUNIQUE
13: TDE 키 저장소를 OKV(Oracle Key Vault)로 이전합니다.
하나의 데이터베이스 노드에서 다음 명령을 실행하여 TDE 소프트웨어 키 저장소를 OKV(Oracle Key Vault)로 이전합니다.
SQL>ADMINISTER KEY MANAGEMENT set key identified by "<OKV-pwd>" force keystore migrate using "TDE-wallet-password";

명령이 성공적으로 반환되면 데이터베이스를 다시 시작하여 Oracle Key Vault와의 통신이 올바르게 작동하는지 확인합니다.
[opc@targetdb ~]$ srvctl stop database -d DBNAMEUNIQUE
[opc@targetdb ~]$ srvctl start database -d DBNAMEUNIQUE
14: OKV(Oracle Key Vault) 구성 확인
다음 질의를 실행하여 OKV(Oracle Key Vault) 구성이 올바르게 구성되었으며 데이터베이스가 외부 키 저장소에 액세스할 수 있는지 확인합니다.

7단계: 소스 데이터베이스 호스트에 ZDM 응답 파일 생성 이 파일은 소스 및 대상 데이터베이스 정보, OKV(Oracle Key Vault) 매개변수 및 물리적 PDB 복제 설정을 비롯한 이전 구성을 정의합니다.
다음 예에서는 이 마이그레이션에 사용된 응답 파일을 보여줍니다.
[opc@sourcedb ~]$ more /opt/opc/zdm/zdm26.1/template/26.1.0/zdm_physical_PDB_Cloning.rsp
ZDM_SRC_DB_OKV_HOME=/u01/app/oracle/admin/ORADB_src/okv_home/okv
ZDM_TGT_DB_OKV_HOME=/u01/app/oracle/admin/ORADB_tgt/okv_home/okv
ZDM_SRC_DB_OKV_VIRTUAL_WALLET_NAME=sourcedbwallet
ZDM_TGT_DB_OKV_VIRTUAL_WALLET_NAME=sourcedbwallet
ZDM_SKIP_TDE_WALLET_MIGRATION=FALSE
PLATFORM_TYPE=VMDB
TGT_DB_UNIQUE_NAME=ORADB_tgt
MIGRATION_METHOD=ONLINE_PHYSICAL
DATA_TRANSFER_MEDIUM=DBLINK
ZDM_PDB_CLONE_METHOD=REFRESHABLE
ZDM_SRC_PDB_NAME=ORADB_PDB1
ZDM_TGT_PDB_NAME=ORADB_PDB1
ZDM_TGT_DBLINK_NAME=clonedblink
ZDM_TGT_DBLINK_USERNAME=
ZDM_TGT_DBLINK_PASSWORD_WALLET=
ZDM_PDB_REFRESH_INTERVAL=60
ZDM_SWITCHOVER=FALSE
ZDM_SRC_DB_RESTORE_SERVICE_NAME=ORADB_PDB1
8단계: 소스 데이터베이스 호스트에서 다음 명령을 실행하여 이전을 평가하고 소스 및 대상 환경이 이전할 준비가 되었는지 검증합니다.
[opc@sourcedb ~]$ /opt/opc/zdm/zdm26.1/zdmcli migrate database \
> -rsp /opt/opc/zdm/zdm26.1/template/26.1.0/zdm_physical_PDB_Cloning.rsp \
> -sourcedb ORADB_src \
> -sourcenode sourcedb \
> -targethome /u01/app/oracle/product/23.0.0.0/dbhome_1 \
> -tdekeystorepasswd \
> -tgttdekeystorepasswd \
> -targetnode targetdb \
> -schedule NOW \
> -eval
Enter source database ORADB_src SYS password:
Enter source database ORADB_src TDE keystore password:
Enter target container database TDE keystore password:
Migration evaluation job started
Result file path: /opt/opc/zdm/zdm26.1/zdmbase/chkbase/scheduled/job-6-2026-06-27-09:08:10.log
======================JOB_EXECUTION_DETAILS_START======================
User: opc
Client: dbSysyabixhpq
...............................................
.........................
참고:
OKV(Oracle Key Vault) 끝점 비밀번호가 TDE 키 저장소 비밀번호와 동일한 경우
-tdekeystorepasswd및-tgttdekeystorepasswd옵션으로도 충분합니다.OKV 끝점 비밀번호가 TDE 키 저장소 비밀번호와 다른 경우 다음 옵션도 지정합니다.
-okvkeystorepasswd– 소스 OKV 끝점 비밀번호를 묻습니다.-tgtokvkeystorepasswd– 대상 OKV 끝점 비밀번호에 대한 프롬프트를 표시합니다.이러한 옵션을 통해 ZDM은 전자 지갑 이전 중 TDE 키 저장소 비밀번호와 독립적으로 Oracle Key Vault 끝점을 사용하여 인증할 수 있습니다.
아래와 같이 마이그레이션 작업 상태를 확인합니다.

9단계: 마이그레이션을 시작하고 -pauseafter 옵션을 사용하여 ZDM_CLONE_PDB_TGT 단계 후 마이그레이션을 중지합니다. 이 단계 중 소스 PDB에 대한 변경사항은 ZDM_PDB_REFRESH_INTERVAL에서 지정된 간격에 따라 대상 PDB와 동기화됩니다.

10단계: 마이그레이션 작업 상태 확인

대상 PDB의 상태를 확인합니다.

11단계: 최종 애플리케이션 전환을 수행할 준비가 되면 마이그레이션 작업을 재개합니다.
[opc@sourcedb ~]$ /opt/opc/zdm/zdm26.1/zdmcli resume job -jobid 6

이전이 완료된 후 대상 PDB의 상태를 확인합니다.

자동 TDE 전자 지갑 이전 확인
다음 로그는 ZDM이 소스 데이터베이스 호스트의 OKV(Oracle Key Vault)에서 TDE 전자 지갑을 자동으로 다운로드함을 보여줍니다.

참조
- Oracle Zero Downtime Migration 26.1 설명서
- https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/
- https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/zdmug/preparing-for-database-migration.html#GUID-0049AE7E-12D7-402B-A988-1C8A802922CF
- 데이터베이스 이전 준비
- https://docs.oracle.com/en/database/oracle/zero-downtime-migration/26.1/zdmug/preparing-for-database-migration.html
- Oracle Key Vault 설명서
- https://docs.oracle.com/en/database/oracle/key-vault/
승인
작성자: Amresh Kumar Singh(주요 컨설턴트)
추가 학습 자원
docs.oracle.com/learn에서 다른 랩을 탐색하거나 Oracle Learning YouTube 채널에서 더 많은 무료 학습 콘텐츠에 액세스하세요. 또한 education.oracle.com/learning-explorer를 방문하여 Oracle Learning Explorer가 되십시오.
제품 설명서는 Oracle Help Center를 참조하십시오.
Oracle ZDM 26.1 Instant Deploy End-to-End Physical PDB Cloning with Oracle Key Vault (OKV)
G58245-02