Ga naar hoofdinhoud Ga naar aanvullende inhoud

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.

InformatieVoor het bekijken en downloaden van de logboeken is de rol Kan gegevens gebruiken vereist.

De logboekweergave openen:

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

  2. Klik op de knop Meer 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 Pijl om naar boven te scrollen en Pijl om naar beneden te scrollen 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 Pijl om naar beneden te scrollen 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 niveau van logboekregistratie wijzigen

WaarschuwingWijzig het logboekregistratieniveau alleen als een vertegenwoordiger van Qlik Support u dit heeft geadviseerd.

U kunt het logboekregistratieniveau van de Gateway voor directe toegang-logboeken wijzigen zoals hieronder beschreven.

Het logboekregistratieniveau van connectorcomponenten wijzigen

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de logboeken van de connectorcomponenten wijzigen.

Ga als volgt te werk:

  1. Open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.
  2. Volg de <COMPONENT>_LOG_LEVEL eigenschap, waarbij COMPONENT een van de volgende kan zijn:

    • AGENT
    • DCAAS
    • ODBC
    • SAPBW
    • SAPSQL
    • SAPPACKAGE
    • FILE
  3. Stel dit in op een van de volgende: ERROR, WARN, INFO of DEBUG
  4. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

    InformatieVanaf Gateway voor directe toegang 1.7.1 hoeft u de service Qlik Gegevensgateway - Directe toegang niet opnieuw te starten als u alleen het onderdeel AGENT hebt gewijzigd.

Het logboekregistratieniveau van DirectAccessAgent wijzigen

Voor het oplossen van problemen moet u misschien het logboekregistratieniveau van de DirectAccessAgent-logboeken wijzigen. DirectAccessAgent is verantwoordelijk voor de verbinding met Qlik Cloud-services. Om het detailniveau van logboekregistratie te tonen en wijzigen, voert u de volgende 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:

      Afbeelding van de Direct Access-registratiesleutel

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

InformatieDe parameterwaarde wordt weergegeven in 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.

Informatie

Vereist Gateway voor directe toegang 1.6.1 of later.

Procesisolatie uitschakelen

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

InformatieBij een nieuwe installatie is procesisolatie standaard ingeschakeld. Het standaard aantal gelijktijdige ladingen voor elk type connector is 9. U kunt de standaardwaarden wijzigen zoals beschreven in Procesisolatie inschakelen van procesisolatie of het aantal gelijktijdige ladingen wijzigen hieronder.

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

 

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

Gegevens in cache opslaan om opnieuw te laden in geval van een probleem

Voor elke laadoperatie kan Gateway voor directe toegang data chunks in het geheugen cachen en ze naar de schijf overbrengen (wanneer de grootte die voor caching is toegewezen, overschreden wordt). 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 overbrengen van 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.

InformatieVereist Gateway voor directe toegang 1.6.8 of hoger.

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 hoeveelheid geheugen die is toegewezen voor het cachen van data chunks (per lading)

    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.
InformatieOm prestatievermindering door samenvoeging van onnodige bestanden te voorkomen, worden verwerkte data chunks verwijderd uit het geheugen en de schijf van de machine.

De standaard cachemap voor chunks overschrijven

InformatieVereist Gateway voor directe toegang 1.7.1 of hoger.

Voor elke laadoperatie kan Gateway voor directe toegang data chunks in het geheugen cachen en ze naar de schijf overbrengen (wanneer de grootte die voor caching is toegewezen, overschreden wordt). U kunt de standaard cachemap voor chunks(C:ProgramData\Gateway\tmp) overschrijven als u niet genoeg schijfruimte op het systeemstation heeft.

InformatieOm stabiliteit te garanderen en prestaties te optimaliseren, kunt u het beste alleen lokale paden te gebruiken.

U doet dit als volgt:

  1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd.
  2. Zoek de eigenschap OVERRIDE_CHUNKS_CACHE_DIR en stel deze in op de map van uw keuze.

    Voorbeeld:

    OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

    InformatieZet het pad niet tussen aanhalingstekens.
  3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Het standaard Qlik Cloud-gegevenstype overschrijven wanneer u met de ODBC (via Gateway voor directe toegang) connector werkt.

InformatieVereist Gateway voor directe toegang 1.7.1 of hoger.

Soms, als gevolg van een probleem met de verwerking van gegevensbrontypen door het ODBC-stuurprogramma van de leverancier, treedt er een fout op tijdens het opnieuw laden of worden er onjuiste gegevens geladen naar Qlik Cloud. In dergelijke gevallen kunt u het gegevenstype Qlik Cloud of de specificatie ervan (schaal of precisie, bijvoorbeeld) overschrijven.

WaarschuwingHoewel veel problemen kunnen worden opgelost door eenvoudig QlikDataType te wijzigen in String, raden wij u aan om, als dit niet mogelijk is, contact op te nemen met Qlik Support voor advies over de Qlik Cloud-gegevenstypen waaraan het brongegevenstype kan worden toegewezen.

U doet dit als volgt:

  1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\custom_type_mapping.json als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd. Dit bestand bevat een voorbeeldbron voor Qlik Cloud-gegevenstypen.
  2. Voeg een sectie toe die het problematische gegevenstype toewijst aan het gewenste Qlik Cloud-gegevenstype.

    In het volgende voorbeeld (dat is opgenomen in het bestand custom_type_mapping.json ) moet de klant de grootte van het Qlik Cloud DateTime gegevenstype wijzigen in 27.

    {

    "Identifier": "Amazon Athena ODBC (x64)",

    "NativeDataType": "timestamp with time zone",

    "QlikDataType": "DateTime",

    "Size": 27,

    "IsBit": false

    }

  3. Sla het custom_type_mapping.json bestand op en herstart de Qlik Gegevensgateway - Directe toegang service.
  4. Laad de gegevens opnieuw.

Gateway voor directe toegang dwingen om opnieuw verbinding te maken met Qlik Cloud

Als de verbinding tussen Gateway voor directe toegang en Qlik Cloud wordt verbroken, wordt de verbinding standaard na 45 seconden hersteld. Als u merkt dat het aanzienlijk langer duurt, kunt u de gateway dwingen om eerder opnieuw verbinding te maken.

U doet dit als volgt:

  1. Gebruik een teksteditor en open C:\ProgramData\Qlik\Gateway\configuration.properties als beheerder. Als u dit via Windows Verkenner doet, moet u controleren of Weergeven > Verborgen items is geselecteerd. Dit bestand bevat een voorbeeldbron voor Qlik Cloud-gegevenstypen.
  2. Voeg AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> toe aan de sectie # Connector Agent aan het begin van het bestand.

    Voorbeeld:

    AGENT_PONG_TIMEOUT_SECONDS=30

    InformatieDe minimale tijd is 30 seconden.
  3. Sla het bestand configuration.properties op en start de Qlik Gegevensgateway - Directe toegang-service opnieuw op.

Foutberichtdetail vergroten bij verbinding met ODBC-gegevensbronnen

Uit veiligheidsoverwegingen bevat het standaardfoutbericht van de ODBC-driver minimale informatie. In bepaalde scenario's hebt u echter meer informatie nodig om een specifiek probleem op te lossen. Voor een meer gedetailleerde foutmelding voegt u de eigenschap ShowErrorDetailMessage toe aan de sectie Geavanceerd in het dialoogvenster van de connector en stelt u deze in op True. Zodra u uw probleem hebt opgelost, is het voor een optimale beveiliging sterk aanbevolen om de eigenschap te verwijderen of in te stellen op False.

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!