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

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

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

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

### 제한 사항 및 고려 사항

* HTTP 프록시 스키마만 지원됩니다.

* 콘텐츠 검사 또는 기타 보안 수단을 위해 SSL 연결을 가로채도록 구성된 프록시 서버는 지원되지 않습니다.

* HTTPS 외에도 직접 액세스 게이트웨이는 WSS(WebSocket 보안) 프로토콜도 사용합니다. 따라서 방화벽과 프록시 서버(사용하려는 경우)가 아웃바운드 WSS 연결을 허용하도록 설정되어 있는지 확인합니다.

### 프록시 서버 연결 활성화

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

1. 설치 워크플로에 따라 다음 중 하나를 수행하십시오.

   * Windows 서버 설치:

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

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.

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

   * 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@

3. 설치 워크플로에 따라 다음 중 하나를 수행하십시오.

   * Windows 서버 설치:

     Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 [Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 서비스를 다시 시작합니다.

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너를 다시 시작합니다.

### 프록시 서버 연결 비활성화

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

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

2. 설치 워크플로에 따라 다음 중 하나를 수행하십시오.

   * Windows 서버 설치:

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

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.

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

   connectoragent qcs set\_config --proxy\_url ""

   * Windows 서버 설치:

     connectoragent qcs set\_config --proxy\_url ""

   * 컨테이너화된 설치:

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. 설치 워크플로에 따라 다음 중 하나를 수행하십시오.

   * Windows 서버 설치:

     Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 [Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 서비스를 다시 시작합니다.

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너를 다시 시작합니다.

## Qlik Cloud 테넌트 URL 업데이트

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

수행할 작업:

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

2. 설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:

   * 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

3. Qlik 데이터 게이트웨이 - 직접 액세스에 설명된 대로 [Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) 서비스를 다시 시작합니다.

정보 메모Qlik Cloud 테넌트 URL을 업데이트할 때도 [2단계: 설치 또는 배포하다 직접 액세스 게이트웨이](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2)에 설명된 대로 새 등록 키를 생성해야 합니다(그리고 [4단계: 데이터 게이트웨이 등록](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4)에 설명된 대로 등록해야 함).

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

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

수행할 작업:

1. 설치 워크플로에 따라 다음 중 하나를 수행하십시오:

   * Windows 서버 설치:

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

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.

2. 설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:

   * 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 데이터 게이트웨이 - 직접 액세스를 마우스 오른쪽 버튼으로 클릭하고 로그온 탭을 선택합니다.그런 다음 이 계정을 선택하고 계정 세부 정보를 입력합니다.완료되면 설정을 저장하고 서비스를 다시 시작합니다.

## 사용 가능한 명령 범주

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

1. 설치 워크플로에 따라 다음 중 하나를 수행하십시오:

   * Windows 서버 설치:

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

   * 컨테이너화된 설치:

     direct-access-agent 컨테이너 내부에서 콘솔을 엽니다.

2. 설치 워크플로에 따라 다음 명령 중 하나를 실행합니다:

   * Windows 서버 설치:

     connectoragent help

   * 컨테이너화된 설치:

     dotnet ConnectorAgent.dll help

다음 목록이 표시됩니다.

* service - 위의 Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리를 참조하세요.

* qcs - 서비스 명령을 제외한 모든 문서화된 명령 앞에 와야 합니다.

  예시 (Windows 서버 설치):

  connectoragent qcs show\_config

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

  dotnet ConnectorAgent.dll qcs show\_config

* setup - 지원용으로만 사용합니다.

* repository - 지원용으로만 사용합니다.

* configuration - 지원용으로만 사용합니다.