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

  Anteckning om information

  Detta krävs endast om du har valt att arbeta med Gateway för dataflytt. Information om fördelarna med Gateway för dataflytt och när det krävs finns i Qlik Data Gateway – dataflytt.

• 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 ett skript körs som automatiskt hämtar, installerar och konfigurerar den nödvändiga driver. 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

Installera driver

Så här hämtar och installerar du driver:

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

   opt/qlik/gateway/movement/drivers/bin

2. Kör följande kommando:

   Syntax:

   ./install oracle

   Om driver inte kan hämtas (på grund av åtkomstbegränsningar eller tekniska problem) visas ett meddelande som beskriver var du kan hämta driver och vart du ska kopiera den på Dataflytt-gatewaydatorn. När du har gjort detta kör du install oracle-kommandot igen.

   I annat fall visas EULA för driver.

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

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

Uppdatering av driver

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

Så här hämtar och uppdaterar du driver:

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

   opt/qlik/gateway/movement/drivers/bin

2. Kör följande kommando:

   Syntax:

   ./update oracle

   Om driver inte kan hämtas (på grund av åtkomstbegränsningar eller tekniska problem) visas ett meddelande som beskriver var du kan hämta driver och vart du ska kopiera den på Dataflytt-gatewaydatorn. När du har gjort detta kör du update oracle-kommandot igen.

   I annat fall visas EULA för driver.

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

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

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 oracle

   driver kommer att avinstalleras.

Installera drivrutinen manuellt

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

Efter att Gateway för dataflytt har installerats hämtar du drivrutinen oracle-instantclient-basiclite-<version>.x86_64.rpm. Du hittar en direkt nedladdningslänk till den version som stöds i binary-artifacts i /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. När hämtningen har slutförts kopierar du RPM-filen till Gateway för dataflytt-maskinen.

Öppna sedan en kommandorad i Gateway för dataflytt 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 drivrutinen (RPM).

4. Om det inte redan finns på ditt system ska du dessutom skapa en symbolisk länk i $Oracle_Home\lib-katalogen. Ge länken namnet libclntsh.so, och låt den peka på en specifik version av filen.

   Exempel:

   lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.21.1

5. Byt arbetskatalog till <Gateway för dataflytt-Install-Dir>/bin och lägg till miljövariabeln LD_LIBRARY_PATH i katalogen för Oracle instant client och i katalogen Gateway för dataflyttlib genom att kopiera drivrutinens plats till filen site_arep_login.sh:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

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

   cat site_arep_login.sh

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

Ge tillgång till Oracle-kontot

Du måste ge Gateway för dataflytt-användaren tillgång till Oracle-kontot. Användaren måste ha läs- och skrivrättigheter i Oracle-databasen. Information om hur du konfigurerar åtkomst till Oracle-kontot finns i Behörigheter som krävs.

Se till att läget ARCHIVELOG är aktiverat

Oracle kan köras i två olika lägen: ARCHIVELOG-läget och NOARCHIVELOG-läget. Om du vill använda Oracle-loggarna med Gateway för dataflytt, kör databasen i ARCHIVELOG-läge. Om loggen inte är inställd på ARCHIVELOG-läge, kör följande fråga:

ALTER database ARCHIVELOG

Observera att om din Oracle-databasinstans finns på Amazon RDS måste ett annat kommando utföras. Mer information finns i Aktivera automatiska säkerhetskopieringar och Ställa in arkivering

Konfigurera kompletterande loggning

Kompletterande loggning måste vara aktiverad för Oracle-databasen, både på databasnivå och på tabellnivå.

Kontrollera och aktivera kompletterande loggning på databasnivå

1. Kör följande fråga:

   SELECT name, value, description FROM v$parameter WHERE name = 'compatible';

   Det returnerade resultatet ska vara från GE to n.n.n där n.n.n är Oracle-databasens version (t.ex. 10.0.0).

   Anteckning om varning

   Parametervärdet måste överensstämma med databasens faktiska version.

2. Kör följande fråga:

   SELECT supplemental_log_data_min FROM v$database;

   Det returnerade resultatet ska vara YES eller IMPLICIT.

   Aktivera kompletterande loggning genom att köra följande fråga:

   ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

   Anteckning om information

   Om din Oracle-databasinstans finns på Amazon RDS måste ett annat kommando utföras. Mer information finns i Arbeta med Amazon RDS for Oracle.

Kontrollera och aktivera kompletterande loggning på tabellnivå

1. Om du vill kontrollera om kompletterande loggning är aktiverad på tabellnivå kör du följande fråga:

   Syntax:

   select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';

   Exempel:

   select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';

2. Om du vill aktivera kompletterande loggning på tabellnivå kör du följande fråga:

   Syntax:

   ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

   Exempel:

   ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

Se även: Behörigheter som krävs