Tosca Distributed Execution with AOS | HTTP einrichten

In den folgenden Kapiteln wird Schritt für Schritt beschrieben, wie Sie die Tosca Distributed Execution with AOS und eine HTTP-Bindung einrichten. Sie sind in der Reihenfolge aufgeführt, die Tricentis für Ihren Setup-Vorgang empfiehlt.

DEX Server installieren

Der Tosca Distribution Server (DEX Server) ist Teil der Standardinstallation des Tosca Server.

Um die DEX Server-Umgebung zu installieren und zu konfigurieren, führen Sie diese Schritte aus:

  1. Führen Sie die Installation des Tosca Server durch. Wählen Sie dazu eine der folgenden Optionen:

  2. Greifen Sie auf die Tricentis Service Configuration zu.

  3. Gehen Sie auf den Reiter Automation Object Service und füllen Sie die Einstellungen aus.

  4. Überprüfen Sie noch einmal die Distribution Server Address. Wenn Sie für Ihren DEX Server einen anderen Port als die Standardeinstellung 5007 verwenden, ändern Sie den Endpunkt: http://<Adresse des DEX Server>:<Port des DEX Server>.

  5. Wenn Sie Tricentis Tosca mit Tosca Cloud integrieren möchten, scrollen Sie zum Abschnitt Elastic Execution Grid und füllen Sie die Einstellungen aus.

  6. Optional können Sie weitere Konfigurationen erkunden:

Definieren, wo der Automation Object Service seine Aufgaben verfolgt

Der Automation Object Service (AOS) führt während der Ausführung verschiedene Aufgaben aus, wie z. B. den Import oder die Verteilung von Daten. Standardmäßig verfolgt AOS diese Aufgaben in den SQLite-Datenbanken unter C:\ProgramData\TRICENTIS\ToscaServer\ToscaAutomationObjectService.

Wenn Sie die Vorteile der parallelen Ausführung mit DEX voll ausschöpfen möchten, ist SQLite möglicherweise nicht die beste Option für Sie. In diesem Fall empfehlen wir Ihnen, zu einer MS SQL Server-Datenbank zu wechseln, die eine bessere Unterstützung für gleichzeitigen AOS-Datenverkehr bietet.

MS SQL Server-Datenbank und AOS-Zugriff vorbereiten

Die MS SQL Server-Datenbank für AOS-Aufgaben ist nicht Teil der Tosca Server-Installation. Sie müssen Folgendes vorbereiten, damit Sie die Datenbank bei Ihnen hosten können:

  • Richten Sie eine leere Datenbank ein. AOS erstellt alle Schemata und Tabellen.

  • Erstellen Sie einen Benutzer für AOS. Dieser Benutzer muss die folgenden Rechte haben: Schemas erstellen, Tabellen erstellen und Daten schreiben. In der Regel ist dies ein db_owner-Benutzer.

  • Bereiten Sie eine Verbindungszeichenfolge vor, um die Datenbank in Ihre DEX-Umgebung zu integrieren.

  • Optional können Sie einen HashiCorp-Schlüsseltresor für Ihre Verbindungszeichenfolge erstellen. Sie müssen dies nur tun, wenn Sie keine reine Textverbindungszeichenfolge in der Konfigurationsdatei wünschen.

Die Datenbank in Ihre DEX-Umgebung integrieren

