Konfigurering och felsökning Qlik Data Gateway – direktåtkomst

Det här ämnet beskriver olika åtgärder som du kan vidta för att konfigurera och felsöka Gateway med direktåtkomst.

Konfigurera Gateway med direktåtkomst från din Qlik Cloud-klientorganisation

Standardinställningarna för Gateway med direktåtkomst är lämpliga för de flesta miljöer, men du kan behöva åsidosätta standardinställningarna för att förbättra prestandan, felsöka problem (via inloggningsinställningarna) eller lösa olika anslutningsproblem.

För att kunna redigera inställningarna i Qlik Cloud krävs någon av följande behörigheter:

• Klientorganisationsadministratör och ägare av gatewayutrymme

• Medlem i klientorganisation med Kan använda data i gatewayutrymmet

För att öppna gateway-inställningarna:

1. I din Qlik Cloud-klientorganisation navigerar du till Administration > Data gateways och letar upp din Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Gateway-inställningar.

   Dialogrutan Gateway-inställningar för <namn> öppnas.

   Inställningarna är indelade i allmänna inställningar (nedan) och inställningar för koppling. Observera att om du ändrar inställningarna kan det också krävas att du startar om Gateway med direktåtkomst-tjänsten.

Allmänna inställningar

Dessa inställningar är relevanta för den allmänna funktionaliteten på Gateway med direktåtkomst, oavsett vilken koppling du använder.

Agent-ID

Agent-ID för användning av offentligt API för Gateway med direktåtkomst.

Port för kopplingsagenter

Port som ska användas vid anslutning till kopplingsagenten. Denna inställning kan inte ändras.

Tröskelvärde för fel på kopplingsagenten

Periodiska hälsokontroller utförs på Gateway med direktåtkomst-komponenterna. Ibland misslyckas hälsokontrollerna i början men fungerar senare. Om hälsokontrollerna fortsatt misslyckas efter det angivna tröskelvärdet kommer Gateway med direktåtkomst-tjänsten att startas om. Du bör endast ändra denna inställning om Qlik Support begär det.

Tidsgräns för begäran om laddning

Vid nätverksstörningar kan omladdningar misslyckas med följande fel:

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

Om felen ovan inträffar ofta kan du prova att öka timeouten till 5–10 minuter.

Loggningsnivå för kopplingsagent.

I felsökningssyfte kan du behöva ändra loggningsnivån för kopplingens agentkomponenter. Du bör endast ändra denna inställning om Qlik Support begär det.

Loggningsalternativ för kopplingsagenter

Om du vill felsöka problem med en specifik komponent i en agent för koppling kan du behöva välja motsvarande loggfil. Du bör endast ändra denna inställning om Qlik Support begär det.

Minne för cachelagrade datasegment

För varje omladdning kan Gateway med direktåtkomst cachelagra databitar i minnet och ladda om dem till disk (när storleken som tilldelats för cachelagring överskrids). Detta är särskilt användbart om du inte använder automatisk återställning och ofta drabbas av 4025-, 4020- och 4021-fel. När det angivna tröskelvärdet uppnås kommer gatewayen att avlasta nästkommande krypterade paket till Gateway med direktåtkomst-maskinens disk.

Tröskelvärde för återställningstid av datasegment

Det är här tröskelvärdet (i minuter) för datasegmentets återställningstid. Om inläsningen inte har återupptagits när threshold för återhämtningstiden har nåtts, kommer den att misslyckas med ett lämpligt meddelande.

Detta alternativ är användbart för inläsningar som annars skulle kunna överskrida gränsen på tre timmar, efter en lång återhämtning. Det tar exempelvis 90 minuter att hämta data från databasen, men så snart inläsningen startar skadas ett av segmenten. I det här fallet lagras alla segment i cacheminnet och skickas från cacheminnet. I ett sådant scenario kan hela inläsningsprocessen (lagring i cache + faktisk inläsning) ta tre timmar att slutföra.

Port för DCaaS

Port som ska användas vid anslutning till DCaaS. Denna inställning kan inte ändras.

Loggningsnivå för DCaaS

I felsökningssyfte kan du behöva ändra loggningsnivån för DCaaS-loggar. Du bör endast ändra denna inställning om Qlik Support begär det.

Kopplingsinställningar

