Перейти к основному содержимому

Установка Qlik DataTransfer

Qlik DataTransfer — это упрощенное приложение Windows, которое позволяет загрузить данные из локальных источников данных в клиент Qlik Sense SaaS без туннелирования брандмауэра. Владелец учетной записи службы (SAO) или администратор клиента создают ключ API из клиента, который затем используется для проверки подлинности Qlik DataTransfer. После прохождения проверки подлинности можно запланировать автоматические перезагрузки данных или загрузить данные вручную.

Примечание: Qlik DataTransfer поддерживает зашифрованную передачу данных, однако не отвечает требованиям федеральных стандартов по обработке информации (Federal Information Processing Standards, FIPS). Пользователи Qlik Sense Enterprise SaaS - Government (US) могут использовать его в реализациях, ожидающих результатов проверки рисков.

Qlik DataTransfer работает со следующими видами источников данных:

  • Данные приложения
  • Данные подключения
  • Папки

Для получения информации о типах данных, доступных в Qlik DataTransfer, см. Загрузка локальных данных с помощью Qlik DataTransfer.

Установку Qlik DataTransfer можно связать только с одним клиентом Qlik Sense SaaS.

Перед началом работы

Перед загрузкой и запуском установщика Qlik DataTransfer убедитесь, что соблюдаются следующие требования:

  • У вас есть доступ к клиенту Qlik Sense SaaS.
  • В клиенте обеспечен доступ Professional.
  • Вам назначена роль разработчика в этом клиенте.
  • У вас есть доступ ко всем пространствам, в которые загружаются данные из Qlik DataTransfer. Для получения дополнительной информации см. Управление пространствами.
  • У вас есть разрешение администратора на компьютере Windows, у которого есть доступ к локальным источникам данных.
  • Компьютер Windows должен отвечать следующим требованиям к системе: Требования к системе для Qlik DataTransfer (только английский язык).
  • Ключи API включены в Management Console. Для получения информации о включении ключей API см. Управление ключами API.
  • Параметры конфигурации SSL для политики необходимо задать только для поддержки шифров в формате IANA на компьютере, на котором устанавливается Qlik DataTransfer.

    При установке или обновлении до выпуска Qlik DataTransfer May 2021 или более позднего на Windows Server 2012 R2 необходимо обновить комплект шифров TLS. Шифры по умолчанию, включенные в политику безопасности по умолчанию Windows Server 2021 R2, не поддерживаются в выпуске Qlik DataTransfer May 2021 или более поздних выпусках. Следующие комплекты шифров должны присутствовать:

    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

    • TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256

    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

    Как обновить комплект шифров TLS в системе и отключить слабые шифры в среде Qlik DataTransfer, описано в этой статье службы поддержки: https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

  • Для Qlik DataTransfer требуется учетная запись пользователя Windows. Рекомендуется использовать выделенную учетную запись пользователя для запуска службы Qlik DataTransfer. Если выделенный пользователь является администратором, можно войти в систему с его учетными данными для установки Qlik DataTransfer. Если выделенный пользователь не является локальным администратором, необходимо использовать учетную запись администратора для установки Qlik DataTransfer.

    Если выполняется установка или обновление Qlik DataTransfer на сервере Windows, где уже есть Qlik Sense Enterprise on Windows, при установке Qlik DataTransfer необходимо использовать ту же учетную запись пользователя служб Qlik Sense, что и при установке Qlik Sense.

  • Учетная запись пользователя, устанавливающего Qlik DataTransfer, должна иметь разрешение на выполнение скриптов PowerShell вместе с политикой выполнения RemoteSigned.

  • Если изменить учетную запись входа в службу после настройки Qlik DataTransfer для клиента, необходимо настроить клиент и подключения заново. Затем в папке %ProgramData%/Qlik/DataTransfer/DataUpload/storage удалите token.json. Перезапустите службу Qlik DataTransfer.

  • Для выпуска February 2021 SR1 рекомендуется устанавливать Qlik DataTransfer на отдельном от Qlik Sense Enterprise on Windows или QlikView Server сервере. Если Qlik DataTransfer установлен на сервере Qlik Sense Enterprise on Windows или QlikView Server, Qlik DataTransfer запускается с помощью учетной записи Local System. При изменении учетной записи службы, Qlik DataTransfer или Qlik Sense Service Dispatcher будут остановлены.

Подсказка: Установщик Qlik DataTransfer включает экземпляр Qlik Associative Engine, коннекторы ODBC Simba и агент Qlik DataTransfer. После запуска он расходует дополнительные ресурсы памяти и ресурсы для обработки, которые нужно учитывать, если сервер совместно использует ресурсы с другими приложениями. Для производственной среды рекомендуется установить Qlik DataTransfer на отдельном сервере.