Um Ihre MS SQL Server-Datenbank zu integrieren, führen Sie diese Schritte aus:

  1. Beenden Sie den Service Tricentis.ToscaAutomationObjectService.

  2. Öffnen Sie die Datei appsettings.json. Bei einer Standardinstallation finden Sie diese Datei unter C:\Programme (x86)\Tricentis\Tosca Server\AutomationObjectService.

  3. Gehen Sie zum Abschnitt Storage und füllen Sie die folgenden StorageProvider-Einstellungen aus:

    Einstellung

    Beschreibung

    Provider

    Geben Sie SqlServer ein.

    CredentialsSource

    Geben Sie einen der folgenden Werte an:

    • Local, wenn Sie die Verbindungszeichenfolge im Klartext eingeben möchten.

    • KeyVault, wenn Sie Ihren HashiCorp-Schlüsseltresor verwenden möchten.

    ConnectionString

    Geben Sie einen der folgenden Werte an:

    • Wenn Ihre CredentialsSource Local ist, geben Sie die Verbindungszeichenfolge zu Ihrer MS SQL Server-Datenbank ein.

    • Wenn Ihre CredentialsSource KeyVault ist, geben Sie den Pfad zur Verbindungszeichenfolge in Ihrem Schlüsseltresor ein: <Engine>/<Schlüsselpfad>[<Eigenschaft>.<optionale Sub-Eigenschaft>]. Zum Beispiel MyVaults/MyConnectionStrings[SQLServer.AOS].

  1. Speichern und schließen Sie die Datei.

  2. Starten Sie den Service Tricentis.ToscaAutomationObjectService. Wenn der Service nicht gestartet wird, überprüfen Sie unter Windows Event Viewer > Windows Logs > Applications, ob Probleme mit der Datenbankverbindung bestehen.

Tosca Commander installieren

Sie müssen den vollständigen Tosca Commander-Client auf folgenden Rechnern installieren:

  • Alle Rechner, auf denen Sie Testereignisse erstellen und deren Ausführung starten möchten.

  • Der Rechner, auf dem sich der Tosca Distribution Server befindet.

Für Informationen zur Installation des Tosca Commander siehe Kapitel "Tricentis Tosca installieren".

Agents installieren

Die Agent-Installation ist Teil der Installation von Tricentis Tosca. Um einen Agent installieren zu können, müssen Sie Tricentis Tosca auf jedem Rechner installieren, der als Agent fungieren soll.

Sie benötigen einen separaten Rechner für jeden Agent. Die Tosca Distributed Execution unterstützt beispielsweise keine Container oder Terminalserver-Setups.

Um einen Agent zu installieren, führen Sie die folgenden Schritte aus:

  1. Starten Sie die Installation von Tricentis Tosca.

  2. Wählen Sie im Bildschirm Type des Installationsprogramms von Tricentis Tosca Ihren Agent-Typ aus:

    • Zum Installieren eines Execution Agent wählen Sie Execution Agent. Der Execution Agent ist eine schlanke Version von Tosca, die für die Ausführung von Engines 3.0-Tests entwickelt wurde.

    • Um den vollständigen Tosca-Client zu installieren, wählen Sie den Tosca Commander.

Agent-Typ im Installationsprogramm von Tricentis Tosca auswählen

  1. Befolgen Sie die Anweisungen des Installationsprogramms von Tricentis Tosca, um die Installation abzuschließen.

Proxyserver mit Agents verbinden

Sie müssen diesen Schritt nur ausführen, wenn Sie einen Proxyserver verwenden möchten. Wenn nicht, können Sie ihn überspringen.

Um Ihren Agent für eine Verbindung zu einem Proxyserver einzurichten, müssen Sie die Agent-Konfigurationsdatei ändern. Beachten Sie, dass Sie dies auf jedem Agent-Rechner tun müssen.

Führen Sie hierzu diese Schritte aus:

  1. Öffnen Sie auf dem Agent-Rechner die Datei ToscaDistributionAgent.exe.config. Standardmäßig befindet sich diese Datei unter %TRICENTIS_DEX_AGENT_HOME%.

  1. Um die Kommunikation zwischen Agent und Proxy herzustellen, gehen Sie zum Abschnitt userSettings und ändern Sie die Einstellungen ProxyAddress, ProxyUsername und ProxyPassword.

