installerenQlik DataTransfer

Qlik DataTransfer is een lichte Windows-toepassing waarmee u gegevens kunt uploaden vanuit on-premise gegevensbronnen naar een Qlik Cloud-tenant zonder firewall-tunneling. De serviceaccounteigenaar (SAO) of tenantbeheerder genereert een API-sleutel vanuit de tenant, die vervolgens wordt gebruikt voor de authenticatie van Qlik DataTransfer. Zodra de authenticatie is voltooid, kunt u het opnieuw laden van gegevens plannen of gegevens handmatig uploaden.

Qlik DataTransfer werkt met de volgende soorten gegevensbronnen:

• App-gegevens
• Verbindingsgegevens
• Mappen

Raadpleeg On-premise gegevens uploaden met Qlik DataTransfer voor meer informatie over gegevenstypen die beschikbaar zijn voor Qlik DataTransfer.

Een installatie van Qlik DataTransfer kan alleen worden gekoppeld aan één Qlik Cloud-tenant.

Systeemvereisten voor Qlik DataTransfer

Voordat u begint

Voordat u het Qlik DataTransfer-installatieprogramma downloadt en installeert, moet u controleren of u aan de volgende vereisten voldoet:

• U hebt toegang tot een Qlik Cloud-tenant.
• U bent een gebruiker met Professional- of Full User-recht in die tenant.
• De rol Ontwikkelaar is aan u toegewezen voor de desbetreffende tenant.
• U hebt toegang tot alle ruimtes waarnaar u gegevens upload vanuit Qlik DataTransfer. Ga voor meer informatie naar Ruimten beheren.
• U hebt beheerdersmachtigingen op een Windows-pc die toegang heeft tot on-premise gegevensbronnen.
• Uw Windows-pc moet voldoen aan de volgende systeemvereisten: Systeemvereisten voor Qlik DataTransfer (alleen in het Engels).
• API‑sleutels zijn ingeschakeld in het Beheer-activiteitencentrum. Raadpleeg API -sleutels beheren voor meer informatie over het inschakelen van API-sleutels.

• De policy Configuratie-instellingen SSL moet zo zijn ingesteld dat alleen versleutelingen in een IANA-indeling worden ondersteund op de computer waarop u Qlik DataTransfer installeert.

  Als u Qlik DataTransfer mei 2021 of nieuwer installeert of naar deze versie bijwerkt op Windows Server 2012 R2, moet u de TLS Cipher Suite bijwerken. De standaardversleutelingen die zijn opgenomen in het Windows Server 2021 R2 standaardbeveiligingsbeleid worden niet ondersteund door Qlik DataTransfer mei 2021 of later. De volgende coderingssuites moeten aanwezig zijn:

  • 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

  Voor instructies over het bijwerken van de TLS-coderingssuite in uw systeem of om zwakke versleutelingen in de Qlik DataTransfer-omgeving uit te schakelen, raadpleegt u het volgende communityartikel: https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

• Voor Qlik DataTransfer is een Windows-gebruikersaccount vereist. Aanbevolen wordt dat u een toegewezen gebruikersaccount gebruikt voor het uitvoeren van de Qlik DataTransfer-service. Als voor de installatie de toegewezen gebruiker een beheerder is, kunt u zich aanmelden als die gebruiker voor het installeren van Qlik DataTransfer. Als uw toegewezen gebruiker geen lokale beheerder is, moet u een beheerdersaccount gebruiken voor het installeren van Qlik DataTransfer.

  Als u Qlik DataTransfer installeert of bijwerkt op een Windows-server waarop Qlik Sense Enterprise on Windows is geïnstalleerd, moet Qlik DataTransfer zijn geïnstalleerd met de Qlik Sense-services die de gebruiker toepast voor de Qlik Sense-installatie.

• Het gebruikersaccount dat Qlik DataTransfer installeert, moet de machtiging hebben om PowerShell-scripts uit te voeren met het uitvoeringsbeleid RemoteSigned.

• Als u het gebruikersaccount voor de service wijzigt nadat u Qlik DataTransfer voor uw tenant hebt geconfigureerd, moet u de tenant en de verbindingen opnieuw configureren. Vervolgens moet u in %ProgramData%/Qlik/DataTransfer/DataUpload/storage token.json verwijderen. Start de Qlik DataTransfer-service opnieuw.

