Felsökning Gateway med direktåtkomst

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

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 ODP-kopplingsloggar (QvSapConnectorPackage-<process_id>)
   • SAP SQL-kopplingsloggar (QvSqlBwConnector-<datum + tidsmarkör>)
   • Loggar för kopplingsagenter (connector-agent_logs_<datum>)

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ån Gateway med direktåtkomst-maskinen. Med en standardinstallation finns dessa loggar på följande platser:

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

Ändra detaljnivån vid loggning

Du kan visa och ändra detaljnivån vid loggning för Gateway med direktåtkomst-loggar (DirectAccessAgent) efter behov. För att göra det 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

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.

Utöka laddningssessionens 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 på följande sätt:

1. Öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa dolda filer, mappar och enheter vara valt.

2. Leta upp ODBC_RELOAD_SESSION_LIFE-parametern och öka dess värde efter behov.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Förlänga tidsgränsen för laddningsbegäran

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 ställa in parametern EXTEND_FIRST_REQUEST_TIMEOUT på 5–10 minuter.

För att göra detta:

1. Öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa dolda filer, mappar och enheter vara valt.

2. Leta upp EXTEND_FIRST_REQUEST_TIMEOUT-parametern och öka dess värde till 5–10 minuter. Standardvärdet är 0.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Minska antalet kopplingskrascher under laddning

Med processisolering kan administratörer med direkt åtkomst till gateway-serverns operativsystem styra hur många processer som är tillgängliga för laddningar 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.

Inaktivera processisolering

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

För att stänga av processisolering:

1. Öppna filen C:\ProgramData\Qlik\Gateway\configuration.properties. Om du gör detta via utforskaren i Windows måste Visa dolda filer, mappar och enheter vara valt.

2. Ställ in [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Färglägg alla rader efter villkor) som None (Specificerade rader).

3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Aktivera processisolering eller ändra antalet samtidiga inläsningar

För att aktivera processisolering eller ändra antalet samtidiga inläsningar:

1. Öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa dolda filer, mappar och enheter vara valt.

   Filen innehåller tre prefix som motsvarar de olika kopplingstyperna: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> och SAPPACKAGE_<property-name>.

2. Ställ in [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE på Load och [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT på N.

   Där:

   = En kommandoprocess + antalet samtidiga laddningsprocesser som ska allokeras.N Exempelvis innebär ett värde på 10 maximalt 9 samtidiga laddningar.

3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.

Exempel på processisolering av ODBC-koppling

Följande utdrag ur configuration.properties-filen visar hur processisolering av ODBC-kopplingen för upp till 12 inläsningar aktiveras:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

Från och med Gateway med direktåtkomst version 1.6.7 kan MAX_PROCESS_COUNT-värdet överstiga 10 utan att andra inställningar behöver ändras. För att helt isolera laddningar med en viss typ av koppling (det vill säga inte mer än en laddning per kopplingsprocess) bör detta värde sättas till minst 30, men du kan behöva sätta det så högt som 60 beroende på arbetsbelastningen.

Lagra skadade eller saknade datapaket för framtida återladdning

För varje återladdningsåtgärd kan Gateway med direktåtkomst lagra skadade eller saknade datapaket i minnet och överföra dem till disk. Detta är särskilt användbart om du inte använder automatisk återställning och ofta drabbas av 4025-, 4020- och 4021-fel. Du aktiverar den här funktionen genom att ställa in tröskelvärdet för cachestorleken för avlastning av skadade eller saknade datapaket till disk (per återladdning). När det angivna tröskelvärdet uppnås kommer gatewayen att avlasta nästkommande krypterade paket till Gateway med direktåtkomst-maskinens disk.

Så här ställer du in cachestorleken:

1. Öppna C:\ProgramData\Qlik\Gateway\configuration.properties som admin. Om du gör detta via utforskaren i Windows måste Visa dolda filer, mappar och enheter vara valt.

2. Ställ in RELOAD_CACHE_MEMORY_MB på N (Standardvärdet är 0, vilket innebär att funktionen inte är aktiverad).

   Där:

   N = Den storlek som ett datapaket kan uppnå innan det laddas om.

   Anteckning om informationOm du aktiverar den här funktionen ökar minnesförbrukningen på Gateway med direktåtkomst-maskinen, så vi rekommenderar att du övervakar påverkan på minnet medan den är aktiverad. Att ställa in RELOAD_CACHE_MEMORY_MB-värdena på 100 bör vara tillräckligt i de flesta situationer.
3. Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.