Voraussetzungen

Vergewissern Sie sich, dass Sie die folgenden Voraussetzungen erfüllen, bevor Sie Daten bereitstellen oder replizieren:

• Installieren des benötigten driver auf dem Gateway-Server für Datenbewegungen

• Gewähren der benötigten Berechtigungen für die Datenquelle

• Konfigurieren des Datenquellenkonnektors

Treibereinrichtung

Sie können den driver mit dem Treiberinstallations-Dienstprogramm (empfohlen) oder manuell installieren. Eine manuelle Installation sollte nur in dem unwahrscheinlichen Fall versucht werden, dass Sie beim Verwenden des Treiberinstallations-Dienstprogramms auf Probleme stoßen.

Verwenden des Treiberinstallations-Dienstprogramms zum Installieren des Treibers

In diesem Abschnitt wird die Installation des erforderlichen driver beschrieben. Während des Prozesses wird der driver heruntergeladen, in den erforderlichen Ordner kopiert (siehe unten) und ein Skript ausgeführt, das den Treiber automatisch installiert und konfiguriert. Sie können auch Skripte ausführen, um den driver bei Bedarf zu aktualisieren und zu deinstallieren.

Vorbereiten der Installation

• Vergewissern Sie sich, dass Python 3.6 oder höher auf dem Data Movement-Gateway-Server installiert ist.

  Python ist in den meisten Linux-Distributionen vorinstalliert. Führen Sie den folgenden Befehl aus, um zu prüfen, welche Python-Version auf Ihrem System installiert ist.

  python3 --version

• Laden Sie das IBM i Access Client Solutions Linux Application Package „ibm-iaccess-<version>.x86_64.rpm“ von der IBM-Website herunter. Die unterstützte Version finden Sie unter binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/db2iseries.yaml. Kopieren Sie nach Abschluss des Downloads die Datei in:

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

Installieren von driver

So den driver herunter und installieren ihn:

1. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

2. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./install db2iseries

   Andernfalls wird die Endbenutzer-Lizenzvereinbarung für den driver angezeigt.

3. Gehen Sie folgendermaßen vor:

   • Drücken Sie mehrmals die [Eingabetaste], um langsam durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie mehrmals die Leertaste, um schnell durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie q, um den Lizenztext zu schließen und die Optionen zum Akzeptieren der Endbenutzer-Lizenzvereinbarung anzuzeigen.

4. Gehen Sie folgendermaßen vor:

   • Geben Sie „y“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung zu akzeptieren und mit der Installation zu beginnen.
   • Geben Sie „n“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung abzulehnen und den Installationsvorgang abzubrechen.

   • Geben Sie „v“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung erneut anzuzeigen.

Der driver wird installiert.

Aktualisieren des driver

Führen Sie den Befehl „update“ aus, wenn Sie vorherige Versionen des driver deinstallieren möchten, bevor Sie den bereitgestellten driver installieren.

So den driver herunter und aktualisieren ihn:

1. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

2. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./update db2iseries

   Andernfalls wird die Endbenutzer-Lizenzvereinbarung für den driver angezeigt.

3. Gehen Sie folgendermaßen vor:

   • Drücken Sie mehrmals die [Eingabetaste], um langsam durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie mehrmals die Leertaste, um schnell durch die Endbenutzer-Lizenzvereinbarung zu scrollen.
   • Drücken Sie q, um den Lizenztext zu schließen und die Optionen zum Akzeptieren der Endbenutzer-Lizenzvereinbarung anzuzeigen.

4. Gehen Sie folgendermaßen vor:

   • Geben Sie „y“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung zu akzeptieren und mit der Installation zu beginnen.
   • Geben Sie „n“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung abzulehnen und den Installationsvorgang abzubrechen.
   • Geben Sie „v“ ein und drücken Sie die [Eingabetaste], um die Endbenutzer-Lizenzvereinbarung von Anfang an anzuzeigen.

