IBM Knowledge Catalog 설치하기

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

IBM Knowledge Catalog 를 설치하기 전에 다음 정보를 확인하십시오:

버전 요구사항

인스턴스와 관련된 모든 구성 요소는 동일한 IBM Software Hub 릴리스로 설치되어야 합니다. 예를 들어, 가 버전 5.3.1IBM Software Hubcontrol plane 으로 설치된 경우, IBM Knowledge Catalog 를 버전 5.3.1 으로 설치해야 합니다.

환경 변수

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

• 환경 변수를 정의하는 스크립트가 없다면, ‘설치 환경 변수 설정’을 참조하십시오.
• 스크립트의 환경 변수를 사용하려면, 이 작업의 명령을 실행하기 전에 환경 변수를 불러와야 합니다. 예를 들면, 다음을 실행하십시오.

  source ./cpd_vars.sh

보안 컨텍스트 제한조건

IBM Knowledge Catalog 기본 Red Hat® OpenShift® Container Platform 보안 컨텍스트 제약 조건과 함께 restricted-v2작동합니다.

Common core services

IBM Knowledge Catalog...가 필요합니다 IBM Software Hubcommon core services .

해당 인스턴스의 operands 프로젝트에 가 common core services 설치되어 있지 않은 경우, IBM Knowledge Catalog 를 설치하면 가 자동으로 common core services 설치됩니다. 이 common core services 설치 작업은 완료까지 걸리는 시간을 늘립니다.

스토리지 요구사항

IBM Knowledge Catalog 를 설치할 때는 스토리지 클래스를 지정해야 합니다. 다음과 같은 스토리지 클래스를 권장합니다. 단, 클러스터에서 이러한 스토리지 클래스를 사용하지 않는 경우, 이에 상응하는 정의가 포함된 스토리지 클래스를 지정해야 합니다.

스토리지	참고	스토리지 클래스
OpenShift Data Foundation	서비스를 설치할 때 파일 스토리지와 블록 스토리지를 지정하십시오.	파일 저장: ocs-storagecluster-cephfs 블록 스토리지: ocs-storagecluster-ceph-rbd
IBM Fusion Data Foundation	서비스를 설치할 때 파일 스토리지와 블록 스토리지를 지정하십시오.	파일 저장: ocs-storagecluster-cephfs 블록 스토리지: ocs-storagecluster-ceph-rbd
IBM Fusion Global Data Platform	서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.	파일 저장: 다음 저장 클래스 중 하나: ibm-spectrum-scale-sc ibm-storage-fusion-cp-sc 블록 스토리지: 다음 저장 클래스 중 하나: ibm-spectrum-scale-sc ibm-storage-fusion-cp-sc
IBM Storage Scale Container Native	서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.	파일 저장: ibm-spectrum-scale-sc 블록 스토리지: ibm-spectrum-scale-sc
Portworx	서비스를 설치할 때 이 --storage_vendor=portworx 옵션을 사용하면 서비스가 올바른 스토리지 클래스를 사용하도록 보장됩니다.	파일 저장: portworx-shared-gp3 블록 스토리지: portworx-cassandra-sc portworx-couchdb-sc portworx-db2-rwo-sc portworx-elastic-sc portworx-gp3-sc portworx-kafka-sc portworx-metastoredb-sc portworx-solr-sc
NFS	서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.	파일 저장: managed-nfs-storage 블록 스토리지: managed-nfs-storage
Amazon Elastic 스토리지	서비스를 설치할 때 다음을 지정할 수 있습니다: 파일 저장 전용 파일 스토리지 및 블록 스토리지 (권장) 파일 저장 공간은 에서 제공합니다 Amazon Elastic File System. 블록 스토리지는 에서 제공합니다 Amazon Elastic Block Store.	파일 저장: efs-nfs-client 블록 스토리지: 다음 저장 클래스 중 하나: gp2-csi gp3-csi
NetApp Trident	서비스를 설치할 때 파일 스토리지와 블록 스토리지에 동일한 스토리지 클래스를 지정하십시오.	파일 저장: ontap-nas 블록 스토리지: ontap-nas
Nutanix	서비스를 설치할 때 파일 스토리지와 블록 스토리지를 지정하십시오.	파일 저장: nutanix-file 블록 스토리지: nutanix-volume

시작하기 전에

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

시스템 요구사항

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

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면 ‘시스템 요구 사항’을 참조하십시오.

또한, GPU가 필요한 기능을 사용할 계획이라면, IBM Knowledge Catalog 에 적합한 유형과 수량의 GPU가 구비되어 있는지 확인하십시오.

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면 GPU 사양을 확인하십시오.

워크스테이션

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

• IBM Software Hub 명령줄 인터페이스: cpd-cli
• OpenShift 명령줄 인터페이스: oc
• Helm 명령줄 인터페이스: helm

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면, ‘클라이언트 워크스테이션 설정’을 참조하십시오.

제어 플레인

이 작업은 가 IBM Software Hubcontrol plane 설치되어 있다고 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면, ‘ IBM 인스턴스 설치 ’ Software Hub 를 참조하십시오.

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

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

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

   자세한 정보를 찾을 위치
   이 작업이 완료되지 않았다면, ‘이미지를 비공개 컨테이너 레지스트리에 미러링하기’를 참조하십시오.

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

   자세한 정보를 찾을 위치
   이 작업이 완료되지 않았다면, ‘ olm-utils-v4 이미지를 비공개 컨테이너 레지스트리에서 가져오기’를 참조하십시오.

