기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기
Qlik 리소스

문제 해결 직접 액세스 게이트웨이

이 섹션에서는 직접 액세스 게이트웨이 문제를 해결하기 위해 수행할 수 있는 다양한 작업에 대해 설명합니다.

로그 파일 보기 및 다운로드

로그 파일은 직접 액세스 게이트웨이 작업에 대한 정보를 제공합니다. Qlik 지원에서 문제 해결을 위해 로그 파일 제공을 요청할 수 있습니다. 로그 뷰어에서 로그 파일을 보거나 다운로드할 수 있습니다. 정상적인 상황에서는 로그 파일을 검사할 이유가 없지만 반복적인 실패 또는 기타 문제가 발생하는 경우 로그 파일이 원인을 정확히 찾는 데 도움이 되는 경우가 많습니다.

정보 메모로그를 보고 다운로드하려면 데이터를 소비할 수 있음 역할이 필요합니다.

로그 뷰어를 열려면:

  1. 관리 콘솔에서 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.

  2. 행 끝에 있는 을 클릭하고 로그 보기를 선택합니다.

    로그 뷰어 창이 열립니다.

  3. 왼쪽 위의 드롭다운 목록에서 Qlik 지원에서 보거나 다운로드하도록 요청한 로그 유형을 선택합니다.

    다음 로그를 사용할 수 있습니다.

    • 직접 액세스 게이트웨이 로그(DirectAccessAgent)
    • DCaaS 로그(dcaas_logs)
    • ODBC 기반 커넥터 로그(odbc-connector_logs)
    • SAP BW 커넥터 로그(QvSAPBwConnector-<날짜 + 타임스탬프>)
    • SAP SQL 커넥터 로그(QvSqlBwConnector-<날짜 + 타임스탬프>)
    • 커넥터 에이전트 로그(connector-agent_logs_<날짜>)

  4. 옆에 있는 드롭다운 목록에서 보거나 다운로드하려는 로그를 선택합니다. 로그 파일은 최신(현재 활성 로그 파일)에서 가장 오래된 것으로 정렬됩니다. 로그 파일을 선택한 후 및 버튼을 사용하여 각각 로그 파일의 시작 또는 끝으로 이동할 수 있습니다.

    팁 메모로그 파일 보기는 최신 메시지로 자동 업데이트되지 않습니다. 보기를 업데이트하려면 을 클릭하여 최신 메시지로 업데이트될 로그 파일의 끝으로 이동합니다.

  5. 로그 파일을 다운로드하려면 다운로드를 클릭합니다.

    브라우저 설정에 따라 파일이 컴퓨터에 다운로드되거나 저장하라는 메시지가 표시됩니다.

직접 액세스 게이트웨이 컴퓨터의 직접 액세스 게이트웨이 로그 열기

관리 콘솔에서 직접 액세스 게이트웨이(DirectAccessAgent) 로그를 다운로드할 수 있을 뿐만 아니라 직접 액세스 게이트웨이 컴퓨터에서 직접 열 수도 있습니다. 기본 설치에서 이러한 로그는 다음 위치에 있습니다.

C:\Program Files\Qlik\ConnectorAgent\data\logs

로깅 세부 정보 수준 변경

필요에 따라 직접 액세스 게이트웨이(DirectAccessAgent) 로그의 로깅 세부 수준을 확인하고 변경할 수 있습니다. 이렇게 하려면 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)에서 다음 명령을 실행합니다.

  • 현재 로깅 수준을 보려면 다음을 실행합니다.

    connectoragent configuration getloggers

  • 로깅 수준을 Trace로 설정하려면 다음을 실행합니다.

    connectoragent configuration setloggers -l Root -v DEBUG

  • 로깅 수준을 Verbose로 설정하려면 다음을 실행합니다.

    connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

등록 키 업데이트

예상치 못하게 키가 손상되거나 권한이 없는 사용자가 데이터 게이트웨이 서버에 액세스한 것으로 의심되는 경우 등록 키를 변경해야 할 수 있습니다.

