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

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

로그 파일 보기 및 다운로드

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

로그 뷰어를 열려면:

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

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

   로그 뷰어 창이 열립니다.

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

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

   • 직접 액세스 게이트웨이 로그(DirectAccessAgent)
   • DCaaS 로그(dcaas_logs)
   • ODBC 기반 커넥터 로그(odbc-connector_logs)
   • SAP BW 커넥터 로그(QvSAPBwConnector-<날짜 + 타임스탬프>)
   • SAP ODP 커넥터 로그(QvSapConnectorPackage-<프로세스 ID>)
   • 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 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

다시 로드 세션 수명 연장

직접 액세스 게이트웨이 및 Qlik Cloud 간의 연결이 20초 이상 유휴 상태인 경우 다음 오류와 함께 다시 로드 작업이 실패할 수 있습니다.

Invalid object name '#<TempTableName>' (indicating that the 직접 액세스 게이트웨이 temp tables are unavailable).

기본 세션 수명은 20초이지만, 이 오류가 자주 발생하는 경우 다음과 같이 세션 수명을 연장할 수 있습니다.

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

2. ODBC_RELOAD_SESSION_LIFE 매개 변수를 찾아 필요에 따라 값을 늘립니다.
3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

로드 요청에 대한 제한 시간 연장

네트워크 중단이 발생하면 다음 오류와 함께 다시 로드가 실패할 수 있습니다.

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

위의 오류가 자주 발생하는 경우 EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 5~10분으로 설정해 보십시오.

수행할 작업:

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

2. EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 찾아 값을 5~10분으로 늘립니다. 기본값은 "0"입니다.
3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

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

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

프로세스 격리 해제

Qlik 지원 센터에서는 문제 해결을 위해 프로세스 격리 해제를 요청할 수 있습니다.

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

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

2. [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE(조건부 모든 행 색 지정)을 None(지정된 행)으로 설정합니다.

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

프로세스 격리 켜거나 동시 다시 로드 수 변경

프로세스 격리를 켜거나 동시 다시 로드 수를 변경하려면:

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

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

2. [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE를 Load 로 설정하고 [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT를 N으로 설정합니다.

   여기서:

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

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

ODBC 커넥터 프로세스 격리 예

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

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

직접 액세스 게이트웨이 버전 1.6.7부터 다른 설정을 변경하지 않고도 MAX_PROCESS_COUNT 값이 10을 초과할 수 있습니다. 특정 커넥터 유형에 대한 다시 로드를 완전히 분리하려면(즉, 커넥터 프로세스당 한 번만 다시 로드) 이 값을 최소 30으로 설정해야 하지만 워크로드에 따라서는 최대 60까지 설정해야 할 수도 있습니다.

향후 다시 로드를 위해 손상되거나 누락된 데이터 청크 저장

각 다시 로드 작업에 대해 직접 액세스 게이트웨이는 손상되거나 누락된 데이터 청크를 메모리에 저장하고 디스크에 오프로드할 수 있습니다. 이는 자동 복구를 사용하지 않고 4025, 4020 및 4021 오류가 자주 발생하는 경우 특히 유용합니다. 손상되었거나 누락된 데이터 청크를 디스크로 오프로드하기 위한 캐시 크기 threshold를 설정하여 이 기능을 켭니다(다시 로드할 때마다). 지정된 threshold에 도달하면 게이트웨이는 다음 암호화된 청크를 직접 액세스 게이트웨이 컴퓨터의 디스크로 오프로드합니다.

캐시 크기를 설정하려면:

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

2. RELOAD_CACHE_MEMORY_MB를 N으로 설정합니다. 기본값은 0이며 기능이 활성화되지 않음을 의미합니다.

   여기서:

   N = 데이터 청크가 다시 로드되기 전에 도달할 수 있는 크기입니다.

   정보 메모이 기능을 활성화하면 직접 액세스 게이트웨이 컴퓨터의 메모리 소비가 증가하므로 활성화된 동안 메모리에 미치는 영향을 모니터링하는 것이 좋습니다. 대부분의 상황에서는 RELOAD_CACHE_MEMORY_MB 값을 100으로 설정하면 충분합니다.
3. configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.