Fehlerbehebung Direct Access Gateway

In diesem Abschnitt werden verschiedene Aktionen beschrieben, die Sie zur Fehlerbehebung in Direct Access Gateway anwenden können.

Anzeigen und Herunterladen von Protokolldateien

Die Protokolldateien bieten Informationen über Vorgänge für Direct Access Gateway. Qlik Der Support bittet Sie möglicherweise darum, diese Protokolle zur Fehlerbehebung bereitzustellen. Sie können die Protokolldateien im Protokoll-Viewer anzeigen oder herunterladen. Unter normalen Umständen ist es nicht erforderlich, die Protokolldateien zu prüfen. Wenn aber häufig Ausfälle oder andere Probleme auftreten, können die Protokolldateien bei der Ursachenermittlung helfen.

So öffnen Sie den Protokoll-Viewer:

1. Gehen Sie im Aktivitätscenter Verwaltung zu Daten-Gateways und suchen Sie nach Ihrem Direct Access Gateway.

2. Klicken Sie auf die Schaltfläche am Ende der Zeile und wählen Sie Protokolle anzeigen aus.

   Das Fenster Protokoll-Viewer wird geöffnet.

3. Wählen Sie aus der Dropdown-Liste oben links den Protokolltyp aus, den Ihnen der Qlik Support genannt hat, um ihn anzuzeigen oder herunterzuladen.

   Folgende Protokolle sind verfügbar:

   • Direct Access Gateway-Protokolle (DirectAccessAgent)
   • DCaaS-Protokolle (dcaas_logs)
   • ODBC-basierte Konnektorprotokolle (odbc-connector_logs)
   • SAP BW-Konnektorprotokolle (QvSAPBwConnector-<Datum + Zeitstempel>)
   • SAP ODP-Konnektorprotokolle (QvSapConnectorPackage-<prozess_id>)
   • SAP SQL-Konnektorprotokolle (QvSqlBwConnector-<Datum + Zeitstempel>)
   • Konnektor-Agent-Protokolle (connector-agent_logs_<Datum>)

4. Wählen Sie aus der danebenliegenden Dropdown-Liste das Protokoll aus, das Sie anzeigen oder herunterladen möchten. Die Protokolldateien sind von der neuesten (der derzeit aktiven Protokolldatei) bis zur ältesten sortiert. Nachdem Sie eine Protokolldatei ausgewählt haben, können Sie die Schaltflächen und verwenden, um zum Anfang bzw. zum Ende der Protokolldatei zu springen.

   TipphinweisDie Ansicht der Protokolldatei wird nicht automatisch mit den neuesten Meldungen aktualisiert. Um die Ansicht zu aktualisieren, klicken Sie auf , um zum Ende der Protokolldatei zu springen, die mit den neuesten Meldungen aktualisiert wurde.

5. Zum Herunterladen der Protokolldatei klicken Sie auf Herunterladen.

   Abhängig von Ihren Browsereinstellungen wird die Datei entweder auf Ihren Computer heruntergeladen, oder Sie werden aufgefordert, sie zu speichern.

Öffnen von Direct Access Gateway-Protokollen auf dem Direct Access Gateway-Computer

Sie können die Direct Access Gateway-Protokolle (DirectAccessAgent) nicht nur vom Aktivitätscenter Verwaltung herunterladen, sondern sie auch direkt auf dem Direct Access Gateway-Computer öffnen. In einer Standardinstallation befinden sich diese Protokolle in folgendem Verzeichnis:

C:\Programme\Qlik\ConnectorAgent\data\logs

Ändern der Protokollierungsdetailstufe

Sie können die Protokollierungsdetailstufe des Direct Access Gateway (DirectAccessAgent) anzeigen und wie erforderlich ändern. Führen Sie hierzu die folgenden Befehle über den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation) aus.

• Um die aktuelle Protokollierungsstufe anzuzeigen, führen Sie folgenden Befehl aus:

  connectoragent configuration getloggers

