# Verwalten des Qlik Data Gateway – direkter Zugriff-Servers

In diesem Abschnitt werden die verschiedenen Verbindungs- und Verwaltungsoptionen beschrieben, die verfügbar sind, nachdem Sie Qlik Data Gateway – direkter Zugriff installiert haben.

## Verbinden mit Qlik Cloud über einen Proxy-Server

Wenn Sie im anfänglichen Setup keine Proxy-Verbindung konfiguriert haben, können Sie dies später nachholen, indem Sie die unten beschriebenen Befehle ausführen. Sie können die gleichen Befehle auch ausführen, um vorhandene Proxy-Server-Einstellungen zu bearbeiten.

### Einschränkungen und Überlegungen

* Nur HTTP-Proxy-Schemas werden unterstützt.

* Proxy-Server, die für das Abfangen von SSL-Verbindungen konfiguriert sind (zur Inhaltsprüfung oder für andere Sicherheitsmaßnahmen) werden nicht unterstützt.

* Zusätzlich zu HTTPS verwendet das Gateway für direkten Zugriff auch das WSS-Protokoll (WebSocket Secure). Vergewissern Sie sich daher, dass Ihre Firewall und Ihr Proxy-Server (wenn Sie einen verwenden möchten) für das Zulassen von ausgehenden WSS-Verbindungen eingerichtet sind.

### Aktivieren der Proxy-Server-Konnektivität

Sie können die Proxy-Server-Konnektivität wie folgt aktivieren oder bearbeiten.

1. Führen Sie je nach Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Öffnen Sie eine Eingabeaufforderung als Administrator und ändern Sie das Arbeitsverzeichnis in den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation).

   * Containerisierte Installation:

     Öffnen Sie eine Konsole in der Sammelbox direct-access-agent .

2. Führen Sie den folgenden Befehl aus:

   * Windows Serverinstallation:

     * Syntax:connectoragent qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Beispiel: connectoragent qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

   * Containerisierte Installation:

     * Syntax:dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://host:port --proxy\_username username --proxy\_password password

     * Beispiel: dotnet ConnectorAgent.dll qcs set\_config --proxy\_url http://myproxy:1212 --proxy\_username admin --proxy\_password f56weqs@

3. Führen Sie je nach Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Starten Sie den Qlik Data Gateway – direkter Zugriff-Dienst wie in [Verwalten des Qlik Data Gateway – direkter Zugriff-Dienstes](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) beschrieben neu.

   * Containerisierte Installation:

     Starten Sie die direct-access-agent-Sammelbox neu.

### Deaktivieren der Proxy-Server-Konnektivität

Sie können die Proxy-Server-Konnektivität wie folgt deaktivieren:

1. Öffnen Sie 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 je nach Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Öffnen Sie eine Eingabeaufforderung als Administrator und ändern Sie das Arbeitsverzeichnis in den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation).

   * Containerisierte Installation:

     Öffnen Sie eine Konsole in der Sammelbox direct-access-agent .

3. Führen Sie den folgenden Befehl aus:

   connectoragent qcs set\_config --proxy\_url ""

   * Windows Serverinstallation:

     connectoragent qcs set\_config --proxy\_url ""

   * Containerisierte Installation:

     dotnet ConnectorAgent.dll qcs set\_config --proxy\_url ""

4. Führen Sie je nach Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Starten Sie den Qlik Data Gateway – direkter Zugriff-Dienst wie in [Verwalten des Qlik Data Gateway – direkter Zugriff-Dienstes](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) beschrieben neu.

   * Containerisierte Installation:

     Starten Sie die direct-access-agent-Sammelbox neu.

## Aktualisieren der Qlik Cloud-Mandanten-URL

Sie können die Qlik Cloud-Mandanten-URL nach Bedarf ändern.

Gehen Sie wie folgt vor:

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 je nach Ihrem Installations-Workflow einen der folgenden Befehle aus:

   * Windows Serverinstallation:

     * Syntax:connectoragent qcs set\_config --tenant\_url URL

     * Beispiel: connectoragent qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

   * Containerisierte Installation:

     * Syntax:dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

     * Beispiel: dotnet ConnectorAgent.dll qcs set\_config --tenant\_url mytenant.us.qlikcloud.com

