Tosca CI Client für Remote-Testausführung über Nicht-Windows-Betriebssysteme konfigurieren

Dieses Kapitel beschreibt ein Legacy-Feature, das Tricentis in naher Zukunft einstellen will. Nähere Informationen zum Einstellungsplan und Zeitablauf finden Sie in diesem Artikel der Tricentis Knowledge Base.

Um mehr über Alternativen zu erfahren, lesen Sie dieses Kapitel.

Wenn Sie Ihre Tests von einem anderen Betriebssystem als Windows starten, konfigurieren Sie das Verhalten Ihres Tosca Continuous Integration Client (Tosca CI Client) in der Datei config.properties.

Diese Datei befindet sich unter %COMMANDER_HOME%\ToscaCI\Client. Stellen Sie sicher, dass sie sich im gleichen Verzeichnis wie die Datei ToscaCIJavaClient.jar befindet.

Die Datei config.properties ist nach folgendem Format aufgebaut:

address=
username=
password=
considerexecutionresult=
resulttype=
reportintermediateresults=
pathtoresultfile=
pollinginterval=
ciclienttimeout=
                                                    

Um das Verhalten Ihres Tosca CI Client anzupassen, geben Sie neue Werte nach dem = (siehe Beispiel unten) ein.

Ignorieren Sie die Eigenschaften dexpollinginterval und ciclienttimeout. Diese Eigenschaften betreffen Sie nur, wenn Sie Ihre Tests mit Tosca Distributed Execution von einem Nicht-Windows-Betriebssystem durchführen.

Für Testausführungen über den Remote Service können Sie die folgenden Einstellungen definieren:

Einstellung	Beschreibung	Optional
address	Definiert den Endpunkt des Remote Service. Geben Sie dieselbe Endpunktadresse ein, die Sie im Abschnitt system.serviceModel der Datei ToscaCIRemoteExecutionService.exe.config eingegeben haben. Ersetzen Sie den Hostnamen mit der IP-Adresse des Rechners, der das Remote Execution Service hostet.
username	Autorisiert den Tosca CI Client zur Ausführung von Tests. Wenn Sie den Remote Execution Service für die Client-Authentifizierung konfiguriert haben, ist diese Einstellung zwingend erforderlich. Geben Sie denselben Wert ein, den Sie in der Datei ToscaCIRemoteExecutionService.exe.config eingegeben haben.
password	Passwort für den AuthenticationUsername. Wenn Sie den Remote Execution Service für die Client-Authentifizierung konfiguriert haben, ist diese Einstellung zwingend erforderlich. Geben Sie denselben Wert ein, den Sie in der Datei ToscaCIRemoteExecutionService.exe.config eingegeben haben.
reportintermediateresults	Gibt an, dass Sie nach der Ausführung jedes Ausführungseintrags zusätzlich zu den zusammenfassenden Ergebnissen am Ende des Testdurchlaufs Ergebnisse erhalten möchten. Standardmäßig ist diese Einstellung ausgeschaltet, d. h. auf False gesetzt. Wenn Sie sie ausschalten, liefert der Tosca CI Client am Ende des Testdurchlaufs nur zusammenfassende Ergebnisse.
pollinginterval	Diese Einstellung gilt nur, wenn ReportIntermediateResults auf True gesetzt ist. Das Intervall in Millisekunden, in dem der Tosca CI Client ein Ergebnis vom Tosca Distribution Server verlangt.
ciclienttimeout	Diese Einstellung gilt nur, wenn ReportIntermediateResults auf True gesetzt ist. Zeit in Millisekunden, die der Tosca CI Client auf eine Response des Tosca Distribution Server wartet. Wenn der Tosca CI Client innerhalb dieses Zeitraumes keine Response vom Tosca Distribution Server erhält, bricht er die Ausführung ab und entfernt den Request aus der Warteschlange. Das im CiClientTimeout definierte Zeitintervall darf nicht niedriger sein als das des PollingInterval. Ist dies der Fall, verwendet das System automatisch das im PollingInterval definierte Zeitintervall. Der Standardwert ist 36000000.
considerexecutionresult	Wenn Ihr Build-Server ExitCodes benötigt, die angeben, ob Tests erfolgreich waren oder nicht, setzen Sie den Wert dieser Einstellung unter Value auf True. Der ExitCode informiert den Build-Server darüber, ob die Tests erfolgreich waren oder nicht, bzw. ob es keine Ergebnisse für einen oder mehrere Ausführungseinträge gibt: Erfolgreich: ExitCode 0 Fehlgeschlagen: ExitCode -1 Kein Ergebnis für Ausführungseinträge: ExitCode -2. Dieser Code gilt, wenn ReportIntermediateResults auf True gesetzt ist.	X
resulttype	Definiert die Struktur der Testergebnisse. Wenn ReportIntermediateResults True ist, ist nur der Ergebnistyp Junit möglich.	X
pathtoresultfile	Definiert den Pfad zur Datei result.xml auf dem Tosca CI Client. Der Build-Server importiert diese Datei, um die Testergebnisse anzuzeigen. Sie können diese Einstellung mit dem Aufrufparameter -r überschreiben, wenn Sie den angegebenen Pfad für die Ausführung eines bestimmten Tests nicht verwenden möchten.	X

Beispiel

Im folgenden Beispiel haben Sie das Verhalten folgendermaßen konfiguriert:

Der Remote Service-Endpunkt ist http://100.100.100.100:8732/TOSCARemoteExecutionService.
Der Remote Execution Service darf den Tosca CI Client SampleAuthenticationUsername mit dem Passwort SamplePassword12345 ausführen.
Der Build-Server erwartet einen ExitCode vom Tosca CI Client.
Die Struktur des Testergebnisses ist Junit.
Der Tosca CI Client liefert Zwischenergebnisse.
Der Tosca CI Client speichert die Ergebnisdatei in den Pfad SampleDirectory\\Result.xml.
Der Tosca CI Client fordert innerhalb von 350.000 Millisekunden ein Ergebnis vom Tosca Distribution Server.
Der Tosca CI Client wartet 36 000 000 Millisekunden auf eine Response vom Tosca Distribution Server Danach bricht er die Ausführung ab.

address=http://100.100.100.100:8732/TOSCARemoteExecutionService
username=SampleAuthenticationUsername
password=SamplePassword12345
considerexecutionresult=true
resulttype=Junit
reportintermediateresults=true
pathtoresultfile=SampleDirectory\\Result.xml
pollinginterval=350000
ciclienttimeout=36000000
                                                    