• Um die Protokollierungsstufe auf „Verfolgen“ festzulegen, führen Sie folgenden Befehl aus:

  connectoragent configuration setloggers -l Root -v DEBUG

• Um die Protokollierungsstufe auf „Ausführlich“ festzulegen, führen Sie folgenden Befehl aus:

  connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

Aktualisieren des Registrierungsschlüssels

Das Ändern des Registrierungsschlüssels kann in dem unwahrscheinlichen Fall erforderlich werden, dass der Schlüssel beschädigt wird, oder wenn Sie vermuten, dass von einem unbefugten Benutzer auf den Daten-Gateway-Server zugegriffen wurde.

So aktualisieren Sie den Registrierungsschlüssel:

1. Öffnen Sie auf dem Server des Gateways für direkten Zugriff eine Eingabeaufforderung als Administrator und ändern Sie das Arbeitsverzeichnis in den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation).

2. Führen Sie die folgenden Befehle aus:

   • Generieren Sie den neuen Schlüssel:

     connectoragent qcs generate_keys

   • Zeigen Sie den Schlüssel an:

     connectoragent qcs get_registration

     Der Schlüssel wird angezeigt:

     

3. Kopieren Sie den vollständigen Schlüssel, wie im obigen Beispiel gezeigt.

4. Öffnen Sie im Aktivitätscenter Verwaltung die Daten-Gateway-Einstellungen, indem Sie auf die Schaltfläche am Ende der betreffenden Zeile klicken und Bearbeiten auswählen.

5. Fügen Sie den Schlüssel in das Feld Schlüssel ein (wodurch Sie den aktuellen Schlüssel ersetzen) und speichern Sie die Einstellungen.

6. Kehren Sie zum Server des Gateways für direkten Zugriff zurück und starten Sie den Qlik Data Gateway - Direct Access-Dienst neu, wie in Verwalten des Qlik Data Gateway - Direct Access-Dienstes beschrieben.

Verlängern der Ladesitzungsdauer

Wenn die Verbindung zwischen Direct Access Gateway und Qlik Cloud für 20 Sekunden oder länger inaktiv ist, kann der Ladevorgang manchmal mit folgendem Fehler fehlschlagen:

Invalid object name '#<TempTableName>' (indicating that the Direct Access Gateway temp tables are unavailable).

Die Standardsitzungsdauer beträgt 20 Sekunden, aber wenn dieser Fehler häufig auftritt, können Sie die Sitzungsdauer wie folgt verlängern:

1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

2. Suchen Sie nach dem Parameter ODBC_RELOAD_SESSION_LIFE und erhöhen Sie seinen Wert wie erforderlich.
3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Verlängern der Zeitüberschreitung für Ladeanforderungen

Wenn Netzwerkunterbrechungen auftreten, können Ladevorgänge mit den folgenden Fehlern fehlschlagen:

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

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

Wenn Sie häufig die oben genannten Fehler sehen, versuchen Sie, den Parameter EXTEND_FIRST_REQUEST_TIMEOUT auf 5-10 Minuten zu setzen.

Gehen Sie wie folgt vor:

1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

2. Suchen Sie nach dem Parameter EXTEND_FIRST_REQUEST_TIMEOUT und erhöhen Sie seinen Wert auf 5-10 Minuten. Der Standardwert ist „0“.
3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Abmildern der Auswirkung von Konnektorabstürzen bei Ladevorgängen

Prozessisolierung ermöglicht Administratoren mit direktem Zugriff auf das Betriebssystem des Gateway-Servers zu steuern, wie viele Prozesse pro Konnektortyp für Ladevorgänge verfügbar sind. Wenn Ladevorgänge auf mehrere Konnektorprozesse verteilt werden, erhöht dies die Isolationsstufe, indem die Anzahl der gleichzeitig laufenden Ladevorgänge für die einzelnen Konnektorprozesse reduziert wird. Dadurch kann sich die allgemeine Stabilität von Direct Access Gateway in Fällen verbessern, in denen Konnektorabstürze aufgetreten waren.

