Förutsättningar

Följande delavsnitt beskriver förutsättningarna för att arbeta med kopplingen IBM DB2 for LUW.

Innan du kan mellanlagra eller replikera data måste du skapa följande förutsättningar:

• Installera nödvändig driver på Data Movement-gatewayservern

• Bevilja nödvändiga behörigheter på datakällan

• Konfigurera datakällans koppling

Inställning av drivrutin

Du kan installera driver med verktyget för installation av drivrutiner (rekommenderas) eller manuellt. Manuell installation ska bara användas om det mot förmodan skulle inträffa ett problem med verktyget för installation av drivrutiner.

Använda verktyget för installation av drivrutiner för att installera drivrutinen

I det här delavsnittet beskrivs hur driver som krävs installeras. Processen innebär att hämta driver, kopiera den till rätt mapp (se nedan) och att köra ett skript som automatiskt installerar och konfigurerar den. Du kan också köra skript som uppdaterar och avinstallerar driver efter behov.

Förbereda installationen

• Kontrollera att Python 3.6 eller senare är installerad på Dataflytt-gatewayservern.

  Python kommer förinstallerad på de flesta Linuxdistributioner. Du kan kontrollera vilken Pythonversion som är installerad på ditt system genom att köra följande kommando:

  python3 --version

• Hämta IBM Data Server Client "<version>_linuxx64_client.tar.gz" från IBM:s webbplats. Du hittar den version som stöds i binary-artifacts i /opt/qlik/gateway/movement/drivers/manifests/db2.yaml. När hämtningen har slutförts kopierar du filen till:

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

Installera driver

Så här installerar du driver:

1. Stoppa tjänsten Data Movement gateway:

   sudo systemctl stop repagent

2. Om du vill kan du bekräfta att tjänsten har stoppats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: inactive (dead) since <timestamp> ago

3. På Dataflytt-gatewaydatorn byter du arbetskatalog till:

   opt/qlik/gateway/movement/drivers/bin

4. Kör följande kommando:

   Syntax:

   ./install db2

   I annat fall visas EULA för driver.

5. Gör ett av följande:

   • Tryck på [Enter] flera gånger för att långsamt rulla genom EULA.
   • Tryck på mellanslagstangenten flera gånger för att snabbt rulla genom EULA.
   • Tryck på q för att lämna avtalstexten. Godkännandealternativen för EULA visas.

6. Gör något av följande:

   • Skriv in "y" och tryck på [Enter] för att godkänna EULA och börja med installationen.
   • Skriv in "n" och tryck på [Enter] för att avböja EULA och avsluta installationen.

   • Skriv in "v" och tryck på [Enter] för att visa EULA igen.

driver kommer att installeras.

7. Vänta tills installationen har slutförts (anges med "Slutförd!") och starta sedan Data Movement gateway-tjänsten:

   sudo systemctl start repagent

8. Du kan även bekräfta att tjänsten har startats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: active (running) since <timestamp> ago

Uppdatering av driver

Kör uppdateringskommandot om du vill avinstallera tidigare versioner av driver innan du installerar den tillhandahållna driver.

Så här uppdaterar du driver:

1. Stoppa tjänsten Data Movement gateway:

   sudo systemctl stop repagent

2. Om du vill kan du bekräfta att tjänsten har stoppats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: inactive (dead) since <timestamp> ago

3. På Dataflytt-gatewaydatorn byter du arbetskatalog till:

   opt/qlik/gateway/movement/drivers/bin

4. Kör följande kommando:

   Syntax:

   ./update db2

   I annat fall visas EULA för driver.

5. Gör ett av följande:

   • Tryck på [Enter] flera gånger för att långsamt rulla genom EULA.
   • Tryck på mellanslagstangenten flera gånger för att snabbt rulla genom EULA.
   • Tryck på q för att lämna avtalstexten. Godkännandealternativen för EULA visas.

