Optionale Konfigurationen des Tosca Distribution Agent

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

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

• Nur für die Tosca Distributed Execution without AOS: Ändern Sie den Detaillierungsgrad im Arbeitsbereichslog des Agent.

• Unattended Execution: Legen Sie einen benutzerdefinierten Port für die RDP-Verbindung fest.

• Unattended Execution: Legen Sie den RDP-Verbindungs-Timeout fest.

• Unattended Execution: Legen Sie RDP-Verbindungswiederholungsversuche fest.

• Unattended Execution: Aktualisieren Sie die Konfigurationsdateien für Consul und Ocelot.

Detaillierungsgrad des Arbeitsbereichslogs ändern

Um die Arbeitsbereichslog-Ebene zu ändern, führen Sie die folgenden Schritte aus:

1. Stoppen Sie den Agent.

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

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

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

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

   • Speichern und schließen Sie die Datei.

   • Starten Sie den Agenten.

Beispiel: Log-Ebene 6

<userSettings>
  <Tricentis.DistributionServer.Properties.Settings>
  ...
    <setting name="LogLevel" serializeAs="String">
      <value>6</value>
    </setting>
  ...
  </Tricentis.DistributionServer.Properties.Settings>
</userSettings>

Benutzerdefinierten RDP-Port festlegen

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.exe.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 Consul und Ocelot mit der neuen Portnummer.

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

   • Speichern und schließen Sie die Datei.

   • Starten Sie den Agenten.

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 ToscaDistributionAgent.exe.config. Standardmäßig befindet sich diese Datei unter C:\Programme (x86)\TRICENTIS\Tosca Testsuite\DistributedExecution.

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:

   • Speichern und schließen Sie die Datei.

   • Starten Sie den Agenten.

Beispiel: Timeout-Intervall von 40 Sekunden

<userSettings>
    [...]
    <setting name="EstablishRdpConnectionTimeoutMilliseconds" serializeAs="String">
        <value>40000</value>
    </setting>
    [...]
</userSettings>

RDP-Verbindungswiederholungsversuche festlegen

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.exe.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:

   • Speichern und schließen Sie die Datei.

   • Starten Sie den Agenten.

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>

Consul und Ocelot konfigurieren

Änderungen anwenden

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

• Tricentis.RdpService

• Tricentis.GatewayService

• ConsulService