Der alte driver wird deinstalliert und der neue driver installiert.

Deinstallieren des driver

Führen Sie den Befehl „uninstall“ aus, wenn Sie den driver deinstallieren möchten.

So deinstallieren Sie den driver:

1. Halten Sie alle Aufgaben an, die für die Verwendung dieses Konnektors konfiguriert sind.

2. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

3. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./uninstall db2iseries

   Der driver wird deinstalliert.

Manuelle Treibereinrichtung

Nehmen Sie nur dann eine manuelle Installation des driver vor, wenn die automatische Treiberinstallation nicht erfolgreich abgeschlossen werden konnte.

Laden Sie das IBM i Access Client Solutions Linux Application Package von der IBM-Website herunter.

Weiter Informationen finden Sie unter https://www.ibm.com/docs/en/i/7.2?topic=packages-linux-application-package.

Öffnen Sie dann auf dem Data Movement Gateway-Computer eine Shell-Eingabeaufforderung und führen Sie Folgendes durch:

1. Halten Sie den Data Movement Gateway-Dienst an:

   sudo systemctl stop repagent

2. Bestätigen Sie optional, dass der Dienst angehalten wurde:

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: inactive (dead) since <timestamp> ago

3. Installieren Sie die RPM-Datei, die im heruntergeladenen Paket enthalten ist.

   Beispiel:

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

   Informationshinweis

   Die angezeigte Treiberversion lautet in den Data Movement Gateway-Protokollen anders. Beispiel: Angenommen, die Treiberversion lautet wie im obigen Beispiel, dann erscheint sie in den Data Movement Gateway-Protokollen als ODBC-Treiberversion: '07.01.026' .

   Weitere Informationen zum Anzeigen der Protokolle finden Sie unter Fehlerbehebung von Datenaufgaben.

4. Ändern Sie das Arbeitsverzeichnis in <Data Movement Gateway_Install_Dir>/bin.

5. Fügen Sie den Speicherort des DB2-Treibers zum Linux-Bibliothekspfad hinzu.

   Fügen Sie dazu den folgenden Pfad zur Datei site_ arep_login.sh im Verzeichnis <install_dir>/replicate/bin hinzu:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib64

   path ist dabei der Pfad zum Treiber.

   Beispiel:

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

6. Bestätigen Sie optional, dass der Speicherort des Treibers kopiert wurde:

   cat site_arep_login.sh

7. Öffnen Sie nach Abschluss der Installation die Datei /etc/odbcinst.ini und stellen Sie sicher, dass sie den folgenden Abschnitt enthält:

   [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. Starten Sie den Data Movement Gateway-Dienst:

   sudo systemctl start repagent

9. Bestätigen Sie optional, dass der Dienst gestartet wurde:

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: active (running) since <timestamp> ago

CDC-Voraussetzungen

Journalvoraussetzungen

Alle Quelltabellen für eine bestimmte Bereitstellung-Aufgabe müssen im gleichen Journal erfasst werden. Der Name des Journals und die Bibliothek, in der es sich befindet, müssen in den Konnektor-Einstellungen angegeben sein. Während der Aufgabe fragt Data Movement Gateway dieses Journal nach Änderungen an den Quelltabellen ab.

Wenn Sie mit dem Journal-Vorgang der Quelltabellen beginnen, kann der Parameter Record images auf *BOTH (zum Erfassen vor und nach Images) oder auf *AFTER festgelegt werden.

Wenn der Parameter Record images auf *AFTER festgelegt wird, enthalten gelöschte Datensätze NULL-Werte in ihren Datenfeldern. Um eine Kopie des gelöschten Datensatzes im Journal für gelöschte Datensätze zu speichern, müssen Sie den Parameter Record images auf *BOTH festlegen.

Parameter MINENTDTA

Der Parameter MINENTDTA muss auf *NONE festgelegt werden, da *FILE (minimale Protokollierung) nicht unterstützt wird.