Configuration des outils de migration Qlik Cloud

Les outils de migration Qlik Cloud vous aident à planifier et à réaliser votre migration vers Qlik Cloud.

L'ensemble d'outils contient les outils suivants :

• Application Migration Qlik Sense vers SaaS — application Qlik Sense utilisée pour gérer le séquencement et le suivi de votre migration.

• Application Migration QlikView vers SaaS — application QlikView utilisée pour gérer le séquencement et le suivi de votre migration. Utilisation de Tableau de bord de gouvernance QlikView.

• Feuille de calcul Migration—utilisez cette feuille de calcul Microsoft Excel pour rassembler des listes d'utilisateurs, de rôles, de règles de sécurité, de licences, d'espaces, etc.

• Scripts de migration—utilisés dans le processus de migration vers Qlik Cloud.

L'image suivante montre comment la migration est effectuée et comment les outils de migration peuvent vous aider à déplacer les utilisateurs et les ressources vers le cloud. Les données de Qlik Sense Client-Managed et les métadonnées de Qlik Cloud sont extraites dans l'application Migration. Les tables de données Migration sont enregistrées dans un fichier CSV et importées dans Qlik Cloud via les scripts qlik-cli. L'application Migration est ensuite actualisée pour refléter le statut de migration. Ce processus est essentiellement le même pour tous les éléments à migrer.

Scripts de migration

Téléchargez les fichiers de métadonnées .csv via l'application Migration. Les scripts sont utilisés pour importer les ressources Client-Managed dans le cloud. Pour en savoir plus, voir Utilisation de scripts de migration.

Préparation à la migration

Les éléments suivants faciliteront votre migration et vous fourniront une procédure de travail recommandée.

• Rubrique : Planification de votre migration vers Qlik Cloud. Pour une migration réussie, l'évaluation et la préparation sont essentielles.

• Outils de migration Qlik Cloud — le fichier zip contient les éléments suivants :

  • application Migration Qlik Cloud, utilisée pour gérer le séquencement et le suivi de votre migration.
  • Feuille de calcul Migration : fichier Excel. Utilisez cette feuille de calcul pour établir des listes d'utilisateurs, de rôles, de règles de sécurité, de licences, d'espaces, etc.
  • Scripts de migration pour migrer les éléments de Qlik Sense Client-Managed vers Qlik Cloud.

• qlik-cli : interface de ligne de commande (CLI), disponible sur Développeur Qlik : qlik-cli.

Une fois l'évaluation et la planification terminées, procédez comme suit :

1. Configurez l'application Migration : importez l'application SaaS Migration 1.x.qvf dans Console de gestion Qlik (QMC), configurez REST Connector, modifiez le script de chargement et chargez de nouveau l'application.

2. Recherchez l'ID de votre client. Vous le trouverez dans Qlik Cloud dans le menu de votre profil utilisateur, sous À propos de.

3. Configurez les scripts de migration.

4. Créez et appliquez des balises aux applications et aux connexions de données.

Configuration de l'application Migration

Cette section explique comment importer l'application Migration, créer une clé API, configurer une connexion REST et modifier le script de chargement de l'application. Pour en savoir plus, voir Configuration de l'application Migration.

 

Import de l'application Migration

Procédez comme suit :

1. Dans QMC, ouvrez Applications.

2. Cliquez sur Importer.

3. Accédez à l'application SaaSMigration 1.x.qvf que vous avez téléchargée.

4. Cliquez sur Importer.

L'application est désormais disponible dans le hub.

Configuration de la connexion REST

Commencez par créer une clé API dans votre client cloud.

Procédez comme suit :

1. Dans la Console de gestion de votre client cloud, ouvrez Clés API.

2. Cliquez sur Générer une nouvelle clé.

3. Cliquez sur Générer une nouvelle clé.

4. Saisissez une description de clé et définissez l'expiration de la clé.

5. Cliquez sur Générer.

6. Copiez la clé API et stockez-la en lieu sûr.

L'étape suivante consiste à configurer REST Connector dans Qlik Sense Enterprise on Windows.

Procédez comme suit :

1. Dans Qlik Sense Enterprise on Windows, créez une nouvelle connexion de données et sélectionnez REST comme source de données.

   Note InformationsSi rien d'autre n'est indiqué, conservez les valeurs par défaut.

