/
Der DMS-Service soll mit 3 Instanzen laufen und über das Gateway geroutet werden

Der DMS-Service soll mit 3 Instanzen laufen und über das Gateway geroutet werden

Autor: Christopher Curio

Stand 02.03.2026

 

Im System sollen 3 DMS-Instanzen aktiviert werden. Standardmäßig benutzt das Gateway die Instanzen als Balancing. Das soll geändert werden. Jeder einzelne soll explizit über das Gateway aufgerufen werden können.

Nachfolgend ist beschrieben, wie man das umsetzen könnte.

 

Schritt für Schritt Anleitung

Sichern

Zuerst die Konfiguration des Servicemanagers (config-Verzeichnis) sichern, bitte außerhalb des Servicemanager\config-Verzeichnisses.

Anpassung der servicewatcher-sw.yml:

  • DMS-Service auf 3 Instanzen stellen und eine Range an Ports eintragen:

    image-20260302-131003.png

  • Nach dem Speichern den Servicemanager neu starten.

  • Über die Servicemanager-Admin-Seite prüfen, ob die 3 Instanzen nun geladen werden.

    image-20260302-132252.png

 

Sichern

Zuerst die Konfiguration des Gateway (config-Verzeichnis) sichern, bitte außerhalb des Gateway-Verzeichnisses.

Erweiterung von application-prod.yml (Gateway):

Das enaio Gateway verwendet die 3 DMS-Instanzen standardmäßig als Balancing. Wenn man die Endpunkte direkt ansprechen möchte, muss man sie konfigurieren. Dazu:

  • 3 Endpoints hinzufügen:
    Wichtig: Auf korrekte Anzahl an Leerzeichen achten.

    image-20260302-132720.png


    Auszug zum Kopieren:

    proxy: defaultEntryPoint: '/osweb' services: handleRedirectsFromService: 'osweb' endpoints: - endpoint: { name: dms1, url: 'http://{Service-Manager-IP}:7981' } - endpoint: { name: dms2, url: 'http://{Service-Manager-IP}:7982' } - endpoint: { name: dms3, url: 'http://{Service-Manager-IP}:7983' }

  • Dienst enaio Gateway neu starten.

  • Im Log prüfen, ob auch die endpoints eingelesen werden. Dazu da gateway.log öffnen und:

    • nach dms suchen.
      Beim 1. Eintrag sollten alle 3 DMS-Services zu finden sein.
      Beim 2. Eintrag ist sichtbar, an wen sich das Gateway aktuell bindet.

    • Desweiteren sollten alle 3 API-Endpoints zu finden sein.

    • Ausschnitt osgateway.log
      add mapping for [dms] --> [http://{service-manager}:{Port}

 

Aufrufe vom DMS erfolgen dann wie folgt:

 

Die Beispiel-URLs nehmen an, dass das Gateway auf HTTPS umgestellt ist. Wenn das Gateway noch mit HTTP läuft, die URLs entsprechend anpassen.

 

Der Aufruf erfolgt nun über die Endpunkte. Bitte beachten, dass die URLs nun vom Standard abweichen!

DMS-Standard:
https://gateway.domain/api/dms/objects/{object-id}

 

Direkt:
https://{Gateway-FQDN}/api3/objects/{object-id}
https://{Gateway-FQDN}/api2/objects/{object-id}
https://{Gateway-FQDN}/api1/objects/{object-id}


Beispiel:

image-20260302-134208.png

Erwartungshaltung sollte hier sein, dass der in der servicewatcher-sw.yml hinterlegte Port für das Mapping verwendet wurde.


Routing-Beispiel:
API1 wird fest zu Port 7981 geroutet, AP2 zu 7982 und API zu 7981

image-20260302-134146.png

 

 

Verwandte Artikel