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 de Beheerconsole 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 op ODBC gebaseerde connector (odbc-connector_logs)
   • Logboeken SAP BW-connector (QvSAPBwConnector-<datum + tijdstempel>)
   • 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 de Beheerconsole 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 de Beheerconsole 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.

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 inschakelen:

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

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

2. Stel ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE in op Laden en ODBC|SAPBW|SAPSQL_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.

   Informatie

   U kunt de waarde bij [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT niet hoger instellen dan 10 met de standaardinstellingen voor poort en bereik.

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

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_PROCESS_ISOLATION_MODE in op Geen.

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 9 ladingen kan worden ingeschakeld:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

Als u de standaardpoortinstellingen wijzigt, kan de MAX_PROCESS_COUNT-waarde hoger worden dan 10. Maar in dit geval:

• Het aantal van de poorten ODBC_PORT of ODBC_DATA_PORT_RANGE_START en SAPBW_PORT of SAPBW_DATA_PORT_RANGE_START moet gelijk zijn aan of groter zijn dan ODBC_MAX_PROCESS_COUNT

• Het aantal van de poorten SAPBW_PORT of SAPBW_DATA_PORT_RANGE_START en SAPSQL_PORT of SAPSQL_DATA_PORT_RANGE_START moet gelijk zijn aan of groter zijn dan SAPBW_MAX_PROCESS_COUNT

Als u bijvoorbeeld ODBC_MAX_PROCESS_COUNT=30 instelt, moeten de poortparameters er ongeveer zo uitzien:

# 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