2. Saisissez l'URL au format suivant : https://<tenant>.<region>.qlikcloud.com/api/v1/items.

3. Dans la section Additional request parameters > Query headers, saisissezAuthorization dans le champ Name et, dans le champ Value, saisissez 'Bearer ', suivi de la clé API que vous avez générée précédemment. Notez l'espace entre 'Bearer ' et votre clé API.

4. Dans la section Pagination > Pagination type, sélectionnez Next URL et, pour le chemin d'accès 'Next url', saisissez root/links/next/href.

5. Saisissez un nom de connexion, par exemple, REST pour Qlik Cloud.

6. Cliquez sur Créer.

Modification du script de chargement

Procédez comme suit :

1. Dans le hub Qlik Sense, ouvrez l'application SaaSMigration 1.x.qvf.

   L'aperçu de l'application apparaît.

2. Ouvrez l'éditeur de chargement de données.

3. Ouvrez la section ** configuration **.

4. Sur la ligne Set vu_tenant_fqdn, saisissez le nom de domaine complet de votre client.

   Exemple : Set vu_tenant_fqdn = 'my_tenant.eu.qlikcloud.com';

5. Sur la ligne Set vu_rest_connection_SaaS, saisissez le nom de la connexion REST de votre client Qlik Cloud.

   Exemple : Set vu_rest_connection_SaaS = 'MyRESTConnection for SaaS';

6. Sur la ligne SET vu_central_node_host_name, saisissez le nom d'hôte de nœud central ou le nom de poste.

   Exemple 1 : SET vu_central_node_host_name = 'sense-central-node'

   Exemple 2 : SET vu_central_node_host_name = 'my-central-node.domain.com'

7. Si votre proxy virtuel a un préfixe, vous devez le saisir sur la ligne SET vu_virtual_proxy_prefix = '';.
   Exemple : SET vu_virtual_proxy_prefix = 'my-virtual-proxy-prefix';

Configuration de qlik-cli et des scripts de migration

Procédez comme suit :

1. Installez Qlik-CLI for Windows, une interface de ligne de commande pour Qlik Sense SaaS. Elle permet d'accéder à toutes les API publiques via la ligne de commande, ce qui facilite la rédaction des scripts et l'automatisation des nouveaux et des anciens flux de travail.

2. Assurez-vous que qlik.exe se trouve dans votre chemin d'exécution Windows. Suivant la manière dont vous avez installé qlik-cli, il se peut que qlik.exe ne se trouve pas dans votre chemin Windows par défaut.

3. Configurez une connexion à Qlik Cloud ; voir Mise en route.

4. Configurez une connexion à Qlik Sense Client-Managed ; voir Qlik Sense : Configuration de l'authentification JWT.

5. Éditez 0_globals.ps1 et définissez des noms contextuels pour :

   • $QlikSaaSContext

   • $tenantid

     Votre TenantID se trouve sous Votre profil utilisateur > À propos de.

   • $MIGRATIONFROM = “Qlik Sense”

   

Création et application de balises

Il est conseillé d'accorder les droits Content Admin aux personnes qui peuvent accéder aux applications et aux connexions de données et leur appliquer des balises.

Procédez comme suit :

1. Créez les balises suivantes dans QMC, dans la section Balises, pour Qlik Sense Client-Managed :

   • Con Status - 05 Selected

   • Con Status - 10 Configured

   • Con Status - 20 Tested

   • Con Status - 30 Completed

   • Con Status - 99 Not Required

   • Con Type Data Files

   • Con Type Data Gateway - Data Access

   • Con Type Native Connector

   • App - 05 Migrated via Multi-Cloud

   • App - 05 URL Link to Qlik Sense Windows

   • App - 10 Selected for Migration Review

   • App - 20 Migration Remediation Needed

   • App - 30 Ready to Migrate

   • App - 40 Migration Complete

   • App - 99 Will Not Migrate

2. Évaluez les applications et les connexions de données et appliquez les balises en conséquence.

3. Dans la section QMC Applications, sélectionnez les applications qui auront la même balise.

4. Cliquez sur Éditer et sélectionnez la balise appropriée.

Travaillez de manière itérative avec quelques types d'application différents à la fois et vérifiez la progression de la migration sur la feuille Application SaaS Migration Status de l'application Migration SaaS ; voir Migration d'applications.