<userSettings>
  <Tricentis.DistributionServer.Properties.Settings>
  ...
    <setting name="ProxyAddress" serializeAs="String">
      <value>http://11.1.11.11:1111</value>
    </setting>
    <setting name="ProxyUsername" serializeAs="String">
      <value>User1</value>
    </setting>
    <setting name="ProxyPassword" serializeAs="String">
      <value >Proxypassword</value>
    </setting>
  </Tricentis.DistributionServer.Properties.Settings>
</userSettings>
  1. Speichern und schließen Sie die Datei.

Agents starten und verbinden

Um die Kommunikation zwischen dem DEX Server und dem Agent zu ermöglichen, starten Sie Ihre Agents und geben Sie die DEX Server-Adresse auf dem Agent-Rechner an. Sie müssen dies auf jedem Agent-Rechner tun.

Das Starten und Verbinden von Agents erfordert Administratorrechte. Wenn Sie keine Administratorrechte haben, führen Sie die Schritte in diesem Artikel der Tricentis Knowledge Base aus.

Das Starten und Verbinden von Agents ist auf folgende Arten möglich:

  • Über die grafische Benutzeroberfläche (GUI).

  • Über die Befehlszeile. In diesem Fall arbeitet der Agent im Hintergrund. Sie können weiterhin GUI-Tests ausführen, aber die Agent-GUI-Elemente sind ausgeblendet.

Wenn Sie den Tosca Server mit einer HTTPS-Bindung verwenden, müssen Sie den Agent über die GUI starten und verbinden. Sie müssen Ihren Agent authentifizieren, was nur in der GUI der Agent-Konfiguration möglich ist.

Über GUI starten und verbinden

Um Ihre Agents über die GUI zu starten und zu verbinden, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf dem Agent-Rechner mit der rechten Maustaste auf die Datei ToscaDistributionAgent.exe und wählen Sie im Kontextmenü Als Administrator ausführen.

    Standardmäßig befindet sich diese Datei unter %TRICENTIS_DEX_AGENT_HOME%.

  2. Wenn Sie den Agent erfolgreich gestartet haben, sehen Sie ein grünes Agent-Symbol in der Windows-Taskleiste.

Agent-Symbol in der Windows-Taskleiste

  1. Klicken Sie mit der rechten Maustaste auf das Agent-Symbol in der Windows-Taskleiste und wählen Sie Configure Agent aus dem Kontextmenü.

    Dadurch öffnet sich das Fenster ToscaDistributionAgent Configuration.

  2. Klicken Sie im Fenster ToscaDistributionAgent Configuration auf den Reiter Connect to server.

  3. Geben Sie im Reiter Connect to server die Adresse des DEX Server ein:

    http://<IP-Adresse oder Hostname des Tosca Server Gateway>:<Gateway-Port>/DistributionServerService/CommunicationService.svc

    Wenn Sie eine IPv6-Adresse verwenden, muss die Serveradresse anstelle des Host-Namens die IP-Adresse enthalten.

Die Serveradresse angeben

  1. Wenn der Verbindungsaufbau zum DEX Server erfolgreich ist, zeigt das Fenster ToscaDistributionAgent Configuration ein grünes Häkchen neben dem Eingabefeld Server address an.

    Wenn das Fenster ein rotes X anzeigt, überprüfen Sie den Link, indem Sie ihn in einen Internetbrowser kopieren.

  2. Klicken Sie auf Save.

  3. Wenn Sie den Tosca Server mit einer HTTPS-Bindung verwenden, authentifizieren Sie den Agent. Gehen Sie dazu auf den Reiter Authenticate Agent und füllen Sie die folgenden Einstellungen aus:

Einstellung

Beschreibung

Token endpoint URL

Geben Sie den Authentifizierungsendpunkt im folgenden Format ein:

http(s)://<IP-Adresse oder Hostname des Tosca Server-Gateway>:<Gateway-Port>/connect/token

Credentials Source

Geben Sie an, wo Sie Ihre Agent-Anmeldedaten aufbewahren. Wählen Sie dazu einen der folgenden Werte aus dem Aufklappmenü:

  • Local, wenn Sie die Anmeldedaten direkt in die Agent-Konfiguration eingeben möchten.

  • Key vault, wenn Sie die Anmeldedaten verwenden möchten, die Sie in Ihrem HashiCorp-Schlüsseltresor speichern.

