Direkt zum Hauptinhalt

Schnellstart

Diese Anleitung führt Sie durch die wichtigsten Schritte zur Inbetriebnahme des MesoWorkerService. Für detaillierte Informationen konsultieren Sie bitte die entsprechenden Abschnitte in dieser Dokumentation.

WICHTIG: Richtige Reihenfolge beachten

Die Datenbank muss IMMER ZUERST erstellt werden, bevor der Service gestartet werden kann!

Die Einrichtung erfolgt in dieser Reihenfolge:

  1. Datenbank erstellen (Anwendungsdatenbank MesoWorkerDb)
  2. ConnectionStrings konfigurieren (auf die erstellte Datenbank zeigen)
  3. Service starten und einrichten

Schritt 1: Datenbank erstellen

Die Anwendungsdatenbank (MesoWorkerDb) muss vor dem ersten Start des Services erstellt werden. Wählen Sie eine der folgenden Methoden:

Option A: Windows-Applikation (empfohlen für Windows-Installation)

Hinweis: Die Setup-Dateien für die Windows-Installation werden Ihnen von Ihrem Mesonic-Händler bereitgestellt.

  1. Entpacken:

    • Entpacken Sie das von Ihrem Händler bereitgestellte MesoWorker.Win-Archiv in ein temporäres Verzeichnis

  2. ConnectionStrings konfigurieren:

    Erstellen Sie die Datei connectionStrings.Local.config im entpackten Verzeichnis:

    <?xml version="1.0"?>
<connectionStrings>
    <add name="ConnectionString" 
         connectionString="Integrated Security=false;Pooling=false;Data Source=SQL-SERVER;Initial Catalog=MesoWorkerDb;User ID=sql-user;Password=sql-passwort;TrustServerCertificate=True" />
    <add name="WinLineSystemDBConnectionString" 
         connectionString="Integrated Security=false;Pooling=false;Data Source=SQL-SERVER;Initial Catalog=CWLSYSTEM;User ID=sql-user;Password=sql-passwort;TrustServerCertificate=True" />
</connectionStrings>

    Passen Sie folgende Werte an:

    • SQL-SERVER: Ihr SQL Server Hostname oder IP-Adresse
    • sql-user und sql-passwort: Ihre SQL-Anmeldedaten
    • Oder verwenden Sie Integrated Security=true für Windows-Authentifizierung

  3. Datenbank erstellen:

    Führen Sie im Verzeichnis folgenden Befehl aus:

    MesoWorker.Win.exe -updateDatabase -silent

    Erfolgreich, wenn Exit Code = 0

Option B: Container (für Container-Deployment)

Hinweis: Für die Container-basierte Installation benötigen Sie einen GitHub-Token mit Zugriffsrechten auf die Container-Registry.

Führen Sie den folgenden Docker-Befehl aus, um die Datenbank zu erstellen:

docker run --rm \
  -e ConnectionStrings__ConnectionString="Data Source=SQL-SERVER;Initial Catalog=MesoWorkerDb;User ID=sql-user;Password=***;TrustServerCertificate=true" \
  -e ConnectionStrings__WinLineSystemDBConnectionString="Data Source=SQL-SERVER;Initial Catalog=CWLSYSTEM;User ID=sql-user;Password=***;TrustServerCertificate=true" \
  ghcr.io/css-edv-support/mesoworkerservice-blazor:latest \
  -updateDatabase -forceUpdate -silent

Passen Sie folgende Werte an:

  • SQL-SERVER: Ihr SQL Server Hostname oder IP-Adresse
  • sql-user und ***: Ihre SQL-Anmeldedaten

Erfolgreich, wenn Exit Code = 0

Alternativ können Sie auch einen separaten Update-Service in Ihrer docker-compose.yml definieren (siehe Datenbank-Ersteinrichtung (Container)).

Schritt 2: ConnectionStrings konfigurieren

Nachdem die Datenbank erfolgreich erstellt wurde, konfigurieren Sie die ConnectionStrings des MesoWorkerService:

