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

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

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

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

인스턴스에 대한 운영자 프로젝트: 이 인스턴스의 연산자는 MongoDB operators 프로젝트에 설치되어 있습니다. 업그레이드 명령어에서 환경 ${PROJECT_CPD_INST_OPERATORS} 변수 `$PATH`는 운영자의 프로젝트를 가리킵니다.
인스턴스에 대한 피연산자 프로젝트: 사용자 정의 리소스 와 control plane 는 operands MongoDB 프로젝트에 설치됩니다. 업그레이드 명령어에서 환경 변수 ` ${PROJECT_CPD_INST_OPERANDS} $_`는 작업 대상 프로젝트를 가리킵니다.

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

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

IBM 인스턴스 업그레이드 control planeIBM Software Hub ( Software Hub ) 문서의 절차를 따르십시오.
업그레이드할 때 MongoDBIBM Software Hubcontrol plane 업그레이드하지 않았다면, 이 작업을 완료하여 업그레이드하십시오 MongoDB.
필요에 따라 반복하십시오. 여러 인스턴스를 관리하는 IBM Software Hub 경우, 이 작업을 반복하여 클러스터 내의 더 많은 MongoDB 인스턴스를 업그레이드할 수 있습니다.

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

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

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

환경 변수

이 작업의 명령어는 환경 변수를 사용하므로, 작성된 그대로 정확히 실행할 수 있습니다.

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

시작하기 전에

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

시스템 요구사항

이 작업은 클러스터가 최소 요구 사항을 충족한다고 MongoDB 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우 시스템 요구 사항을 참조하십시오.

또한, 적절한 유형과 수의 GPU를 확보해야 MongoDB 합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우 GPU 요구 사항을 참조하십시오.

또한 GPU가 필요한 기능을 사용할 계획이라면, 해당 기능에 적합한 유형과 수의 GPU를 MongoDB 보유하고 있는지 확인하십시오.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우 GPU 요구 사항을 참조하십시오.

워크스테이션

이 작업은 업그레이드를 실행할 워크스테이션이 클라이언트 워크스테이션으로 설정되어 있으며 다음 명령줄 인터페이스를 갖추고 있다고 가정합니다:

IBM Software Hub CLI: cpd-cli
OpenShift® CLI: oc
Helm CLI: oc

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 클라이언트 워크스테이션 업데이트를 참조하십시오.

제어 플레인

이 작업은 가 IBM Software Hubcontrol plane 업그레이드된 상태를 전제로 합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, IBM 인스턴스 업그레이드( Software Hub )를 참조하십시오.

개인용 컨테이너 레지스트리

사용 중인 환경이 사설 컨테이너 레지스트리를 사용하는 경우(예: 클러스터가 에어갭 상태인 경우), 이 작업은 다음 작업들이 완료되었음을 전제로 합니다:

소프트웨어 MongoDB 이미지는 사설 컨테이너 레지스트리에 미러링됩니다.
자세한 정보를 찾을 위치

이 작업이 완료되지 않은 경우, '이미지를 개인 컨테이너 레지스트리로 미러링하기'를 참조하십시오.
해당 구성은 사설 컨테이너 레지스트리에서 cpd-cli 이미지를 olm-utils-v4 가져오도록 설정되어 있습니다.
자세한 정보를 찾을 위치

이 작업이 완료되지 않은 경우, 개인 컨테이너 레지스트리에서 ` olm-utils-v4 ` 이미지를 가져오는 방법을 참조하십시오.

GPU 운영자

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, '이미지를 개인 컨테이너 레지스트리로 미러링하기'를 참조하십시오.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 개인 컨테이너 레지스트리에서 ` olm-utils-v4 ` 이미지를 가져오는 방법을 참조하십시오.

이 작업은 GPU 사용에 필요한 운영 체제가 설치되어 있음을 전제로 합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, GPU가 필요한 서비스용 오퍼레이터 설치를 참조하십시오.

