Attended Installation
In your Lobster Data Platform go to Configuration → Connections → Bridge Connections
In the upper right corner klick on "Download Lobster Bridge" and wait for the download to complete. You need to allow popups in your browser for this to work. The installation file contains all necessary item for Windows and Linux/MacOS.
Java
On the Bridge System Java 11 has to be installed (up to date version, preferably https://adoptium.net/de/temurin/releases/?os=any&arch=any&version=11)
Make sure that the e nvironment variable JAVA_HOME is set.
Installing Lobster Bridge Service
Unzip the installation package in the desired folder.
With the Lobster Service Wrapper the bridge can be installed and run as system service on Linux and Windows. The Service Wrapper is located in the "bin" folder of the bridge installation. Start the Service Wrapper with "java -jar wrapper.jar".
> java -jar .\bin\wrapper.jar[2025-09-18 07:45:45,830] Starter Service Management Commands:[2025-09-18 07:45:45,832][2025-09-18 07:45:45,832] Service Installation & Management:[2025-09-18 07:45:45,832] --install-service Install Starter as a system service[2025-09-18 07:45:45,832] --uninstall-service Uninstall the Starter service[2025-09-18 07:45:45,832] --start-service Start the Starter service[2025-09-18 07:45:45,832] --stop-service Stop the Starter service[2025-09-18 07:45:45,832] --restart-service Restart the Starter service[2025-09-18 07:45:45,832] --service-status Show service status information[2025-09-18 07:45:45,832] --enable-service Enable service for automatic startup[2025-09-18 07:45:45,832] --disable-service Disable automatic startup[2025-09-18 07:45:45,832] --run Run in console[2025-09-18 07:45:45,832][2025-09-18 07:45:45,833] Platform Support:[2025-09-18 07:45:45,833] - Windows: Uses Windows Service Control Manager[2025-09-18 07:45:45,833] - Linux: Uses systemd service management[2025-09-18 07:45:45,833][2025-09-18 07:45:45,833] Examples:[2025-09-18 07:45:45,833] java -jar wrapper.jar --install-service[2025-09-18 07:45:45,833] java -jar wrapper.jar --start-service[2025-09-18 07:45:45,833] java -jar wrapper.jar --service-statusRun the bridge on console
For testing purpose, the bridge can be started on console:
> java -jar .\bin\wrapper.jar --run[2025-09-18 08:26:40,536] Package logging initialized successfully. Log directory: D:\lobster\bridge\logs[2025-09-18 08:26:40,536] Starting Lobster Application Wrapper...[2025-09-18 08:26:40,536] Starting Lobster Application Wrapper (restart count: 0)[2025-09-18 08:26:40,536] Starting application sequence...[2025-09-18 08:26:40,537] Starting JVM subprocess for Updater[2025-09-18 08:26:40,538] JVM argument: -Djava.io.tmpdir=./tmpIO[2025-09-18 08:26:40,538] Classpath entry: ./bin/updater.jar[2025-09-18 08:26:40,538] Program argument: C:/lobster/bridge[2025-09-18 08:26:40,551] Launched JVM subprocess with PID: 26924[2025-09-18 08:26:40,712] [2025-09-18 10:26:40] [INFO] No CData drivers found to install/update.[2025-09-18 08:26:40,831] [2025-09-18 10:26:40] [INFO] Checking for patch file(s)...[2025-09-18 08:26:40,836] [2025-09-18 10:26:40] [INFO] No patch file(s) found. Aborting.[2025-09-18 08:26:40,853] [2025-09-18 10:26:40] [INFO] Legacy installer version check:[2025-09-18 08:26:40,854] [2025-09-18 10:26:40] [INFO] Installed version of Lobster Data Platform: 25.1.0[2025-09-18 08:26:40,855] [2025-09-18 10:26:40] [INFO] Legacy installer may run: false[2025-09-18 08:26:40,865] [2025-09-18 10:26:40] [INFO] Starting legacy patch installer...[2025-09-18 08:26:40,865] [2025-09-18 10:26:40] [INFO] Checking installation directory 'D:\\lobster\\bridge'...[2025-09-18 08:26:40,865] [2025-09-18 10:26:40] [INFO] --------------------------------------------------------------------------[2025-09-18 08:26:40,867] [2025-09-18 10:26:40] [INFO] Checking backup directory 'D:\\lobster\\bridge\\logs\\backup\\libbackup'...[2025-09-18 08:26:40,867] [2025-09-18 10:26:40] [INFO] --------------------------------------------------------------------------[2025-09-18 08:26:40,868] [2025-09-18 10:26:40] [INFO] Starting legacy updater...[2025-09-18 08:26:40,869] [2025-09-18 10:26:40] [INFO] No patch files found in directory D:\\lobster\\bridget\\etc\\update\\patches[2025-09-18 08:26:41,912] Starting JVM subprocess for Bridge[2025-09-18 08:26:41,913] JVM argument: -Dhsqldb.method_class_names=java.lang.Math[2025-09-18 08:26:41,913] JVM argument: -Djava.io.tmpdir=C:/lobster/bridge/tmpIO....[2025-09-18 08:26:41,915] Program argument: C:/lobster/bridge/etc/dummy.xml[2025-09-18 08:26:41,920] Launched JVM subprocess with PID: 28652[2025-09-18 08:26:42,720] --------------------------------------------------------------------------[2025-09-18 08:26:42,721] (c) 2019-2025 by Lobster GmbH[2025-09-18 08:26:42,721] Starting Lobster Bridge Server, version 25.1.0-SNAPSHOT[2025-09-18 08:26:42,721] Starting configured services, please stand by...[2025-09-18 08:26:43,159] Reading system configuration from 'file:d:/lobster/bridge/logs/etc/system.conf'[2025-09-18 08:26:43,160] Trying to read system configuration[2025-09-18 08:26:43,163] System is configured for product 1001002, features 80 and installation 1002p[2025-09-18 08:26:43,172] LicenseManager 1.1.2_56741 trying to load license[2025-09-18 08:26:43,172] Checking legacy license[2025-09-18 08:26:43,875] System is licensed to *** Lobster GmbH (DW) ***[2025-09-18 08:26:43,875] Licensed services:[2025-09-18 08:26:43,878] 'AS2'[2025-09-18 08:26:43,878] 'CommunicationLog'[2025-09-18 08:26:43,878] 'DataWizard'[2025-09-18 08:26:43,878] 'Sms'[2025-09-18 08:26:43,879] 10:26:43 [MESSAGE] SYSTEM:SERVICEFACTORY Started all configured subsystems of IS/5.9.16_...[2025-09-18 08:26:50,944] [main] INFO org.atmosphere.cpr.AtmosphereFramework - Atmosphere Framework 2.7.3.slf4jvaadin6 started.[2025-09-18 08:26:50,948] [main] INFO org.atmosphere.cpr.AtmosphereFramework - Installed AtmosphereInterceptor Track Message Size Interceptor using | with priority BEFORE_DEFAULT[2025-09-18 08:26:51,288] [qtp1171713907-106] INFO com.vaadin.flow.server.DefaultDeploymentConfiguration - Vaadin is running in production mode.[2025-09-18 08:26:51,422] Started HTTP-server 'Main Server'[2025-09-18 08:26:51,422] Http servers started[2025-09-18 08:26:51,449] WARNING: A terminally deprecated method in java.lang.System has been called[2025-09-18 08:26:51,451] WARNING: System::setSecurityManager has been called by com.ebd.hub.server.MainServer (file:/C:/lobster/bridge/lib/Hub.jar)[2025-09-18 08:26:51,451] WARNING: Please consider reporting this to the maintainers of com.ebd.hub.server.MainServer[2025-09-18 08:26:51,451] WARNING: System::setSecurityManager will be removed in a future release[2025-09-18 08:26:51,451] Lobster Bridge Server started in 8731 ms, system is ready...[2025-09-18 08:26:51,451] --------------------------------------------------------------------------Install as system service
To install the bridge as system service open a shell with the required user rights to install a system service:
Windows
Open a shell as Administrator.
Linux
Use "sudo" to run the command as root user "sudo java -jar wrapper.jar --install-service"
Install the service
> java -jar .\bin\wrapper.jar --install-service[2025-09-18 07:46:04,486] Package logging initialized successfully. Log directory: d:\lobster\bridge\logs[2025-09-18 07:46:04,490] Installing Starter as a service on Windows...[2025-09-18 07:46:04,560] Installing service 'LobsterApplicationWrapper' on Windows[2025-09-18 07:46:04,560] Using startcommand: C:\Program Files\Eclipse Adoptium\jdk-17.0.16.8-hotspot\bin\java.exe -Djava.awt.headless=true -server -Dfile.encoding=UTF-8 -jar d:\lobster\bridge\bin\wrapper.jar --windows-service[2025-09-18 07:46:04,568] Service 'LobsterApplicationWrapper' installed successfully[2025-09-18 07:46:04,568] Service installed successfully![2025-09-18 07:46:04,568]You can now:[2025-09-18 07:46:04,569] - Start the service: java -jar starter.jar --start-service[2025-09-18 07:46:04,569] - Stop the service: java -jar starter.jar --stop-service[2025-09-18 07:46:04,569] - Check status: java -jar starter.jar --service-status[2025-09-18 07:46:04,570] Shutdown signal received, initiating graceful shutdown...[2025-09-18 07:46:04,570] Stopping Lobster Application Wrapper...[2025-09-18 07:46:04,570] Process manager shutdown complete[2025-09-18 07:46:04,570] Lobster Application Wrapper stopped successfullyUninstall the service
> java -jar wrapper.jar --uninstall-service[2025-09-18 08:25:27,764] Package logging initialized successfully. Log directory:d:\lobster\bridge\logs[2025-09-18 08:25:27,766] Executing uninstall command on Windows...[2025-09-18 08:25:27,841] Uninstalling service 'LobsterApplicationWrapper' on Windows[2025-09-18 08:25:27,843] Service 'LobsterApplicationWrapper' uninstalled successfully[2025-09-18 08:25:27,843] Service uninstalled successfully![2025-09-18 08:25:27,843] Shutdown signal received, initiating graceful shutdown...[2025-09-18 08:25:27,843] Stopping Lobster Application Wrapper...[2025-09-18 08:25:27,844] Process manager shutdown complete[2025-09-18 08:25:27,844] Lobster Application Wrapper stopped successfullyStart the service
> java -jar .\bin\wrapper.jar --start-service[2025-09-18 07:47:00,229] Package logging initialized successfully. Log directory:d:\lobster\bridge\logs[2025-09-18 07:47:00,233] Executing start command on Windows...[2025-09-18 07:47:00,306] Starting service 'LobsterApplicationWrapper' on Windows[2025-09-18 07:47:01,070] Service 'LobsterApplicationWrapper' started successfully[2025-09-18 07:47:01,071] Service started successfully![2025-09-18 07:47:03,098] Service is running.[2025-09-18 07:47:03,100] Shutdown signal received, initiating graceful shutdown...[2025-09-18 07:47:03,101] Stopping Lobster Application Wrapper...[2025-09-18 07:47:03,101] Process manager shutdown complete[2025-09-18 07:47:03,101] Lobster Application Wrapper stopped successfullyStop the service
> java -jar .\bin\wrapper.jar --stop-service[2025-09-18 07:52:21,921] Package logging initialized successfully. Log directory: d:\lobster\bridge\logs[2025-09-18 07:52:21,922] Executing stop command on Windows...[2025-09-18 07:52:21,991] Stopping service 'LobsterApplicationWrapper' on Windows[2025-09-18 07:52:22,808] Service 'LobsterApplicationWrapper' stopped successfully[2025-09-18 07:52:22,808] Service stopped successfully![2025-09-18 07:52:22,809] Shutdown signal received, initiating graceful shutdown...[2025-09-18 07:52:22,809] Stopping Lobster Application Wrapper...[2025-09-18 07:52:22,810] Process manager shutdown complete[2025-09-18 07:52:22,810] Lobster Application Wrapper stopped successfullyCheck service status:
> java -jar .\bin\wrapper.jar --service-status[2025-09-18 07:50:31,340] Package logging initialized successfully. Log directory:d:\lobster\bridge\logs[2025-09-18 07:50:31,343] Executing status command on Windows...[2025-09-18 07:50:31,429] Service Status Information:[2025-09-18 07:50:31,429] Name: LobsterApplicationWrapper[2025-09-18 07:50:31,429] Display Name: Lobster Application Wrapper[2025-09-18 07:50:31,429] Platform: Windows[2025-09-18 07:50:31,429] Installed: YES[2025-09-18 07:50:31,429] Running: YES[2025-09-18 07:50:31,429] Status: Service[LobsterApplicationWrapper] State=RUNNING PID=26688 CanStop=true CanPause=true[2025-09-18 07:50:31,433] Shutdown signal received, initiating graceful shutdown...[2025-09-18 07:50:31,434] Stopping Lobster Application Wrapper...[2025-09-18 07:50:31,434] Process manager shutdown complete[2025-09-18 07:50:31,434] Lobster Application Wrapper stopped successfullyDisable and Enable the service
The automatic startup of the service can be enabled and disabled with
> java -jar .\bin\wrapper.jar --enable-service
> java -jar .\bin\wrapper.jar --disable-service
Service Wrapper Log file
The service wrapper log file is <INSTALLATION_FOLDER>/logs/wrapper.log
Configuring
Application URL
To access the Lobster Bridge application interface, navigate to the following URL in your web browser, By default, Lobster Bridge is configured to use SSL port 443. The SSL port configuration can be found and customized in “./etc/hub.xml”
https://<Server-IP-or-Hostname>:<SSL-Port>/bridge
First Time Login
Username: admin
Password: admin
Upon first login, users will be guided through a straightforward installation and configuration process using the Lobster Bridge Installer. This interactive installer simplifies setup by prompting users through clearly defined steps.
The only mandatory step during initial setup with the Lobster Bridge Installer is the creation of the Bridge Administrator user account. All other configuration steps, such as uploading certificates—essential for the application's secure and proper functionality—and configuring AS2 settings, can either be completed during installation or configured later within the application itself.
At first start the wizard must be completed.
The two necessary steps are creating a user and exchanging the certificates. The rest of the configuration process like AS2 can be skipped and completed later.
Create the bridge admin user
Enter the bridge id and password from the platform
Create the bridge certificate and upload the public key to the bridge registry
Download the public key from the platform certificate from the registry.
Use the next two steps to configure AS2 settings, if needed.
Finish the Bridge Installer, you should see the Bridge Dashboard.
Updating the Bridge certificate in the Bridge Connection Entry on the Platform
After successfully completing the wizard, the Bridge certificate has to be updated in the Bridge Connection Entry via the context menu "Fetch data from Bridge Registry"
