Qlik 데이터 게이트웨이 - 직접 액세스 서버 관리

마지막 업데이트: 2026. 9. 30.

이 섹션에서는 Qlik 데이터 게이트웨이 - 직접 액세스를 설치한 후 사용할 수 있는 다양한 연결 및 관리 옵션에 대해 설명합니다.

프록시 서버를 통해 Qlik Cloud에 연결

초기 설정에서 프록시 연결을 구성하지 않은 경우 아래에 설명된 명령을 실행하여 나중에 구성할 수 있습니다.동일한 명령을 실행하여 기존 프록시 서버 설정을 편집할 수도 있습니다.

제한 사항 및 고려 사항

HTTP 프록시 스키마만 지원됩니다.
콘텐츠 검사 또는 기타 보안 수단을 위해 SSL 연결을 가로채도록 구성된 프록시 서버는 지원되지 않습니다.
HTTPS 외에도 직접 액세스 게이트웨이는 WSS(WebSocket 보안) 프로토콜도 사용합니다. 따라서 방화벽과 프록시 서버(사용하려는 경우)가 아웃바운드 WSS 연결을 허용하도록 설정되어 있는지 확인합니다.

프록시 서버 연결 활성화

다음과 같이 프록시 서버 연결을 활성화하거나 편집할 수 있습니다.

설치 워크플로에 따라 다음 중 하나를 수행하십시오.
- Windows 서버 설치:
  
  관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.
다음 명령을 실행합니다.
- Windows 서버 설치:
  - 구문:connectoragent qcs set_config --proxy_url http://host:port --proxy_username username --proxy_password password
  - 예: connectoragent qcs set_config --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@
- 컨테이너화된 설치:
  - 구문:dotnet ConnectorAgent.dll qcs set_config --proxy_url http://host:port --proxy_username username --proxy_password password
  - 예: dotnet ConnectorAgent.dll qcs set_config --proxy_url http://myproxy:1212 --proxy_username admin --proxy_password f56weqs@
설치 워크플로에 따라 다음 중 하나를 수행하십시오.
- Windows 서버 설치:
  
  Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리 서비스를 다시 시작합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너를 다시 시작합니다.

프록시 서버 연결 비활성화

다음과 같이 프록시 서버 연결을 해제할 수 있습니다.

관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
설치 워크플로에 따라 다음 중 하나를 수행하십시오.
- Windows 서버 설치:
  
  관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.
다음 명령을 실행합니다.

connectoragent qcs set_config --proxy_url ""
- Windows 서버 설치:
  
  connectoragent qcs set_config --proxy_url ""
- 컨테이너화된 설치:
  
  dotnet ConnectorAgent.dll qcs set_config --proxy_url ""
설치 워크플로에 따라 다음 중 하나를 수행하십시오.
- Windows 서버 설치:
  
  Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리 서비스를 다시 시작합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너를 다시 시작합니다.

Qlik Cloud 테넌트 URL 업데이트

필요에 따라 Qlik Cloud 테넌트 URL을 변경할 수 있습니다.

수행할 작업:

직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:
- Windows 서버 설치:
  - 구문:connectoragent qcs set_config --tenant_url URL
  - 예: connectoragent qcs set_config --tenant_url mytenant.us.qlikcloud.com
- 컨테이너화된 설치:
  - 구문:dotnet ConnectorAgent.dll qcs set_config --tenant_url URL
  - 예: dotnet ConnectorAgent.dll qcs set_config --tenant_url mytenant.us.qlikcloud.com
Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리 서비스를 다시 시작합니다.

Qlik Cloud 테넌트 URL을 업데이트할 때도 2단계: 설치 또는 배포하다 직접 액세스 게이트웨이에 설명된 대로 새 등록 키를 생성해야 합니다(그리고 4단계: 데이터 게이트웨이 등록에 설명된 대로 등록해야 함).

현재 직접 액세스 게이트웨이 서버 설정 보기

현재 Direct Access gateway 서버 설정을 볼 수 있습니다.

수행할 작업:

설치 워크플로에 따라 다음 중 하나를 수행하십시오:
- Windows 서버 설치:
  
  직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.
설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:
- Windows 서버 설치:
  
  connectoragent qcs set_config --tenant_url URL
- 컨테이너화된 설치:
  
  dotnet ConnectorAgent.dll qcs set_config --tenant_url URL
현재 설정이 표시됩니다.
```
connector-agent starting....
--tenant_url "elastic.example"
--proxy_url ""
--proxy_username ""
DirectAccessAgent Control Program completed successfully.
```

Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리

Windows 서버 설치에만 적용됩니다.

직접 액세스 게이트웨이 서버에서 설정을 변경한 후 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작해야 합니다.다른 계정으로 서비스를 실행할 수도 있습니다.

서비스 시작, 중지 또는 다시 시작

직접 액세스 게이트웨이 서버에서 다음 중 하나를 수행하여 서비스를 중지, 시작 또는 다시 시작합니다.

Windows 서비스 콘솔을 열고 필요에 따라 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 중지, 시작 또는 다시 시작합니다.

관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.그런 후 다음 명령을 실행합니다.

connectoragent service stop

서비스가 성공적으로 중지되었다는 확인 메시지가 표시됩니다.

connectoragent service start

서비스가 성공적으로 시작되었다는 확인 메시지가 표시됩니다.

다른 계정으로 서비스 실행

기본적으로 Qlik 데이터 게이트웨이 - 직접 액세스 서비스는 로컬 시스템 계정으로 실행됩니다.다른 계정으로 서비스를 실행하려면 Windows 서비스 콘솔에서 Qlik 데이터 게이트웨이 - 직접 액세스를 마우스 오른쪽 버튼으로 클릭하고 로그온 탭을 선택합니다.그런 다음 이 계정을 선택하고 계정 세부 정보를 입력합니다.완료되면 설정을 저장하고 서비스를 다시 시작합니다.

사용 가능한 명령 범주

사용 가능한 명령 범주 목록을 확인하려면:

설치 워크플로에 따라 다음 중 하나를 수행하십시오:
- Windows 서버 설치:
  
  관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
- 컨테이너화된 설치:
  
  direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.
설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:
- Windows 서버 설치:
  
  connectoragent help
- 컨테이너화된 설치:
  
  dotnet ConnectorAgent.dll help

다음 목록이 표시됩니다.

service - 위의 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리를 참조하세요.
qcs - 서비스 명령을 제외한 모든 문서화된 명령 앞에 와야 합니다.

예시 (Windows 서버 설치):

connectoragent qcs show_config

예(컨테이너화된 설치):

dotnet ConnectorAgent.dll qcs show_config
setup - 지원용으로만 사용합니다.
repository - 지원용으로만 사용합니다.
configuration - 지원용으로만 사용합니다.

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

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

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