기본 콘텐츠로 건너뛰기

설치 Qlik DataTransfer

Qlik DataTransfer는 방화벽 터널링 없이 온프레미스 데이터 소스에서 Qlik Sense SaaS 테넌트로 데이터를 업로드할 수 있는 경량 Windows 응용 프로그램입니다. SAO(서비스 계정 소유자) 또는 테넌트 관리자는 테넌트에서 API 키를 생성한 다음 Qlik DataTransfer를 인증하는 데 사용합니다. 인증되면 자동 데이터 로드를 예약하거나 데이터를 수동으로 업로드할 수 있습니다.

참고: Qlik DataTransfer는 암호화된 통신을 지원하지만 FIPS(Federal Information Processing Standards)와 호환되지 않습니다. Qlik Sense Enterprise SaaS - Government (US) 사용자는 이 도구를 사용하여 보류 중인 자체 위험 검토를 구현할 수 있습니다.

Qlik DataTransfer는 다음과 같은 종류의 데이터 소스에서 작동합니다.

  • 앱 데이터
  • 연결 데이터
  • 폴더

Qlik DataTransfer에서 사용할 수 있는 데이터 유형에 대한 정보는 Qlik DataTransfer를 사용하여 온프레미스 데이터 업로드을 참조하십시오.

Qlik DataTransfer 설치는 단일 Qlik Sense SaaS 테넌트에만 연결할 수 있습니다.

시작하기 전에

Qlik DataTransfer 설치 관리자를 다운로드하고 실행하기 전에 다음 요구 사항을 충족하는지 확인합니다.

  • Qlik Sense SaaS 테넌트에 액세스할 수 있습니다.
  • 해당 테넌트에 대한 Professional 액세스 권한이 있습니다.
  • 해당 테넌트에 대한 개발자 역할이 할당되었습니다.
  • Qlik DataTransfer에서 데이터를 업로드하는 모든 공간에 액세스할 수 있습니다. 자세한 내용은 공간 관리를 참조하십시오.
  • 온프레미스 데이터 소스에 대한 액세스 권한이 있는 Windows 시스템에 대한 관리자 권한이 있습니다.
  • Windows 시스템은 다음 시스템 요구 사항을 충족합니다. Qlik DataTransfer의 시스템 요구 사항 (영어로만 제공)
  • API 키는 Management Console에서 활성화됩니다. API 키 활성화에 대한 자세한 내용은 API 키 관리를 참조하십시오.
  • SSL 구성 설정 정책은 Qlik DataTransfer를 설치 중인 시스템에서 IANA 형식의 암호만 지원하도록 설정되어야 합니다.

    Windows Server 2012 R2에서 Qlik DataTransfer May 2021 이상 릴리스를 설치하거나 업그레이드하는 경우 TLS Cipher Suite를 업데이트해야 합니다. Windows Server 2021 R2 기본 보안 정책에 포함된 기본 암호는 Qlik DataTransfer May 2021 이상에서 지원되지 않습니다. 다음 암호 그룹이 있어야 합니다.

    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    시스템에서 TLS Cipher Suite를 업데이트하거나 Qlik DataTransfer 환경에서 약한 암호를 비활성화하는 방법에 대한 지침은 다음 커뮤니티 문서를 참조하십시오. https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

  • Qlik DataTransfer를 사용하려면 Windows 사용자 계정이 필요합니다. Qlik DataTransfer 서비스를 실행하려면 전용 사용자 계정을 사용하는 것이 좋습니다. 전용 사용자가 관리자인 경우 해당 사용자로 로그인하여 Qlik DataTransfer를 설치할 수 있습니다. 전용 사용자가 로컬 관리자가 아닌 경우 관리자 계정을 사용하여 Qlik DataTransfer를 설치해야 합니다.

    Qlik Sense Enterprise on Windows가 설치된 Windows 서버에 Qlik DataTransfer를 설치하거나 업그레이드하는 경우 Qlik Sense 설치에 사용된 Qlik Sense 서비스 사용자로 Qlik DataTransfer를 설치해야 합니다.

  • Qlik DataTransfer를 설치하는 사용자 계정에는 RemoteSigned 실행 정책으로 PowerShell 스크립트를 실행할 수 있는 권한이 있어야 합니다.

  • 테넌트를 사용하여 Qlik DataTransfer를 구성한 후 서비스 로그온 계정을 변경하는 경우 테넌트 및 연결을 다시 구성해야 합니다. 그런 다음 %ProgramData%/Qlik/DataTransfer/DataUpload/storage에서 token.json을 삭제합니다. Qlik DataTransfer 서비스를 다시 시작합니다.

  • February 2021 SR1의 경우 Qlik Sense Enterprise on Windows 또는 QlikView Server와는 별도의 서버에 Qlik DataTransfer를 설치하는 것이 좋습니다. Qlik DataTransferQlik Sense Enterprise on Windows 서버 또는 QlikView Server에 설치된 경우 Qlik DataTransfer는 로컬 시스템 사용자 계정을 사용하여 실행됩니다. 서비스 사용자 계정을 변경하면 Qlik DataTransfer 또는 Qlik Sense Service Dispatcher가 중지됩니다.

