Installation de Qlik DataTransfer

Qlik DataTransfer est une application Windows légère qui permet de charger des données depuis des sources de données On-Premises dans un client Qlik Sense SaaS sans tunnellisation de pare-feu. Le propriétaire du compte de service (Service Account Owner ou SAO) ou l'administrateur de clients génère une clé API auprès du client, qui est ensuite utilisée pour authentifier Qlik DataTransfer. Une fois authentifié, vous pouvez planifier des chargements de données automatiques ou charger des données manuellement.

Qlik DataTransfer fonctionne avec les types de sources de données suivants :

• Données d'application
• Données de connexion
• Dossiers

Pour des informations sur les types de données disponibles avec Qlik DataTransfer, voirChargement de données On-Premises avec Qlik DataTransfer.

Une installation de Qlik DataTransfer ne peut être associée qu'à un seul client Qlik Sense SaaS.

Configuration système requise pour Qlik DataTransfer

Avant de commencer

Avant de télécharger et d'exécuter le programme d'installation de Qlik DataTransfer, assurez-vous que vous remplissez les conditions suivantes :

• Vous avez accès à un client Qlik Sense SaaS.
• Vous disposez d'un accès Professionnel sur ce client.
• Vous disposez d'un rôle de développeur sur ce client.
• Vous avez accès à tous les espaces dans lesquels vous chargez des données depuis Qlik DataTransfer. Pour plus d'informations, voir Gestion des espaces.
• Vous disposez d'une autorisation Administrateur sur un poste Windows qui a accès aux sources de données On-Premises.
• Votre poste Windows remplit la configuration système requise suivante : Configuration système requise pour Qlik DataTransfer (uniquement en anglais).
• Les clés API sont activées dans Console de gestion. Pour des informations sur l'activation des clés API, voir Gestion des clés API.

• La stratégie Paramètres de configuration SSL doit être définie de sorte à prendre en charge uniquement les chiffrements au format IANA sur le poste sur lequel vous installez Qlik DataTransfer.

  Si vous installez ou mettez à niveau à la version Qlik DataTransfer May 2021 ou une version ultérieure sous Windows Server 2012 R2, vous devez mettre à jour la suite cryptographique TLS. Les chiffrements par défaut inclus dans la stratégie de sécurité par défaut de Windows Server 2021 R2 ne sont pas pris en charge par la version Qlik DataTransfer May 2021 ou les versions ultérieures. Les suites cryptographiques suivantes doivent être présentes :

  • 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

  Pour des instructions pour la mise à jour de la suite de chiffrement TLS dans votre système ou pour désactiver les chiffrements faibles dans l'environnement Qlik DataTransfer, voir l'article de la communauté suivant : https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

• Qlik DataTransfer nécessite un compte d'utilisateur Windows. Pour exécuter le service Qlik DataTransfer, il est recommandé d’utiliser un compte d'utilisateur dédié. Si l'utilisateur dédié est un administrateur, vous pouvez vous connecter en tant que tel pour installer Qlik DataTransfer. Si l'utilisateur dédié n'est pas un administrateur local, vous devez utiliser un compte d'administrateur pour installer Qlik DataTransfer.

  Si vous installez ou si vous mettez à niveau Qlik DataTransfer sur un serveur Windows sur lequel Qlik Sense Enterprise on Windows est installé, Qlik DataTransfer doit être installé avec les services Qlik Sense utilisés par l'utilisateur dans l'installation Qlik Sense.

• Le compte d'utilisateur qui installe Qlik DataTransfer doit être autorisé à exécuter des scripts PowerShell avec la stratégie d'exécution RemoteSigned.

• Si vous modifiez le compte de connexion du service après avoir configuré Qlik DataTransfert avec votre client, vous devez reconfigurer le client et les connexions. Ensuite, dans %ProgramData%/Qlik/DataTransfer/DataUpload/storage, supprimez token.json. Redémarrez le service Qlik DataTransfer.

