5.3.x 버전에서 최신 EDB Postgres 버전으로 업그레이드하기 5.3 refresh

인스턴스 관리자는 버전 5.3.xEDB Postgres 에서 최신 버전 5.3 으로 업그레이드할 수 있습니다.

누가 이 작업을 완료해야 합니까?

인스턴스 관리자 업그레이드하려면 인스턴스 관리자 EDB Postgres 권한이 있어야 합니다. 인스턴스 관리자는 다음 프로젝트의 소프트웨어를 관리할 권한이 있습니다:

인스턴스에 대한 운영자 프로젝트

이 인스턴스의 연산자는 EDB Postgres operators 프로젝트에 설치되어 있습니다. 업그레이드 명령어에서 환경 ${PROJECT_CPD_INST_OPERATORS} 변수 `$PATH`는 운영자의 프로젝트를 가리킵니다.

인스턴스에 대한 피연산자 프로젝트

사용자 정의 리소스 와 control plane 는 operands EDB Postgres 프로젝트에 설치됩니다. 업그레이드 명령어에서 환경 변수 ` ${PROJECT_CPD_INST_OPERANDS} $_`는 작업 대상 프로젝트를 가리킵니다.

이 작업을 언제까지 완료해야 합니까?

다음 옵션을 검토하여 이 작업을 완료해야 하는지 여부를 결정하십시오:

  • IBM 인스턴스 업그레이드 control planeIBM Software Hub ( Software Hub ) 문서의 절차를 따르십시오.
  • 업그레이드할 때 EDB PostgresIBM Software Hubcontrol plane 업그레이드하지 않았다면, 이 작업을 완료하여 업그레이드하십시오 EDB Postgres.

    필요에 따라 반복하십시오. 여러 인스턴스를 관리하는 IBM Software Hub 경우, 이 작업을 반복하여 클러스터 내의 더 많은 EDB Postgres 인스턴스를 업그레이드할 수 있습니다.

이 태스크를 완료하는 데 필요한 정보

업그레이드하기 전에 다음 EDB Postgres 정보를 검토하십시오 :

버전 요구사항

의 인스턴스와 연관된 모든 구성 IBM Software Hub 요소는 동일한 릴리스에서 설치되어야 합니다. 예를 들어, 가 버전 IBM Software Hubcontrol plane 인 5.3.1 경우, 를 버전 으로 EDB Postgres5.3.1 업그레이드해야 합니다.

환경 변수
이 작업의 명령어는 환경 변수를 사용하므로, 작성된 그대로 정확히 실행할 수 있습니다.
  • 환경 변수를 정의하는 스크립트가 없는 경우, 설치 환경 변수 설정을 참조하십시오.
  • 스크립트에서 환경 변수를 사용하려면, 이 작업의 명령어를 실행하기 전에 환경 변수를 소스 처리해야 합니다. 예를 들면, 다음을 실행하십시오.
    source ./cpd_vars.sh

시작하기 전에

이 작업은 다음의 전제 조건이 충족된다는 것을 가정합니다:

시스템 요구사항
이 작업은 클러스터가 최소 요구 사항을 충족한다고 EDB Postgres 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우 시스템 요구 사항을 참조하십시오.
또한 GPU가 필요한 기능을 사용할 계획이라면, 해당 기능에 적합한 유형과 수의 GPU를 EDB Postgres 보유하고 있는지 확인하십시오.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우 GPU 요구 사항을 참조하십시오.
워크스테이션
이 작업은 업그레이드를 실행할 워크스테이션이 클라이언트 워크스테이션으로 설정되어 있으며 다음 명령줄 인터페이스를 갖추고 있다고 가정합니다:
  • IBM Software Hub CLI: cpd-cli
  • OpenShift® CLI: oc
  • Helm CLI: oc
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 클라이언트 워크스테이션 업데이트를 참조하십시오.
제어 플레인
이 작업은 가 IBM Software Hubcontrol plane 업그레이드된 상태를 전제로 합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, IBM 인스턴스 업그레이드( Software Hub )를 참조하십시오.
개인용 컨테이너 레지스트리
사용 중인 환경이 사설 컨테이너 레지스트리를 사용하는 경우(예: 클러스터가 에어갭 상태인 경우), 이 작업은 다음 작업들이 완료되었음을 전제로 합니다:
  1. 소프트웨어 EDB Postgres 이미지는 사설 컨테이너 레지스트리에 미러링됩니다.
    자세한 정보를 찾을 위치
    이 작업이 완료되지 않은 경우, '이미지를 개인 컨테이너 레지스트리로 미러링하기'를 참조하십시오.
  2. 해당 구성은 사설 컨테이너 레지스트리에서 cpd-cli 이미지를 olm-utils-v4 가져오도록 설정되어 있습니다.
    자세한 정보를 찾을 위치
    이 작업이 완료되지 않은 경우, 개인 컨테이너 레지스트리에서 ` olm-utils-v4 ` 이미지를 가져오는 방법을 참조하십시오.
