Installation des beA Message Servers

Überblick

Der beA Message Server ist die zentrale Backend-Komponente und verantwortlich für:

  • die Nachrichtensynchronisation mit dem beA-System
  • die Kommunikation mit STP-Komponenten
  • die Datenspeicherung und -verarbeitung

Er muss vor der Installation des beA Desk Clients installiert werden.

Installationsvoraussetzungen

Stellen Sie vor Beginn der Installation sicher, dass:

  • ein SQL Server verfügbar ist
  • das STP User Management installiert ist
  • der LEXolution Service Bus verfügbar ist

Installation starten

Führen Sie die Installationsdatei aus:

STP beA Message Server Setup <VERSION>.exe

Hinweis
Führen Sie das Setup als Administrator und von einem lokalen Laufwerk aus.

Installationsart

Wählen Sie:

  • Complete → empfohlen
  • Custom → ermöglicht individuelle Konfiguration

Installationspfad

Standardpfad:

C:\Programme\STP beA Message Server

Hinweis
Eine Änderung des Standardpfads wird nicht empfohlen.

Serverkonfiguration

Datenbankkonfiguration

Die Datenbank wird beim ersten Start automatisch erstellt, sofern sie noch nicht existiert.

Hinweis
Bei Update-Installationen werden Änderungen am Datenbankschema beim ersten Start automatisch übernommen.

Erforderliche Parameter
  • DB Server → Datenbank-Host
  • DB Name → Standard: STP_beA
  • DB User → Datenbankbenutzer mit vollständigen Berechtigungen
  • DB Password → entsprechendes Passwort

Hinweis
Der Datenbankbenutzer muss berechtigt sein, das Schema zu erstellen sowie Daten zu lesen, zu schreiben und zu löschen. Die Verwendung des „sa“-Benutzers sollte vermieden werden.

API-Konfiguration

  • Computer Name → Server-Hostname
  • HTTP Port → Standard: 8096
  • HTTPS Port → Standard: 8097

Hinweis
Passen Sie die Ports nur an, wenn diese bereits von anderen Diensten verwendet werden.

LEXolution Service Bus (LSB)

  • Host → Servername
  • Port → Standard: 5672
  • Benutzername / Passwort → Zugangsdaten des LSB

STP User Management

  • Username → Service-Benutzer
  • Password → entsprechendes Passwort

Hinweis
Stellen Sie sicher, dass die Zugangsdaten korrekt sind, da das Setup diese nicht überprüft.

Blob Storage

Definiert den Speicherort für alle Dateien:

  • Anhänge
  • Dokumente
  • Nachrichtendaten

Hinweis
Nehmen Sie keine manuellen Änderungen an Dateien in diesem Verzeichnis vor.

Hinweis
Dieses Verzeichnis muss in die Backups aufgenommen werden.

Weitere Konfiguration

Hinweis
Das Setup überprüft die Verbindungsdaten für Datenbank, LSB und User Management nicht. Stellen Sie sicher, dass alle Angaben korrekt sind.

STP Updater

Wenn bereits ein STP Update Server installiert ist, sind keine Änderungen erforderlich.
Die beA-spezifischen Einstellungen werden automatisch ergänzt.

beA Desk Signer ID

Wenn der beA Desk Signer verwendet wird, muss die entsprechende Signer-ID während des Setups eingegeben werden.

Hinweis
Diese Einstellung ist nur erforderlich, wenn der beA Desk Signer zum Signieren verwendet wird.

Abschluss der Installation

Klicken Sie auf Install, um die Installation abzuschließen.

Nach der Installation:

  • startet der Dienst automatisch
  • läuft der Message Server als Windows-Dienst

Überprüfung

Überprüfen Sie die Installation über:

  • Windows-Dienste
  • Dienststatus = aktiv

Wichtige Hinweise

Hinweis
Es kann nur ein beA Message Server pro LEXolution Service Bus betrieben werden.

Hinweis
Der Message Server benötigt Zugriff auf externe Dienste (z. B. https://www.xrepository.de), um XJustiz-Codelisten aktuell zu halten.

Hinweis
Für einen korrekten Start müssen STP User Management und LEXolution Service Bus bereits laufen.

Hinweis
Nach einem Systemneustart kann der Message Server kurz warten, bis abhängige Dienste verfügbar sind.

Fehlerbehebung

Falls Probleme beim Start auftreten:

  • prüfen Sie die Logdateien:
    %PROGRAMDATA%\STP AG\beA Message Server\Logs

  • überprüfen Sie:

    • die Datenbankverbindung
    • die Verfügbarkeit des LEXolution Service Bus
    • die Verfügbarkeit des STP User Management

Verknüpfung mit