Conditions préalables requises

Avant de pouvoir déposer temporairement ou répliquer des données, vérifiez que vous remplissez bien les conditions préalables requises suivantes :

• Installez le driver requis sur le serveur Data Movement gateway.

  Note Informations

  Cela est nécessaire uniquement si vous avez décidé d'utiliser Data Movement gateway. Pour des informations sur les avantages de Data Movement gateway et quand il convient de l'utiliser, consultez Qlik Data Gateway - Data Movement.

• Accordez les autorisations requises sur la source de données.

• Configuration du connecteur de source de données

Configuration du pilote

Vous pouvez installer le driver via l'utilitaire d'installation de pilote (recommandé) ou manuellement. Tentez une installation manuelle uniquement dans le cas improbable où vous rencontriez un problème avec l'utilitaire d'installation de pilote.

Utilisation de l'utilitaire d'installation de pilote pour installer le pilote

Cette section explique comment installer le driver requis. Le processus implique le téléchargement du driver, sa copie dans le dossier requis (voir ci-dessous) et l'exécution d'un script qui l'installera et le configurera automatiquement. Vous pouvez également exécuter des scripts permettant de mettre à jour et de désinstaller le driver, si nécessaire.

Préparation de l'installation

• Assurez-vous que Python 3.6 ou une version ultérieure est installé sur le serveur de passerelle Déplacement des données.

  Python est préinstallé sur la plupart des distributions Linux. Vous pouvez vérifier la version de Python installée sur votre système en exécutant la commande suivante :

  python3 --version

• Téléchargez le package d'applications Linux IBM i Access Client Solutions "ibm-iaccess-<version>.x86_64.rpm" depuis le site Web d'IBM. Vous trouverez la version supportée sous binary-artifacts dans /opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml. Une fois le téléchargement terminé, copiez le fichier dans :

  /opt/qlik/gateway/movement/drivers/db2i

Installation de driver

Pour installer le driver :

1. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

2. Exécutez la commande suivante :

   Syntaxe :

   ./install db2iseries

   Sinon, le CLUF du driver apparaîtra.

3. Procédez de l'une des manières suivantes :

   • Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF.
   • Appuyez à plusieurs reprises sur la barre d'espace pour parcourir rapidement le CLUF.
   • Appuyez sur q pour quitter le texte de licence et faire apparaître les options d'acceptation du CLUF.

4. Procédez de l'une des manières suivantes :

   • Saisissez « y » et appuyez sur [Entrée] pour accepter le CLUF et démarrer l'installation.
   • Saisissez « n » et appuyez sur [Entrée] pour rejeter le CLUF et quitter l'installation.

   • Saisissez « v » et appuyez sur [Entrée] pour afficher de nouveau le CLUF.

Le driver sera installé.

Mise à jour du driver

Exécutez la commande update si vous souhaitez désinstaller des versions précédentes du driver avant d'installer le driver fourni.

Pour mettre à jour le driver :

1. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

2. Exécutez la commande suivante :

   Syntaxe :

   ./update db2iseries

   Sinon, le CLUF du driver apparaîtra.

3. Procédez de l'une des manières suivantes :

   • Appuyez à plusieurs reprises sur [Entrée] pour parcourir lentement le CLUF.
   • Appuyez à plusieurs reprises sur la barre d'espace pour parcourir rapidement le CLUF.
   • Appuyez sur q pour quitter le texte de licence et faire apparaître les options d'acceptation du CLUF.

4. Procédez de l'une des manières suivantes :

   • Saisissez « y » et appuyez sur [Entrée] pour accepter le CLUF et démarrer l'installation.
   • Saisissez « n » et appuyez sur [Entrée] pour rejeter le CLUF et quitter l'installation.
   • Saisissez « v » et appuyez sur [Entrée] pour passer le CLUF en revue depuis le début.

L'ancien driver sera désinstallé et le nouveau driver sera installé.

Désinstallation du driver

Exécutez la commande uninstall si vous souhaitez désinstaller le driver.