• Voor februari 2021 SR1 wordt aanbevolen om Qlik DataTransfer te installeren op een andere server dan Qlik Sense Enterprise on Windows of QlikView Server. Als Qlik DataTransfer is geïnstalleerd op de Qlik Sense Enterprise on Windows-server of QlikView Server, wordt Qlik DataTransfer uitgevoerd met behulp van het lokaal systeemaccount. Als u het servicegebruikersaccount wijzigt, wordt Qlik DataTransfer of de Qlik Sense Servicedispatcher gestopt.

Het uitvoeringsbeleid voor het gebruikersaccount voor installatie bevestigen

Het gebruikersaccount dat Qlik DataTransfer installeert, moet de machtiging hebben om PowerShell-scripts uit te voeren met het uitvoeringsbeleid RemoteSigned . Als u zelf geen machtiging hebt om machtigingen toe te wijzen aan het gebruikersaccount, neemt u contact op met uw beheerder om het gebruikersaccount voor installatie deze machtigingen te geven.

Doe het volgende:

1. Open PowerShell in beheerdersmodus.

2. Voer Get-ExecutionPolicy uit. Het moet RemoteSigned zijn. Ga door naar de volgende stap als het Restricted of Disabled is.

3. Voer Set-ExecutionPolicy RemoteSigned uit.

4. Selecteer Y.

Download en voer het installatieprogramma uit

Doe het volgende:

1. Download het bestand Qlik DataTransfer.exe van:

   • Product downloaden
     Ga voor meer informatie naar Installatiebestanden downloaden.

   • Qlik Cloud
     Klik rechtsboven op uw profielpictogram en klik vervolgens op Profielinstellingen. Onder Overig klikt u op Tools.

     Opmerking over Qlik Cloud GovernmentDeze optie is niet beschikbaar in Qlik Cloud Government.

2. Voer het installatieprogramma uit en accepteer de Qlik User License Agreement. Het standaardinstallatiepad is %Program Files%\Qlik\DataTransfer. Bij het invoeren van de aanmeldgegevens voor de service, moet de gebruikersnaam worden ingevoerd in de vorm domein\gebruikersnaam.

   Informatie

   Als u een gebruikersnaam invoert die langer is dan 20 tekens, moet deze worden ingevoerd in de opmaak User Principal Name (UPN) en moet de volledige domeinnaam worden opgegeven. Bijvoorbeeld, langegebruikersnaam@volledige.domein.naam.

   Informatie

   Als u een Qlik Sense Desktop- of ander Qlik-platform op dezelfde server hebt geïnstalleerd, moet u deze afsluiten en de Qlik-services stoppen voordat u Qlik DataTransfer kunt installeren.

   

   Zodra de installatie is voltooid, kunt u de Qlik-services in de volgende volgorde starten:

   1. Qlik Sense Servicedispatcher

   2. Qlik Logging-service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense-opslagservice

   6. Qlik Sense-planningsservice

   7. Qlik Sense Printingservice

3. Op het venster Aanmeldgegevens service voert u de gebruikersnaam en het wachtwoord in voor het account dat u wilt gebruiken voor het uitvoeren van de Qlik DataTransfer-services.

4. Zie Qlik DataTransfer configureren om extra instellingen in het bestand services.config aan te passen.

Het installatieprogramma maakt een bureaubladsnelkoppeling om de Qlik DataTransfer-toepassing te openen.

Een API-sleutel genereren

API-sleutels verlopen. De standaardverlooptijd is mogelijk niet geschikt voor uw zakelijke behoeften. Voordat u een API‑sleutel genereert, moet u overwegen om de maximale verlooptijd voor tokens te wijzingen via de instellingen in het Beheer-activiteitencentrum. Zie API-sleutels inschakelen in de tenant voor meer informatie.

Doe het volgende:

1. Log in bij uw Qlik Cloud-tenant.
2. Klik vanuit uw activiteitencentrum rechtsboven op uw profielpictogram en klik vervolgens op Profielinstellingen.
3. Selecteer API-sleutels.

4. Selecteer Nieuwe sleutel genereren.

   
5. Voer een naam in voor de API-sleutel en selecteer Verloopt over.

6. Klik op Genereren.

   

7. Klik op Kopiëren en sluiten om de API  naar uw klembord te kopiëren.

   InformatieZorg dat u de API-sleutel opslaat. U hebt deze sleutel nodig voor de authenticatie van Qlik DataTransfer.
   

   Nu u over een API-sleutel beschikt, kunt u een veilige verbinding opzetten tussen Qlik DataTransfer en uw Qlik Cloud-tenant. De API-sleutel wordt gebruikt voor de authenticatie van Qlik DataTransfer tijdens het uploaden van gegevens naar de tenant. Aangezien de API een verlooptijd heeft, moet u een nieuwe API-sleutel maken en Qlik DataTransfer opnieuw authenticeren wanneer deze sleutel verloopt. U hoeft uw gegevensverbindingen niet opnieuw te maken als de API-sleutel verloopt.