Deaktivieren der Prozessisolierung

Der Qlik-Support kann Sie bitten, die Prozessisolierung zur Fehlerbehebung zu deaktivieren.

So deaktivieren Sie die Prozessisolierung:

1. Öffnen Sie die Datei C:\ProgramData\Qlik\Gateway\configuration.properties. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Versteckte Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

2. Legen Sie [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE auf None fest.

3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Aktivieren der Prozessisolierung oder Ändern der Anzahl gleichzeitiger Ladevorgänge

So aktivieren Sie die Prozessisolierung oder ändern die Anzahl gleichzeitiger Ladevorgänge:

1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

   Die Datei enthält drei Präfixe, die den verschiedenen Konnektortypen entsprechen: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> und SAPPACKAGE_<property-name>.

2. Legen Sie [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE auf Load und [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT auf N fest.

   Hierbei gilt:

   N = Ein Befehlsprozess + die Anzahl der gleichzeitigen Ladevorgänge, die zugewiesen werden müssen. Beispielsweise bedeutet ein Wert von 10 maximal 9 gleichzeitige Ladevorgänge.

3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.

Beispiele für die ODBC-Konnektor-Prozessisolierung

Der folgende Auszug aus der Datei configuration.properties zeigt, wie die ODBC-Konnektor-Prozessisolierung für bis zu 12 Ladevorgänge aktiviert wird:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=13

 

Ab Direct Access Gateway Version 1.6.7 kann der Wert MAX_PROCESS_COUNT 10 überschreiten, ohne dass andere Einstellungen geändert werden müssen. Um Ladevorgänge mit einem bestimmten Konnektor-Typ vollständig zu isolieren (d.h. nicht mehr als ein Ladevorgang pro Konnektor), sollte dieser Wert auf ein Minimum von 30 gesetzt werden, aber je nach Arbeitslast kann es auch erforderlich sein, ihn auf einen höheren Wert von bis zu 60 zu setzen.

Speichern beschädigter oder fehlender Datenblöcke für spätere Ladevorgänge

Für jeden Ladevorgang kann Direct Access Gateway beschädigte oder fehlender Datenblöcke im Arbeitsspeicher speichern und an eine Festplatte auslagern. Das ist besonders hilfreich, wenn Sie keine automatische Wiederherstellung nutzen und häufig die Fehler 4025, 4020 und 4021 auftreten. Sie aktivieren diese Funktion, indem Sie den Schwellenwert der Zwischenspeichergröße für das Auslagern beschädigter oder fehlender Datenblöcke auf die Festplatte (pro Ladevorgang) festlegen. Wenn der angegebene Schwellenwert erreicht ist, lagert das Gateway die nächsten verschlüsselten Blöcke auf der Festplatte des Direct Access Gateway-Computers aus.

So legen Sie die Zwischenspeichergröße fest:

1. Öffnen Sie C:\ProgramData\Qlik\Gateway\configuration.properties als Administrator. Wenn Sie hierzu Windows-Explorer verwenden, vergewissern Sie sich, dass Ausgeblendete Dateien, Ordner und Laufwerke anzeigen aktiviert ist.

2. Legen Sie RELOAD_CACHE_MEMORY_MB auf N fest (der Standardwert ist 0, was bedeutet, dass die Funktion nicht aktiviert ist).

   Hierbei gilt:

   N = Die Größe, die ein Datenblock erreichen kann, bevor er erneut geladen wird.

   InformationshinweisWenn Sie diese Funktion aktivieren, erhöht sich die Arbeitsspeichernutzung auf dem Direct Access Gateway-Computer. Daher wird empfohlen, die Auswirkung auf den Arbeitsspeicher zu überwachen, während die Funktion aktiviert ist. Die Einstellung des Werts RELOAD_CACHE_MEMORY_MB auf 100 sollte für die meisten Situationen genügen.
3. Speichern Sie die Datei configuration.properties und starten Sie den Dienst Qlik Data Gateway - Direct Access neu.