Optionale Konfigurationen des Tosca Distribution Agent

Ab Tricentis Tosca 2026.1 LTS ist die Distributed Execution nicht mehr standardmäßig aktiviert. Obwohl die Distributed Execution sowohl in Tosca Commander- als auch in Tosca Server-Installationen enthalten ist, müssen Sie die Funktion manuell aktivieren:

  • Tosca Commander: Die Option Distributed Execution Agent ist im Installationsprogramm standardmäßig deaktiviert. Sie müssen sie aktivieren, bevor Sie die Tricentis Tosca-Installation starten.

  • Tosca Server: Alle Services im Zusammenhang mit der Distributed Execution bleiben standardmäßig deaktiviert. Sie müssen den DEX Server nach der Tosca Server-Installation aktivieren.

Nähere Informationen dazu, wie Sie den Distributed Execution Agent und den DEX Server aktivieren, siehe diesen Artikel der Tricentis Knowledge Base.

Sie können die meisten Einstellungen des Agent im Tosca Distribution Monitor ändern (siehe "Agents im Tosca Distributed Execution Monitor überwachen, wiederherstellen und konfigurieren").

Zusätzlich können Sie die folgenden Einstellungen in den Konfigurationsdateien ändern:

Benutzerdefinierten RDP-Port festlegen

Der Agent benötigt einen eingehenden Port für die RDP-Verbindung. Der Standardport für Remotedesktop unter Windows ist 3389.

Wenn Sie einen anderen Port für Remotedesktop unter Windows angegeben haben, müssen Sie diesen Port auch in Ihrer Agent-Konfiguration ändern. Sie müssen dies auf jedem Agent-Rechner tun, auf dem Sie einen anderen Port für Remotedesktop unter Windows festgelegt haben.

