다음 `cpd-cli service-instance create` 명령어를 사용하여 Db2 Big SQL 의 서비스 인스턴스를 생성합니다

Db2 Big SQL 를 설치한 후에는 operands 프로젝트 내에 최소 한 개의 Db2 Big SQL 서비스 인스턴스를 생성해야 합니다. 사용자라면 IBM® Software Hub 명령을 cpd-cli service-instance create 사용하여 서비스 인스턴스 생성 과정을 스크립트로 작성할 수 있습니다.

누가 이 작업을 완료해야 하나요?: 를 사용하여 서비스 cpd-cli인스턴스를 생성하려면, 에서 ‘서비스 IBM Software Hub인스턴스 생성(can_provision)’ 권한이 있어야 합니다.

이 작업을 언제까지 완료해야 하나요?

cpd-cli
service-instance
create

명령어를 cpd-cli 사용하여 서비스 인스턴스를 생성하려는 경우에만 이 작업을 수행하십시오.

서비스 인스턴스를 생성하는 다른 방법

웹 클라이언트에서. 자세한 내용은 웹 클라이언트에서 ‘ Db2 Big SQL ’ 서비스 인스턴스 만들기를 참조하십시오.
REST API /v3/service_instances 호출을 사용하여. 자세한 내용은 ‘ Db2 Big SQL 용 서비스 인스턴스를 프로그래밍 방식으로 만들기’를 참조하세요.

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

Db2 Big SQL 용 서비스 인스턴스를 생성하기 전에 다음 정보를 확인하십시오:

버전 요구사항: 인스턴스와 관련된 모든 구성 요소는 동일한 IBM Software Hub 릴리스에서 설치되거나 생성되어야 합니다. 예를 들어, Db2 Big SQL 가 버전 5.3.1 으로 설치된 경우, 서비스 인스턴스는 버전 5.3.1 으로 생성해야 합니다.

중요: Db2 Big SQL 는. IBM Software Hub와 다른 버전 번호를 사용합니다. 이 항목에는 각 갱신 시의 IBM Software HubDb2 Big SQL 버전을 보여주는 표가 포함되어 있습니다. 이 표를 참고하여 설치된 IBM Software Hub 버전에 맞는 올바른 버전을 확인하십시오.

환경 변수

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

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

시작하기 전에

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

필수 소프트웨어	자세한 정보를 찾을 위치
Db2 Big SQL 설치되어 있습니다.	이 작업이 완료되지 않았다면, ‘ Db2 Big SQL 설치’를 참조하십시오.
서비스 인스턴스를 생성할 워크스테이션에 명령줄 `cpd-cli` 인터페이스가 설치되어 있습니다.	이 작업이 완료되지 않았다면, ‘클라이언트 워크스테이션 설정’을 참조하십시오.
서비스 인스턴스를 생성할 워크스테이션에 사용자 IBM Software Hub 프로필을 생성했습니다. 이 프로필은 에서 '서비스 인스턴스 생성'`can_provision` 권한을 IBM Software Hub가진 사용자와 연결되어야 합니다.	이 작업이 완료되지 않은 경우, cpd-cli 관리 명령을 사용하려면 프로필 만들기를 참조하십시오.

프로시저

서비스 인스턴스를 생성하려면 다음 작업을 완료하십시오:

서비스 인스턴스 생성
서비스 인스턴스가 생성되었는지 확인
다음에 무엇을 해야 할까요?

서비스 인스턴스 작성

서비스 인스턴스를 작성하려면 다음을 수행하십시오.

서비스 인스턴스 페이로드를 정의하는 JSON 파일을 생성할 워크스테이션의 디렉터리로 이동하십시오.
서비스 인스턴스의 JSON 페이로드를 구성하는 데 사용되는 환경 변수를 설정합니다:
1. 서비스 인스턴스의 표시 이름으로 사용할 고유한 이름을 환경 INSTANCE_NAME 변수에 설정하십시오:
```
export INSTANCE_NAME=<display-name>
```
  이 이름은 웹 IBM Software Hub 클라이언트의 ‘인스턴스’ 페이지에 표시됩니다.
  
  표시 이름은 이며 string , 영문자와 숫자(a-z, A-Z, 0-9) 및 하이픈(-)만 포함할 수 있습니다. 이름은 반드시 영문자나 숫자로 시작하고 끝내야 합니다.
