Installazione di Qlik DataTransfer

Qlik DataTransfer è un'applicazione leggera per Windows che consente di caricare dati da sorgenti dati in loco in un tenant Qlik Cloud senza ricorrere al tunneling del firewall. Il proprietario dell'account del servizio (SAO, Service Account Owner) o l'amministratore tenant genera una chiave API dal tenant, che viene quindi utilizzata per autenticare Qlik DataTransfer. Effettuata l'autenticazione, è possibile pianificare ricaricamenti automatici dei dati o caricare i dati manualmente.

Qlik DataTransfer funziona con i seguenti tipi di sorgenti dati:

• Dati app
• Dati di connessione
• Cartelle

Per informazioni sui tipi di dati disponibili con Qlik DataTransfer, vedere Caricamento dati in loco con Qlik DataTransfer.

Un'installazione di Qlik DataTransfer può essere associata a un singolo tenant di Qlik Cloud.

Requisiti di sistema per Qlik DataTransfer

Prima di iniziare

Prima di scaricare ed eseguire il programma di installazione di Qlik DataTransfer, assicurarsi di rispettare i seguenti requisiti:

• Si ha accesso a un tenant Qlik Cloud.
• Si è un utente con Diritto Full User o Professional su quel tenant.
• Si è assegnati al ruolo Sviluppatore su tale tenant.
• Si ha accesso a tutti gli spazi in cui caricare i dati da Qlik DataTransfer. Per ulteriori informazioni, vedere Gestione degli spazi.
• Si dispone di un'autorizzazione amministratore su un computer Windows che ha accesso a sorgenti dati in loco.
• Il proprio computer Windows rispetta i seguenti requisiti di sistema: Requisiti di sistema per Qlik DataTransfer (solo in lingua inglese).
• Le Chiavi API devono essere attive nel centro attività Amministrazione. Per informazioni sull'abilitazione di chiavi API, vedere Gestione delle chiavi API.

• Il criterio Impostazioni di configurazione SSL deve essere impostato in modo da supportare la crittografia solo nel formato IANA sulla macchina su cui si sta installando Qlik DataTransfer.

  Se si sta installando o eseguendo l'upgrade a Qlik DataTransfer May 2021 o versione successiva su Windows Server 2012 R2, è necessario aggiornare la TLS Cipher Suite. Le cifrature predefinite incluse nel criterio di protezione predefinito di Windows Server 2012 R2 non sono supportate da Qlik DataTransfer May 2021 o versione successiva. Devono essere presenti le seguenti suite di cifratura:

  • 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

  Per istruzioni sull'aggiornamento della TLS Cipher Suite nel proprio sistema o per disabilitare le cifrature deboli nell'ambiente Qlik DataTransfer, vedere il seguente articolo del supporto: https://community.qlik.com/t5/Knowledge/Adding-Cipher-Suite-for-Qlik-Data-Transfer-on-Windows-2012-R2/ta-p/1819406.

• Qlik DataTransfer richiede un account utente Windows. Si consiglia di utilizzare un account utente dedicato con privilegi da amministratore per eseguire il servizio Qlik DataTransfer. Per l'installazione, se l'utente dedicato è un amministratore, è possibile accedere come tale utente per installare Qlik DataTransfer. Se il proprio utente dedicato non è un amministratore locale, è necessario utilizzare un account amministratore per installare Qlik DataTransfer.

  Se si sta installando o aggiornando Qlik DataTransfer su un server Windows con Qlik Sense Enterprise on Windows installato, Qlik DataTransfer deve essere installato con i servizi Qlik Sense che l'utente ha utilizzato nell'installazione di Qlik Sense.

• L'account utente che installa Qlik DataTransfer deve disporre dell'autorizzazione per eseguire gli script PowerShell con il criterio di esecuzione RemoteSigned

• Se si modifica l'account di accesso al servizio dopo la configurazione di Qlik DataTransfer con il proprio tenant, è necessario riconfigurare il tenant e le connessioni. Quindi, in %ProgramData%/Qlik/DataTransfer/DataUpload/storage, eliminare token.json. Riavviare il servizio Qlik DataTransfer.

• Per February 2021 SR1, si consiglia di installare Qlik DataTransfer su un server separato rispetto a Qlik Sense Enterprise on Windows o QlikView Server. Se Qlik DataTransfer viene installato sul server Qlik Sense Enterprise on Windows o QlikView Server, l'esecuzione di Qlik DataTransfer avviene usando l'account utente Sistema locale. Se si modifica l'account utente di servizio, Qlik DataTransfer o Dispatcher servizi di Qlik Sense verrà arrestato.

Conferma del criterio di esecuzione dell'account utente di installazione

L'account utente che installa Qlik DataTransfer deve disporre dell'autorizzazione per eseguire gli script PowerShell con il criterio di esecuzione RemoteSigned . Se non si dispone dell'autorizzazione per assegnare le autorizzazioni account utente, contattare il proprio amministratore per fornire all'account utente di installazione tali autorizzazioni.

Procedere come indicato di seguito:

1. Aprire PowerShell in modalità amministratore.

2. Eseguire Get-ExecutionPolicy. Dovrebbe corrispondere a RemoteSigned. Se corrisponde a Restricted o a Disabled, proseguire con il prossimo passaggio.

3. Eseguire Set-ExecutionPolicy RemoteSigned.

4. Selezionare Y.

Download ed esecuzione del programma di installazione

Procedere come indicato di seguito:

1. Scaricare il file Qlik DataTransfer.exe da una delle seguenti opzioni:

   • Download di prodotti
     Per ulteriori informazioni, vedere Download dei file di installazione.

   • Qlik Cloud
     Fare clic sull'icona del proprio profilo nell'angolo in alto a destra, quindi fare clic su Impostazioni profilo. Sotto Altro, fare clic su Strumenti.

     Nota su Qlik Cloud GovernmentQuesta opzione non è disponibile in Qlik Cloud Government.

2. Eseguire il programma di installazione e accettare il Contratto di licenza utente Qlik. Il percorso di installazione predefinito è %Program Files%\Qlik\DataTransfer. Quando si inseriscono le credenziali di servizio, il nome utente deve essere riportato nella forma dominio\nomeutente.

   Nota informatica

   Se si inserisce un nome utente lungo più di 20 caratteri, deve rispettare il formato User Principal Name (UPN) e includere il nome di dominio completo. Ad esempio, longusername@full.domain.name.

   Nota informatica

   Se si dispone di Qlik Sense Desktop o di un'altra piattaforma Qlik installata sullo stesso server, arrestarli, dopodiché arrestare i servizi Qlik prima di poter installare Qlik DataTransfer.

   

   Al termine dell'installazione, riavviare i servizi Qlik nel seguente ordine:

   1. Dispatcher servizi di Qlik Sense

   2. Servizio di registrazione Qlik

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Servizio di pianificazione Qlik Sense

   7. Servizio stampa di Qlik Sense

3. Sulla finestra Service Credentials (Credenziali di servizio), inserire il nome utente e la password per l'account che si desidera utilizzare per eseguire i servizi Qlik DataTransfer.

4. Vedere Configurazione di Qlik DataTransfer per personalizzare impostazioni aggiuntive nel file services.config.

Il programma di installazione crea un collegamento desktop per avviare l'applicazione Qlik DataTransfer.

Generazione di una chiave API

Le chiavi API scadono. Gli orari di scadenza predefiniti potrebbero non essere appropriati per le proprie esigenze di business. Prima di generare una chiave API, considerare di modificare la scadenza del token massima nelle impostazioni del centro attività Amministrazione. Per informazioni, vedere Abilitazione delle chiavi API nel tenant.

Procedere come indicato di seguito:

1. Accedere al proprio tenant Qlik Cloud.
2. Dal centro attività, fare clic sull'icona del proprio profilo nell'angolo in alto a destra, quindi fare clic su Impostazioni profilo.
3. Selezionare le chiavi API.

4. Selezionare Genera nuova chiave.

   
5. Inserire un nome per la chiave API e selezionare l'orario Scade tra.

6. Fare clic su Genera.

   

7. Fare clic su Copia e chiudi per copiare l'API nei propri appunti.

   Nota informaticaAssicurarsi di salvare la chiave API. Questa chiave è necessaria per autenticare Qlik DataTransfer.
   

   Ora che si dispone di una chiave API, è possibile creare una connessione sicura tra Qlik DataTransfer e il proprio tenant Qlik Cloud. La chiave API è utilizzata per autenticare Qlik DataTransfer quando si caricano dati nel tenant. Dato che l'API presenta un orario di scadenza, è necessario creare una nuova chiave API ed autenticare nuovamente Qlik DataTransfer quando scade questa chiave. Non è necessario ricreare le proprie connessioni dati se la chiave API scade.

Autenticazione Qlik DataTransfer

Procedere come indicato di seguito:

1. Aprire Qlik DataTransfer.

   Alla prima apertura di Qlik DataTransfer, apparirà la schermata di autenticazione Configurazione di Qlik DataTransfer .

   
2. Inserire un nome per la connessione.
3. Inserire l'URL per il tenant Qlik Cloud.

4. Incollare la chiave API generata dal tenant.

5. Fare clic su Applica per convalidare il tenant.

6. In caso di scadenza della propria chiave API, oppure di autenticazione di Qlik DataTransfer rispetto a un altro tenant, fare clic su per accedere a una nuova chiave API, quindi fare clic su Conferma.

   

Una volta autenticato Qlik DataTransfer, è possibile caricare i propri dati in loco nel proprio tenant Qlik Cloud. Per informazioni su come utilizzare Qlik DataTransfer, vedere Caricamento dati in loco con Qlik DataTransfer.

Aggiornamento di Qlik DataTransfer

Qlik DataTransfer visualizza un banner di notifica quando sono disponibili nuove versioni. Qlik DataTransfer non esegue automaticamente l'upgrade alle versioni più recenti.

Procedere come indicato di seguito:

1. Scaricare la nuova versione di Qlik DataTransfer dal banner interno all'app o da Download di prodotti.
2. Chiudere la versione corrente di Qlik DataTransfer.

3. Eseguire il programma di installazione di Qlik DataTransfer.

   Nota informatica

   Se si sta aggiornando Qlik DataTransfer su un server Windows con Qlik Sense Enterprise on Windows installato, Qlik DataTransfer deve essere aggiornato con i servizi Qlik Sense che l'utente ha utilizzato nell'installazione di Qlik Sense.

4. Fare clic su Upgrade.

   

Disinstallazione di Qlik DataTransfer

Procedere come indicato di seguito:

1. Eseguire il programma di installazione di Qlik DataTransfer.

   Nota informatica

   Se si dispone di una piattaforma Qlik installata sullo stesso server, arrestare gli altri servizi Qlik prima di poter disinstallare Qlik DataTransfer.

2. Fare clic su Disinstalla.

3. Al termine della disinstallazione, riavviare i servizi Qlik nel seguente ordine:

   1. Dispatcher servizi di Qlik Sense

   2. Servizio di registrazione Qlik

   3. Qlik Sense Repository Service

   4. Qlik Sense Proxy Service

   5. Qlik Sense Engine Service

   6. Servizio di pianificazione Qlik Sense

   7. Servizio stampa di Qlik Sense

Limiti

Qlik DataTransfer presenta le seguenti limitazioni:

• Al momento di eseguire l'upgrade da October 2020 o versione successiva, la posizione per l'archiviazione di file di configurazione e le porte utilizzate per l'esecuzione di Qlik DataTransfer passano ai valori predefiniti nel file di configurazione Service.conf. Se non si è utilizzato la posizione predefinita per l'archiviazione dei file di configurazione o delle porte predefinite per l'esecuzione di Qlik DataTransfer, si perderanno tali impostazioni. Per mantenere le proprie impostazioni, eseguire il backup di Service.conf prima dell'upgrade e ripetere le impostazioni in Service.conf dal file di cui si è eseguito il backup dopo il completamento dell'upgrade.

• Se non si è utilizzato la posizione predefinita per l'archiviazione dei file di configurazione in Service.conf, sarà necessario eliminare manualmente i file nella cartella selezionata.

• Se si utilizzano proxy, è necessario aggiungere un bypass per Qlik DataTransfer ai propri firewall utilizzando l'URL del tenant Qlik Cloud. Senza un bypass, Qlik DataTransfer non sarà in grado di connettersi a Qlik Cloud.

• Qlik DataTransfer dovrebbe essere installato su un server Windows dedicato come indicato nei Requisiti di sistema per Qlik DataTransfer. Non installarlo sul server della sorgente dati o su un server su cui è installato Qlik Data Gateway - Direct Access.