Подтверждение политики выполнения для учетной записи пользователя, выполняющего установку

Учетная запись пользователя, устанавливающего Qlik DataTransfer, должна иметь разрешение на выполнение скриптов PowerShell вместе с политикой выполнения RemoteSigned . Если разрешение на назначение прав учетной записи пользователя у вас отсутствует, обратитесь к своему администратору для предоставления этих прав учетной записи пользователя, выполняющего установку.

  1. Откройте PowerShell в режиме администратора.

  2. Запустите Get-ExecutionPolicy Она должна быть RemoteSigned. Если она имеет статус Restricted или Disabled, перейдите к следующему шагу.

  3. Запустите Set-ExecutionPolicy RemoteSigned

  4. Выберите Y.

Загрузка и запуск установщика

Примечание:

Если выполняется установка или обновление Qlik DataTransfer на сервере Windows, где уже есть Qlik Sense Enterprise on Windows, при установке Qlik DataTransfer необходимо использовать ту же учетную запись пользователя служб Qlik Sense, что и при установке Qlik Sense.

  1. Загрузите файл Qlik DataTransfer.exe из следующих мест:

    1. С сайта загрузки Qlik.

    2. Из облачного хаба. Щелкните значок своего профиля в правом верхнем углу и выберите Параметры профиля. Эта опция недоступна в Qlik Sense Enterprise SaaS - Government (US).

  2. Запустите установщик и примите пользовательское лицензионное соглашение Qlik. Путь установки по умолчанию — %Program Files%\Qlik\DataTransfer. При вводе учетных данных службы имя пользователя должно быть в форме домен\имя_пользователя.

    Примечание:

    Если имя пользователя длиннее 20 символов, оно должно быть в формате имени участника-пользователя (UPN) и должно включать полное доменное имя. Например, длинное_имя_пользователя@полное.доменное.имя.

    Примечание:

    Если на том же сервере установлен Qlik Sense Desktop или другая платформа Qlik, необходимо завершить их работу и остановить службы Qlik перед установкой Qlik DataTransfer.

    Экран программы установки Qlik DataTransfer

    После установки перезапустите службы Qlik в следующем порядке:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

  3. В окне Service Credentials (Учетные данные службы) введите имя пользователя и пароль для учетной записи, которую предполагается использовать для запуска служб Qlik DataTransfer.

Установщик создает ярлык на рабочем столе для запуска приложения Qlik DataTransfer.

Порты

Qlik DataTransfer использование следующие порты:

Служба Порт Направление

Защищенный обмен данными в веб-браузере (HTTPS)

Примечание: Необходимо открыть этот порт в брандмауэре.
443 Исходящий
Служба загрузки данных 5505 Внутренний
Engine service 5506 Внутренний
Прокси-служба реестра коннектора 5507 Внутренний

Если возник конфликт портов с одним из портов службы по умолчанию, его можно изменить его в файле services.conf, расположенном в %Program Files%\Qlik\DataTransfer.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507

Хранение журналов и файлов данных

Qlik DataTransfer Файлы журнала находятся в этой папке: %ProgramData%\Qlik\DataTransfer\Log

Qlik DataTransfer Подключения к данным находятся в этой папке: %ProgramData%\Qlik\DataTransfer\DataUpload

Стандартный путь для хранения можно изменить в файле services.conf, расположенном в папке %Program Files%\Qlik\DataTransfer.

[globals] LogPath="${ALLUSERSPROFILE}\Qlik\DataTransfer\Log" StoragePath="${ALLUSERSPROFILE}\Qlik\DataTransfer" DataUploadServicePort=5505 EnginePort=5506 ConnectorRegistryPort=5507
Примечание: Рекомендуется создать резервную копию файлов в папке хранения в безопасном месте.

Создание ключа API

Срок действия ключей API ограничен. Время истечения срока по умолчанию может не отвечать вашим бизнес-потребностям. Перед созданием ключа API можно изменить максимальный срок действия токена в параметрах Management Console. Для получения дополнительной информации см. Активирование ключей API в клиенте.

Выполните следующие действия.

  1. Войдите в клиент Qlik Sense SaaS.
  2. Из облачного хаба щелкните значок своего профиля в правом верхнем углу и выберите Параметры профиля.
  3. Выберите Ключи API.
  4. Выберите Создать новый ключ.

    Меню «Параметры облачного хаба», «Создать ключ API»
  5. Введите имя ключа API и выберите время для параметра Срок действия истекает.
  6. Щелкните Создать.

    Экран «Создать новый ключ API»

  7. Щелкните Копировать и закрыть, чтобы скопировать ключ API в буфер обмена.

    Примечание: Сохраните ключ API. Этот ключ нужен для проверки подлинности Qlik DataTransfer.
    Экран сводки ключа API

    Теперь, имея ключ API, можно создать безопасное подключение между Qlik DataTransfer и клиентом Qlik Sense SaaS. Ключ API служит для проверки подлинности Qlik DataTransfer при загрузке данных в клиент. Так как срок действия ключа API ограничен, по его истечении необходимо создать новый ключ API и повторно пройти проверку подлинности Qlik DataTransfer. Подключения к данным повторно создавать не нужно, если срок действия ключа API истечет.

Проверка подлинности Qlik DataTransfer

Выполните следующие действия.

  1. Откройте Qlik DataTransfer.

    При первом открытии Qlik DataTransfer появляется экран проверки подлинности Настройка Qlik DataTransfer .

    Экран подключения ключа API Qlik dataTransfer
  2. Введите имя для подключения.
  3. Введите URL-адрес клиента Qlik Sense SaaS.
  4. Вставьте созданный ключ API из клиента.

  5. Щелкните Применить, чтобы проверить клиент.

  6. Когда срок действия ключа API истечет или нужно выполнить проверку подлинности Qlik DataTransfer для другого клиента, щелкните , чтобы ввести новый ключ API, затем щелкните Подтвердить.

После прохождения проверки подлинности Qlik DataTransfer можно загружать локальные данные в клиент Qlik Sense SaaS. Информация об использовании Qlik DataTransfer приводится в разделе Загрузка локальных данных с помощью Qlik DataTransfer.

Примечание: Если изменить учетную запись входа в службу после настройки Qlik DataTransfer для клиента, необходимо настроить клиент и подключения к источникам данных ODBC заново.

Обновление Qlik DataTransfer

Qlik DataTransfer отображает баннер уведомления, когда выпускаются новые версии. Qlik DataTransfer не обновляется автоматически на более новую версию.

Предупреждение:

Если выбрано другое местоположение для хранения файлов конфигурации или другие порты для запуска Qlik DataTransfer из файла конфигурации Service.conf, обновление переопределит их. Чтобы сохранить параметры, создайте резервную копию файла Service.conf до обновления и скопируйте его в папку конфигурации по умолчанию после завершения обновления.

Если Qlik DataTransfer использует учетную запись Local System, то подсказка к вводу учетных данных пользователя службы не будет показана и будет продолжено использование учетной записи Local System.

Баннер обновления Qlik DataTransfer

Выполните следующие действия.

  1. Загрузите новую версию Qlik DataTransfer, воспользовавшись баннером в приложении или сайтом загрузок Qlik.
  2. Закройте текущую версию Qlik DataTransfer.
  3. Запустите установщик Qlik DataTransfer.

    Примечание:

    Если выполняется обновление Qlik DataTransfer на сервере Windows, где уже есть Qlik Sense Enterprise on Windows, при обновлении Qlik DataTransfer необходимо использовать ту же учетную запись пользователя служб Qlik Sense, что и при установке Qlik Sense.

  4. Щелкните Обновить.

    Окно «Обновление Qlik DataTransfer»

Удаление Qlik DataTransfer

Примечание: При удалении Qlik DataTransfer установщик удаляет все файлы и папки Qlik DataTransfer. Необходимо сохранить любые файлы или папки в новом местоположении, если они нужны.

Выполните следующие действия.

  1. Запустите установщик Qlik DataTransfer.

    Примечание:

    Если на том же сервере установлена платформа Qlik, необходимо остановить службы Qlik перед удалением Qlik DataTransfer.

  2. Щелкните Удаление.
  3. После удаления при необходимости перезапустите службы Qlik в следующем порядке:

    1. Qlik Sense Service Dispatcher

    2. Qlik Logging Service

    3. Qlik Sense Repository Service

    4. Qlik Sense Proxy Service

    5. Qlik Sense Engine Service

    6. Qlik Sense Scheduler Service

    7. Qlik Sense Printing Service

Ограничения

Qlik DataTransfer имеет следующие ограничения:

  • При обновлении с выпуска October 2020 или более позднего местоположение для хранения файлов конфигурации и порты, используемые для запуска Qlik DataTransfer, будут изменены на значения по умолчанию в файле конфигурации Service.conf. Если местоположение для хранения файлов конфигурации по умолчанию или порты для запуска Qlik DataTransfer по умолчанию не использовались, эти параметры будут потеряны. Для сохранения параметров скопируйте Service.conf перед обновлением и восстановите параметры в Service.conf из сохраненного файла после завершения обновления.

  • Если местоположение для хранения файлов конфигурации по умолчанию в Service.conf не использовалось, необходимо вручную удалить файлы в выбранной папке.