STP.Common Service installieren

Der Dienst RabbitMQ und die Schnittstellen in den angebundenen Programmen und Windows-Diensten bilden gemeinsam den Service Bus (SB). Der SB ermöglicht die Kommunikation zwischen Diensten und Anwendungen.

Das Setup installiert die notwendigen Serverkomponenten für den Service Bus (SB) auf dem Server oder einem anderen Server.

Hinweis
Für die Installation von Erlang OTP muss die Windows-Umgebungsvariable Homedrive C: sein.

Geben Sie in der Eingabeaufforderung set homedrive ein und drücken Sie die Taste [Enter], um die Umgebungsvariable zu ermitteln. Brechen Sie die Installation ab, wenn ein anderer Wert konfiguriert ist.

Starten Sie eine neue Eingabeaufforderung als Administrator, geben Sie Set HOMEDRIVE=C: ein, um die Umgebungsvariable für die aktuelle Session zu ändern.

Wechseln Sie mit dem Befehl cd zum Installationsverzeichnis und starten Sie aus dieser Eingabeaufforderung die Installationsdatei STP.Common.Services.Setup.exe.

Starten Sie die ausführbare Datei STP.Common.Services.Setup.exe.

Das Setup installiert zuerst die Laufzeitkomponenten Erlang OTP und danach den Dienst RabbitMQ.

Verwenden Sie zur Konfiguration nach Möglichkeit die vom Installationsprogramm vorgeschlagenen Werte.

Hinweis
Unterbrechen Sie das Setup nicht und schließen Sie insbesondere keine vom Installationsprogramm geöffneten Eingabeaufforderungen.

Wenn eine Eingabeaufforderung eine Aktion des Anwenders erfordert, ist ein Fehler aufgetreten. Wenden Sie sich in diesem Fall an den Service der STP Informationstechnologie GmbH.

RabbitMQ-Benutzerkonfiguration für STP Common Service

1. Administrator-Benutzer anlegen (stpadmin)

  1. Melden Sie sich an der RabbitMQ-Weboberfläche an (z. B. http://localhost:15672) mit einem Benutzer, der über Administratorrechte verfügt (z. B. guest).

  2. Navigieren Sie zu Admin → Users und klicken Sie auf Add user.

  3. Füllen Sie die Felder wie folgt aus:

    • Username: stpadmin
    • Password: sicheres Passwort wählen
    • Tags: administrator

  4. Klicken Sie auf Add user.

  5. Wechseln Sie zum Abschnitt Permissions für den virtuellen Host (in der Regel /) und vergeben Sie folgende Rechte:

    • Configure: .*
    • Write: .*
    • Read: .*

  6. Klicken Sie auf Set permission.

Hinweis
Der Benutzer guest ist standardmäßig nach der Installation mit dem Passwort guest aktiv. Er kann ausschließlich über localhost (also direkt auf dem Server) auf RabbitMQ zugreifen.

Sobald Sie den Benutzer stpadmin erfolgreich eingerichtet haben, sollten Sie sich mit diesem anmelden und den Benutzer guest vollständig löschen, um ein potenzielles Sicherheitsrisiko auszuschließen.

2. Benutzerrechte für bestehenden Benutzer stpuser ändern

  1. Navigieren Sie zu Admin → Users.

  2. Wählen Sie den Benutzer stpuser aus.

  3. Klicken Sie auf Update this user.

  4. Entfernen Sie im Feld Tags den Eintrag administrator. Lassen Sie das Feld leer.

  5. Bestätigen Sie die Änderung mit dem aktuellen Passwort (stp.). Achtung: Falls Sie hier ein neues Passwort vergeben, müssen Sie das Passwort in allen Clients und Servern in den jeweiligen Configs aktualisieren.

  6. Klicken Sie auf Update user, um die Änderungen zu speichern.

  7. Scrollen Sie nach unten zum Bereich Permissions.

  8. Wählen Sie den virtuellen Host (in der Regel /) aus.

  9. Tragen Sie folgende Rechte ein:

    • Configure: .*
    • Write: .*
    • Read: .*

  10. Klicken Sie auf Set permission.

Hinweis
Der Benutzer stpuser darf ausschließlich für den Nachrichtenaustausch in STP-Produkten verwendet werden. Er darf keinen Zugang zur RabbitMQ-Verwaltungsoberfläche erhalten.

Firewall

Geben auf Sie dem Rechner, auf dem der Dienst RabbitMQ läuft, den Port 15672 in der Firewall frei.

Verknüpfung mit