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:
-
I Hanteringskonsol går du till Data gateways och söker reda på Gateway med direktåtkomst.
-
Klicka på i slutet av raden och välj Visa loggar.
Fönstret med loggvisaren öppnas.
-
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>)
-
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. -
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 Hanteringskonsol 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:
- 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).
-
Kör sedan följande kommando:
-
Generera den nya nyckeln:
connectoragent qcs generate_keys
-
Visa nyckeln:
connectoragent qcs get_registration
Nyckeln visas:
-
-
Kopiera hela nyckeln så som visas i exemplet ovan.
-
I Hanteringskonsol öppnar du inställningarna för datagatewayen genom att klicka på -knappen i slutet av relevant rad och välja Redigera.
-
Klistra in nyckeln i Nyckel-fältet (och byt ut aktuell nyckel) och spara inställningarna.
-
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.
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.
Kräver Gateway med direktåtkomst 1.6.1 eller senare.
För att slå på processisolering:
-
Ö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.
Filen innehåller tre prefix som motsvarar de olika kopplingstyperna: ODBC_<egenskap-namn>, SAPBW_<egenskap-namn> och SAPSQL_<egenskap-namn>.
-
Ställ in ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE till Load och ODBC|SAPBW|SAPSQL_MAX_PROCESS_COUNT till N.
Där:
N = En kommandoprocess + antalet samtidiga laddningsprocesser som ska allokeras. Exempelvis innebär ett värde på 10 maximalt 9 samtidiga laddningar.
Anteckning om informationDu kan inte ställa in värdet [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT högre än 10 med standardportnumret och intervalluppsättningarna.
- Spara filen configuration.properties och starta om tjänsten Qlik Data Gateway – direktåtkomst.
För att stänga av processisolering:
- Ö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.
-
Ställ in ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE till None.
- 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 nio laddningar aktiveras:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=10
Om du ändrar standardportinställningarna kan MAX_PROCESS_COUNT-värdet överskrida 10. Men i det här fallet:
-
Antalet portar mellan ODBC_PORT eller ODBC_DATA_PORT_RANGE_START och SAPBW_PORT eller SAPBW_DATA_PORT_RANGE_START måste vara lika med eller större än ODBC_MAX_PROCESS_COUNT
-
Antalet portar mellan SAPBW_PORT eller SAPBW_DATA_PORT_RANGE_START och SAPSQL_PORT eller SAPSQL_DATA_PORT_RANGE_START måste vara lika med eller större än SAPBW_MAX_PROCESS_COUNT
För att exempelvis ställa in ODBC_MAX_PROCESS_COUNT=30 ska portparametrarna därför se ut ungefär så här:
# ODBC Connector
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=30
ODBC_DATA_PORT_RANGE_START=50260
ODBC_PORT=3005
# SAP BW Connector
SAPBW_PROCESS_ISOLATION_MODE=None
SAPBW_MAX_PROCESS_COUNT=0
SAPBW_DATA_PORT_RANGE_START=50290
SAPBW_PORT=3035
# SAP SQL Connector
SAPSQL_PROCESS_ISOLATION_MODE=None
SAPSQL_MAX_PROCESS_COUNT=0
SAPSQL_DATA_PORT_RANGE_START=50300
SAPSQL_PORT=3045