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 beachtenEinrichtungsschritte

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

Die Einrichtung erfolgt in dieser Reihenfolge:

  1. Datenbank erstellen (Anwendungsdatenbank MesoWorkerDb)
ConnectionStrings konfigurieren (aufDatenbankverbindung diezum erstellteSQL Datenbank zeigen)Server) 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-DateienAnwendungsdatenbank für(MesoWorkerDb) wird beim ersten Start automatisch erstellt. Eine manuelle Datenbank-Erstellung ist nicht erforderlich — es genügt, dass der angegebene SQL-Benutzer die Windows-InstallationBerechtigung werdenhat, IhnenDatenbanken von Ihrem Mesonic-Händler bereitgestellt.anzulegen.

    Entpacken:

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

      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

        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:1: ConnectionStrings konfigurieren

          Nachdem die Datenbank erfolgreich erstellt wurde, konfigurierenKonfigurieren Sie die ConnectionStringsDatenbankverbindungen des MesoWorkerService:MesoWorkerService. Die Anwendungsdatenbank (MesoWorkerDb) wird beim ersten Start automatisch erstellt — der SQL-Benutzer benötigt dafür CREATE DATABASE-Rechte.

          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
          • DieMesoWorkerDb: ConnectionStringsName müssender aufAnwendungsdatenbank die(wird inautomatisch Schritt 1 erstellte Datenbank zeigenangelegt)

          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üssenSQL-Benutzer aufbenötigt dieCREATE in Schritt 1 erstellte Datenbank zeigen!)DATABASE-Rechte)
  - 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:2: 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