Client ID

Geben Sie die Client ID Ihres API-Zugriffstokens der Tricentis User Administration ein:

  • Wenn Ihre Credentials Source Local ist, geben Sie die Client ID ein.

  • Wenn Ihre Credentials Source Key vault ist, geben Sie den Pfad zur ID in Ihrem Schlüsseltresor ein: <Pfad zum Geheimnis>[<Feld>]. Zum Beispiel kv/tosca_dex/agent[clientID].

Client secret

Geben Sie den geheimen Clientschlüssel des API-Zugriffstokens ein. Geben Sie je nach Credentials Source den geheimen Clientschlüssel direkt ein oder geben Sie den Pfad zum Geheimnis in Ihrem Schlüsseltresor ein.

  1. Richten Sie den Agent so ein, dass er RDP-Zugriff für die Unattended Execution erlaubt. Gehen Sie dazu zum Reiter Unattended execution und führen Sie die folgenden Aktionen aus:

    • Wählen Sie Allow to open remote connections to this agent.

    • Wählen Sie Use RDP connection.

    • Füllen Sie die folgenden Felder aus:

Feld

Optional?

Beschreibung

Credentials Source

 

Geben Sie an, wo Sie die Benutzeranmeldedaten des Windows-Benutzers aufbewahren, der den Agent ausführt. Wählen Sie dazu einen der folgenden Werte aus dem Aufklappmenü:

  • Local, wenn Sie die Anmeldedaten direkt in die Agent-Konfiguration eingeben möchten.

  • HashiCorp Key vault, wenn Sie die Anmeldedaten verwenden möchten, die Sie in Ihrem HashiCorp-Schlüsseltresor speichern.

RDP Mode

 

Definieren Sie, welchen RDP-Modus Sie ausführen möchten. Wählen Sie dazu einen der folgenden Werte aus dem Aufklappmenü:

  • On Demand, wenn Tosca die RDP-Session nur während der Ausführung öffnen und nach Abschluss der Ausführung schließen soll.

  • Always On, wenn Sie die RDP-Session öffnen möchten, sobald Sie den Agent starten, und dann geöffnet lassen möchten. Dies beschleunigt die Vorbereitungszeit und Ausführung des Agent. Die Vorbereitungszeit des Agent, da Sie Ihren UI-Session-Benutzer für diese Session nur einmal definieren müssen. Und die Ausführung, da der Agent Sessions bei Testdurchläufen nicht wiederholt öffnen und schließen muss.

Username

 

Geben Sie den Benutzernamen des Windows-Benutzers ein:

  • Wenn Ihre Credentials Source Local ist, geben Sie den Benutzernamen ein.

  • Wenn Ihre Credentials Source HashiCorp Key vault ist, geben Sie den Pfad zum Benutzernamen in Ihrem Schlüsseltresor ein: <Pfad zum Geheimnis>[<Feld>]. Zum Beispiel kv/tosca_dex/agent/rdp[Benutzername].

Password

 

Geben Sie das Passwort des Windows-Benutzers ein. Geben Sie je nach Credentials Source das Passwort direkt ein oder geben Sie den Pfad zum Passwort in Ihrem Schlüsseltresor ein.

Desktop Width

ja

Ändern Sie die Standardbreite des Remote-Desktops in Pixeln. Der Standardwert ist 1600.

Desktop Height

ja

Ändern Sie die Standardhöhe des Remote-Desktops in Pixeln. Der Standardwert ist 1200.

Color Depth

ja

Ändern Sie die Standardfarbtiefe des Remote-Desktops. Der Standardwert ist 16.

  1. Um zu überprüfen, ob Ihr Agent-Rechner über alle notwendigen Konfigurationen und Richtlinien für die Unattended Execution verfügt, wählen Sie Check RDP Configuration aus und gehen Sie den Report durch.

  2. Klicken Sie auf Save und schließen Sie das Fenster.