2. 서비스 인스턴스에 사용할 설명으로 환경 INSTANCE_DESCRIPTION 변수를 설정하십시오:
```
export INSTANCE_DESCRIPTION="<description>"
```
  이 설명은 웹 IBM Software Hub 클라이언트의 ‘인스턴스’ 페이지에 표시됩니다.
  
  설명은 문자열이며 string , 영문자와 숫자, 공백, 하이픈, 밑줄, 마침표를 포함할 수 있습니다. 앞서 보여준 export 명령어와 같이 표시 이름을 반드시 따옴표로 묶어 주십시오.
3. 클러스터에 설치된 IBM Software Hub 의 버전과 일치하는 버전으로 INSTANCE_VERSION 를 설정하십시오:
```
export INSTANCE_VERSION=<version>
```
  다음 표를 참고하여 적절한 값을 결정하십시오:
  
  IBM Software Hub버전 서비스 인스턴스 버전
  
  5.3.1 8.3.1
  
  5.3.0 8.3.0
4. 서비스 인스턴스에 할당할 CPU 양을 환경 INSTANCE_CPU 변수에 설정하십시오:
```
export INSTANCE_CPU=<integer>
```
  4에서 64 사이의 값을 입력하십시오.
  
  워크로드에 맞춰 인스턴스 사양을 조정하십시오. 서비스 인스턴스에 할당할 CPU 수에 대한 자세한 내용은 구성 요소 확장 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.
5. 서비스 인스턴스에 할당할 메모리 양을 환경 INSTANCE_MEMORY 변수에 설정하십시오:
```
export INSTANCE_MEMORY=<integer>
```
  16 Gi에서 512 Gi 사이의 값을 지정하십시오. 값을 정수로 지정하십시오. 단위는 생략하십시오.
  
  워크로드에 맞춰 인스턴스 사양을 조정하십시오. 서비스 인스턴스에 할당할 메모리 용량에 대한 자세한 내용은 구성 요소 확장 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.
6. 서비스 인스턴스를 실행할 워커 노드 수를 환경 INSTANCE_WORKERS 변수에 설정하십시오:
```
export INSTANCE_WORKERS=<integer>
```
  지정할 수 있는 작업자 수 상한은 가 관리자 권한으로 실행되도록 Db2U 설정되었는지 여부에 따라 달라집니다:
  - 가 제한된 권한으로 실행되도록 구성된 경우 Db2U , 1부터 클러스터의 전체 워커 노드 수 사이의 값을 지정할 수 있습니다.
  - 가 관리자 권한으로 실행되도록 설정된 Db2U 경우, 1에서 999 사이의 값을 지정할 수 있습니다.
  대부분의 워크로드는 1~3개의 노드에서 실행할 수 있습니다. 사용 중인 워크로드에 따라 권장되는 노드 수에 대한 자세한 내용은 구성 요소 확장 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.
7. 서비스 인스턴스에 할당할 저장소 용량을 환경 PV_SIZE 변수에 설정하십시오.
```
export PV_SIZE=<integer>
```
  200GB에서 10240GB 사이의 값을 지정하십시오. 기본 권장 용량은 200GB입니다. 값을 정수로 지정하십시오. 단위는 생략하십시오.
  
  데이터 세트의 크기, 실행할 쿼리 수, 그리고 실행할 쿼리의 복잡도를 고려하여 퍼시스턴트 볼륨의 크기를 결정하십시오. 서비스 인스턴스에 할당할 스토리지 용량에 대한 자세한 내용은 구성 요소 확장 가이드 PDF 를 참조하십시오. 이 IBM Entitled Registry문서는 에서 다운로드할 수 있습니다.
