Oracle GoldenGate 마이크로서비스 업그레이드 - GUI 기반

GUI를 사용하여 Oracle GoldenGate 마이크로서비스를 업그레이드하는 단계를 알아봅니다.

이 시점에서는 새로운 Oracle GoldenGate 26ai 마이크로서비스 홈과 Oracle GoldenGate MA의 이전 릴리스 홈이 있어야 합니다.

서비스 관리자 업그레이드

최신 Oracle GoldenGate MA 버전을 설치한 후 다음 단계는 Service Manager를 업그레이드하는 것입니다.

Oracle Grid Infrastructure 에이전트(XAG)를 사용하는 경우 Service Manager를 업그레이드하기 전에 GoldenGate 인스턴스를 사용 안함으로 설정합니다.

$ agctl disable goldengate <goldengate_name>

Service Manager 업그레이드를 수행하는 단계는 다음과 같습니다.

다음 URL에서 서비스 관리자에 로그인합니다. https://hostname:servicemanager_port
[서비스 관리자 개요] 페이지의 배치 섹션에서 ServiceManager 링크를 확장합니다.
세부정보를 누른 다음 [배치 세부정보] 섹션 옆에 있는 연필 아이콘을 눌러 GoldenGate 홈 경로를 편집하기 위한 대화 상자를 엽니다.
새 Oracle GoldenGate 홈에 대한 전체 경로로 Oracle GoldenGate 홈 경로를 업데이트합니다.
적용을 누릅니다.
작업 드롭다운을 사용하여 서비스 관리자를 재시작합니다.

XAG를 사용하는 경우 GoldenGate 인스턴스 매개변수를 업데이트합니다.
```
 $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient
```
참고: XAG를 사용하는 경우 업그레이드된 Service Manager에서 관리하는 배포도 업그레이드해야 합니다. 서비스 관리자에 대한 다른 GoldenGate 소프트웨어 릴리스를 사용하여 서비스 관리자에서 배포를 실행할 수 없습니다.

배치 업그레이드

배치를 업그레이드하려면 다음을 수행합니다.

모든 Extract 및 Replicat 프로세스를 정상적으로 중지합니다.
- Extract를 정상적으로 정지하는 데 시간이 더 걸릴 수 있으므로 열린(장기 실행) 트랜잭션 및 제한된 복구를 확인하십시오.
- 불필요한 열린 트랜잭션(예: SEND EXTRACT group_name SHOWTRANS)이 표시되면 해당 트랜잭션을 건너뛰거나 즉시 중지할 수 있습니다. 이 경우 다음 명령을 사용하여 Bounded Recovery 체크포인트를 검색할 수 있습니다.
  
  SEND EXTRACT group_name, BR BRCHECKPOINT immediate
Service Manager에서 Oracle GoldenGate 26ai 홈 디렉토리의 현재 위치를 확인합니다.
1. 서비스 관리자 로그인: http://hostname:servicemanager_port
2. 서비스 관리자 홈 페이지의 배치 섹션에서 ServiceManager 링크를 확장합니다.
3. Oracle GoldenGate 홈 경로를 복사합니다.
배포 섹션으로 돌아가서 업그레이드할 배포의 링크를 확장합니다.
세부정보를 누른 다음 배치 세부정보 섹션 옆에 있는 연필 아이콘을 눌러 GoldenGate 홈 경로를 편집하기 위한 대화상자를 엽니다.
새 Oracle GoldenGate 홈 디렉토리의 전체 경로로 Oracle GoldenGate 홈 경로를 업데이트합니다.
제출을 누르고 Oracle GoldenGate 홈 경로가 업데이트되었는지 확인합니다.
업그레이드 중인 배포의 데이터베이스에 따라 환경 변수 설정이 추가로 변경될 수 있습니다.

필요한 경우 환경 변수에 대한 설정을 수정하려면 구성을 누릅니다.

(Oracle GoldenGate for Oracle AI Database에만 해당), 통합 빌드 기능을 사용하려면 TNS_ADMIN만 Oracle GoldenGate 내에서 Oracle Database Client 소프트웨어로 조정해야 합니다.

TNS_ADMIN = tnsnames.ora 및 sqlnet.ora의 위치

OGG_HOME 환경 변수는 DATABASE_HOME, LD_LIBRARY_PATH 및 JAVA_HOME를 자동으로 감지할 수 있습니다. 주: 21c에서 26ai로 업그레이드하는 경우 이 단계는 필요하지 않습니다. Oracle GoldenGate 19c(또는 이전 버전)에서 26ai로 업그레이드하는 경우 TNS_ADMIN 환경 변수만 있으면 됩니다.

(SQL Server용 Oracle GoldenGate에만 해당) Linux의 SQL Server용 Oracle GoldenGate 26ai에는 데이터베이스 연결을 위한 ODBC 드라이버가 포함되어 있습니다. 필수는 아니지만 패키지된 드라이버를 사용하는 것이 좋습니다. 패키지 드라이버를 사용하려면 두 개의 새 환경 변수를 생성해야 하며 이전에 생성된 odbc.ini 파일을 업데이트해야 합니다.

배포에 다음 환경 변수를 추가합니다.
- ODBCSYSINI = ${OGG_HOME}/msodbc
- ODBCINI = ${OGG_HOME}/msodbc/odbc.ini
새 환경 변수를 생성한 후 기존 odbc.ini 파일을 GoldenGate msodbc 폴더로 복사하고 모든 DSN 항목의 ODBC 드라이버 값을 다음과 같이 변경합니다.
```
Driver=Microsoft ODBC Driver for SQL Server
```
환경 변수에 대한 변경사항을 저장하려면 제출을 누릅니다.
서비스 관리자 홈 페이지로 돌아갑니다.
배치에 대한 작업 필드에서 다시 시작 아이콘을 누르고 확인을 눌러 배치를 재시작합니다.
새 관리 서비스에 다시 로그인하고 모든 추출 및 복제를 시작합니다.

XAG를 사용하는 경우 배치 업그레이드 후 GoldenGate 인스턴스를 다시 사용으로 설정합니다.
```
 $ agctl enable goldengate <GoldenGate Name>
```

서비스 관리자 및 배포가 다시 시작되면 업그레이드가 완료됩니다.

주: Oracle GoldenGate for PostgreSQL의 경우 추출을 시작하기 전에 업그레이드 후 단계를 참조하십시오.