• Pour la version February 2021 SR1, il est recommandé d'installer Qlik DataTransfer sur un serveur différent de Qlik Sense Enterprise on Windows ou de QlikView Server. Si Qlik DataTransfer est installé sur le serveur Qlik Sense Enterprise on Windows ou QlikView Server, Qlik DataTransfer est exécuté via le compte d'utilisateur Système local. Si vous modifiez le compte d'utilisateur du service, cela entraînera l'arrêt de Qlik DataTransfer ou de Qlik Sense Service Dispatcher.

Confirmation de la stratégie d'exécution du compte d'utilisateur de l'installation

Le compte d'utilisateur qui installe Qlik DataTransfer doit être autorisé à exécuter des scripts PowerShell avec la stratégie d'exécution RemoteSigned . Si vous n'êtes pas autorisé à affecter des autorisations à des comptes d'utilisateur, contactez votre administrateur pour qu'il accorde ces autorisations au compte d'utilisateur de l'installation.

Procédez comme suit :

1. Ouvrez PowerShell en mode Administrateur.

2. Exécutez Get-ExecutionPolicy. Il doit s'agir de RemoteSigned. S'il s'agit de Restricted ou de Disabled, passez à l'étape suivante.

3. Exécutez Set-ExecutionPolicy RemoteSigned.

4. Sélectionnez Y.

Téléchargement et exécution du programme d'installation

Procédez comme suit :

1. Téléchargez le fichier Qlik DataTransfer.exe depuis l'un des deux emplacements suivants :

   • Le Site de téléchargement Qlik.
     Pour plus d'informations, voir Téléchargement de fichiers d'installation.

   • Le hub de cloud. Cliquez sur l'icône de votre profil dans le coin supérieur droit, puis sur Paramètres du profil.

     Note Qlik Sense Enterprise SaaS GovernmentCette option n'est pas disponible dans Qlik Sense Enterprise SaaS - Government (US).