Pour désinstaller le driver :

1. Arrêtez toutes les tâches configurées pour utiliser ce connecteur.

2. Sur le poste de passerelle Déplacement des données, remplacez le répertoire de travail par :

   opt/qlik/gateway/movement/drivers/bin

3. Exécutez la commande suivante :

   Syntaxe :

   ./uninstall db2iseries

   le driver sera désinstallé.

Configuration manuelle du pilote

Vous devez tenter d'installer manuellement le driver uniquement si l'installation de pilote automatisée n'a pas fonctionné.

Téléchargez le package d'application IBM i Access Client Solutions Linux depuis le site Web d'IBM.

Pour en savoir plus, voir https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package.

Ensuite, sur le poste Data Movement gateway, ouvrez une invite shell et procédez comme suit :

1. Arrêtez le service Data Movement gateway :

   sudo systemctl stop repagent

2. Confirmez éventuellement l'arrêt du service :

   sudo systemctl status repagent

   Le statut doit être comme suit :

   Active: inactive (dead) since <timestamp> ago

3. Installez le RPM fourni dans le package téléchargé.

   Exemple :

   rpm -i ibm-iaccess-1.1.0.26-1.0.x86_64

   Note Informations

   La version affichée du pilote est différente dans les journaux Data Movement gateway. Par exemple, si l'on suppose que la version du pilote est identique à celle de l'exemple ci-dessus, elle apparaît comme Version du pilote ODBC : '07.01.026' dans les journaux Data Movement gateway.

   Pour des informations sur l'affichage des journaux, voir Résolution des problèmes des tâches de données.

4. Remplacez le répertoire de travail par <répertoire_d'_installation_Data Movement gateway>/bin.

5. Ajoutez l'emplacement du pilote DB2 dans le chemin d'accès de la bibliothèque Linux.

   À cet effet, ajoutez le chemin suivant au fichier site_ arep_login.sh dans <install_dir>/replicate/bin :

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib64

   où path correspond au chemin d'accès du pilote.

   Exemple :

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/ibm/iaccess/lib64" >> site_arep_login.sh

6. Confirmez éventuellement que l'emplacement du pilote a été copié :

   cat site_arep_login.sh

7. Après la fin de l'installation, ouvrez le fichier /etc/odbcinst.ini et vérifiez s'il contient la section suivante :

   [IBM i Access ODBC Driver 64-bit]
   Description = IBM i Access for Linux 64-bit ODBC Driver Driver = /opt/ibm/iaccess/lib64/libcwbodbc.so Setup = /opt/ibm/iaccess/lib64/libcwbodbcs.so Threading = 0 DontDLClose = 1 UsageCount = 1

8. Démarrez le service Data Movement gateway :

   sudo systemctl start repagent

9. Confirmez éventuellement le lancement du service :

   sudo systemctl status repagent

   Le statut doit être comme suit :

   Active: active (running) since <timestamp> ago

Conditions préalables requises CDC

Conditions préalables requises du journal

Toutes les tables sources pour une tâche déplacement donnée doivent être journalisées dans le même journal. Le nom du journal et la bibliothèque dans laquelle il se trouve doivent être spécifiés dans les paramètres du connecteur. Pendant la tâche, Data Movement gateway interroge ce journal pour connaître les modifications apportées aux tables sources.

Lorsque vous commencez à journaliser les tables sources, le paramètre Record images peut être réglé sur *BOTH(pour capturer des images avant et après) ou *AFTER.

Lorsque le paramètre Record images est défini sur *AFTER, les enregistrements supprimés contiendront des valeurs NULL dans leurs champs de données. Pour sauvegarder une copie de l'enregistrement supprimé dans le journal des enregistrements supprimés, vous devez définir le paramètre Record images sur *BOTH.

Paramètre MINENTDTA

Le paramètre MINENTDTA doit être défini sur *NONE, puisque *FILE (journalisation minimale) n'est pas pris en charge.