Um dies zu tun, führen Sie die folgenden Schritte aus:

  1. Stoppen Sie den Agent.

  2. Öffnen Sie auf dem Agent-Rechner die Datei ToscaRdpServer.dll.config. Standardmäßig befindet sich diese Datei unter C:\Programme (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\Rdp.

  3. Geben Sie im Abschnitt applicationSettings unter value einen neuen Wert ein für RdpListeningPort.

  4. Wenn Sie auch die Einstellung für die Wiederholungsversuche für die RDP-Verbindung ändern möchten, können Sie dies jetzt tun.

  5. Aktualisieren Sie die Konfigurationsdateien für Ocelot mit der neuen Portnummer.

  6. Wenn Sie mit Ihren Konfigurationen fertig sind, führen Sie die folgenden Aktionen aus:

Beispiel: Port 4444 einstellen

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="RdpListeningPort" serializeAs="String">
            <value>4444</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>

RDP-Verbindungs-Timeout festlegen

Bei der Ausführung versucht der Agent 30 000 Millisekunden (30 Sekunden) lang, eine RDP-Verbindung aufzubauen. Wenn er innerhalb dieses Zeitraums nicht erfolgreich ist, bricht der Agent den Versuch ab.

Sie können diesen Zeitraum ändern. Beachten Sie, dass Sie dies auf jedem Agent-Rechner tun müssen, der einen anderen Zeitraum benötigt.

Um den Zeitraum zu ändern, führen Sie die folgenden Schritte aus:

  1. Stoppen Sie den Agent.

  2. Öffnen Sie auf dem Agent-Rechner die Datei AgentSettings.xml. Standardmäßig befindet sich diese Datei unter C:\ProgramData\TRICENTIS\Tosca Testsuite\7.0.0\DistributedExecutionAgent\Default\settings.

  3. Geben Sie im Abschnitt userSettings unter value einen neuen Wert ein für EstablishRdpConnectionTimeoutMilliseconds.

  4. Wenn Sie auch die Einstellung für die Arbeitsbereichslog-Ebene ändern möchten, können Sie dies jetzt tun.

  5. Wenn Sie mit Ihren Konfigurationen fertig sind, führen Sie die folgenden Aktionen aus:

Beispiel: Timeout-Intervall von 40 Sekunden

<AgentSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    [...]
        <EstablishRdpConnectionTimeoutMilliseconds>40000</EstablishRdpConnectionTimeoutMilliseconds>
    [...]
</AgentSettings>

RDP-Verbindungswiederholungsversuche festlegen

Standardmäßig versucht der Agent nicht, die Verbindung wiederherzustellen, wenn die RDP-Verbindung verloren geht.

Wenn Sie sich bei einem Agent anmelden, der gerade ausgeführt wird, stoppt die Ausführung und kann nicht fortgesetzt werden. Um Risiken zu minimieren, können Sie festlegen, dass der Agent versuchen soll, eine verlorene Verbindung wiederherzustellen. Beachten Sie, dass Sie dies auf jedem Agent-Rechner tun müssen, der versuchen soll, eine Verbindung wiederherzustellen.

Um dies zu tun, führen Sie die folgenden Schritte aus:

  1. Stoppen Sie den Agent.

  2. Öffnen Sie auf dem Agent-Rechner die Datei ToscaRdpServer.dll.config. Standardmäßig befindet sich diese Datei unter C:\Programme (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\Rdp.

  3. Geben Sie im Abschnitt applicationSettings unter value einen neuen Wert ein für die folgenden Einstellungen:

    • MaxConnectionRetries: Geben Sie die maximale Anzahl von Wiederholungsversuchen ein.

    • WaitBetweenRetriesMilliseconds: Geben Sie an, wie viele Millisekunden der Agent zwischen den Versuchen warten soll.

  4. Wenn Sie auch die Einstellung für den RDP-Port ändern möchten, können Sie dies jetzt tun.

  5. Wenn Sie mit Ihren Konfigurationen fertig sind, führen Sie die folgenden Aktionen aus:

Während des Wiederholungsversuchs meldet das System alle aktiven Benutzer ab.

Wenn Sie sich also bei einem Agent anmelden, der versucht, eine RDP-Verbindung wiederherzustellen, meldet Sie das System kurz danach ab.

Beispiel: 3 Wiederholungen mit einer maximalen Wartezeit von 20 Sekunden dazwischen

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="MaxConnectionRetries" serializeAs="String">
            <value>3</value>
        </setting>
        <setting name="WaitBetweenRetriesMilliseconds" serializeAs="String">
            <value>20000</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>

Ocelot-Konfiguration

Sie müssen die Ocelot-Konfigurationsdateien aktualisieren, wenn Sie Änderungen am Standardport oder an der Endpunktadresse des RDP Server vornehmen. In den folgenden Abschnitten wird ausführlich erläutert, wo Sie diese Dateien finden und wie Sie die entsprechenden Eigenschaften aktualisieren können.

Ocelot-Konfigurationsdatei aktualisieren

Führen Sie die folgenden Schritte aus, um die Ocelot-Konfigurationsdatei des RDP Server zu aktualisieren:

  1. Öffnen Sie die Datei ocelot.json, die sich unter C:\Programme (x86)\TRICENTIS\Tosca Server\Gateway befindet.

  2. Suchen Sie nach zwei Elementen mit dem ServiceId-Wert RdpService.

  3. Aktualisieren Sie die Werte der folgenden Eigenschaften in diesen Elementen:

Eigenschaft

Beschreibung

DownstreamScheme

Geben Sie je nach gewählter Bindung entweder http oder https ein.

Port

Geben Sie den Port des RDP Server ein.

Änderungen anwenden

Starten Sie die folgenden Services neu, um die Änderungen anzuwenden:

  • Tricentis.RdpService

  • Tricentis.GatewayService

Automatische Bestätigung von RDP-Anmeldenachrichten aktivieren

Wenn der Agent versucht, eine RDP-Verbindung einzurichten, zeigt der Rechner nach der Anmeldung möglicherweise eine Begrüßungsnachricht oder eine Richtlinienbestätigung an. Dieser Schritt erfordert eine manuelle Interaktion und kann Ihre RDP-Session blockieren. Sie müssen im Bestätigungsdialog OK wählen, bevor der Desktop verfügbar wird.

Um dieses Problem zu vermeiden, können Sie den Agent so konfigurieren, dass er das Drücken der Leertaste simuliert, nachdem er die RDP-Verbindung hergestellt hat. Dadurch wird die Nachricht bestätigt und der Agent kann die Session ohne Unterbrechung fortsetzen.

Führen Sie hierzu die folgenden Schritte aus:

  1. Stoppen Sie den Agent.

  2. Öffnen Sie auf dem Agent-Rechner die Datei ToscaRdpServer.dll.config. Standardmäßig befindet sich diese Datei unter C:\Programme (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution\Rdp.

  3. Legen Sie im Abschnitt userSettings die Werte für die folgenden Eigenschaften fest:

    Eigenschaft

    Beschreibung

    SendSpaceKey

    Stellen Sie dies auf True, um das Drücken der Leertaste nach dem Start der RDP-Sessions zu simulieren.

    SpaceKeyDelayMilliseconds

    Geben Sie die Verzögerung zwischen der Anmeldung und dem simulierten Tastendruck in Millisekunden an. Der Standardwert ist 5000.

  4. Wenn Sie mit Ihren Konfigurationen fertig sind, führen Sie die folgenden Aktionen aus:

Beispiel: Anmeldenachricht nach 5 Sekunden bestätigen

<userSettings>
    [...]
      <setting name="SendSpaceKey" serializeAs="String">
        <value>True</value>
     </setting>
     <setting name="SpaceKeyDelayMilliseconds" serializeAs="String">
        <value>5000</value>
    </setting>
    [...]
</userSettings>

Timeout für den Schlüsseltresor für RDP-Anmeldedaten festlegen

Wenn Sie Ihre RDP-Anmeldedaten in einem Schlüsseltresor speichern, ruft der Agent sie ab, bevor er eine RDP-Verbindung öffnet. Standardmäßig wartet der Agent bis zu 30 000 Millisekunden (30 Sekunden) auf eine Antwort.

Wenn Ihr Schlüsseltresor länger als 30 Sekunden für eine Antwort benötigt, beispielsweise weil er in einer anderen Region gehostet wird, sich hinter einem langsamen VPN befindet oder viele Anmeldedatenanfragen gleichzeitig verarbeitet, schlägt die Ausführung fehl, bevor die Anmeldedaten eintreffen. Um dieses Problem zu vermeiden, erhöhen Sie das Timeout mit der Eigenschaft KeyVaultTimeoutMilliseconds in der Einstellungsdatei des DEX-Agenten. Dadurch hat Ihr Schlüsseltresor genügend Zeit für eine Antwort.

Um das Timeout zu erhöhen, führen Sie diese Schritte aus:

  1. Stoppen Sie den Agent.

  2. Öffnen Sie auf dem Agent-Rechner die Datei AgentSettings.xml. Standardmäßig befindet sich diese Datei unter C:\ProgramData\TRICENTIS\Tosca Testsuite\7.0.0\DistributedExecutionAgent\Default\settings.

  3. Geben Sie für KeyVaultMilliseconds einen neuen value ein.

  4. Wenn Sie mit der Konfiguration fertig sind, führen Sie die folgenden Aktionen aus:

Beispiel: Timeout für den Schlüsseltresor auf 60 Sekunden festlegen

<AgentSettings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    [...]
           <KeyVaultTimeoutMilliseconds>60000</KeyVaultTimeoutMilliseconds>
    [...]
</AgentSettings>