팁: Qlik DataTransfer 설치 관리자에는 Qlik associative engine, Simba ODBC 커넥터 및 Qlik DataTransfer 에이전트의 인스턴스가 포함됩니다. 설치가 시작되면 추가 메모리 및 처리 리소스를 사용하므로 서버가 다른 응용 프로그램과 리소스를 공유하는 경우 이 점을 고려해야 합니다. 프로덕션 환경의 경우 자체 서버에 Qlik DataTransfer를 설치하는 것이 좋습니다.

설치 사용자 계정 실행 정책 확인

Qlik DataTransfer를 설치하는 사용자 계정에는 RemoteSigned 실행 정책으로 PowerShell 스크립트를 실행할 수 있는 권한이 있어야 합니다. 사용자 계정 권한을 할당할 권한이 없는 경우 관리자에게 문의하여 설치 사용자 계정에 이러한 권한을 부여합니다.

  1. 관리자 모드에서 PowerShell을 엽니다.

  2. Get-ExecutionPolicy를 실행합니다. RemoteSigned여야 합니다. Restricted 또는 Disabled인 경우 다음 단계를 계속합니다.

  3. Set-ExecutionPolicy RemoteSigned를 실행합니다.

  4. Y을 선택합니다.

설치 관리자 다운로드 및 실행

참고:

Qlik Sense Enterprise on Windows가 설치된 Windows 서버에 Qlik DataTransfer를 설치하거나 업그레이드하는 경우 Qlik Sense 설치에 사용된 Qlik Sense 서비스 사용자로 Qlik DataTransfer를 설치해야 합니다.

  1. 다음 중 하나에서 Qlik DataTransfer.exe 파일을 다운로드합니다.

    1. Qlik 다운로드 사이트.

    2. 클라우드 허브. 오른쪽 위 모서리에서 프로필 아이콘을 클릭하고 프로필 설정을 클릭합니다. 이 옵션은 Qlik Sense Enterprise SaaS - Government (US)에서 사용할 수 없습니다.

  2. 설치 관리자를 실행하고 Qlik 사용자 라이센스 계약에 동의합니다. 기본 설치 경로는 %Program Files%\Qlik\DataTransfer입니다. 서비스 자격 증명을 입력할 때 사용자 이름은 도메인\사용자 이름 형식이어야 합니다.

    참고:

    21자 이상의 사용자 이름을 입력하는 경우 UPN(사용자 계정 이름) 형식이어야 하며 전체 도메인 이름을 포함해야 합니다. 예: longusername@full.domain.name.

    참고:

    동일한 서버에 Qlik Sense Desktop 또는 다른 Qlik 플랫폼이 설치되어 있는 경우 Qlik DataTransfer를 설치하기 전에 해당 플랫폼을 종료하고 Qlik 서비스를 중지해야 합니다.

    Qlik dataTransfer 설치 관리자 화면

    설치가 완료되면 다음 순서로 Qlik 서비스를 다시 시작합니다.

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

  3. Service Credentials(서비스 자격 증명) 창에서 Qlik DataTransfer 서비스를 실행하는 데 사용할 계정의 사용자 이름과 암호를 입력합니다.