Über die Befehlszeile starten und verbinden

Um Ihre Agents über die Befehlszeile zu starten und zu verbinden, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie auf dem Agent-Rechner eine Eingabeaufforderung mit Administratorrechten.

  2. Navigieren Sie zum Ordner %TRICENTIS_DEX_AGENT_HOME%.

  3. Geben Sie folgenden Befehl in die Befehlszeile ein:

    ToscaDistributionAgent.exe cmd-only http://<IP-Adresse oder Hostname des Tosca Server Gateway>:<Tosca ServerGateway-Port>/DistributionServerService/CommunicationService.svc

    Wenn Sie eine IPv6-Adresse verwenden, muss die Serveradresse anstelle des Host-Namens die IP-Adresse enthalten.

  4. Richten Sie den Agent so ein, dass er RDP-Zugriff für die Unattended Execution erlaubt. Sie können dies in der Agent View des DEX Monitor tun (siehe Kapitel "Agents im Tosca Distributed Execution Monitor überwachen, wiederherstellen und konfigurieren").

Lizenzen verwalten

Sie benötigen eine gültige Tosca-Lizenz auf allen Rechnern, auf denen Sie Tricentis Tosca installieren:

  • Jeder Agent-Rechner benötigt eine ExecutionOnly-Lizenz.

  • Jeder Rechner, auf dem Sie Tests erstellen und deren Ausführung starten, benötigt eine entsprechende Tosca-Lizenz. Welche Lizenz Sie benötigen, hängt von der Art der Tests ab, die Sie erstellen. Für Informationen zu Lizenzoptionen kontaktieren Sie Tricentis Sales.

  • Um den AOS-Arbeitsbereich auf dem DEX Server einrichten zu können, benötigen Sie eine gültige Tosca-Lizenz.

    Sie benötigen diese Lizenz nur, um den Arbeitsbereich einzurichten. Sobald die Tosca Distributed Execution gestartet wurde und Sie nicht mehr mit dem DEX Server-Arbeitsbereich arbeiten, benötigen Sie keine Lizenz mehr für den Serverrechner.

Für Informationen zum Einrichten der Lizenzierung auf Ihren Rechnern siehe Kapitel "Lizenzverwaltung".

Arbeitsbereiche einrichten

Um die Tosca Distributed Execution with AOS verwenden zu können, müssen Sie separate Multiuser-Arbeitsbereiche einrichten.

Diese Arbeitsbereiche müssen Zugriff auf ein einziges Common Repository haben.

  • Ein Multiuser-Arbeitsbereich auf jedem Rechner, auf dem Sie Ihre Tests erstellen und starten. Dies sind Ihre Benutzer-Arbeitsbereiche.

  • Ein oder mehrere Multiuser-Arbeitsbereiche für den Automation Object Service (AOS). Diese Arbeitsbereiche existieren nur, um AOS Zugriff auf das Repository zu gewähren. Mehrere AOS-Arbeitsbereiche können die Leistung der Testausführung in größeren Projekten verbessern.

Arbeitsbereiche für Benutzer erstellen

Um Ihre Benutzer-Arbeitsbereiche einzurichten, führen Sie die folgenden Schritte aus:

  1. Erstellen Sie sie.

    • Wenn Sie bereits mit Tricentis Tosca arbeiten und ein Repository und Arbeitsbereiche haben, können Sie diesen Schritt überspringen.

    • Wenn Sie Ihr Repository und Arbeitsbereiche noch nicht eingerichtet haben, tun Sie dies jetzt (siehe Kapitel "Multiuser-Arbeitsbereiche erstellen"). Sie benötigen einen Arbeitsbereich auf jedem Rechner, auf dem ein Benutzer Tests erstellen und ausführen soll.

      Wenn Sie den ersten Arbeitsbereich erstellen, stellen Sie sicher, dass der Arbeitsbereichsname nur alphanumerische Zeichen und Unterstriche _ enthält.

      Verwenden Sie keine anderen Sonderzeichen.

  2. Öffnen Sie einen beliebigen Arbeitsbereich, der mit dem Repository verbunden ist.

  3. Gehen Sie zu Home->Project.

  4. Notieren Sie sich im Reiter Details den Projektwurzelnamen.

    Sie benötigen diesen Namen später, wenn Sie den Arbeitsbereich für den Automation Object Service einrichten.