GPU 운영자
GPU가 필요한 기능을 사용할 계획이라면, 이 작업은 GPU 사용에 필요한 운영자가 설치되어 있다고 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, GPU가 필요한 서비스용 오퍼레이터 설치를 참조하십시오.
클러스터 범위 리소스
이 작업은 사용자 정의 리소스 정의, 클러스터 역할, 클러스터 역할 바인딩과 같은 클러스터 범위 리소스가 업데이트되었음을 가정합니다.
자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 플랫폼 및 서비스에 대한 클러스터 범위 리소스 업데이트를 참조하십시오.

프로시저

업그레이드하려면 다음 EDB Postgres 작업을 완료하세요:

  1. 서비스 업그레이드
  2. 업그레이드 검증
  3. 기존 서비스 인스턴스 업그레이드
  4. 다음에 무엇을 해야 할까

서비스 업그레이드

업그레이드하려면 EDB Postgres :

  1. 클러스터에 Red Hat® OpenShift Container Platform cpd-cli 로그인하십시오:
    ${CPDM_OC_LOGIN}
    기억하세요: CPDM_OC_LOGIN 는 cpd-cli manage login-to-ocp 명령어의 별칭입니다.
  2. . EDB Postgres 에 대한 운영자 및 사용자 정의 리소스를 업데이트하십시오.
    cpd-cli manage install-components \
--license_acceptance=true \
--components=edb_cp4d \
--release=${VERSION} \
--operator_ns=${PROJECT_CPD_INST_OPERATORS} \
--instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--image_pull_prefix=${IMAGE_PULL_PREFIX} \
--image_pull_secret=${IMAGE_PULL_SECRET} \
--upgrade=true

업그레이드 검증

EDB Postgres install-components 명령이 반환될 때 업그레이드됩니다:
[SUCCESS]... The install-components command ran successfully

사용자 지정 리소스 상태가 인지 확인하려면 다음 cpd-cli manage get-cr-statusCompleted 명령을 실행할 수 있습니다:

cpd-cli manage get-cr-status \
--cpd_instance_ns=${PROJECT_CPD_INST_OPERANDS} \
--components=edb_cp4d

기존 서비스 인스턴스 업그레이드

업그레이드 후에는 관련 서비스 인스턴스를 EDB Postgres EDB Postgres 반드시 업그레이드해야 합니다.

서비스 인스턴스를 업그레이드하려면:

  1. 인스턴스 관리자로 Red Hat OpenShift Container Platform 에 로그인하십시오.
    ${OC_LOGIN}
    기억하세요: OC_LOGIN 는 oc login 명령어의 별칭입니다.
  2. 서비스 인스턴스 EDB Postgres 목록을 가져옵니다:
    oc get CPDEdbInstance \
--namespace=${PROJECT_CPD_INST_OPERANDS}
  3. 업그레이드하려는 서비스 인스턴스의 이름으로 환경 INSTANCE_NAME 변수를 설정하십시오:
    export INSTANCE_NAME=<instance-name>
  4. 클러스터에 설치된 Cloud Pak for Data 버전에 해당하는 버전으로 환경 INSTANCE_VERSION 변수를 설정하십시오:
    export INSTANCE_VERSION=<version>

    다음 표를 사용하여 적절한 값을 결정하십시오:

    IBM Software Hub버전 추가 기능 버전 서비스 인스턴스 버전
    (하나 선택)
    5.3.1 5.3.1 13.23, 14.20, 15.15, 16.11, 17.7, 18.1
    5.3.0 5.3.0 13.22, 14.19, 15.14, 16.10, 17.6
    참고: EDB Postgres 은 주요 버전 업그레이드를 직접 지원하지 않습니다. PostgreSQL 의 경우 롤링 업데이트 또는 소규모 릴리스 업그레이드만 지원합니다. 자세한 내용은 EDB PostgreSQL Rolling Updates 를 참조하십시오.

    사용자는 EDB PostgreSQL Database Import에 설명된 대로 주요 버전 업그레이드 시 병렬 업그레이드를 수행해야 합니다.

    메이저 버전 업그레이드가 필요한 경우 최신 버전으로 업그레이드하십시오.

  5. 서비스 인스턴스 사용자 지정 리소스에서 버전을 업데이트하십시오:
    oc patch CPDEdbInstance ${INSTANCE_NAME} \
--namespace=${PROJECT_CPD_INST_OPERANDS} \
--type=merge \
--patch='{"spec": {"version": "${INSTANCE_VERSION}"}}'
    참고: 버전 5.2.x 부터는 서비스 인스턴스 사용자 지정 리소스에서 버전을 업데이트하기 위해 다음 명령어도 지원됩니다:
    ./cpd-cli service-instance upgrade \
  --instance-name=${INSTANCE_NAME} \
  --service-type=edb \
  --profile=${CPD_PROFILE_NAME} \
  --version=5.2.0 \
  --merge-override=true \
  --override=parameters.yaml
    다음은 파일의 parameters.yaml 샘플입니다:
    parameters:
 version: '${INSTANCE_VERSION}'
  6. operands 프로젝트의 각 서비스 인스턴스를 업그레이드하려면 앞의 단계를 반복하십시오.

다음에 수행할 작업

기존 EDB Postgres 데이터베이스 인스턴스는 사용 준비가 완료되었습니다. EDB Postgres 서비스에 대한 설치 후 설정을 완료해야 EDB Postgres 에 액세스할 수 있습니다.