Installation de Qlik DataTransfer

Qlik DataTransfer est une application Windows légère qui vous permet de charger des données depuis des sources de données sur site dans un client Qlik Cloud sans tunneling 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 sur site avec Qlik DataTransfer.

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

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 de remplir les conditions suivantes :

Qlik Cloud et autorisations utilisateur

• Accès à un client Qlik Cloud.

• Droit Professional ou Full User.

• Autorisation Gérer les clés API, affectée soit par le biais d'un rôle personnalisé, soit par les paramètres Utilisateur par défaut , et clés API activées dans le centre d'activités Administration. Pour des informations, consultez Gestion des clés API.

• Accès à tous les espaces dans lesquels vous chargerez des données à partir de Qlik DataTransfer. Pour plus d'informations, consultez Gérer les espaces.

Accès et autorisations sur votre poste Windows

• Autorisation Administrateur sur un poste Windows avec accès aux sources de données sur site.
• Poste Windows remplissant les conditions de la configuration système requise. Pour des informations détaillées, consultez Configuration système requise pour Qlik DataTransfer (uniquement en anglais).

• Politique Paramètres de configuration SSL définie de sorte à supporter uniquement les chiffrements au format IANA.

• Autorisation d'exécuter des scripts PowerShell avec la stratégie d'exécution RemoteSigned.

Conditions requises en matière de TLS et de chiffrement (Windows Server 2012 R2)

En cas d'installation ou de mise à niveau vers Qlik DataTransfer May 2021 ou une version ultérieure sur Windows Server 2012 R2 :

• Mettez à jour la suite de chiffrement TLS. Les chiffrements par défaut sur Windows Server 2012 R2 ne sont pas supportés. Chiffrements requis :

  • 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, consultez Communauté Qlik : Ajout de la suite de chiffrement pour le transfert de données Qlik sur Windows 2012 R2.

Conditions requises du compte de service

• Qlik DataTransfer nécessite un compte d'utilisateur Windows. Pour exécuter le service, il est recommandé d’avoir un compte d'utilisateur dédié avec des privilèges d'administrateur.

• Si l'utilisateur dédié est un administrateur, connectez-vous en tant que tel pour installer Qlik DataTransfer. Sinon, utilisez un compte d'administrateur.

• 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.

• Si vous changez de compte de connexion au service après avoir configuré Qlik DataTransfer, reconfigurez le client et les connexions, supprimez token.json dans %ProgramData%/Qlik/DataTransfer/DataUpload/storage et redémarrez le service Qlik DataTransfer.

Recommandations supplémentaires

• 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 l'installation s'effectue sur le même serveur, Qlik DataTransfer s'exécute à l'aide du 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 Répartiteur de services Qlik Sense.

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 :

   • Téléchargements de produits
     Pour plus d'informations, consultez Téléchargement des outils et des fichiers d'installation.

   • Qlik Cloud
     Cliquez sur l'icône de votre profil dans le coin supérieur droit, puis sur Paramètres. Sous Autre, cliquez sur Outils.

     Note Qlik Cloud GovernmentCette option n'est pas disponible dans Qlik Cloud Government.

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 plateforme 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. Répartiteur de services Qlik Sense

   2. Service de journalisation Qlik

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Service de planification Qlik Sense

   7. Service d'impression Qlik Sense

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.

4. Voir Configuration de Qlik DataTransfer pour personnaliser des paramètres supplémentaires dans le fichier services.config.

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

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 du centre d'activités Administration. Pour des informations, consultez Activation de clés API dans le client.

Procédez comme suit :

1. Connectez-vous à votre client Qlik Cloud.
2. Dans votre centre d'activités, cliquez sur l'icône de votre profil dans le coin supérieur droit, puis sur Paramètres.
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 Cloud. 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 Cloud.

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 Cloud. Pour plus d'informations sur l'utilisation de Qlik DataTransfer, voir Chargement de données sur site 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 Téléchargements de produits.
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 plateforme 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. Répartiteur de services Qlik Sense

   2. Service de journalisation Qlik

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Service de planification Qlik Sense

   7. Service d'impression Qlik Sense

Mise hors service de Qlik DataTransfer

Passerelle de données Qlik - Accès direct vous permet d'accéder en toute sécurité à des sources de données situées derrière le pare-feu, via une connexion strictement sortante, chiffrée et mutuellement authentifiée. Avec l'ajout de l'accès aux sources de données locales via la passerelle, il est recommandé de mettre hors service les serveurs Qlik DataTransfer dans la mesure du possible.

Pour plus d'informations, consultez Passerelle de données Qlik - Accès direct et File (via Direct Access gateway) (uniquement en anglais).

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 fichiers du dossier que vous avez sélectionné.

• Si vous utilisez des proxies, vous devez ajouter un contournement pour Qlik DataTransfer à vos pare-feu via l'URL de client Qlik Cloud. Sans contournement, Qlik DataTransfer ne sera pas en mesure de se connecter à Qlik Cloud.

• Qlik DataTransfer doit être installé sur un serveur Windows dédié tel que stipulé à la section Configuration système requise pour Qlik DataTransfer. Ne l'installez pas sur le serveur de source de données existant, ni sur un serveur sur lequel Passerelle de données Qlik - Accès direct est installé.