Om du vill ändra inställningarna för kopplingen väljer du typ av koppling till vänster och ändrar sedan inställningarna efter behov.

Port

Port som ska användas vid anslutning till datakällan. Denna inställning kan inte ändras.

Loggningsnivå

I felsökningssyfte kan du behöva ändra loggningsnivån för kopplingsloggarna. Du bör endast ändra denna inställning om Qlik Support begär det.

Processisolering

Med processisolering kan administratörer med åtkomst till Gateway med direktåtkomst-serverns operativsystem styra hur många processer som är tillgängliga för inläsning per kopplingstyp. Att fördela laddningar på flera olika kopplingsprocesser ökar graden av isolering genom att minska antalet laddningar som körs samtidigt på varje kopplingsprocess. Detta kan i sin tur förbättra den övergripande stabiliteten för Gateway med direktåtkomst i sådana fall där krascher har inträffat.

Med en ren installation är processisolering aktiverat som standard. Standardantalet samtidiga inläsningar för varje kopplingstyp är nio. Du kan åsidosätta standardvärdena enligt beskrivningen i Antal samtida inläsningsprocesser nedan.

Inaktivering av processisolering

Qlik Support kan be dig att inaktivera processisolering i felsökningssyfte.

Välj Inaktiverad för att stänga av processisolering-

Antal samtidiga processer för laddning

Antalet samtidiga inläsningsprocesser som tilldelats kopplingen, inklusive kommandoprocessen. Exempelvis innebär ett värde på 30 maximalt 29 samtidiga inläsningar. Observera att denna inställning endast är relevant när processisolering är aktiverad.

Inläsningssessionens livslängd

Om kopplingen mellan Gateway med direktåtkomst och Qlik Cloud är inaktiv i 20 sekunder eller mer kan det hända att laddningsåtgärden misslyckas med följande fel:

Invalid object name '#<TempTableName>' (indicating that the Gateway med direktåtkomst temp tables are unavailable).

Standardtiden för sessionen är 20 sekunder, men om du ofta upplever detta fel kan du förlänga sessionens livslängd efter behov.

Maximalt antal tabeller som ska laddas ur

Max 10 000 tabeller hämtas ur databasen som standard. Du kan åsidosätta standardinställningarna om din databas innehåller fler än 10 000 tabeller.

Starta om Gateway med direktåtkomst efter att ha ändrat inställningarna

Vissa inställningar tillämpas först efter att tjänsten Gateway med direktåtkomst har startats om. I sådana fall kommer du att uppmanas att starta om tjänsten när du sparar dina inställningar. Om det finns aktiva inläsningar kommer du inte att kunna starta om tjänsten förrän de är slutförda. När det inte finns några aktiva omladdningar kan du starta om tjänsten när som helst enligt följande:

1. I din Qlik Cloud-klientorganisation navigerar du till Administration > Data gateways och letar upp din Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Starta om tjänst.

Du kan också starta om tjänsten direkt på Gateway med direktåtkomst-datorn, enligt beskrivningen i Starta, stoppa eller starta om tjänsten

Konfigurera Gateway med direktåtkomst direkt på Gateway med direktåtkomst-datorn

De flesta inställningar för Gateway med direktåtkomst kan konfigureras i Qlik Cloud, men vissa inställningar kan bara ändras genom att redigera konfigurationsfilerna direkt på Gateway med direktåtkomst-datorn

Åsidosätta standardkatalogen för cachesegment

För varje omladdning kan Gateway med direktåtkomst cachelagra databitar i minnet och ladda om dem till disk (när storleken som tilldelats för cachelagring överskrids). Du kan åsidosätta standardkatalogen för cachesegment (C:\ProgramData\Qlik\Gateway\tmp) om du inte har tillräckligt med diskutrymme på systemenheten.

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Hitta egenskapen för OVERRIDE_CHUNKS_CACHE_DIR och ställ in den på den katalog du vill ha.

   Exempel:

   OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

   Anteckning om informationAnge inte sökvägen inom citationstecken.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Se även: Minne för cachelagrade datasegment

Åsidosätt standarddatatypen Qlik Cloud när du arbetar med ODBC-koppling (via Gateway med direktåtkomst)