서비스 인스턴스에서 연결하려는 데이터 소스에 대한 환경 변수를 설정하십시오
Hadoop 군집
1. 클러스터 Hadoop 관리자에 연결할 때 사용할 프로토콜을 환경 REMOTE_CLUSTER_PROTOCOL 변수로 설정하십시오. 예를 들어 HTTP 또는 HTTPS:
```
export REMOTE_CLUSTER_PROTOCOL=<protocol>
```
2. 환경 REMOTE_CLUSTER_HOST 변수를 클러스터 Hadoop 관리자의 호스트 이름이나 IP 주소로 설정하십시오:
```
export REMOTE_CLUSTER_HOST=<host>
```
3. 클러스터 Hadoop 관리자에 연결할 포트 번호로 환경 REMOTE_CLUSTER_PORT 변수를 설정하십시오:
```
export REMOTE_CLUSTER_PORT=<port-number>
```
4. 환경 CM_ADMIN_USER 변수를 클러스터 Hadoop 관리자(administrator)의 사용자 이름으로 설정하십시오.
```
export CM_ADMIN_USER=<username>
```
5. 환경 CM_ADMIN_PASSWORD 변수를 클러스터 Hadoop 관리자(administrator)의 비밀번호로 설정하십시오.
```
export CM_ADMIN_PASSWORD=<password>
```
6. 클러스터의 Hadoop 구성에 Kerberos 따라 환경 KERBEROS_TYPE 변수를 설정하십시오.
  - 클러스터에서 를 사용하지 않는 Kerberos경우, 환경 변수를 로 설정하십시오 0.
```
export KERBEROS_TYPE=0
```
  - 클러스터가 MIT KDC를 Kerberos사용하는 경우, 환경 변수를 로 설정하십시오 1.
```
export KERBEROS_TYPE=1
```
  - 클러스터에서 사용자 정의 Kerberos keytab 파일을 사용하는 경우, 환경 변수를 로 설정하십시오 2.
```
export KERBEROS_TYPE=2
```
7. MIT KDC Kerberos 구성만 해당됩니다. 사용자 Db2 Big SQL 계정을 생성할 권한이 있는 Kerberos 관리자의 Kerberos 계정을 환경 KERBEROS_PRINCIPAL 변수에 설정하십시오.
```
export KERBEROS_PRINCIPAL=<admin-ID>
```
8. MIT KDC Kerberos 구성만 해당됩니다. 환경 KERBEROS_PASSWORD 변수를 관리자 Kerberos ID의 비밀번호로 설정하십시오:
```
export KERBEROS_PASSWORD=<password>
```
9. Kerberos 사용자 정의 keytab 구성만 가능합니다. 환경 KERBEROS_CUSTOM_KEYTAB 변수를 키탭 파일의 전체 경로로 설정하십시오:
```
export KERBEROS_CUSTOM_KEYTAB=<fully-qualified-file-name>
```
오브젝트 저장소
1. 환경 OS_ENDPOINT 변수를 오브젝트 스토어의 서비스 엔드포인트로 설정하십시오:
```
export OS_ENDPOINT=<endpoint>
```
2. 환경 HMAC_ACCESS_KEY 변수를 객체 저장소 서비스 계정과 연결된 HMAC 액세스 키로 설정하십시오:
```
export HMAC_ACCESS_KEY=<your-HMAC-access-key>
```
3. 환경 HMAC_SECRET_KEY 변수를 액세스 키와 연결된 시크릿 키로 설정하세요:
```
export HMAC_SECRET_KEY=<your-HMAC-secret-key>
```
4. SSL 해당 환경에서만. SSL 인증서를 제공하려는 방식에 따라 환경 OS_SSL_CERT 변수를 설정하십시오:
  - 볼트에 시크릿으로 저장된 SSL 인증서를 사용하려면 다음 형식을 따르세요:
```
export OS_SSL_CERT=vault:<vault-secret-name>:<vault-secret-key>
```
  - 수동으로 제공된 SSL 인증서를 사용하려면:
