Integritätsprüfung für Tosca Server-Services

Der Tosca Gateway Service via Consul bietet eine Überwachungsfunktion, die erkennt, ob ein Tosca Server-Feature oder ein Service, den Sie installiert haben, verfügbar ist und ausgeführt wird.

Um zu sehen, ob ein Service ausgeführt wird, rufen Sie die Startseite des Tosca Server auf. Nicht verfügbare Service-Kacheln sind hellgrau.

Tosca-Services über die Startseite des Tosca Server konfigurieren

Sie können Tosca-Services in der Service Configuration konfigurieren, auf die Sie über die Startseite des Tosca Server zugreifen können.

Klicken Sie oben rechts auf der Startseite auf Settings, um die Service Configuration zu öffnen.

Was tun, wenn keine Tosca Server-Services verfügbar sind?

Wenn eine Service-Kachel auf der Startseite des Tosca Server grau ist, bedeutet dies, dass der Service nicht ausgeführt wird. In diesem Fall gibt es mehrere Möglichkeiten, ihn neu zu starten.

Ein Service ist nicht verfügbar

Wenn ein Service nicht verfügbar ist, starten Sie ihn auf eine der folgenden Arten:

Über den Windows Task-Manager:

  1. Öffnen Sie den Task-Manager im Start-Menü von Windows.

  2. Gehen Sie auf die Registerkarte Dienste und suchen Sie den nicht verfügbaren Dienst in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Starten oder Neu starten, je nachdem, welche Option verfügbar ist.

Über die Windows-Dienste:

  1. Öffnen Sie die Dienste im Start-Menü von Windows.

  2. Suchen Sie den nicht verfügbaren Dienst in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Neu starten.

Wenn ein Neustart den Service nicht verfügbar macht, gehen Sie zu <Tosca Server-Installationsordner>/<Ordner des nicht verfügbaren Service>/appsettings.json. Überprüfen Sie die Datei appsettings.json auf fehlerhafte Einträge, wie z. B. falsche Endpunkte.

Alle Services sind nicht verfügbar

Wenn alle Services nicht verfügbar sind, ist Consul, die Software, die den Tosca Gateway Service hostet, möglicherweise nicht verfügbar. Starten Sie in diesem Fall den Consul Service auf eine der folgenden Arten:

Über den Windows Task-Manager:

  1. Öffnen Sie den Task-Manager im Start-Menü von Windows.

  2. Gehen Sie auf die Registerkarte Dienste und suchen Sie Consul.Service in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Starten oder Neu starten, je nachdem, welche Option verfügbar ist.

Über die Windows-Dienste:

  1. Öffnen Sie die Dienste im Start-Menü von Windows.

  2. Suchen Sie Consul.Service in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Neu starten.

Startseite ist nicht verfügbar

Die Startseite des Tosca Server ist ebenfalls ein Service und kann Ausfallzeiten haben. Wenn Sie nicht auf die Startseite des Tosca Server zugreifen können, starten Sie sie auf eine der folgenden Arten:

Über den Windows Task-Manager:

  1. Öffnen Sie den Task-Manager im Start-Menü von Windows.

  2. Gehen Sie auf die Registerkarte Dienste und suchen Sie Tricentis.GatewayService in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Starten oder Neu starten, je nachdem, welche Option verfügbar ist.

Über die Windows-Dienste:

  1. Öffnen Sie die Dienste im Start-Menü von Windows.

  2. Suchen Sie Tricentis.GatewayService in der Liste.

  3. Klicken Sie mit der rechten Maustaste auf den Dienstnamen und wählen Sie Neu starten.

Service Configuration ist nicht erreichbar

Wenn Sie den Tosca Gateway Service konfiguriert haben und die Service Configuration nicht mehr erreichen können, können Sie den Service auf die Standardeinstellung zurücksetzen.

Führen Sie hierzu die folgenden Schritte aus:

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

  2. Ersetzen Sie im Abschnitt HttpServer den Wert von Port durch einen gültigen Zahlenwert.

  3. Setzen Sie den Wert von Scheme auf http.

  4. Entfernen Sie den Wert von Thumbprint. Er muss eine leere Zeichenfolge ("") sein.

  5. Ändern Sie im Abschnitt Discovery den Wert von ServiceDiscovery auf http://localhost:<Port>. Der Port muss mit dem Port übereinstimmen, den Sie im Abschnitt HttpServer angegeben haben.

  6. Speichern und schließen Sie die Datei.

Fahren Sie mit den folgenden Schritten fort:

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

  2. Ändern Sie im Abschnitt GlobalConfiguration den Wert von BaseUrl auf den gleichen Wert, den Sie für ServiceDiscovery in der Datei appsettings.json angegeben haben.

  3. Ändern Sie den Wert unter Host auf localhost.

  4. Ändern Sie den Wert unter DownstreamScheme auf http.

  5. Ändern Sie im Abschnitt Routes den Wert von DownstreamScheme auf allen Routen, auf denen ServiceId den Wert LandingPage hat, und auf allen Routen, auf denen die Eigenschaft ServiceId nicht vorhanden ist, auf http.

  6. Ändern Sie den Wert von Host auf allen Routen, auf denen ServiceId den Wert LandingPage hat, und auf allen Routen, auf denen die Eigenschaft ServiceId nicht vorhanden ist, auf localhost.

  7. Ändern Sie den Wert von Port auf den gleichen Wert, den Sie für ServiceDiscovery in der Datei appsettings.json auf allen Routen angegeben haben, auf denen ServiceId den Wert LandingPage hat, und auf allen Routen, auf denen die Eigenschaft ServiceId nicht vorhanden ist.

  8. Speichern und schließen Sie die Datei.

  9. Öffnen Sie die Dienste im Start-Menü von Windows.

  10. Klicken Sie mit der rechten Maustaste auf den Dienst und wählen Sie Neu starten.

Wenn die Service Configuration nach Durchführung dieser Schritte immer noch nicht verfügbar ist, deinstallieren Sie den Tosca Server und installieren Sie ihn erneut.

Was tun, wenn der Tosca Gateway-Port nicht verfügbar ist?

Es ist möglich, dass der zuvor verwendete Gateway-Port nicht verfügbar ist, wenn Sie den Tosca Server deinstalliert haben und versuchen, ihn sofort neu zu installieren. Dieses Problem sollte nach einer Wartezeit von ein bis zwei Minuten behoben sein.