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

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

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

버전 요구사항

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

환경 변수

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

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

  source ./cpd_vars.sh

시작하기 전에

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

시스템 요구사항

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

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

워크스테이션

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

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

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

제어 플레인

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

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

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

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

1. 소프트웨어 OpenPages 이미지는 사설 컨테이너 레지스트리에 미러링됩니다.

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

2. 해당 구성은 사설 컨테이너 레지스트리에서 cpd-cli 이미지를 olm-utils-v4 가져오도록 설정되어 있습니다.

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

클러스터 범위 리소스

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

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

프로시저

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

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

서비스 업그레이드

업그레이드하려면 OpenPages :

1. 클러스터에 Red Hat® OpenShift Container Platform cpd-cli 로그인하십시오:

   ${CPDM_OC_LOGIN}

   기억하세요: CPDM_OC_LOGIN 는 cpd-cli manage login-to-ocp 명령어의 별칭입니다.
2. . OpenPages 에 대한 운영자 및 사용자 정의 리소스를 업데이트하십시오.

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

--tethered_instance_ns=${PROJECT_CPD_INSTANCE_TETHERED}

업그레이드 검증

[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=openpages

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

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

인스턴스를 OpenPages 업그레이드하면 해당 인스턴스가 종료된 후 다시 시작됩니다. 이 작업은 약 2시간이 소요되며, 이 기간 동안 사용자에게 서비스가 제공되지 않습니다. 사용자가 로그인하지 않은 상태에서 인스턴스 업그레이드를 수행하십시오.

내부 데이터베이스를 사용하는 OpenPages 인스턴스를 업그레이드할 때, CR은 Db2 as a service 최신 버전으로 업그레이드됩니다.

시작하기 전에

서비스 인스턴스를 업그레이드할 워크스테이션에 프로필을 생성하십시오.

프로필은 다음 권한 중 하나를 가진 사용자와 IBM Software Hub 연결되어야 합니다:

• 서비스 인스턴스 생성 (can_provision)
• 서비스 인스턴스 관리 (manage_service_instances)

자세한 내용은 cpd-cli 관리 명령어를 사용하기 위한 프로필 생성을 참조하십시오.

프로시저

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

1. 서비스 인스턴스 OpenPages 목록을 가져옵니다:

   cpd-cli service-instance list \
   --service-type=openpages \
   --profile=${CPD_PROFILE_NAME}

2. 업그레이드하려는 서비스 인스턴스의 이름으로 환경 INSTANCE_NAME 변수를 설정하십시오:

   export INSTANCE_NAME=<instance-name>

3. 다음 명령어를 실행하여 서비스 OpenPages 인스턴스가 실행 중인 상태인지 확인하십시오:

   cpd-cli service-instance status ${INSTANCE_NAME} \ 
   --profile=${CPD_PROFILE_NAME} \ 
   --service-type=openpages

4. 서비스 인스턴스 업그레이드:

   cpd-cli service-instance upgrade \
   --service-type=openpages \
   --instance-name=${INSTANCE_NAME} \
   --force-version-upgrade=true \
   --profile=${CPD_PROFILE_NAME}
   

5. 이 인스턴스와 연결된 각 서비스 인스턴스를 IBM Software Hub업그레이드하려면 앞의 단계를 반복하십시오.

다음에 수행할 작업