AuthenticerenQlik DataTransfer

Doe het volgende:

1. Open Qlik DataTransfer.

   Als u Qlik DataTransfer voor de eerste keer opent, verschijnt het verificatiescherm voor Installatie Qlik DataTransfer .

   
2. Voor een naam in voor de verbinding.
3. Voer de URL in van de Qlik Cloud-tenant.

4. Plak de API-sleutel die u voor de tenant hebt gegenereerd.

5. Klik op Toepassen om de tenant te valideren.

6. Als uw API-sleutels verlopen of als u Qlik DataTransfer wilt verifiëren op basis van een andere tenant, klikt u op om een nieuwe API-sleutel in te voeren, klik vervolgens op Bevestigen.

   

Nadat Qlik DataTransfer is geauthenticeerd, kunt u uw lokale gegevens naar uw Qlik Cloud-tenant uploaden. Voor meer uitleg over hoe u de Qlik DataTransfer gebruikt, raadpleegt u On-premise gegevens uploaden met Qlik DataTransfer.

Upgrade uitvoeren Qlik DataTransfer

Qlik DataTransfer toont een meldingsbanner als er nieuwe versies beschikbaar zijn. Qlik DataTransfer wordt niet automatisch bijgewerkt naar nieuwe versies.

Doe het volgende:

1. Download de nieuwe versie van Qlik DataTransfer via de banner in de app of via Product downloaden.
2. Sluit uw huidige versie van Qlik DataTransfer.

3. Voer het Qlik DataTransfer-installatieprogramma uit.

   Informatie

   Als u Qlik DataTransfer bijwerkt op een Windows-server waarop Qlik Sense Enterprise on Windows is geïnstalleerd, moet Qlik DataTransfer worden bijgewerkt met de Qlik Sense-services die de gebruiker toepast voor de Qlik Sense-installatie.

4. Klik op Bijwerken.

   

Qlik DataTransfer verwijderen

Doe het volgende:

1. Voer het Qlik DataTransfer-installatieprogramma uit.

   Informatie

   Als u een Qlik-platform op dezelfde server hebt geïnstalleerd, moet u de andere Qlik-services stoppen voordat u Qlik DataTransfer kunt verwijderen.

2. Klik op Verwijderen.

3. Zodra het verwijderen is voltooid (indien van toepassing), kunt u de Qlik-services in de volgende volgorde starten:

   1. Qlik Sense Servicedispatcher

   2. Qlik Logging-service

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense-opslagservice

   6. Qlik Sense-planningsservice

   7. Qlik Sense Printingservice

Beperkingen

Qlik DataTransfer heeft de volgende beperkingen:

• Als u de upgrade uitvoert voor oktober 2020 of nieuwer, worden de locatie voor het opslaan van configuratiebestanden en de poorten die worden gebruikt voor het uitvoeren van Qlik DataTransfer gewijzigd in de standaardlocatie en standaardpoort van het configuratiebestand Service.conf. Als u geen gebruik maakte van de standaardlocatie voor het opslaan van configuratiebestanden of standaardpoorten voor het uitvoeren van Qlik DataTransfer, verliest u deze instellingen. Als u uw instellingen wilt behouden, moet u voordat u de upgrade uitvoert een back-up maken van Service.conf en de instellingen in Service.conf herstellen via het back-upbestand nadat de upgrade is voltooid.

• Als u geen gebruik maakte van de standaardlocatie voor het opslaan van configuratiebestanden in Service.conf, moet u handmatig de bestanden verwijderen in de map die u hebt geselecteerd.

• Als u proxy's gebruikt, moet u een bypass voor Qlik DataTransfer toevoegen aan uw firewalls met de Qlik Cloud-tenant-URL. Zonder een bypass kan Qlik DataTransfer geen verbinding maken met Qlik Cloud.

• Qlik DataTransfer moet worden geïnstalleerd op een toegewezen Window Server zoals omschreven in Systeemvereisten voor Qlik DataTransfer. Installeer de software niet op de server van de gegevensbron of op een server waarop Qlik Gegevensgateway - Directe toegang is geïnstalleerd.