Gå till huvudinnehåll Gå till ytterligare innehåll
Qlik-resurser

Förutsättningar

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

  • Installera nödvändig driver på Gateway för dataflytt-servern

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

  • Konfigurera datakällans koppling

Installera R4Z-produkten på z/OS

Innan du kan arbeta med en IBM DB2 for z/OS-källa måste du först installera och konfigurera R4Z-produkten på z/OS.

  1. Gå till Produkthämtningar.

  2. Välj Qlik Dataintegrering.

  3. Bläddra nedåt i listan Produkt och välj Gateway för dataflytt.

  4. I kolumnen Hämtningslänk klickar du på länken QlikReplicate_2023.5.0.191_r4z.zip för att starta hämtningen.

  5. Hämta R4Z och installera det på din z/OS-datakälla.

Anvisningar för installation och konfiguration finns i Installera och konfigurera R4Z.

Installera och konfigurera drivrutinen

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 Gateway för dataflytt:

    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.

    7. driver kommer att installeras.

  7. Vänta tills installationen har slutförts (anges med "Slutförd!") och starta sedan Gateway för dataflytt-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 Gateway för dataflytt:

    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.

    7. Den gamla driver avinstalleras och den nya driver installeras.

  7. Vänta tills installationen har slutförts (anges med "Slutförd!") och starta sedan Gateway för dataflytt-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.

Linux ODBC-klientpaket

Du kan välja mellan att installera det fullständiga ODBC-klientpaketet eller installera bara dataserverklienten enligt beskrivningen i Linux-dataserverklient nedan.

Anteckning om information

Drivrutinsalternativet "enableWLB" stöds inte. Om du vill tvinga anslutningen att automatiskt växla till en annan LPAR i en parallell sysplex (dvs. "redundans") ställer du in "enableACR" på "true" och "enableWLB" på "false" i drivrutinskonfigurationen.

Öppna en skalprompt på Gateway för dataflytt-maskinen och gör följande:

  1. Stoppa tjänsten Gateway för dataflytt:

    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 v11.5.8_linuxx64_server_dec.tar.gz och välj alternativet “CLIENT”

  4. Om Gateway för dataflytt-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. Ändra arbetskatalogen till <Gateway för dataflytt_Installationskat>/bin.

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

  7. Om du vill kan du bekräfta att drivrutinsplatsen kopierades:

    cat site_arep_login.sh

  8. Lägg till följande post i filen odbcinst.ini under /etc:

    [IBM DB2 ODBC DRIVER]

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

    fileusage=1

    dontdlclose=1

  9. Starta Gateway för dataflytt-tjänsten.

    sudo systemctl start repagent

  10. Om du vill kan du bekräfta att tjänsten har startats:

    sudo systemctl status repagent

    Statusen ska vara enligt följande:

    Active: active (running) since <timestamp> ago

Linux-dataserverklient

  1. Hämta v11.5.8_linuxx64_client.tar.gz från IBM Fix Central och extrahera filerna.

  2. Stoppa tjänsten Gateway för dataflytt:

    sudo service repagent stop

  3. Bekräfta eventuellt att tjänsten har stoppats:

    sudo service repagent status

    Statusen ska vara enligt följande:

    Active: inactive (dead) since <timestamp> ago

  4. Ändra arbetskatalogen till /opt/client och kör db2_install.

  5. Skapa en RSP-fil (se Exempel på RSP-fil nedan) och kör sedan följande kommando (från /opt/client):

    ./db2setup -r /file-path/client.rsp

  6. Lägg till följande post i filen odbcinst.ini under /etc:

    [IBM DB2 ODBC DRIVER]

    Driver = /opt/ibm/db2/V11.5/lib64/libdb2o.so

    fileusage=1

    dontdlclose=1

  9. Starta Gateway för dataflytt-tjänsten.

    sudo service repagent start

  10. Om du vill kan du bekräfta att tjänsten har startats:

    sudo service repagent status

    Statusen ska vara enligt följande:

    Active: active (running) since <timestamp> ago

Exempel på RSP-fil

*-----------------------------------------------------
* Generated response file used by the DB2 Setup wizard
* generation time: 2/18/22 4:10 PM
*-----------------------------------------------------
*  Product Installation
LIC_AGREEMENT       = ACCEPT
PROD       = CLIENT
FILE       = /opt/ibm/db2/V11.5
INSTALL_TYPE       = TYPICAL
* ----------------------------------------------
*  Instance properties
* ----------------------------------------------
INSTANCE       = inst1
inst1.TYPE       = client
*  Instance-owning user
inst1.NAME       = qlik
inst1.UID       = 1000
inst1.GROUP_NAME       = qlik
inst1.HOME_DIRECTORY       = /home/qlik
inst1.AUTOSTART       = NO
*-----------------------------------------------
*  Installed Languages
*-----------------------------------------------
LANG       = EN

Inställning för ODBC-serversidan

Bind planen för ODBC som anges i PLANNAME=-värdet i initieringsfilen för ODBC. Standardnamnet är DSNACLI. BIND-jobbet finns i medlem DSNTIJCL som finns i biblioteket SDSNSAMP i installationen av käll-DB2.

Använd bindkommandot DB2CLI för att binda paketen som tillhandahålls av ODBC till avsett z/OS DB2-subsystem i källan. Åtgärden beskrivs i Configuring your developer and runtime environment på IBM:s webbplats. Information om DB2CLI-verktyget, med exempel för bindverktyget, finns i db2cli - DB2 interactive CLI command på IBM:s webbplats.

Behörigheter som krävs

För att göra det möjligt för Gateway för dataflytt att extrahera data från källtabellerna (Full Load och Change Data Capture), måste användaren som angetts i inställningarna för IBM DB2 for z/OS beviljas följande behörigheter:

  • EXECUTE för IFI-läsning av UDTF (krävs enbart för Change Data Capture)
  • SELECT för källtabellerna och för följande systemkatalogtabeller:
    • SYSIBM.SYSDUMMY1
    • SYSIBM.SYSTABLES
    • SYSIBM.SYSTABLESPACE
    • SYSIBM.SYSPARMS
    • SYSIBM.SYSROUTINES
    • SYSIBM.SYSCOLUMNS
    • SYSIBM.SYSLGRNX
    • SYSIBM.SYSTABLEPART
  • MONITOR2 för att kunna starta IFI-sessioner (krävs enbart för Change Data Capture)

Registrera dataändringar

För att samla in ändringar från IBM DB2 for z/OS använder Gateway för dataflytt ett specialprogram – anropas som en extern rutin – som är en användardefinierad tabellfunktion (UDTF). Detta program (en laddmodul) likväl som UDTF måste vara installerad och konfigurerad i z/OS-systemet innan ändringar kan samlas in. Installationsproceduren, som bör utföras av DBA, beskrivs i Installera och konfigurera R4Z.

Dessutom måste attributet DATA CAPTURE CHANGES vara inställt för alla tabell vars ändringar ska samlas in. Du kan antingen göra det manuellt eller låta Gateway för dataflytt göra det genom att lämna alternativet Aktivera DATA CAPTURE CHANGES automatiskt (kräver adminbehörighet) aktiverat (standardvärde) i koppling-inställningarna.

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här