# Управление сервером Шлюз данных Qlik — прямой доступ

В этом разделе описываются различные параметры подключения и управления доступные после установки Шлюз данных Qlik — прямой доступ.

## Подключение к Qlik Cloud через прокси-сервер

Если подключение через прокси-сервер не настроено на этапе установки, это можно сделать позже, используя описанные ниже команды. Также можно выполнить те же команды для изменения существующих настроек прокси-сервера.

### Ограничения и замечания

* Поддерживаются только схемы прокси-подключения через HTTP.

* Не поддерживаются прокси-серверы, настроенные для перехвата подключений SSL (с целью перехвата содержимого или реализации других мер обеспечения безопасности).

* Помимо HTTPS шлюз прямого доступа также использует протокол WSS (WebSocket Secure). Поэтому в настройках брандмауэра и прокси-сервера (если планируется его использовать) необходимо разрешить исходящие соединения 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/ru-RU/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/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

   * Контейнеризированная установка:

     Перезапустите контейнер direct-access-agent.

## Обновление URL-адреса клиента Qlik Cloud

При необходимости URL-адрес клиента Qlik Cloud можно изменить.

Действие:

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/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing).

Примечание к информацииПри обновлении URL-адреса Qlik Cloud клиента также требуется сгенерировать новый ключ регистрации, как описано в [Этап 2: установить или развернуть Direct Access Gateway](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) (и зарегистрировать его, как описано в [Этап 4: регистрация шлюза данных](https://help.qlik.com/ru-RU/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 — прямой доступ запускается с использованием учетной записи Local System. Чтобы запустить службу с использованием другой учетной записи, щелкните правой кнопкой Шлюз данных Qlik — прямой доступ на консоли «Службы Windows» и перейдите на вкладку Вход. Затем выберите Эта учетная запись и введите сведения об учетной записи. По окончании сохраните настройки и переЗапустите сервис.

## Доступные категории команд

Чтобы просмотреть список доступных категорий команд:

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 только для сотрудников службы поддержки.