Wenn Sie Schritt 1 übersprungen haben, weil Sie bereits ein Repository und Arbeitsbereiche haben, überprüfen Sie den Projektwurzelnamen.

Der Name darf nur alphanumerische Zeichen und Unterstriche _ enthalten.

Wenn Ihr Projektname andere Sonderzeichen enthält, müssen Sie ihn ändern:

  1. Checken Sie das Projektwurzelelement aus.

  2. Überschreiben Sie den vorhandenen Namen mit dem neuen Namen.

  3. Checken Sie es ein.

Projektwurzelnamen überprüfen

AOS-Arbeitsbereich erstellen

Der AOS-Arbeitsbereich gibt dem Automation Object Service (AOS) Zugriff auf alle erforderlichen Objekte im Repository, z. B. Testereignisse und Konfigurationen.

Beachten Sie Folgendes:

  • Der AOS-Arbeitsbereich ist ein Hintergrundarbeitsbereich für den Automation Object Service. Lassen Sie Benutzer nicht in diesem Arbeitsbereich arbeiten. Wenn Sie dies tun, verursachen Sie eine Fehlfunktion des Automation Object Service.

  • Verwenden Sie keine REST-Services mit Ihrem AOS-Arbeitsbereich. Diese führen zu einer Fehlfunktion des Automation Object Service. Die einzige Ausnahme von dieser Regel ist die AOS-REST-API, mit der Sie AOS-Arbeitsbereichsaufgaben ausführen können.

  • Wenn Sie den Zugriff auf Testobjekte mithilfe der Synchronisation verwalten, überprüfen Sie Ihre Synchronisationsrichtlinien im AOS-Arbeitsbereich. Der Service benötigt vollen Zugriff auf alle Testartefakte im Projekt.

  • Wenn Sie über mehrere Benutzerarbeitsbereiche und Objekte verfügen, können Sie mehrere AOS-Arbeitsbereiche erstellen, um die Ausführung zu beschleunigen.

Um einen AOS-Arbeitsbereich zu erstellen und einzurichten, führen Sie diese Schritte aus:

  1. Öffnen Sie den Tosca Commander auf dem Rechner des Distributed Execution (DEX) Server.

  2. Gehen Sie zu Project->New.

  3. Wählen Sie im folgenden Fenster Create new workspace Ihren Repository-Typ aus dem Aufklappmenü aus.

  4. Wenn Sie einen Tricentis Server Repository-Arbeitsbereich erstellen möchten, klicken Sie auf Login to Tricentis Server und melden Sie sich mit Ihren Anmeldedaten für die Tricentis User Administration an.

  5. Verbinden Sie den AOS-Arbeitsbereich mit dem Repository:

    • Für alle Repository-Typen außer Tricentis Server Repository wählen Sie Use existing repository und geben Sie die Verbindungszeichenfolge zu Ihrem Repository ein.

    • Für den Repository-Typ Tricentis Server Repository wählen Sie das Projekt aus dem Aufklappmenü Project Name.

  6. Geben Sie im Feld Select name for new workspace einen eindeutigen Namen für den neuen AOS-Arbeitsbereich ein.

  7. Stellen Sie sicher, dass Sie nicht Create slim workspace ausgewählt haben. Der AOS-Arbeitsbereich kann kein minimaler Arbeitsbereich sein.

  8. Klicken Sie auf OK, um den Arbeitsbereich zu erstellen.