GPU가 필요한 기능을 사용할 계획이라면, 이 작업은 GPU 사용에 필요한 운영자가 설치되어 있다고 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, GPU가 필요한 서비스용 오퍼레이터 설치를 참조하십시오.

클러스터 범위 리소스

이 작업은 사용자 정의 리소스 정의, 클러스터 역할, 클러스터 역할 바인딩과 같은 클러스터 범위 리소스가 업데이트되었음을 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, 플랫폼 및 서비스에 대한 클러스터 범위 리소스 업데이트를 참조하십시오.

프로시저

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

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

서비스 업그레이드

업그레이드하려면 MongoDB :

클러스터에 Red Hat® OpenShift Container Platform cpd-cli 로그인하십시오:
```
${CPDM_OC_LOGIN}
```
기억하세요: CPDM_OC_LOGIN 는 cpd-cli manage login-to-ocp 명령어의 별칭입니다.

. MongoDB 에 대한 운영자 및 사용자 정의 리소스를 업데이트하십시오.

cpd-cli manage install-components \
--license_acceptance=true \
--components=mongodb_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

업그레이드 검증

MongoDB 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=mongodb_cp4d

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

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

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

인스턴스 관리자로 Red Hat OpenShift Container Platform 에 로그인하십시오.
```
${OC_LOGIN}
```
기억하세요: OC_LOGIN 는 oc login 명령어의 별칭입니다.

서비스 인스턴스 MongoDB 목록을 가져옵니다:

oc get CPDMongoDb \
--namespace=${PROJECT_CPD_INST_OPERANDS}

업그레이드하려는 서비스 인스턴스의 이름으로 환경 INSTANCE_NAME 변수를 설정하십시오:
```
export INSTANCE_NAME=<instance-name>
```
클러스터의 IBM Software Hub 버전과 일치하는 버전으로 환경 INSTANCE_VERSION 변수를 설정하십시오:
```
export INSTANCE_VERSION=<version>
```
다음 표를 사용하여 적절한 값을 결정하십시오:

IBM Software Hub버전 서비스 인스턴스 버전
(하나 선택)

5.3.1 7.0.18-ent, 8.0.6-ent

5.3.0 7.0.18-ent, 8.0.6-ent

중요: 서비스 MongoDB 인스턴스를 5.x.y 버전에서 7.x.y 버전으로 업그레이드하려면, 먼저 5.x.y 버전에서 6.x.y 버전으로 업그레이드한 후, 6.x.y 버전에서 7.x.y 버전으로 업그레이드해야 합니다.

IBM Software Hub버전	서비스 인스턴스 버전 (하나 선택)
5.3.1	7.0.18-ent, 8.0.6-ent
5.3.0	7.0.18-ent, 8.0.6-ent

서비스 인스턴스 사용자 지정 리소스에서 버전을 업데이트하십시오:

업데이트를 사용하여 cpd-cli

업그레이드할 MongoDB 버전을 포함한 YAML 파일을 생성하십시오:

cat <<EOF > newparamsmdb.yaml
parameters:
  mdbversion: '${INSTANCE_VERSION}'
  opsmgrversion: '${OPS_MGR_INSTANCE_VERSION}'
EOF

인스턴스 업데이트:

cpd-cli service-instance upgrade \
--instance-name=${INSTANCE_NAME} \
--service-type=mongodb \
--profile=${CPD_PROFILE_NAME} \
--version=${VERSION} \
--merge-override=true \
--override=newparamsmdb.yaml

업데이트를 사용하여 oc patch

oc patch CPDMongoDb ${INSTANCE_NAME} \
--namespace=${PROJECT_CPD_INST_OPERANDS} \
--type=merge \
--patch="{\"spec\": {\"parameters\": {\"mdbversion\": \"${INSTANCE_VERSION}\", \"opsmgrversion\": \"${OPS_MGR_INSTANCE_VERSION}\"}, \"version\": \"${INSTANCE_VERSION}\"}}"

operands 프로젝트의 각 서비스 인스턴스를 업그레이드하려면 앞의 단계를 반복하십시오.

다음에 수행할 작업

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