로드 밸런서

IBM Knowledge Catalog 에 맞게 로드 밸런서의 타임아웃 설정이 조정되었습니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않은 경우, ‘로드 밸런서 설정 변경’을 참조하십시오.

GPU 운영자

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

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

Red Hat OpenShift AI

이 작업은 또는 IBM Knowledge Catalog Premium 의 IBM Knowledge Catalog Standard경우, 가 설치되어 Red Hat OpenShift AI 있다고 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면, ‘ Red Hat OpenShift AI 설치’를 참조하십시오.

클러스터 범위 리소스

이 작업은 사용자 정의 리소스 정의, 클러스터 역할, 클러스터 역할 바인딩과 같은 클러스터 범위 리소스가 이미 존재한다고 가정합니다.

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

이미지 풀 시크릿

이 작업은 인스턴스의 이미지 다운로드 자격 증명을 포함하는 시크릿이 이미 존재한다고 가정합니다.

자세한 정보를 찾을 위치
이 작업이 완료되지 않았다면, IBM 인스턴스에 대한 이미지 풀 시크릿 생성 방법( Software Hub )을 참조하십시오.

프로시저

IBM Knowledge Catalog 를 설치하려면 다음 단계를 수행하십시오:

1. IBM Knowledge Catalog 에디션 지정하기
2. 설치 옵션 지정
3. 서비스 설치
4. 설치 확인
5. 다음에 무엇을 해야 할까요?

IBM Knowledge Catalog 에디션 지정하기

IBM Knowledge Catalog 세 가지 버전으로 제공됩니다. 설치할 버전을 지정해야 합니다.

설치하려는 IBM Knowledge Catalog 버전에 맞춰 환경 IKC_TYPE 변수를 설정하십시오:

IBM Knowledge Catalog

export IKC_TYPE=wkc

IBM Knowledge Catalog Premium

export IKC_TYPE=ikc_premium

IBM Knowledge Catalog Standard

export IKC_TYPE=ikc_standard

설치 옵션 지정

서비스 설치

IBM Knowledge Catalog 를 설치하려면:

1. 클러스터에 Red Hat OpenShift Container Platform cpd-cli 로그인하세요:

   ${CPDM_OC_LOGIN}

   참고: CPDM_OC_LOGIN 는 cpd-cli manage login-to-ocp 명령어의 별칭입니다.
2. IBM Knowledge Catalog 용 오퍼레이터와 사용자 정의 리소스를 설치합니다.

   실행할 명령어는 클러스터의 스토리지 구성에 따라 달라집니다.

   ---

   Red Hat OpenShift 데이터 파운데이션 스토리지

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   IBM 퓨전 데이터 파운데이션 스토리지

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   IBM 퓨전 글로벌 데이터 플랫폼 스토리지

   기억하세요: 스토리지 클래스를 IBM Fusion Global Data Platform 사용할 때, 와 는 ${STG_CLASS_BLOCK} 모두 동일한 ${STG_CLASS_FILE} 스토리지 클래스를 가리키며, 일반적으로 ibm-spectrum-scale-sc 또는 ibm-storage-fusion-cp-sc입니다.

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   IBM Storage 스케일 컨테이너 네이티브 스토리지

   기억하세요: 스토리지(storage)를 IBM Storage Scale Container Native 사용할 때, 와 는 ${STG_CLASS_BLOCK} 모두 동일한 ${STG_CLASS_FILE} 스토리지 클래스를 가리키며, 일반적으로 ibm-spectrum-scale-sc입니다.

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   Portworx 스토리지

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --storage_vendor=portworx \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --storage_vendor=portworx \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   NFS 스토리지

   기억하세요: 스토리지(storage)를 NFS 사용할 때, 와 는 ${STG_CLASS_BLOCK} 모두 동일한 ${STG_CLASS_FILE} 스토리지 클래스를 가리키며, 일반적으로 managed-nfs-storage입니다.

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   AWS EFS 저장소만 사용할 경우

   참고: EFS 스토리지 클래스를 사용할 경우, 와 는 ${STG_CLASS_BLOCK} 모두 동일한 ${STG_CLASS_FILE} 스토리지 클래스를 가리키며, 일반적으로 efs-nfs-client입니다.

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   AWS EFS 및 EBS 스토리지를 통해

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

   NetApp Trident

   기억하세요: 스토리지(storage)를 NetApp Trident 사용할 때, 와 는 ${STG_CLASS_BLOCK} 모두 동일한 ${STG_CLASS_FILE} 스토리지 클래스를 가리키며, 일반적으로 ontap-nas입니다.

   사용 중인 환경에 맞는 명령어를 실행하십시오:

   기본 설치 (설치 옵션 없이)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET}

   맞춤형 설치 (설치 옵션 포함)

   cpd-cli manage install-components \
   --license_acceptance=true \
   --components=${IKC_TYPE} \
   --release=${VERSION} \
   --operator_ns=${PROJECT_CPD_INST_OPERATORS} \
   --instance_ns=${PROJECT_CPD_INST_OPERANDS} \
   --block_storage_class=${STG_CLASS_BLOCK} \
   --file_storage_class=${STG_CLASS_FILE} \
   --image_pull_prefix=${IMAGE_PULL_PREFIX} \
   --image_pull_secret=${IMAGE_PULL_SECRET} \
   --param-file=/tmp/work/install-options.yml

   ---

설치 확인

[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=${IKC_TYPE}

다음에 수행할 작업