AOS-Arbeitsbereich erstellen

  1. Öffnen Sie die Tricentis Service Configuration.

  2. Füllen Sie im Reiter Automation Object Service der Tricentis Service Configuration die Felder Workspace Folder, Project Root Name, Workspace Name, Username und Password aus.

  3. Für größere Projekte empfiehlt Tricentis, zusätzliche AOS-Arbeitsbereiche zu erstellen, um die Leistung der Testausführung zu verbessern. Wenn Sie dies tun möchten, wiederholen Sie die Schritte 2 bis 5.

  1. Um das AOS-Setup abzuschließen, konfigurieren Sie die Ausführungsumgebung, die Sie verwenden möchten:

    • Nur Distributed Execution

    • Nur Tosca Cloud

    • Distributed Execution und Tosca Cloud

  2. Klicken Sie auf Save und schließen Sie den Dialog Tricentis Service Configuration.

Distributed Execution with AOS für mehrere Common Repositorys konfigurieren (optional)

Standardmäßig arbeitet die Tosca Distributed Execution mit einem einzigen Common Repository.

Sie können sie so einrichten, dass sie mit mehreren Repositorys arbeitet. Weitere Informationen finden Sie hier: siehe Kapitel "Distributed Execution with AOS mit mehreren Repositorys".

Tosca Commander verbinden

Jetzt müssen Sie die Verbindung zwischen dem Tosca Commander und dem DEX Server angeben.

Sie müssen dies auf allen Rechnern tun, auf denen Sie Tests erstellen und Ausführungen starten möchten.

Alternativ können Sie Projekteinstellungen erstellen. In diesem Fall gelten die Einstellungen für alle Arbeitsbereiche, die mit dem Repository verbunden sind.

Um den Tosca Commander zu verbinden, führen Sie die folgenden Schritte aus:

  1. Öffnen Sie den Tosca Commander.

  2. Gehen Sie zu Project->Settings->Commander->DistributedExecution->Server.

  3. Geben Sie als Wert der Einstellung EndpointAddress die Adresse des Tosca Gateway Service wie folgt ein:

    http://<IP-Adresse oder Hostname des Tosca Server Gateway>:<Port>/DistributionServerService/ManagerService.svc

    Für Standardports siehe "Benötigte Ports für Features des Tricentis Tosca Server".

    Wenn Sie eine IPv6-Adresse verwenden, muss die Serveradresse anstelle des Hostnamens die IP-Adresse enthalten.

  4. Wenn Sie einen Proxyserver verwenden möchten, füllen Sie den Wert der Einstellung Proxy mit der vollständigen Netzwerkadresse des Proxyservers aus:

    http://<IP-Adresse oder Hostname des Proxyservers>:<Port>

  5. Gehen Sie zu Project->Settings->Commander->DistributedExecution->Monitor Url.

  6. Geben Sie als Wert der Einstellung Url die Adresse des Tosca Gateway Service wie folgt ein:

    http://<IP-Adresse oder Hostname des Tosca Server Gateway>:<Port>/Monitor/

Einstellungen ändern

Parallele Ausführung einrichten

Dieser letzte Schritt der Einrichtung der Tosca Distributed Execution ist optional.

Darin erstellen Sie eine Projektwurzel-Einstellung, mit der Benutzer definieren können, wie Ausführungslisten von Tosca ausgeführt werden sollen.

Wenn alle Testfälle in einer Ausführungsliste unabhängig voneinander sind, können Benutzer eine Ausführungsliste auf Agents aufteilen. Die Agents führen dann die Testfälle gleichzeitig aus, was den Testdurchlauf beschleunigt.