```
export OS_SSL_CERT="<my-certificate-contents>"
```
    인증서 내용을 반드시 큰따옴표("")로 묶어야 합니다.
5. 특정 버킷에 대한 액세스를 제한할지 여부에 따라 환경 OS_BUCKET 변수를 설정하십시오:
  - 특정 버킷에 대한 액세스를 제한하려면 환경 변수를 해당 버킷의 이름으로 설정하세요:
```
export OS_BUCKET=<bucket-name>
```
  - 특정 버킷에 대한 액세스를 제한하지 않으려면 환경 변수를 다음과 같이 ""설정하세요:
```
export OS_BUCKET=""
```
6. 객체 저장소 서비스가 경로 기반 액세스로 구성되어 있는지 여부에 따라 환경 OS_PATH_STYLE_ACCESS 변수를 설정하십시오:
  - 오브젝트 스토어가 경로 기반 액세스로 구성되어 있다면, 환경 변수를 다음과 같이 true설정하십시오:
```
export OS_PATH_STYLE_ACCESS=true
```
  - 객체 저장소가 가상 호스팅 방식의 액세스로 구성되어 있다면, 환경 변수를 다음과 같이 false설정하십시오:
```
export OS_PATH_STYLE_ACCESS=false
```

IBM Software Hub버전	서비스 인스턴스 버전
5.3.1	8.3.1
5.3.0	8.3.0

페이로드 big-sql-instance.json 파일을 생성합니다:

인스턴스가 Kerberos 없이 원격 Hadoop 클러스터를 가리킵니다

cat << EOF > ./big-sql-instance.json
{
    "addon_type": "bigsql",
    "display_name": "${INSTANCE_NAME}",
    "addon_version": "${INSTANCE_VERSION}",
    "namespace": "${PROJECT_CPD_INST_OPERANDS}",
    "create_arguments": {
        "resources": {
            "cpu": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_CPU} ))",
            "memory": "$(( (${INSTANCE_WORKERS} + 1) * ${INSTANCE_MEMORY} ))"
        },
        "parameters": {
            "global.persistence.storageClassName": "${STG_CLASS_BLOCK}",
            "resources.engine.requests.cpu": "${INSTANCE_CPU}",
            "resources.engine.requests.memory": "${INSTANCE_MEMORY}Gi",
            "workerCount": "${INSTANCE_WORKERS}",
            "persistence.headPvSize": "${PV_SIZE}Gi",
            "remoteCluster.cmAdminUserEncoded": "$([[ ! -z ${CM_ADMIN_USER} ]] && echo ${CM_ADMIN_USER} | base64)",
            "remoteCluster.cmAdminPasswordEncoded": "$([[ ! -z ${CM_ADMIN_PASSWORD} ]] && echo ${CM_ADMIN_PASSWORD} | base64)",
            "remoteCluster.cmProtocol": "${REMOTE_CLUSTER_PROTOCOL}",
            "remoteCluster.cmHost": "${REMOTE_CLUSTER_HOST}",
            "remoteCluster.cmPort": "${REMOTE_CLUSTER_PORT}",
            "remoteCluster.useCloudObjectStore": "false",
            "secretsInstanceKey": "${INSTANCE_SECRET_KEY}",
            "persistence.auditPvSize": "30Gi"
        },
        "description": "",
        "metadata": {
            "engine-service": "c-bigsql-{INSTANCEID}-db2u-0.c-bigsql-{INSTANCEID}-db2u-internal.zen",
            "database-name": "bigsql",
            "jdbc-port": 50000,
            "secure-jdbc-port": 50001,
            "sslConnection": true,
            "credentials": {
                "user": "dmcuser",
                "securityMechanism": "9"
            },
            "ssl": {
                "certKey": "ca.crt",
                "certLabel": "CN=zen-ca-cert",
                 "secretName": "bigsql-{INSTANCEID}-internal-tls"
            }
                },
    "deployment_id": ""
  },
  "transient_fields": {}
}
EOF