Voraussetzungen

Im folgenden Abschnitt werden die Voraussetzungen für die Arbeit mit dem IBM DB2 for LUW-Konnektor beschrieben.

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 den IBM Data Server Client „<version>_linuxx64_client.tar.gz“ von der IBM-Website herunter. Die unterstützte Version finden Sie unter binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. Kopieren Sie nach Abschluss des Downloads die Datei in:

  /opt/qlik/gateway/movement/drivers/db2

Installieren von driver

So den driver herunter und installieren ihn:

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. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

4. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./install db2

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

5. 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.

6. 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.

7. Warten Sie, bis die Installation abgeschlossen ist („Complete!“ wird angezeigt) und starten Sie dann den Data Movement Gateway-Dienst:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: active (running) since <timestamp> ago

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. 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. Ändern Sie auf dem Data Movement-Gateway-Computer das Arbeitsverzeichnis zu:

   opt/qlik/gateway/movement/drivers/bin

4. Führen Sie den folgenden Befehl aus:

   Syntax:

   ./update db2

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

5. 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.

6. 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.

7. Warten Sie, bis die Installation abgeschlossen ist („Complete!“ wird angezeigt) und starten Sie dann den Data Movement Gateway-Dienst:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: active (running) since <timestamp> ago

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 db2

   Der driver wird deinstalliert.

Manuelles Installieren des Treibers

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

Öffnen Sie 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 IBM Data Client v11.5.8_linuxx64_server_t.tar.gz; wählen Sie dabei die „CLIENT“-Installation aus.

4. Falls der Data Movement Gateway-Rechner keine DB2-Instanz aufweist, erstellen Sie eine, indem Sie die folgenden Befehle ausführen:

   adduser <db2_instance_name>

   /opt/ibm/db2/V11.5/instance/db2icrt <db2_instance_name>

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

   Fügen Sie dazu die folgende Zeile folgendermaßen zur Datei site_ arep_login.sh hinzu:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   wobei path der CLIENT-Pfad zum Treiber ist.

   Beispiel (mit db2clnt1 als Namen der Instanz):

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/db2clnt1/sqllib/lib:/home/db2clnt1/sqllib/lib64/gskit

   export DB2INSTANCE=db2clnt1

6. Erstellen Sie eine neue Datei namens odbcinst.ini unter /etc und fügen Sie den folgenden Eintrag hinzu:

   [IBM DB2 ODBC DRIVER]

   Driver = /home/db2clnt1/sqllib/lib/libdb2o.so

   fileusage=1

   dontdlclose=1

7. Starten Sie den Data Movement Gateway-Dienst:

   sudo systemctl start repagent

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

   sudo systemctl status repagent

   Der Status lautet wie folgt:

   Active: active (running) since <timestamp> ago

9. Definieren Sie die Verbindungseinstellungen für IBM DB2 for LUW wie in IBM DB2 for LUW beschrieben und klicken Sie auf Verbindung testen.

   Falls Sie den folgenden Fehler erhalten:

   Cannot connect to DB2 LUW Server ODBC unknown error.

   RetCode: SQL_ERROR SqlState: NativeError: -1390 Message: [unixODBC][IBM][CLI Driver] SQL10007N Message "0" could not be retrieved. Reason code: "3". ODBC general error.

   1. Führen Sie den folgenden Befehl aus:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_Konnektor_connection_settings> -host <server_name_from_Konnektor_connection_settings> -port <port_from_Konnektor_connection_settings>

   2. Wechseln Sie zum Data Movement Gatewaybin -Verzeichnis (<install_dir>/bin). Halten Sie dann den Data Movement Gateway-Dienst an und starten Sie ihn erneut wie oben beschrieben.

Aktivieren von CDC in der Datenbank

So aktivieren Sie CDC (Change Data Capture):

• Legen Sie die Datenbank als wiederherstellbar fest: Damit Änderungen erfasst werden können, muss für Data Movement Gateway die Datenbank als wiederherstellbar konfiguriert sein. Eine Datenbank ist wiederherstellbar, wenn ein oder beide Datenbank-Konfigurationsparameter LOGARCHMETH1 und LOGARCHMETH2 nicht auf OFF festgelegt sind.

• Berechtigungen: Dem Qlik-Benutzer müssen die folgenden Berechtigungen gewährt werden:

  • SYSADM oder DBADM

  • DATAACCESS

• Um die Datenerfassung aus IBM DB2 for LUW zu aktivieren, müssen die Quelltabellen wie folgt erstellt werden:

  CREATE / ALTER TABLE table-name …. DATA CAPTURE CHANGES [INCLUDE LONGVAR COLUMNS];

  Sie können entweder Data Movement Gateway so konfigurieren, dass es diesen Vorgang ausführt, indem Sie DATA CAPTURE CHANGES automatisch aktivieren (erfordert Admin-Rechte) in den Konnektor-Einstellungen aktivieren, oder Sie können dies manuell tun.