3. Starten Sie den Qlik Data Gateway – direkter Zugriff-Dienst wie in [Verwalten des Qlik Data Gateway – direkter Zugriff-Dienstes](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-managing.htm#Managing) beschrieben neu.

InformationshinweisDie Aktualisierung der Qlik Cloud-Mandanten-URL erfordert außerdem, dass Sie einen neuen Registrierungsschlüssel generieren, wie in [Phase zwei: Installieren oder bereitstellen Direct Access Gateway](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Install2) beschrieben (und diesen registrieren, wie in [Schritt vier: Daten-Gateway registrieren](https://help.qlik.com/de-DE/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/direct-access-gateway-setting-up.htm#Stage4) beschrieben).

## Anzeigen der aktuellen Servereinstellungen des Gateways für direkten Zugriff

Sie können die aktuellen Servereinstellungen des Direct Access gateway anzeigen.

Gehen Sie wie folgt vor:

1. Führen Sie je nach Ihrem Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Ö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).

   * Containerisierte Installation:

     Öffnen Sie eine Konsole in der Sammelbox direct-access-agent .

2. Führen Sie je nach Ihrem Installations-Workflow einen der folgenden Befehle aus:

   * Windows Serverinstallation:

     connectoragent qcs set\_config --tenant\_url URL

   * Containerisierte Installation:

     dotnet ConnectorAgent.dll qcs set\_config --tenant\_url URL

   Ihre aktuellen Einstellungen werden angezeigt.

   ```
   connector-agent starting....
   --tenant_url "elastic.example"
   --proxy_url ""
   --proxy_username ""
   DirectAccessAgent Control Program completed successfully.
   ```

## Verwalten des Qlik Data Gateway – direkter Zugriff-Dienstes

InformationshinweisGilt nur für Windows-Serverinstallationen.

Nachdem Sie eine Einstellung auf dem Server des Gateways für direkten Zugriff geändert haben, müssen Sie den Qlik Data Gateway – direkter Zugriff-Dienst neu starten. Sie können den Dienst auch unter einem anderen Konto ausführen.

### Starten, Anhalten oder Neustarten des Dienstes

Führen Sie auf dem Gateway-Server für direkten Zugriff einen der folgenden Schritte aus, um den Dienst anzuhalten, zu starten oder neu zu starten:

* Öffnen Sie die Windows-Dienste-Konsole, wo Sie den Qlik Data Gateway – direkter Zugriff-Dienst wie erforderlich anhalten, starten oder neu starten.

* Öffnen Sie eine Eingabeaufforderung als Administrator und ändern Sie das Arbeitsverzeichnis in den Unterordner ConnectorAgent (C:\Programme\Qlik\ConnectorAgent\ConnectorAgent für eine Standardinstallation). Führen Sie dann die folgenden Befehle aus:

  connectoragent service stop

  Es wird eine Bestätigung angezeigt, dass der Dienst erfolgreich angehalten wurde.

  connectoragent service start

  Es wird eine Bestätigung angezeigt, dass der Dienst erfolgreich gestartet wurde.

### Ausführen des Dienstes unter einem anderen Konto

Standardmäßig wird der Qlik Data Gateway – direkter Zugriff-Dienst im Konto des lokalen Systems ausgeführt. Um den Dienst in einem anderen Konto auszuführen, klicken Sie in der Windows-Dienste-Konsole mit der rechten Maustaste auf Qlik Data Gateway – direkter Zugriff und wählen Sie die Registerkarte Anmelden aus. Wählen Sie dann Dieses Konto aus und geben Sie die Anmeldeinformationen ein. Speichern Sie dann Ihre Einstellungen und starten Sie den Dienst neu.

## Verfügbare Befehlskategorien

Um eine Liste der verfügbaren Befehlskategorien anzuzeigen:

1. Führen Sie je nach Ihrem Installations-Workflow einen der folgenden Schritte aus:

   * Windows Serverinstallation:

     Öffnen Sie eine Eingabeaufforderung als Administrator und wechseln Sie das Arbeitsverzeichnis zum Unterordner ConnectorAgent (C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent bei einer Standardinstallation.

   * Containerisierte Installation:

     Öffnen Sie eine Konsole in der Sammelbox direct-access-agent .

2. Führen Sie je nach Ihrem Installations-Workflow einen der folgenden Befehle aus:

   * Windows Serverinstallation:

     connectoragent help

   * Containerisierte Installation:

     dotnet ConnectorAgent.dll help

Die folgende Liste wird angezeigt:

* service: Weitere Informationen finden Sie unter Verwalten des Qlik Data Gateway – direkter Zugriff-Diensts oben.

* qcs: Muss allen dokumentierten Befehlen vorangestellt werden, außer Dienstbefehlen.

  Beispiel (Windows Serverinstallation):

  connectoragent qcs show\_config

  Beispiel (containerisierte Installation):

  dotnet ConnectorAgent.dll qcs show\_config

* setup: Nur für Supportzwecke.

* repository: Nur für Supportzwecke.

* configuration: Nur für Supportzwecke.