Vereisten

De volgende sectie beschrijft de vereisten voor het werken met de IBM DB2 for LUW-connector.

Voordat u gegevens tijdelijk kunt opslaan of repliceren, moet u zorgen dat er aan de volgende vereisten is voldaan:

• Installeer het vereiste driver op de server van de gateway voor gegevensverplaatsing

• Verleen de vereiste machtigingen voor de gegevensbron

• De gegevensbronconnector configureren

Setup stuurprogramma

U kunt het driver installeren met het installatieprogramma (aanbevolen) of handmatig. U moet een handmatige installatie alleen uitvoeren als er een probleem ontstaat bij het hulpprogramma.

Het hulpprogramma gebruiken om het stuurprogramma te installeren

In deze sectie wordt beschreven hoe u het vereiste driver installeert. Het proces omvat het downloaden van het driver, het kopiëren ervan naar de vereiste map (zie hieronder) en het uitvoeren van een script dat automatisch het vereiste stuurprogramma installeert en configureert. U kunt indien nodig ook scripts uitvoeren om het driver bij te werken en verwijderen.

De installatie voorbereiden

• Controleer of Python 3.6 of hoger is geïnstalleerd op de Gegevensverplaatsing-gatewayserver.

  Python is al geïnstalleerd op de meeste Linux-distributies. U kunt controleren welke Python-versie is geïnstalleerd op uw systeem door de volgende opdracht uit te voeren:

  python3 --version

• Download de IBM Data Server Client "<version>_linuxx64_client.tar.gz" van de IBM-website. U vindt de ondersteunde versie onder binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. Nadat de download is voltooid, kopieert u het bestand naar:

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

De driver installeren

Ga als volgt te werk om het driverte installeren:

1. Stop de Data Movement gateway-service:

   sudo systemctl stop repagent

2. Bevestig eventueel dat de service is gestopt:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: inactive (dead) since <timestamp> ago

3. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

   opt/qlik/gateway/movement/drivers/bin

4. Voer dan de volgende opdracht uit:

   Syntaxis:

   ./install db2

   Anders wordt de gebruiksrechtovereenkomst voor het driver getoond.

5. Voer een van de volgende handelingen uit:

   • Druk herhaaldelijk op [Enter] om langzaam door de gebruiksrechtovereenkomst te scrollen.
   • Druk herhaaldelijk op de spatiebalk om snel door de gebruiksrechtovereenkomst te scrollen.
   • Druk op q om de licentietekst af te sluiten en de opties te tonen voor het aanvaarden van de gebruiksrechtovereenkomst.

6. Voer een van de volgende handelingen uit:

   • Typ "y" en druk op [Enter] om de gebruiksrechtovereenkomst te accepteren en de installatie te starten.
   • Typ "n" en druk op [Enter] om de gebruiksrechtovereenkomst af te wijzen en de installatie af te sluiten.

   • Typ "v" en druk op [Enter] om de gebruiksrechtovereenkomst nogmaals te tonen.

Het driver wordt geïnstalleerd.

7. Wacht totdat de installatie is voltooid (wordt aangegeven met "Voltooid!") en start vervolgens de Data Movement gateway-service:

   sudo systemctl start repagent

8. Bevestig eventueel dat de service is gestart:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: active (running) since <timestamp> ago

Het driver bijwerken

Voer de update-opdracht uit als u eerdere versies van het driver wilt verwijderen voordat u het meegeleverde driver installeert.

Ga als volgt te werk om het driver te bij te werken:

1. Stop de Data Movement gateway-service:

   sudo systemctl stop repagent

2. Bevestig eventueel dat de service is gestopt:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: inactive (dead) since <timestamp> ago

3. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

   opt/qlik/gateway/movement/drivers/bin

4. Voer dan de volgende opdracht uit:

   Syntaxis:

   ./update db2

   Anders wordt de gebruiksrechtovereenkomst voor het driver getoond.

5. Voer een van de volgende handelingen uit:

   • Druk herhaaldelijk op [Enter] om langzaam door de gebruiksrechtovereenkomst te scrollen.
   • Druk herhaaldelijk op de spatiebalk om snel door de gebruiksrechtovereenkomst te scrollen.
   • Druk op q om de licentietekst af te sluiten en de opties te tonen voor het aanvaarden van de gebruiksrechtovereenkomst.

