Probleemoplossing Gateway voor directe toegang

In deze sectie worden de verschillende acties beschreven om problemen met Gateway voor directe toegang op te lossen.

Logbestanden weergeven en downloaden

De logbestanden geven informatie over Gateway voor directe toegang-bewerkingen. Qlik Support kan u vragen om deze logbestanden te verstrekken voor probleemoplossing. U kunt de logbestanden weergeven of downloaden in de logboekweergave. Onder normale omstandigheden is er geen reden om de logbestanden te bekijken, maar als u herhaaldelijk fouten of andere problemen hebt, kunnen de logbestanden vaak aangeven wat de oorzaak is.

De logboekweergave openen:

1. Ga in het Beheer-activiteitencentrum naar Gegevensgateways en zoek uw Gateway voor directe toegang.

2. Klik op de knop aan het einde van een rij en selecteer logboeken weergeven.

   Het venster logboekweergave wordt geopend.

3. Kies bovenaan links in de vervolgkeuzelijst het type logboek waar Qlik-support u om heeft gevraagd. U kunt het weergeven of downloaden.

   De volgende logboeken zijn beschikbaar:

   • Gateway voor directe toegang-logboeken (DirectAccessAgent)
   • DCaaS logs (dcaas_logs)
   • Logboeken ODBC-gebaseerde connector (odbc-connector_logs)
   • Logboeken SAP BW-connector (QvSAPBwConnector-<datum + tijdstempel>)
   • Logboeken SAP ODP-connector (QvSapConnectorPackage-<process_id>)
   • Logboeken SAP SQL-connector (QvSqlBwConnector-<datum + tijdstempel>)
   • Logboeken connector-agent (connector-agent_logs_<datum>)

4. Selecteer het logboek dat u wilt weergeven of downloaden in de bijbehorende vervolgkeuzelijst. De logbestanden worden op volgorde van nieuwste (het actuele, actieve logbestand) naar oudste gerangschikt. Nadat u een logbestand hebt geselecteerd, kunt u de knoppen en gebruiken om naar het begin of het eind van het logbestand te springen.

   TipDe weergave van het logboekbestand wordt niet automatisch met de laatste berichten bijgewerkt. Als u de weergave wilt bijwerken, klikt u op om naar het einde van het logboekbestand te springen dat wordt bijgewerkt met de nieuwste berichten.

5. Om het logbestand te downloaden, klikt u op Downloaden.

   Het bestand wordt gedownload naar uw computer of u wordt gevraagd het op te slaan, afhankelijk van uw browserinstellingen.

Gateway voor directe toegang-logboeken openen op de Gateway voor directe toegang-machine

Naast dat u de Gateway voor directe toegang-logboeken (DirectAccessAgent) vanuit het Beheer-activiteitencentrum kunt downloaden, kunt u ze ook rechtstreeks vanaf de Gateway voor directe toegang-machine openen. In het geval van een standaardinstallatie bevinden deze zich in de volgende map:

C:\Program Files\Qlik\ConnectorAgent\data\logs

Het detailniveau van logboekregistratie wijzigen

U kunt zo nodig het detailniveau van de logboekregistratie van de Gateway voor directe toegang-logboeken (DirectAccessAgent) wijzigen. Volg de volgend opdrachten uit vanuit de submap ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent in het geval van een standaardinstallatie).

• Als u het huidige niveau van logboekregistratie wilt bekijken, voert u het volgende uit:

  connectoragent configuration getloggers

• Als u het niveau van logboekregistratie wilt instellen in Trace, voert u het volgende uit:

  connectoragent configuration setloggers -l Root -v DEBUG

• Als u het niveau van logboekregistratie wilt instellen in Verbose, voert u het volgende uit:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

De registratiesleutel bijwerken

Het is mogelijk vereist om de registratiesleutel te wijzigen in het onwaarschijnlijke geval dat de sleutel corrupt raakt of u vermoedt dat een onbevoegde gebruiker toegang tot de server van de gegevensgateway heeft verkregen.

Ga als volgt te werk om de registratiesleutel bij te werken:

1. Op de server met de gateway voor directe toegang, opent u een opdrachtprompt als een beheerder en wijzigt u de werkmap in de submap ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent met een standaardinstallatie).

2. Voer de volgende opdrachten uit:

   • De nieuwe sleutel genereren:

     connectoragent qcs generate_keys

   • De sleutel weergeven:

     connectoragent qcs get_registration

     De sleutel wordt getoond:

     

3. Kopieer de volledige sleutel zoals in het bovenstaande voorbeeld wordt getoond.

4. In het Beheer-activiteitencentrum opent u de instellingen van de gegevensgateway door op de knop te klikken aan het einde van de relevante rij en Bewerken te selecteren.

5. Plak de sleutel in het veld Sleutel (hiermee wordt de huidige sleutel vervangen) en sla de instellingen op.

6. Ga terug naar de server van de gateway voor directe toegang en start de Qlik Gegevensgateway - Directe toegang-service opnieuw, zoals beschreven in De Qlik Gegevensgateway - Directe toegang-service beheren.

Levensduur van de laadsessie verlengen

