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 in der Verwaltungskonsole 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 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 direkt von der Verwaltungskonsole 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 in der Verwaltungskonsole 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.

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.

So aktivieren 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.

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

2. Legen Sie ODBC|SAPBW|SAPSQL_PROCESS_ISOLATION_MODE auf Laden und ODBC|SAPBW|SAPSQL_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.

   Informationshinweis

   Mit den Standardeinstellungen für Portnummer und Bereich können Sie den Wert [ODBC|SAPBW|SAPSQL]_MAX_PROCESS_COUNT nicht höher als 10 festlegen.

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

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_PROCESS_ISOLATION_MODE auf Keine fest.

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 Auszufg aus der Datei configuration.properties zeigt, wie die ODBC-Konnektor-Prozessisolierung für bis zu 9 Ladevorgánge aktiviert wird:

ODBC_PROCESS_ISOLATION_MODE=Load

ODBC_MAX_PROCESS_COUNT=10

Wenn Sie die Standard-Porteinstellungen ändern, kann der Wert für MAX_PROCESS_COUNT 10 überschreiten. In diesem Fall gilt jedoch:

• Die Anzahl der Ports zwischen ODBC_PORT oder ODBC_DATA_PORT_RANGE_START und SAPBW_PORT oder SAPBW_DATA_PORT_RANGE_START muss größer oder gleich ODBC_MAX_PROCESS_COUNT sein

• Die Anzahl der Ports zwischen SAPBW_PORT oder SAPBW_DATA_PORT_RANGE_START und SAPSQL_PORT oder SAPSQL_DATA_PORT_RANGE_START muss größer oder gleich SAPBW_MAX_PROCESS_COUNT sein

Um ODBC_MAX_PROCESS_COUNT=30 festzulegen, müssen somit die Portparameter in etwa wie folgt aussehen:

# 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