2. Exécutez le programme d'installation et acceptez le contrat de licence utilisateur Qlik. Le chemin d'accès à l'installation par défaut est %Program Files%\Qlik\DataTransfer. Lors de la saisie des informations d'identification du service, le nom d'utilisateur doit être au format domaine\nom d'utilisateur.

   Note Informations

   Si vous saisissez un nom d'utilisateur contenant plus de 20 caractères, il doit être au format UPN (User Principal Name - Nom d'utilisateur principal) et inclure le nom de domaine complet. Par exemple, nom d'utilisateur long@nom.de.domaine.complet.

   Note Informations

   Si vous avez installé Qlik Sense Desktop ou une autre plate-forme Qlik sur le même serveur, vous devez le/la fermer et arrêter les services Qlik avant de pouvoir installer Qlik DataTransfer.

   

   Une fois l'installation terminée, redémarrez les services Qlik dans l'ordre suivant :

   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. Dans la fenêtre Service Credentials (Informations d'identification du service), saisissez le nom d'utilisateur et le mot de passe du compte que vous souhaitez utiliser pour exécuter les services Qlik DataTransfer.

Le programme d'installation créer un raccourci bureau permettant de lancer l'application Qlik DataTransfer.

Ports

Enregistrement des journaux et des fichiers de données

Les fichiers journaux Qlik DataTransfer se trouvent ici : %ProgramData%\Qlik\DataTransfer\Log

Les connexions de données Qlik DataTransfer se trouvent ici : %ProgramData%\Qlik\DataTransfer\DataUpload

Génération d'une clé API

Les clés API expirent. Il se peut que les délais d'expiration par défaut ne soient pas appropriés pour vos besoins professionnels. Avant de générer une clé API, vous pouvez modifier le délai d'expiration maximal du jeton dans les paramètres de Console de gestion. Pour plus d'informations, voir Activation de clés API dans le client.

Procédez comme suit :

1. Connectez-vous à votre client Qlik Sense SaaS.
2. Dans le hub de cloud, cliquez sur l'icône de votre profil dans le coin supérieur droit, puis sur Paramètres du profil.
3. Sélectionnez Clés API.

4. Sélectionnez Générer une nouvelle clé.

   
5. Saisissez un nom pour la clé API et sélectionnez le délai Expire dans.

6. Cliquez sur Générer.

   

7. Cliquez sur Copier et fermer pour copier l'API dans votre Presse-papiers.

   Note InformationsAssurez-vous d'enregistrer la clé API. Vous avez besoin de cette clé pour authentifier Qlik DataTransfer.
   

   Maintenant que vous disposez d'une clé API, vous pouvez créer une connexion sécurisée entre Qlik DataTransfer et votre client Qlik Sense SaaS. La clé API sert à authentifier Qlik DataTransfer lors du chargement de données dans le client. Étant donné que l'API a un délai d'expiration, vous devez créer une nouvelle clé API et authentifier de nouveau Qlik DataTransfer quand cette clé expire. Si la clé API expire, vous n'avez pas besoin de recréer vos connexions de données.

Authentification de Qlik DataTransfer

Procédez comme suit :

1. Ouvrez Qlik DataTransfer.

   La première fois que vous ouvrez Qlik DataTransfer, l'écran d'authentification Configurer Qlik DataTransfer apparaît.

   
2. Saisissez un nom pour la connexion.
3. Saisissez l'URL pointant vers le client Qlik Sense SaaS.

4. Collez la clé API générée auprès du client.

5. Cliquez sur Appliquer pour valider le client.

6. Quand la clé API expire, ou pour authentifier Qlik DataTransfer par rapport à un autre client, cliquez sur pour saisir un nouvelle clé API, puis sur Confirmer.

   

Une fois Qlik DataTransfer authentifié, vous pouvez charger vos données On-Premises dans votre client Qlik Sense SaaS. Pour plus d'informations sur l'utilisation de Qlik DataTransfer, voir Chargement de données On-Premises avec Qlik DataTransfer.

Mise à niveau de Qlik DataTransfer

Qlik DataTransfer affiche une bannière de notification quand de nouvelles versions sont disponibles. Qlik DataTransfer ne se met pas automatiquement à niveau en cas de version plus récente.

Procédez comme suit :

1. Téléchargez la nouvelle version de Qlik DataTransfer depuis la bannière de l'application ou depuis le Site de téléchargement Qlik.
2. Fermez votre version existante de Qlik DataTransfer.

3. Exécutez le programme d'installation de Qlik DataTransfer.

   Note Informations

   Si vous mettez à niveau Qlik DataTransfer sur un serveur Windows sur lequel Qlik Sense Enterprise on Windows est installé, Qlik DataTransfer doit être mis à niveau avec les services Qlik Sense utilisés par l'utilisateur dans l'installation Qlik Sense.

4. Cliquez sur Mettre à niveau.

   

Désinstallation de Qlik DataTransfer

Procédez comme suit :

1. Exécutez le programme d'installation de Qlik DataTransfer.

   Note Informations

   Si vous avez installé une plate-forme Qlik sur le même serveur, vous devez arrêter les autres services Qlik avant de pouvoir désinstaller Qlik DataTransfer.

2. Cliquez sur Désinstaller.

3. Une fois la désinstallation terminée, le cas échéant, redémarrez les services Qlik dans l'ordre suivant :

   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

Limitations

Qlik DataTransfer présente les limites suivantes :

• Lors de la mise à niveau depuis la version October 2020 ou une version ultérieure, l'emplacement de stockage des fichiers de configuration et les ports utilisés pour exécuter Qlik DataTransfer sont remplacés par ceux par défaut du fichier de configuration Service.conf. Si vous n'utilisiez pas l'emplacement par défaut pour stocker les fichiers de configuration ou les ports par défaut pour exécuter Qlik DataTransfer, vous perdrez ces paramètres. Pour conserver vos paramètres, sauvegardez Service.conf avant la mise à niveau et configurez de nouveau les paramètres dans Service.conf à partir du fichier sauvegardé, une fois la mise à niveau terminée.

• Si vous n'utilisiez pas l'emplacement par défaut pour stocker les fichiers de configuration dans Service.conf, vous devrez supprimer manuellement les fichier du dossier que vous avez sélectionné.