설치 관리자는 Qlik DataTransfer 응용 프로그램을 시작하기 위한 바탕 화면 바로 가기를 만듭니다.

포트

Qlik DataTransfer는 다음 포트를 사용합니다.

서비스 포트 방향

보안 웹 브라우저 통신(HTTPS)

참고: 방화벽에서 이 포트를 열어야 합니다.
443 아웃바운드
Data Upload service 5505 내부
Engine service 5506 내부
Connector Registry proxy 5507 내부

기본 서비스 포트 중 하나와 충돌하는 포트가 있는 경우 %Program Files%\Qlik\DataTransfer에 있는 services.conf 파일에서 해당 포트를 변경할 수 있습니다.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507

로그 및 데이터 파일 저장소

Qlik DataTransfer 로그 파일은 다음 위치에 있습니다. %ProgramData%\Qlik\DataTransfer\Log

Qlik DataTransfer 데이터 연결은 다음 위치에 있습니다. %ProgramData%\Qlik\DataTransfer\DataUpload

%Program Files%\Qlik\DataTransfer에 있는 services.conf 파일에서 기본 저장소 경로를 변경할 수 있습니다.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507
참고: 저장소 폴더의 파일을 안전한 위치에 백업하는 것이 좋습니다.

API 키 생성

API 키가 만료되었습니다. 기본 만료 시간은 비즈니스 요구 사항에 적합하지 않을 수 있습니다. API 키를 생성하기 전에 Management Console 설정에서 최대 토큰 만료 시간을 변경하는 것이 좋습니다. 자세한 내용은 테넌트에서 API 키 활성화을 참조하십시오.

다음과 같이 하십시오.

  1. Qlik Sense SaaS 테넌트에 로그인합니다.
  2. 클라우드 허브에서 오른쪽 위 모서리에서 프로필 아이콘을 클릭하고 프로필 설정을 클릭합니다.
  3. API 키를 선택합니다.
  4. 새 키 생성을 선택합니다.

    클라우드 허브 설정 메뉴, API 키 생성
  5. API 키의 이름을 입력하고 만료 시간을 선택합니다.
  6. 생성을 클릭합니다.

    새 API 키 생성 화면

  7. 복사 및 닫기를 클릭하여 API 를 클립보드에 복사합니다.

    참고: API 키를 저장해야 합니다. Qlik DataTransfer를 인증하려면 이 키가 필요합니다.
    API 키 요약 화면

    이제 API 키가 있으므로 Qlik DataTransferQlik Sense SaaS 테넌트 간에 보안 연결을 만들 수 있습니다. API 키는 테넌트에 데이터를 업로드할 때 Qlik DataTransfer를 인증하는 데 사용됩니다. API 에는 만료 시간이 있으므로 새 API 키를 만들고 이 키가 만료되면 Qlik DataTransfer를 다시 인증해야 합니다. API 키가 만료되면 데이터 연결을 다시 만들 필요가 없습니다.

인증 Qlik DataTransfer

다음과 같이 하십시오.

  1. Qlik DataTransfer를 엽니다.

    Qlik DataTransfer를 처음 열면 Qlik DataTransfer 설정 인증 화면이 나타납니다.

    Qlik dataTransfer API 키 연결 화면
  2. 연결 이름을 입력합니다.
  3. Qlik Sense SaaS 테넌트에 대한 URL을 입력합니다.
  4. 테넌트에서 생성한 API 키를 붙여넣습니다.

  5. 적용을 클릭하여 테넌트를 확인합니다.

  6. API 키가 만료된 경우 또는 다른 테넌트에 대해 Qlik DataTransfer를 인증하려면 을 클릭하여 새 API 키를 입력한 다음 확인을 클릭합니다.

