전제 조건

다음 섹션에서는 IBM DB2 for LUW 커넥터 작업을 위한 전제 조건에 대해 설명합니다.

데이터를 랜딩하거나 복제하려면 먼저 다음 전제 조건을 완료해야 합니다.

• 데이터 이동 게이트웨이 서버에 필요한 driver를 설치합니다.

  정보 메모

  이는 데이터 이동 게이트웨이를 사용하기로 선택한 경우에만 필요합니다. 데이터 이동 게이트웨이의 이점과 필요한 경우에 대한 자세한 내용은 Qlik 데이터 게이트웨이 - 데이터 이동를 참조하십시오.

• 데이터 소스에 필요한 권한 부여

• 데이터 소스 커넥터 구성

드라이버 설정

드라이버 설치 유틸리티(권장)를 사용하거나 수동으로 driver를 설치할 수 있습니다. 수동 설치는 드라이버 설치 유틸리티에 문제가 발생하는 드문 경우에만 시도해야 합니다.

드라이버 설치 유틸리티를 사용하여 드라이버 설치

이 섹션에서는 필수 driver를 설치하는 방법에 대해 설명합니다. 프로세스에는 driver 다운로드, 필요한 폴더(아래 참조)에 복사, 자동으로 설치 및 구성할 스크립트 실행이 포함됩니다. 필요에 따라 스크립트를 실행하여 driver를 업데이트하고 제거할 수도 있습니다.

설치 준비

• Python 3.6 이상이 데이터 이동 게이트웨이 서버에 설치되어 있는지 확인합니다.

  Python은 대부분의 Linux 배포에 사전 설치되어 있습니다. 다음 명령을 실행하여 시스템에 설치된 Python 버전을 확인할 수 있습니다.

  python3 --version

• IBM 웹 사이트에서 IBM Data Server Client "<버전>_linuxx64_client.tar.gz"를 다운로드합니다. /opt/qlik/gateway/movement/drivers/manifests/db2.yaml의 binary-artifacts에서 지원되는 버전을 찾을 수 있습니다. 다운로드가 완료되면 파일을 다음 위치에 복사하십시오.

  /opt/qlik/gateway/movement/drivers/db2

driver 설치

driver를 하고 설치하려면:

1. 데이터 이동 게이트웨이 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: inactive (dead) since <timestamp> ago

3. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

4. 다음 명령을 실행합니다.

   구문:

   ./install db2

   그렇지 않으면 driver에 대한 EULA가 표시됩니다.

5. 다음 중 하나를 수행합니다.

   • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
   • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
   • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

6. 다음 중 하나를 수행합니다.

   • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
   • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.

   • "v"를 입력하고 [Enter] 키를 눌러 EULA를 다시 봅니다.

driver가 설치됩니다.

7. 설치가 완료될 때까지 기다린 다음("완료!"로 표시됨) 데이터 이동 게이트웨이 서비스를 시작합니다.

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

driver 업데이트

제공된 driver를 설치하기 전에 driver의 이전 버전을 제거하려면 업데이트 명령을 실행합니다.

driver를 다운로드하고 업데이트하려면:

1. 데이터 이동 게이트웨이 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: inactive (dead) since <timestamp> ago

3. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

4. 다음 명령을 실행합니다.

   구문:

   ./update db2

   그렇지 않으면 driver에 대한 EULA가 표시됩니다.

5. 다음 중 하나를 수행합니다.

   • [Enter] 키를 반복해서 눌러 EULA를 천천히 스크롤합니다.
   • 스페이스바를 반복해서 눌러 EULA를 빠르게 스크롤합니다.
   • q를 눌러 라이센스 텍스트를 종료하고 EULA 동의 옵션이 표시됩니다.

6. 다음 중 하나를 수행합니다.

   • "y"를 입력하고 [Enter]를 눌러 EULA에 동의하고 설치를 시작합니다.
   • "n"을 입력하고 [Enter] 키를 눌러 EULA를 거부하고 설치를 종료합니다.
   • "v"를 입력하고 [Enter] 키를 눌러 EULA를 처음부터 검토합니다.

이전 driver가 제거되고 새 driver가 설치됩니다.

7. 설치가 완료될 때까지 기다린 다음("완료!"로 표시됨) 데이터 이동 게이트웨이 서비스를 시작합니다.

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