Ibland, på grund av ett problem med leverantörens ODBC-drivrutinshantering av källdatatyper, kommer antingen ett fel att inträffa under inläsningen eller felaktiga data att laddas till Qlik Cloud. I sådana fall kan du åsidosätta Qlik Cloud-datatypen eller dess specifikation (t.ex. skala eller precision).

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\custom_type_mappings.json som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt. Den här filen innehåller ett exempel på en källa till Qlik Cloud-datatyper.

2. Lägg till ett delavsnitt som mappar den problematiska datatypen till den önskade Qlik Cloud-datatypen.

   I följande exempel (som ingår i filen custom_type_mappings.json) behöver kunden ändra storleken på Qlik Cloud DateTime-datatypen till 27.

    

3. Spara filen custom_type_mappings.json och starta om tjänsten Qlik Data Gateway – direktåtkomst.
4. Ladda om data.

Tvingar Gateway med direktåtkomst att återansluta till Qlik Cloud

Om Gateway med direktåtkomst kopplas bort från Qlik Cloud ska den som standard återanslutas efter 45 sekunder. Om du märker att det tar betydligt längre tid kan du tvinga gatewayen att återansluta tidigare.

För att göra detta:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt. Den här filen innehåller ett exempel på en källa till Qlik Cloud-datatyper.

2. Lägg till AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> i delavsnittet # Connector Agent i början av filen.

    

   Exempel:

   {
   "Identifier": "Amazon Athena ODBC (x64)",
   "NativeDataType": "timestamp with time zone",
   "QlikDataType": "DateTime",
   "Size": 27,
   "IsBit": false
   }

   AGENT_PONG_TIMEOUT_SECONDS=30

   Anteckning om informationMinsta tid är 30 sekunder.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Utföra begäran om inläsningsdata asynkront

Att utföra begäran om inläsningsdata asynkront i agenten förkortar den tid molntjänsten behöver vänta på svar från agenten signifikant.

För att aktivera asynkrona begäranden om inläsningsdata:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Lägg till följande rad i filen:

   OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

3. Spara filen configuration.properties.

För att inaktivera asynkrona begäranden om inläsningsdata:

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Ersätt AsyncLoadDataRequest med None enligt följande:

   OPTIONAL_CAPABILITIES=None

3. Spara filen configuration.properties.

Tillåter kopplingar till localhost med REST-kopplingen (via Gateway med direktåtkomst)

Du kan tillåta REST-kopplingen (via Gateway med direktåtkomst) att ansluta till localhost. Detta underlättar användningen av lokala (för gateway-servern) REST-slutpunkter, såsom slutpunkten connector-agent/status för att fastställa det aktiva antalet belastningar på en agent.

1. Använd en textredigerare för att öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa > Dolda objekt vara valt.

2. Ange REST_ALLOW_LOCALHOST_CONNECTION=true (ange till false för att inaktivera denna funktion)

3. Spara filen configuration.properties.

Mer detaljer i felmeddelanden vid koppling till ODBC-datakällor

På grund av säkerhetsskäl innehåller standardfelmeddelandet som returneras av ODBC-drivrutinen minimal information. I vissa scenarier kan du dock behöva mer information för att felsöka ett specifikt problem. Om du vill få ett mer detaljerat felmeddelande lägger du till egenskapen ShowErrorDetailMessage i delavsnittet Avancerat i dialogrutan för kopplingen och ställer in den på True. När du har löst ditt problem rekommenderas det starkt att du antingen tar bort egenskapen eller ställer in den på False för optimal säkerhet.

Visa och ladda ner loggfiler

Loggfilerna innehåller information om åtgärder i Gateway med direktåtkomst. Qlik Supporten kan be dig att tillhandahålla loggfiler för att felsöka. Du kan visa eller ladda ner loggfiler i loggvisaren. Normalt finns det ingen anledning att gå igenom loggfiler men om det upptår återkommande fel eller andra problem kan loggfilerna ofta hjälpa till att identifiera orsaken.

Öppna loggvisaren:

1. Gå till Datagateways i aktivitetscentret för Administration och leta upp Gateway med direktåtkomst.

2. Klicka på i slutet av raden och välj Visa loggar.

   Fönstret med loggvisaren öppnas.

