Installing the beA Message Server

Overview

The beA Message Server is the central backend component and is responsible for:

• message synchronization with the beA system
  
• communication with STP components
  
• data storage and processing

It must be installed before installing the beA Desk Client.

Installation Requirements

Before you begin installation, make sure that:

• an SQL Server is available
  
• STP User Management is installed
  
• the LEXolution Service Bus is available

Start Installation

Run the installation file:

STP beA Message Server Setup <VERSION>.exe

Note
Run the setup as an administrator and from a local drive.

Installation Type

Select:

• Complete → recommended
  
• Custom → allows custom configuration

Installation Path

Default path:

C:\Program Files\STP beA Message Server

Note
Changing the default path is not recommended.

Server Configuration

Database Configuration

The database will be created automatically on first startup if it does not already exist.

Note
For update installations, changes to the database schema will be applied automatically on first startup.

Required Parameters

• DB Server → database host
  
• DB Name → default: STP_beA
  
• DB User → database user with full permissions
  
• DB Password → corresponding password

Note
The database user must have permission to create the schema, as well as read, write, and delete data. Avoid using the "sa" user.

API Configuration

• Computer Name → server hostname
  
• HTTP Port → default: 8096
  
• HTTPS Port → default: 8097

Note
Only change the ports if they are already in use by other services.

LEXolution Service Bus (LSB)

• Host → server name
  
• Port → default: 5672
  
• Username / Password → LSB login credentials

STP User Management

• Username → service user
  
• Password → corresponding password

Note
Make sure the login credentials are correct, as the setup does not verify them.

Blob Storage

Defines the storage location for all files:

• attachments
  
• documents
  
• message data

Note
Do not make manual changes to files in this directory.

Note
This directory must be included in backups.

Additional Configuration

Note
The setup does not check the connection data for the database, LSB, or User Management. Make sure all information is correct.

STP Updater

If an STP Update Server is already installed, no changes are needed.
The beA-specific settings will be added automatically.

beA Desk Signer ID

If the beA Desk Signer is used, the corresponding signer ID must be entered during setup.

Note
This setting is only required if the beA Desk Signer is used for signing.

Completing the Installation

Click Install to finish the installation.

After installation:

• the service starts automatically
  
• the Message Server runs as a Windows service

Verification

Check the installation via:

• Windows Services
  
• Service status = active

Important Notes

Note
Only one beA Message Server can be operated per LEXolution Service Bus.

Note
The Message Server needs access to external services (e.g., https://www.xrepository.de) to keep XJustiz code lists up to date.

Note
For proper startup, STP User Management and LEXolution Service Bus must already be running.

Note
After a system restart, the Message Server may briefly wait until dependent services are available.

Troubleshooting

If problems occur during startup:

• check the log files:
  %PROGRAMDATA%\STP AG\beA Message Server\Logs

• check the following:

  • the database connection
    
  • availability of the LEXolution Service Bus
    
  • availability of STP User Management