Um die Projektwurzel-Einstellung zu erstellen, gehen Sie wie folgt vor:

  1. Öffnen Sie einen Arbeitsbereich, der Zugriff auf das Common Repository hat, und gehen Sie zu Home->Project.

  2. Checken Sie das Projektwurzelelement aus.

  3. Wechseln Sie zum Reiter Properties definition.

  4. Klicken Sie im Reiter Properties definition mit der rechten Maustaste auf ExecutionList und wählen Sie Create Property aus der Minisymbolleiste.

  5. Benennen Sie die neue Eigenschaft in TCDistribution um.

  6. Stellen Sie sicher, dass Visible ausgewählt ist.

Eigenschaft TCDistribution für alle Ausführungslisten

AOS-Arbeitsbereichsaufgaben ausführen

Tricentis bietet eine REST-API für den Automation Object Service.

Mit der AOS-Rest-API können Sie die folgenden Aufgaben in Ihrem AOS-Arbeitsbereich ausführen:

  • Überprüfen, was in einem bestimmten AOS-Arbeitsbereich passiert.

  • Einen AOS-Arbeitsbereich komprimieren.

    Standardmäßig gibt es im AOS-Arbeitsbereich keine Aufgabe zum Komprimieren des Arbeitsbereichs. Infolgedessen kann sich das Abrufen und Behalten von Daten im Laufe der Zeit verlangsamen.

    Um dies zu vermeiden, empfiehlt Tricentis, Ihre AOS-Arbeitsbereiche regelmäßig zu komprimieren.

  • Einen AOS-Arbeitsbereich schließen und erneut öffnen.

    Tricentis Tosca behandelt den Automation Object Service als separaten Arbeitsbereich-Benutzer. Wenn Sie eine Ausführung auslösen, öffnet AOS den Arbeitsbereich als Benutzer. Dadurch wird der Arbeitsbereich gesperrt; kein anderer Benutzer kann darauf zugreifen.

    Wenn Sie etwas in diesem bestimmten Arbeitsbereich überprüfen müssen, z. B. wenn der Arbeitsbereich nicht wie erwartet funktioniert oder Sie Berechtigungen anpassen müssen, können Sie den Arbeitsbereich manuell schließen. Durch das Schließen des Arbeitsbereichs wird nichts verworfen. AOS beendet die laufenden Aufgaben und stellt alles andere in eine Warteschlange.

    Sobald Sie fertig sind, müssen Sie den Arbeitsbereich erneut öffnen. Dann kann AOS die Aufgaben in der Warteschlange abschließen.

AOS-REST-API aufrufen

Um mit einem beliebigen REST-Client auf den API-Endpunkt zuzugreifen, müssen Sie den Header X-TRICENTIS zu Ihren HTTP-Requests hinzufügen. Andernfalls antwortet der Webservice mit HTTP 400 Bad Request.

Um auf die AOS-Rest-API zuzugreifen, geben Sie die folgende URL ein:

http://<IP-Adresse oder Hostname des Tosca Server>:<Port>/swagger/index.html

  • Wenn Sie eine IPv6-Adresse verwenden, müssen Sie die IP-Adresse des Servers verwenden, nicht den Hostnamen.

  • Wenn Sie von dem Rechner, auf dem sich der Tosca Distribution Server befindet, auf die REST-API zugreifen, können Sie localhost anstelle der IP-Adresse/des Hostnamens eingeben.

  • Ersetzen Sie <AOS-Port> durch den AOS-Port, den Sie in der Tricentis Service Configuration angegeben haben.

AOS-Arbeitsbereichsaufgaben ausführen

Informationen zu AOS-REST-API-Requests und -Responses finden Sie in der Swagger-Dokumentation in der AOS-REST-API.

Nächste Schritte

Nachdem Sie nun die Tosca Distributed Execution eingerichtet haben, sind Sie bereit, mit dem Testen zu beginnen! Weitere Informationen finden Sie hier: siehe Kapitel "Testereignisse anlegen und ausführen".

Ihr aktuelles Setup anpassen

Sie können die Features der Tosca Distributed Execution nach dem Setup weiter anpassen. Weitere Konfigurationsoptionen finden Sie in den folgenden Kapiteln: