Установка Qlik DataTransfer

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

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, должна иметь разрешение на выполнение скриптов PowerShell вместе с политикой выполнения RemoteSigned . Если разрешение на назначение прав учетной записи пользователя у вас отсутствует, обратитесь к своему администратору для предоставления этих прав учетной записи пользователя, выполняющего установку.

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

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

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

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

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

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

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

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 в следующем порядке:

   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 Файлы журнала находятся в этой папке: %ProgramData%\Qlik\DataTransfer\Log

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

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

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

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

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

4. Выберите Создать новый ключ.

   
5. Введите имя ключа API и выберите время для параметра Срок действия истекает.

6. Щелкните Создать.

   

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

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

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

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

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

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

   При первом открытии Qlik DataTransfer появляется экран проверки подлинности Настройка 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

Qlik DataTransfer отображает баннер уведомления, когда выпускаются новые версии. 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

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

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 не использовалось, необходимо вручную удалить файлы в выбранной папке.