6. Voer een van de volgende handelingen uit:

   • Typ "y" en druk op [Enter] om de gebruiksrechtovereenkomst te accepteren en de installatie te starten.
   • Typ "n" en druk op [Enter] om de gebruiksrechtovereenkomst af te wijzen en de installatie af te sluiten.
   • Typ "v" en druk op [Enter] om de gebruiksrechtovereenkomst nogmaals vanaf het begin te tonen.

Het oude driver wordt verwijderd en het nieuwe driver wordt geïnstalleerd.

7. Wacht totdat de installatie is voltooid (wordt aangegeven met "Voltooid!") en start vervolgens de Data Movement gateway-service:

   sudo systemctl start repagent

8. Bevestig eventueel dat de service is gestart:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: active (running) since <timestamp> ago

Het driver verwijderen

Voer de uninstall-opdracht uit als u het driver wilt verwijderen.

Ga als volgt te werken om het driver te verwijderen:

1. Stop alle taken die zijn geconfigureerd om deze connector te gebruiken.

2. Op de Gegevensverplaatsing-gatewaymachine wijzigt u de werkdirectory in:

   opt/qlik/gateway/movement/drivers/bin

3. Voer dan de volgende opdracht uit:

   Syntaxis:

   ./uninstall db2

   driver wordt verwijderd.

Het stuurprogramma handmatig installeren

U moet het driver alleen handmatig uitvoeren als de geautomatiseerde installatie van het stuurprogramma niet is voltooid.

Open op de Data Movement gateway-machine een opdrachtregel en doe het volgende:

1. Stop de Data Movement gateway-service:

   sudo systemctl stop repagent

2. Bevestig eventueel dat de service is gestopt:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: inactive (dead) since <timestamp> ago

3. Installeer IBM Data Client v11.5.8_linuxx64_server_t.tar.gz; kies om de “CLIENT” te installeren.

4. Als de Data Movement gateway-machine geen DB2-exemplaar heeft, maak dan een DB2-exemplaar door de volgende opdrachten uit te voeren:

   adduser <db2_instance_name>

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

5. Voeg de locatie van de het DB2-stuurprogramma toe aan het Linux-bibliotheekpad.

   Voeg hiervoor de volgende regel toe aan het site_ arep_login.sh bestand:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   waar path het CLIENT-pad naar het stuurprogramma is.

   Voorbeeld (met db2clnt1 als de exemplaarnaam):

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

   export DB2INSTANCE=db2clnt1

6. Maak een nieuw bestand met de naam odbcinst.ini onder /etc en geef de volgende invoer op:

   [IBM DB2 ODBC DRIVER]

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

   fileusage=1

   dontdlclose=1

7. Start de Data Movement gateway-service:

   sudo systemctl start repagent

8. Bevestig eventueel dat de service is gestart:

   sudo systemctl status repagent

   De status zou als volgt moeten zijn:

   Active: active (running) since <timestamp> ago

9. Definieer de verbindingsinstellingen van IBM DB2 for LUW zoals beschreven in IBM DB2 for LUW en klik op Verbinding testen.

   Als u de volgende fout te zien krijgt:

   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. Voer dan de volgende opdracht uit:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_connector_connection_settings> -host <server_name_from_connector_connection_settings> -port <port_from_connector_connection_settings>

   2. Wijzig naar de Data Movement gatewayprullenbakmap (<install_dir>/bin). Stop vervolgens en start de Data Movement gateway-service zoals hierboven beschreven.

CDC voor de database inschakelen

CDC (Change Data Capture) inschakelen:

• Stel de database in zodat deze te herstellen is - Als u wijzigingen wilt vastleggen, vereist Data Movement gateway dat de database wordt geconfigureerd als te herstellen. Een database is te herstellen als een of beide van de databaseconfiguratieparameters LOGARCHMETH1 en LOGARCHMETH2 niet zijn ingesteld op OFF.

• Machtigingen - De Qlik-gebruiker moet de volgende machtigingen toegekend krijgen:

  • SYSADM of DBADM

  • DATAACCESS

• Om het vastleggen van wijzigingsgegevens van IBM DB2 for LUW in te schakelen, moet u de brontabellen als volgt maken:

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

  U kunt connector configureren om deze actie uit te voeren door DATA CAPTURE CHANGES automatisch inschakelen (vereist de beheerdersbevoegdheid) in te schakelen in de Data Movement gateway-instellingen of u kunt dit handmatig doen.