등록 키를 업데이트하려면:

  1. 직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.

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

    • 새 키 생성:

      connectoragent qcs generate_keys

    • 키 표시:

      connectoragent qcs get_registration

      키가 표시됩니다.

  3. 위의 예와 같이 전체 키를 복사합니다.

  4. 관리 콘솔에서 해당 행 끝에 있는 버튼을 클릭하고 편집을 선택하여 데이터 게이트웨이 설정을 엽니다.

  5. 키 필드에 키를 붙여넣고(현재 키 교체) 설정을 저장합니다.

  6. Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리에 설명된 대로 직접 액세스 게이트웨이 서버로 돌아가 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

다시 로드 중 커넥터 충돌 완화

프로세스 격리를 통해 관리자는 게이트웨이 서버 운영 체제에 직접 액세스하여 커넥터 유형별로 다시 로드할 수 있는 프로세스 수를 제어할 수 있습니다. 여러 커넥터 프로세스에 다시 로드를 분산시키면 각 커넥터 프로세스에서 동시에 실행되는 다시 로드 수가 줄어들어 격리 수준이 높아집니다. 결과적으로 커넥터 충돌이 발생한 경우 전반적인 직접 액세스 게이트웨이 안정성이 향상될 수 있습니다.

정보 메모

직접 액세스 게이트웨이 1.6.1 이상이 필요합니다.

프로세스 격리를 켜려면 다음을 수행합니다.

  1. C:\ProgramData\Qlik\Gateway\configuration.properties 파일을 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

    파일에는 다양한 커넥터 유형에 해당하는 세 가지 접두사가 포함되어 있습니다. ODBC_<속성 이름>, SAPBW_<속성 이름> 및 SAPSQL_<속성 이름>.

  2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE를 로드로 설정하고 ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT를 N으로 설정합니다.

    여기서:

    N = 명령 프로세스 1개 + 할당할 동시 다시 로드 프로세스 수입니다. 예를 들어, 값 10은 최대 9개의 동시 다시 로드를 의미합니다.

    정보 메모

    기본 포트 번호 및 범위 설정으로는 [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT 값을 10보다 높게 설정할 수 없습니다.

  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

프로세스 격리를 끄려면 다음을 수행합니다.

  1. C:\ProgramData\Qlik\Gateway\configuration.properties 파일을 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.

  2. ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE를 없음으로 설정합니다.

  3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

ODBC 커넥터 프로세스 격리 예

configuration.properties 파일 중 다음 부분은 최대 9번의 다시 로드에 대해 ODBC 커넥터 프로세스 격리를 활성화하는 방법을 보여 줍니다.

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

기본 포트 설정을 변경하면 MAX_PROCESS_COUNT 값이 10을 초과할 수 있습니다. 그러나 이 경우:

  • ODBC_PORT 또는 ODBC_DATA_PORT_RANGE_START와 SAPBW_PORT 또는 SAPBW_DATA_PORT_RANGE_START 사이의 포트 수는 ODBC_MAX_PROCESS_COUNT 이상이어야 합니다.

  • SAPBW_PORT 또는 SAPBW_DATA_PORT_RANGE_START와 SAPSQL_PORT 또는 SAPSQL_DATA_PORT_RANGE_START 사이의 포트 수는 SAPBW_MAX_PROCESS_COUNT 이상이어야 합니다.

예를 들어, ODBC_MAX_PROCESS_COUNT=30을 설정하려면 포트 매개 변수가 다음과 같아야 합니다.

# ODBC Connector

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=30

ODBC_DATA_PORT_RANGE_START=50260

ODBC_PORT=3005

# SAP BW Connector

SAPBW_PROCESS_ISOLATION_MODE=None

SAPBW_MAX_PROCESS_COUNT=0

SAPBW_DATA_PORT_RANGE_START=50290

SAPBW_PORT=3035

# SAP SQL Connector

SAPSQL_PROCESS_ISOLATION_MODE=None

SAPSQL_MAX_PROCESS_COUNT=0

SAPSQL_DATA_PORT_RANGE_START=50300

SAPSQL_PORT=3045

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!

여기에 피드백을 남겨주십시오.