3. I listrutan uppe till vänster väljer du typ av logg som Qlik-supporten har bett dig visa eller ladda ner.

   Följande loggar är tillgängliga:

   • Gateway med direktåtkomst-loggar (DirectAccessAgent)
   • DCaaS-loggar (dcaas_logs)
   • ODBC-baserade kopplingsloggar (odbc-connector_logs)
   • SAP BW-kopplingsloggar (QvSAPBwConnector-<datum + tidsmarkör>)
   • SAP SQL-kopplingsloggar (QvSqlBwConnector-<datum + tidsmarkör>)

   • Loggar för kopplingsagenter (connector-agent_logs_<datum>)

   • Kopplingsloggar för SAP ODP (QvSapConnectorPackage-<process_id>)

   • Loggar för REST-koppling (rest-connector_logs_<tidsmarkör>)

   • Loggar för filkoppling (file-connector_logs_<tidsmarkör>)

   Anteckning om informationFrån och med Gateway med direktåtkomst 1.7.1 skrivs start-, avslutnings- och omstartshändelser för kopplingar till loggfilen Gateway med direktåtkomst(DirectAccessAgent). I tidigare versioner skrevs de till loggfilen Loggar för kopplingsagenter (connector-agent_logs_<date>).

4. I listrutan bredvid kan du välja loggen som du vill visa eller ladda ner. Loggfilerna är ordnade från nyaste (den vid tillfället aktiva loggfilen) till den äldsta. När du väljer loggfil kan du använda knapparna och för att hoppa till början eller slutet av loggfilen.

   Anteckning om tipsVyn för loggfilen uppdateras inte automatiskt med de senaste meddelandena. För att uppdatera klickar du på för att rulla till slutet av loggfilen som uppdaterats med de senaste meddelandena.

5. Klicka på Ladda ner för att ladda ner loggfilen.

   Filen kommer antingen att laddas ner till din dator eller så kommer du att bli ombedd att spara den, beroende på din webbläsarinställningar.

Öppna Gateway med direktåtkomst-loggar på Gateway med direktåtkomst-maskinen

Förutom att kunna hämta Gateway med direktåtkomst-loggarna (DirectAccessAgent) från aktivitetscentret för Administration kan du även öppna dem direkt frånGateway med direktåtkomst-maskinen. Med en standardinstallation finns dessa loggar på följande platser:

C:\Programfiler\Qlik\ConnectorAgent\data\logs

Ändra loggningsnivån för DirectAccessAgent

I felsökningssyfte kan du behöva ändra loggningsnivån för DirectAccessAgent-loggar. DirectAccessAgent ansvarar för kopplingen till Qlik Cloud-tjänster. För att visa och ändra loggningsdetaljnivån för DirectAccessAgent-loggarna kör du följande kommando från undermappen i ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent med en standardinstallation):

• För att visa den aktuella loggningsnivån kör du:

  connectoragent configuration getloggers

• För att ställa in loggningsnivån till Trace kör du:

  connectoragent configuration setloggers -l Root -v DEBUG

• För att ställa in loggningsnivån till Verbose kör du:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Ytterligare loggningsalternativ finns i Konfigurera Gateway med direktåtkomst i Qlik Cloud nedan.

Uppdatera registreringsnyckeln

Trots att det är osannolikt så kan det hända att nyckeln blir skadad eller så kan det finnas misstanke om obehörig åtkomst av datagatewayservern och det är då nödvändigt att ändra registreringsnyckeln.

För att uppdatera registreringsnyckeln:

1. På gatewayservern för direktåtkomst ska du öppna ett kommandofönster och ändra arbetskatalogen till ConnectorAgent-undermappen (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent med en standardinstallation).

2. Kör sedan följande kommando:

   • Generera den nya nyckeln:

     connectoragent qcs generate_keys

   • Visa nyckeln:

     connectoragent qcs get_registration

     Nyckeln visas:

     

3. Kopiera hela nyckeln så som visas i exemplet ovan.

4. I aktivitetscentret för Administration öppnar du inställningarna för datagateway genom att klicka på -knappen i slutet av relevant rad och välja Redigera.

5. Klistra in nyckeln i Nyckel-fältet (och byt ut aktuell nyckel) och spara inställningarna.

6. Gå tillbaka till gatewayservern för direktåtkomst och starta om Qlik Data Gateway – direktåtkomst-tjänsten så som beskrivs i Hantera Qlik Data Gateway – direktåtkomst-tjänsten.