Als de verbinding tussen Gateway voor directe toegang en Qlik Cloud 20 seconden of meer inactief is, mislukte de laadbewerking soms met de volgende fout:

Invalid object name '#<TempTableName>' (indicating that the Gateway voor directe toegang temp tables are unavailable).

De standaard levensduur van de sessie is 20 seconden, maar als deze fout regelmatig optreedt, kunt u de levensduur van de sessie als volgt verlengen:

1. Open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Verborgen bestanden, mappen en stations is geselecteerd.

2. Zoek de parameter ODBC_RELOAD_SESSION_LIFE en verhoog de waarde zoals vereist.
3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

De time-out voor laadaanvragen verlengen

Als de netwerkverbinding wordt onderbroken, kunnen ladingen mislukken met de volgende fouten:

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

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

Treden de bovenstaande fouten regelmatig op, stel dan de parameter EXTEND_FIRST_REQUEST_TIMEOUT in op 5-10 minuten.

Voor de volgende actie:

1. Open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Verborgen bestanden, mappen en stations is geselecteerd.

2. Zoek de parameter EXTEND_FIRST_REQUEST_TIMEOUT en verhoog de waarde naar 5-10 minuten. De standaardwaarde is 0.
3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Connectoruitval tijdens ladingen beperken

Procesisolatie stelt beheerders met directe toegang tot het besturingssysteem van de gatewayserver in staat om te beheren hoeveel processen beschikbaar zijn per connectortype voor ladingen. Het spreiden van ladingen over meerdere connectorprocessen verhoogt het isolatieniveau doordat het aantal ladingen wordt verminderd dat gelijktijdig in elk connectorproces wordt uitgevoerd. Dit kan op zijn beurt de algemene stabiliteit van Gateway voor directe toegang verbeteren in gevallen waarbij connectoruitval heeft plaatsgevonden.

Procesisolatie uitschakelen

Qlik Support kan u vragen om procesisolatie uit te schakelen om problemen op te lossen.

Procesisolatie uitschakelen:

1. Open het bestand C:\ProgramData\Qlik\Gateway\configuration.properties. Als u dit via Windows Verkenner doet, moet u controleren of Verborgen bestanden, mappen en stations is geselecteerd

2. Stel [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Aan alle rijen kleur toekennen per voorwaarde) in op None (Opgegeven rijen).

3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Procesisolatie inschakelen van procesisolatie of het aantal gelijktijdige ladingen wijzigen

Ga als volgt te werk om procesisolatie in te schakelen of het aantal gelijktijdige ladingen te wijzigen:

1. Open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Verborgen bestanden, mappen en stations is geselecteerd.

   Het bestand bevat drie prefixen die overeenkomen met de verschillende connectortypen:ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> en SAPPACKAGE_<property-name>.

2. Stel [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE in op Load en [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT op N.

   Waarbij:

   N = Één opdrachtproces + het aantal gelijktijdig toe te wijzen herlaadprocessen. Bijvoorbeeld: een waarde van 10 zou maximaal 9 gelijktijdige ladingen betekenen.

3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Voorbeelden van ODBC-connectorprocesisolatie

De volgende passage uit het bestand configuration.properties laat zien hoe de ODBC-connectorprocesisolatie voor maximaal 12 ladingen kan worden ingeschakeld:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

Vanaf Gateway voor directe toegang versie 1.6.7 kan de waarde MAX_PROCESS_COUNT groter zijn dan 10 zonder dat andere instellingen hoeven te worden gewijzigd. Om ladingen met een bepaald type connector volledig te isoleren (dat wil zeggen, niet meer dan één keer opnieuw laden per connectorproces), moet deze waarde worden ingesteld op een minimum van 30, maar het kan nodig zijn om hem zo hoog als 60 in te stellen, afhankelijk van de werklast.

Beschadigde of ontbrekende data chunks opslaan voor toekomstige ladingen

Voor elke laadbewerking kan Gateway voor directe toegang beschadigde of ontbrekende data chunks opslaan in het geheugen en offloaden naar de schijf. Dit is met name handig als u geen automatisch herstel gebruikt en regelmatig last hebt van 4025-, 4020- en 4021-fouten. U schakelt deze functie in door de drempelwaarde voor de cachegrootte in te stellen voor het offloaden van beschadigde of ontbrekende data chunks naar de schijf (per lading). Nadat de opgegeven drempelwaarde is bereikt, offloadt de gateway de volgende versleutelde chunks naar de schijf van de Gateway voor directe toegang-machine.

De cachegrootte instellen:

1. Open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Verborgen bestanden, mappen en stations is geselecteerd.

2. Stel RELOAD_CACHE_MEMORY_MB in op N (de standaardinstelling is 0, wat betekent dat de functie niet is ingeschakeld).

   Waarbij:

   N = de grootte die een data chunk kan bereiken voordat het wordt geladen.

   InformatieDoor het inschakelen van deze functie neemt het geheugenverbruik toe op de Gateway voor directe toegang-machine. We raden daarom aan om de impact op het geheugen bij te houden als deze functie is ingeschakeld. De waarde van RELOAD_CACHE_MEMORY_MB instellen op 100 werkt in de meeste situaties.
3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.