2.3. 템플릿 기반 설치의 Oracle Database로 3scale 업그레이드
이 섹션에서는 OpenShift 3.11의 템플릿 기반 설치에서 Oracle Database와 함께 3scale 시스템 이미지를 사용할 때 Red Hat 3scale API Management를 업데이트하는 방법을 설명합니다.
사전 요구 사항
Oracle Database를 사용한 3scale 설치 Oracle Database를 사용하여 3scale 시스템 이미지 설정을 참조하십시오.
템플릿 기반 설치의 Oracle 데이터베이스를 사용하여 3scale 시스템 이미지를 업그레이드하려면 다음 절차를 수행하십시오.
2.3.1. Oracle 19c로 3scale 업그레이드 링크 복사링크가 클립보드에 복사되었습니다!
이 절차에서는 기존 3scale 2.11 설치의 3scale 2.12용 Oracle 데이터베이스 19c 업데이트를 안내합니다.
중요: 데이터베이스에 대한 연결 손실이 발생하면 3scale이 손상될 수 있습니다. 업그레이드를 진행하기 전에 백업을 만듭니다. 자세한 내용은 Oracle Database 설명서를 참조하십시오. Oracle Database Backup and recovery User's Guide.
사전 요구 사항
- 3scale 2.11 설치.
Oracle Database 19c 설치
- Oracle을 사용한 3scale 구성에 대한 자세한 내용은 Oracle 데이터베이스 준비를 참조하십시오.
절차
GitHub 리포지토리에서 3scale OpenShift 템플릿을 다운로드하고 아카이브를 추출합니다.
tar -xzf 3scale-amp-openshift-templates-3scale-2.12.0-GA.tar.gz
tar -xzf 3scale-amp-openshift-templates-3scale-2.12.0-GA.tar.gz
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
Oracle Database Instant Client Package 파일을
3scale-amp-openshift-templates-3scale-2.12.0-GA/amp/system-oracle/oracle-client-files
디렉터리에 배치합니다. -f
옵션과 함께oc process
명령을 실행하고build.yml
OpenShift 템플릿을 지정합니다.oc process -f build.yml | oc apply -f -
$ oc process -f build.yml | oc apply -f -
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc new-app
명령을-f
옵션과 함께 실행하여amp.yml
OpenShift 템플릿을 표시하고-p
옵션을 사용하여 OpenShift 클러스터 도메인으로WILDCARD_DOMAIN
매개변수를 지정합니다.oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com
$ oc new-app -f amp.yml -p WILDCARD_DOMAIN=mydomain.com
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 참고다음 단계는 선택 사항입니다. 설치 또는 시스템 업그레이드 후
ORACLE_SYSTEM_PASSWORD
를 제거하는 경우 사용합니다.다음
oc patch
명령을 입력하고SYSTEM_PASSWORD
를 Oracle 데이터베이스 준비에 설정한 Oracle Databasesystem
암호로 바꿉니다.oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'
$ oc patch dc/system-app -p '[{"op": "add", "path": "/spec/strategy/rollingParams/pre/execNewPod/env/-", "value": {"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}}]' --type=json $ oc patch dc/system-app -p '{"spec": {"strategy": {"rollingParams": {"post":{"execNewPod": {"env": [{"name": "ORACLE_SYSTEM_PASSWORD", "value": "SYSTEM_PASSWORD"}]}}}}}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Oracle 데이터베이스 준비에 지정된
DATABASE_URL
을 입력하여 Oracle 데이터베이스를 가리키도록 다음 명령을 입력합니다.oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'
$ oc patch secret/system-database -p '{"stringData": {"URL": "DATABASE_URL"}}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc start-build
명령을 입력하여 새 시스템 이미지를 빌드합니다.oc start-build 3scale-amp-system-oracle --from-dir=.
$ oc start-build 3scale-amp-system-oracle --from-dir=.
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 빌드가 완료될 때까지 기다립니다. 빌드 상태를 확인하려면 다음 명령을 실행합니다.
oc get build <build-name> -o jsonpath="{.status.phase}"
$ oc get build <build-name> -o jsonpath="{.status.phase}"
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 빌드가 완료 (Complete) 상태가 될 때까지 기다립니다.
Oracle Database로 3scale 시스템 이미지를 설정한 경우
system-app
DeploymentConfig에서ORACLE_SYSTEM_PASSWORD
를 제거합니다. 3scale의 새 버전으로 업그레이드할 때까지 다시 필요하지 않습니다.oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-
$ oc set env dc/system-app ORACLE_SYSTEM_PASSWORD-
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
open_cursors
매개변수 설정 확인
이 데이터베이스의 open_cursors
매개변수가 1000
보다 큰 값으로 설정되어 있는지 확인해야 합니다.
이렇게 하려면 Oracle 데이터베이스에 SYSTEM 사용자로 로그인하고 다음 명령을 실행합니다.
show parameter open_cursors;
show parameter open_cursors;
반환 값은 최소 1000
여야 합니다. 그렇지 않은 경우 열려 있는 커서
에 대한 Oracle 문서에 따라 매개 변수를 1000
보다 큰 값으로 변경합니다.
open_cursors
매개변수가 이전에 1000
미만의 일부 제한으로 구성되었으며 값을 늘리지 않으면 OpenShift system-app
pod 로그 중 하나에서 다음 오류가 표시될 수 있습니다.
ORA-01000: maximum open cursors exceeded
ORA-01000: maximum open cursors exceeded
추가 리소스
3scale 및 Oracle Database 지원에 대한 자세한 내용은 Red Hat 3scale API Management 지원 구성을 참조하십시오.