Windows-Dienst

Bearbeiten Sie die Datei appsettings.json im Installationsverzeichnis des MesoWorkerService:

{
  "ConnectionStrings": {
    "ConnectionString": "Data Source=SQL-SERVER;Initial Catalog=MesoWorkerDb;Integrated Security=true;TrustServerCertificate=true",
    "WinLineSystemDBConnectionString": "Data Source=SQL-SERVER;Initial Catalog=CWLSYSTEM;Integrated Security=true;TrustServerCertificate=true"
  },
  "License": {
    "CustomerNr": "12345",
    "LicenseNr": "LIZENZNUMMER"
  }
}

Wichtig: Ersetzen Sie:

  • SQL-SERVER: Ihr SQL Server Hostname
  • 12345 und LIZENZNUMMER: Ihre Lizenzinformationen
  • Die ConnectionStrings müssen auf die in Schritt 1 erstellte Datenbank zeigen

Container-Deployment

Konfigurieren Sie die Umgebungsvariablen in Ihrer docker-compose.yml oder im Portainer Stack:

environment:
  # Lizenzierung
  - LICENSE_CUSTOMER_NR=12345
  - LICENSE_LICENSE_NR=LIZENZNUMMER
  
  # Datenbankverbindungen (müssen auf die in Schritt 1 erstellte Datenbank zeigen!)
  - ConnectionStrings__ConnectionString=Data Source=SQL-SERVER;Initial Catalog=MesoWorkerDb;User ID=sql-user;Password=sql-pass;TrustServerCertificate=true
  - ConnectionStrings__WinLineSystemDBConnectionString=Data Source=SQL-SERVER;Initial Catalog=CWLSYSTEM;User ID=sql-user;Password=sql-pass;TrustServerCertificate=true

Wichtig:

  • Die ConnectionStrings müssen exakt auf dieselben Datenbankverbindungen zeigen, die in Schritt 1 verwendet wurden
  • Ersetzen Sie SQL-SERVER, sql-user, sql-pass mit Ihren tatsächlichen Zugangsdaten
  • Ersetzen Sie 12345 und LIZENZNUMMER mit Ihrer Lizenz

Schritt 3: Service starten

Windows-Dienst

  1. Service installieren (siehe Option 1: Windows-Dienst für Details):

    New-Service -Name "MESO-WorkerService" `
            -BinaryPathName "C:\MesoWorkerService\MesoWorkerService.exe" `
            -DisplayName "MESO Worker Service" `
            -Description "Automatisierungsdienst für Mesonic WinLine" `
            -StartupType Automatic

  2. Service starten:

    Start-Service -Name "MESO-WorkerService"

  3. Web-Interface öffnen:

    • Öffnen Sie http://localhost:5000 im Browser
    • Melden Sie sich mit Benutzername Admin an (Passwort muss bei Erstanmeldung gesetzt werden)

Container-Deployment

  1. Container starten:

    docker-compose up -d

  2. Web-Interface öffnen:

    • Blazor UI: http://server:8012 (oder Ihr konfigurierter Port)
    • Melden Sie sich mit Benutzername Admin an (Passwort muss bei Erstanmeldung gesetzt werden)

Nächste Schritte

Nach der erfolgreichen Inbetriebnahme sollten Sie:

  1. Admin-Passwort setzen bei der Erstanmeldung
  2. SMTP-Konten einrichten für E-Mail-Versand (siehe SMTP-Konten einrichten)
  3. Mandanten aktivieren in der Administrationsoberfläche
  4. Module konfigurieren je nach lizenzierten Modulen:
    • Mail-Einstellungen für Ihre Workflows
    • OrderLine-Einstellungen für Belegzeilen-Workflows
    • Appointment-Einstellungen für Terminsynchronisation
    • OpenItem-Einstellungen für den OP-Versand

Für detaillierte Konfigurationsoptionen konsultieren Sie die entsprechenden Abschnitte in dieser Dokumentation.

nach oben