Qlik DataTransfer가 인증되면 온프레미스 데이터를 Qlik Sense SaaS 테넌트에 업로드할 수 있습니다. Qlik DataTransfer를 사용하는 방법에 대한 자세한 내용은 Qlik DataTransfer를 사용하여 온프레미스 데이터 업로드를 참조하십시오.

참고: 테넌트를 사용하여 Qlik DataTransfer를 구성한 후 서비스 로그온 계정을 변경하는 경우 테넌트 및 연결을 ODBC 데이터 소스에 다시 구성해야 합니다.

업그레이드 Qlik DataTransfer

Qlik DataTransfer는 새 버전을 사용할 수 있을 때 알림 배너를 표시합니다. Qlik DataTransfer는 최신 버전으로 자동 업그레이드되지 않습니다.

경고:

구성 파일 Service.conf에서 구성 파일을 저장할 다른 위치를 선택했거나 Qlik DataTransfer를 실행하는 데 다른 포트를 선택한 경우 업그레이드가 이를 재정의합니다. 업그레이드하기 전에 Service.conf 파일을 백업하고 업그레이드가 완료된 후 기본 구성 폴더에 복사하여 설정을 유지하십시오.

Qlik DataTransfer에서 로컬 시스템 계정을 사용하는 경우 서비스 사용자 자격 증명을 요청하는 메시지가 표시되지 않고 로컬 시스템을 계속 사용합니다.

Qlik DataTransfer 업그레이드 배너

다음과 같이 하십시오.

  1. 앱 내 배너 또는 Qlik 다운로드 사이트에서 Qlik DataTransfer의 새 버전을 다운로드합니다.
  2. Qlik DataTransfer의 현재 버전을 닫습니다.
  3. Qlik DataTransfer 설치 관리자를 실행합니다.

    참고:

    Qlik Sense Enterprise on Windows가 설치된 Windows 서버에 Qlik DataTransfer를 업그레이드하는 경우 Qlik Sense 설치에 사용된 Qlik Sense 서비스 사용자로 Qlik DataTransfer를 업그레이드해야 합니다.

  4. 업그레이드를 클릭합니다.

    QlikDataTransfer 업그레이드 창

제거Qlik DataTransfer

참고: Qlik DataTransfer를 제거하면 설치 관리자가 모든 Qlik DataTransfer 파일과 폴더를 제거합니다. 보관할 파일이나 폴더를 새 위치에 저장해야 합니다.

다음과 같이 하십시오.

  1. Qlik DataTransfer 설치 관리자를 실행합니다.

    참고:

    동일한 서버에 Qlik 플랫폼이 설치되어 있는 경우 Qlik DataTransfer를 제거하기 전에 Qlik 서비스를 중지해야 합니다.

  2. 제거를 클릭합니다.
  3. 제거가 완료되면 해당되는 경우 다음 순서로 Qlik 서비스를 다시 시작합니다.

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

제한 사항

Qlik DataTransfer 다음과 같은 제한 사항이 있습니다.

  • October 2020 릴리스 이상에서 업그레이드할 때 구성 파일을 저장하는 위치와 Qlik DataTransfer 실행에 사용되는 포트가 구성 파일 Service.conf에서 기본값으로 변경됩니다. 구성 파일을 저장하는 데 기본 위치를 사용하지 않았거나 Qlik DataTransfer를 실행하는 데 기본 포트를 사용하지 않은 경우 이러한 설정이 손실됩니다. 설정을 유지하려면 업그레이드 전에 Service.conf를 백업하고 업그레이드가 완료된 후 백업된 파일에서 Service.conf의 설정을 다시 지정하십시오.

  • Service.conf에서 구성 파일을 저장하는 데 기본 위치를 사용하지 않은 경우 선택한 폴더에서 파일을 수동으로 삭제해야 합니다.