driver 제거

driver를 제거하려면 제거 명령을 실행합니다.

driver를 제거하려면:

1. 이 커넥터를 사용하도록 구성된 모든 작업을 중지합니다.

2. 데이터 이동 게이트웨이 컴퓨터에서 작업 디렉터리를 다음으로 변경합니다.

   opt/qlik/gateway/movement/drivers/bin

3. 다음 명령을 실행합니다.

   구문:

   ./uninstall db2

   driver이 제거됩니다.

수동으로 드라이버 설치

자동 드라이버 설치가 성공적으로 완료되지 않은 경우에만 수동으로 driver 설치를 시도해야 합니다.

데이터 이동 게이트웨이 컴퓨터에서 셸 프롬프트를 열고 다음을 수행합니다.

1. 데이터 이동 게이트웨이 서비스 중지:

   sudo systemctl stop repagent

2. 선택적으로 서비스가 중지되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: inactive (dead) since <timestamp> ago

3. IBM Data Client v11.5.8_linuxx64_server_t.tar.gz를 설치합니다. "CLIENT" 설치를 선택합니다.

4. 데이터 이동 게이트웨이 컴퓨터에 DB2 인스턴스가 없는 경우 다음 명령을 실행하여 DB2 인스턴스를 만듭니다.

   adduser <db2_instance_name>

   /opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>

5. Linux 라이브러리 경로에 DB2 드라이버 위치를 추가합니다.

   이렇게 하려면 site_ arep_login.sh 파일에 복사합니다.

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   여기서 path은 드라이버에 대한 CLIENT 경로입니다.

   예(인스턴스 이름으로 db2clnt1 사용):

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit

   export DB2INSTANCE=db2clnt1

6. odbcinst.ini라는 새 파일을 /etc 아래에 만들고 다음 항목을 추가합니다.

   [IBM DB2 ODBC DRIVER]

   Driver = /home/db2clnt1/sqllib/lib/libdb2o.so

   fileusage=1

   dontdlclose=1

7. 데이터 이동 게이트웨이 서비스 시작:

   sudo systemctl start repagent

8. 선택적으로 서비스가 시작되었는지 확인합니다.

   sudo systemctl status repagent

   상태는 다음과 같아야 합니다.

   Active: active (running) since <timestamp> ago

9. IBM DB2 for LUW에 설명된 대로 IBM DB2 for LUW 연결 설정을 정의하고 연결 테스트를 클릭합니다.

   다음 오류가 발생하는 경우:

   Cannot connect to DB2 LUW Server ODBC unknown error.

   RetCode: SQL_ERROR SqlState: NativeError: -1390 Message: [unixODBC][IBM][CLI Driver] SQL10007N Message "0" could not be retrieved. Reason code: "3". ODBC general error.

   1. 다음 명령을 실행합니다.

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_커넥터_connection_settings> -host <server_name_from_커넥터_connection_settings> -port <port_from_커넥터_connection_settings>

   2. 데이터 이동 게이트웨이bin 디렉터리(<설치 디렉터리>/bin)로 변경합니다. 그런 다음 위에서 설명한 대로 데이터 이동 게이트웨이 서비스를 중지했다가 시작합니다.

데이터베이스에서 CDC 활성화

CDC(변경 데이터 캡처)를 활성화하려면:

• 데이터베이스를 복구 가능으로 설정 - 변경 내용을 캡처하려면 데이터 이동 게이트웨이에서 데이터베이스를 복구 가능으로 구성해야 합니다. 데이터베이스 구성 매개 변수 LOGARCHMETH1 및 LOGARCHMETH2 중 하나 또는 모두가 OFF로 설정되지 않은 경우 데이터베이스를 복구할 수 있습니다.

• 권한 - Qlik 사용자에게 다음 권한이 부여되어야 합니다.

  • SYSADM 또는 DBADM

  • DATAACCESS

• IBM DB2 for LUW에서 데이터 캡처를 활성화하려면 소스 테이블을 다음과 같이 만들어야 합니다.

  CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS];

  커넥터 설정에서 DATA CAPTURE CHANGES 자동 활성화(관리자 권한 필요)를 선택하여 이 작업을 수행하도록 데이터 이동 게이트웨이를 구성하거나 수동으로 수행할 수 있습니다.