6. Gör något av följande:

   • Skriv in "y" och tryck på [Enter] för att godkänna EULA och börja med installationen.
   • Skriv in "n" och tryck på [Enter] för att avböja EULA och avsluta installationen.
   • Skriv in "v" och tryck på [Enter] för att granska EULA från början.

Den gamla driver avinstalleras och den nya driver installeras.

7. Vänta tills installationen har slutförts (anges med "Slutförd!") och starta sedan Data Movement gateway-tjänsten:

   sudo systemctl start repagent

8. Du kan även bekräfta att tjänsten har startats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: active (running) since <timestamp> ago

Avinstallera driver

Kör avinstalleringskommandot om du vill avinstallera driver.

Så här avinstallerar du driver:

1. Stoppa alla uppgifter som är konfigurerade för att använda denna koppling.

2. På Dataflytt-gatewaydatorn byter du arbetskatalog till:

   opt/qlik/gateway/movement/drivers/bin

3. Kör följande kommando:

   -syntax

   ./uninstall db2

   driver kommer att avinstalleras.

Installera drivrutinen manuellt

Du bör bara försöka installera driver manuellt om den automatiserade drivrutinsinstallationen inte slutfördes.

Öppna en skalprompt på Data Movement gateway-maskinen och gör följande:

1. Stoppa tjänsten Data Movement gateway:

   sudo systemctl stop repagent

2. Om du vill kan du bekräfta att tjänsten har stoppats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: inactive (dead) since <timestamp> ago

3. Installera IBM Data Client v11.5.8_linuxx64_server_t.tar.gz, välj att installera "CLIENT".

4. Om Data Movement gateway-maskinen inte har en DB2-instans skapar du en DB2-instans genom att köra följande kommandon:

   adduser <db2_instance_name>

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

5. Lägg till DB2-drivrutinens plats i bibliotekssökvägen för Linux.

   Gör det genom att lägga till följande rad i site_ arep_login.sh enligt följande:

   export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/path/lib

   där path är CLIENT-sökvägen till drivrutinen.

   Exempelvis (med db2clnt1 som instansnamn):

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

   export DB2INSTANCE=db2clnt1

6. Skapa en ny fil som heter odbcinst.ini under /etc och lägg till följande post:

   [IBM DB2 ODBC DRIVER]

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

   fileusage=1

   dontdlclose=1

7. Starta Data Movement gateway-tjänsten.

   sudo systemctl start repagent

8. Du kan även bekräfta att tjänsten har startats:

   sudo systemctl status repagent

   Statusen ska vara enligt följande:

   Active: active (running) since <timestamp> ago

9. Definiera kopplingsinställningarna för IBM DB2 for LUW enligt beskrivningen i IBM DB2 för LUW och klicka på Testa koppling.

   Om du får följande fel:

   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. Kör följande kommando:

      /opt/ibm/db2/V11.5/bin /db2cli writecfg add -database <db_name_from_koppling_connection_settings> -host <server_name_from_koppling_connection_settings> -port <port_from_koppling_connection_settings>

   2. Växla till Data Movement gatewaybin-katalogen <installationskat>/bin). Stoppa sedan och starta tjänsten Data Movement gateway enligt beskrivningen ovan.

Aktivera CDC på databasen

Aktivera CDC (Change Data Capture):

• Set the database to be recoverable – För att samla in ändringar kräver Data Movement gateway att databasen är konfigurerad så den kan återställas. En databas kan återställas om antingen en eller båda parametrarna LOGARCHMETH1 och LOGARCHMETH2 är inställda som OFF.

• Permissions – Qlik-användaren måste beviljas följande behörigheter:

  • SYSADM eller DBADM

  • DATAACCESS

• För att aktivera datainsamling från IBM DB2 för LUW, måste källtabellerna skapas enligt följande:

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

  Du kan antingen konfigurera Data Movement gateway så att den här åtgärden utförs genom att markera Automatically enable DATA CAPTURE CHANGES (kräver administratörsbehörighet) i koppling-inställningarna eller så kan du göra detta manuellt