Installation auf Windows Server

Diese Anleitung richtet Bestell-Bar auf einem Windows Server ein, auf dem IIS und Microsoft SQL Server bereits installiert sind. Die kostenlose SQL Server Express-Edition genügt; höhere Editionen funktionieren genauso.

Voraussetzungen

• Windows Server mit eingerichteter IIS-Webserver-Rolle.
• Microsoft SQL Server (Express oder höher), idealerweise mit SQL Server Management Studio oder sqlcmd zur Verwaltung.
• Administratorrechte auf dem Server.
• Die Anwendung "Bestell-Bar" und die Hilfe als zip-Archiv.

Programmpaket herunterladen

Das Paket steht unter www.bestell-bar.ch/download bereit – eine Datei je Version, benannt nach der Versionsnummer (z. B. bestell-bar-1.7.1.zip). Dieselben Links stehen auf der Impressum-Seite der Anwendung bei den Release-Notes.

Neben jedem Archiv liegt eine Datei .sha256 mit der Prüfsumme. So lässt sich nachweisen, dass das Archiv unverändert ist – die Lizenz erlaubt die Weitergabe nur unverändert. Prüfen in PowerShell:

Get-FileHash .\bestell-bar-1.7.1.zip -Algorithm SHA256

Der ausgegebene Wert muss mit dem Inhalt der .sha256-Datei übereinstimmen.

Hinweis zu Windows SmartScreen: Das Programm ist nicht signiert. Beim ersten Start meldet Windows daher möglicherweise, der Computer sei geschützt worden. Über Weitere Informationen → Trotzdem ausführen lässt sich der Start fortsetzen.

Benötigte IIS-Rollendienste

Die reine Rolle Webserver (IIS) genügt nicht – für Bestell-Bar müssen zusätzlich diese Rollendienste installiert sein (Server-Manager → Rollen und Features hinzufügen, oder per PowerShell):

• Statischer Inhalt – liefert die CSS/JS/Bilder aus wwwroot und die statischen Hilfe-Seiten (zwingend).
• Standarddokument und HTTP-Fehler.
• HTTP-Umleitung – für die Weiterleitung von HTTP auf HTTPS.
• WebSocket-Protokoll – für die Live-Aktualisierung der Stations- und Auslieferungs-Boards (SignalR); ohne dieses Feature bleiben Boards ohne Neuladen stehen.
• Statische & dynamische Inhaltskomprimierung – für schnellere Antworten.
• IIS-Verwaltungskonsole – zum Einrichten von Website/Anwendungspool.

Auf einem Windows Server installiert dieser Befehl (als Administrator in PowerShell) alles Nötige:

Install-WindowsFeature -Name Web-Server, Web-Static-Content, Web-Default-Doc, `
    Web-Http-Errors, Web-Http-Redirect, Web-WebSockets, Web-Stat-Compression, `
    Web-Dyn-Compression, Web-Mgmt-Console -IncludeManagementTools

Benötigte SQL-Server-Features

Bei der Installation von SQL Server (Express oder höher) genügt für Bestell-Bar:

• Datenbankmodul-Dienste (Database Engine Services) – zwingend.
• Optional SQL Server Management Studio (SSMS, separater Download) zur bequemen Verwaltung – sqlcmd genügt aber auch.

• Für die lokale Verbindung (. bzw. .\SQLEXPRESS) reichen die Standardprotokolle (Shared Memory / Named Pipes) – keine weitere Einrichtung nötig.
• Liegt der SQL Server auf einem anderen Rechner, im SQL Server-Konfigurations-Manager das TCP/IP-Protokoll aktivieren und den Port (Standard 1433) in der Firewall freigeben.
• Für eine SQL-Anmeldung (statt Windows-Authentifizierung, siehe Schritt 4) bei der Installation den gemischten Modus aktivieren.

Schritt 1: .NET Hosting Bundle installieren

1. Das ASP.NET Core 10 Hosting Bundle von dotnet.microsoft.com herunterladen (Abschnitt ASP.NET Core Runtime → Hosting Bundle) und installieren. Es verbindet .NET mit dem IIS (ASP.NET-Core-Modul).
2. Anschliessend in einer Administrator-Eingabeaufforderung iisreset ausführen (oder den IIS manuell neustarten).

Schritt 2: Anwendungsdateien ablegen

1. Einen Ordner für die Anwendung anlegen, z. B. D:\Sites\bestellbar.
2. Den kompletten Inhalt des zip-Archivs hineinkopieren (JKOrderManager.exe, appsettings.json, web.config, wwwroot usw.).

Schritt 3: IIS einrichten

1. Im IIS-Manager einen neuen Anwendungspool anlegen, z. B. BestellBar, .NET-CLR-Version Kein verwalteter Code. Die Identität kann auf dem Standard (ApplicationPoolIdentity) bleiben (je nach Verbindung mit dem MS SQL Server).
2. Eine Website (oder eine Anwendung unterhalb einer bestehenden Website, z. B. /bestellbar) anlegen: physischer Pfad = Ordner aus Schritt 2, Anwendungspool = BestellBar. Der Betrieb unter einem Unterpfad wird von Bestell-Bar vollständig unterstützt.
3. Eine HTTPS-Bindung mit Zertifikat einrichten (die QR-Codes und die Bestellseiten der Gäste setzen eine sichere Verbindung voraus).

Schritt 4: Datenbank anlegen und Rechte vergeben

1. Eine leere Datenbank anlegen, z. B. BestellBar:

   sqlcmd -S .\SQLEXPRESS -E -Q "CREATE DATABASE BestellBar"

   (bei einer Standardinstanz -S . statt .\SQLEXPRESS). Die Tabellen erstellt die Anwendung beim ersten Start selbst.
2. Dem Konto des Anwendungspools Zugriff geben (empfohlen: Windows-Authentifizierung):

   sqlcmd -S .\SQLEXPRESS -E -Q "CREATE LOGIN [IIS AppPool\BestellBar] FROM WINDOWS"
   sqlcmd -S .\SQLEXPRESS -E -d BestellBar -Q "CREATE USER [IIS AppPool\BestellBar] FOR LOGIN [IIS AppPool\BestellBar]; ALTER ROLE db_owner ADD MEMBER [IIS AppPool\BestellBar]"

   Der Login-Name entspricht immer IIS AppPool\<Name des Anwendungspools>.

Schritt 5: appsettings.json anpassen

Die Datei appsettings.json im Anwendungsordner öffnen und anpassen:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=.\\SQLEXPRESS;Database=BestellBar;Trusted_Connection=True;TrustServerCertificate=True;MultipleActiveResultSets=true"
  },
  "Qr":         { "Secret": "…langer Zufallswert…" },
  "Encryption": { "Key": "…langer Zufallswert…" },
  "Seed": {
    "SuperAdminEmail": "admin@example.ch",
    "SuperAdminPassword": "…starkes Passwort…",
    "SuperAdminDisplayName": "Plattform-Administrator"
  },
  "Installation": { "Label": "" },
  "Security":     { "SuperAdminTwoFactorBypass": false },
  "DataProtection": {
    "KeyPath": "",
    "ApplicationName": "",
    "ProtectKeysWithDpapi": true
  },
  "Hosting": { "HttpsRedirectPort": 443 },
  "RateLimits": {
    "Enabled": true,
    "Registration":       { "Limit": 3,  "WindowMinutes": 60 },
    "Mail":               { "Limit": 5,  "WindowMinutes": 10 },
    "Login":              { "Limit": 10, "WindowMinutes": 5 },
    "AnonymousMailTotal": { "Limit": 20, "WindowMinutes": 60 }
  },
  "Imprint": {
    "Name": "Musterverein Zürich",
    "AddressLines": [ "Musterstrasse 1", "8000 Zürich", "CH" ],
    "Email": "info@musterverein.ch",
    "Representative": "Vorname Nachname"
  }
}

• DefaultConnection: Servername/Instanz und Datenbankname aus Schritt 4.
• Qr:Secret und Encryption:Key: je ein eigener, langer Zufallswert (mindestens 32 Zeichen). Bequem erzeugen mit:

  powershell -Command "[Convert]::ToBase64String([Security.Cryptography.RandomNumberGenerator]::GetBytes(48))"

• Seed: E-Mail und Passwort des ersten Plattform-Administrators (damit melden Sie sich nach der Installation an).
• Installation:Label (optional): Text wie Demo oder Test, der zur Kennzeichnung der Umgebung klein unter dem Schriftzug in der Menüleiste erscheint; leer = keine Anzeige.
• Security:SuperAdminTwoFactorBypass: bleibt auf false. Der Schalter ist der Notzugang für den Fall, dass der Plattform-Administrator seine Authenticator-App und seine Wiederherstellungscodes verliert – über ihm steht niemand, der zurücksetzen könnte (Vereins-Admins setzt ein anderer Vereins-Admin zurück). Siehe unten.
• DataProtection (optional): Ablage der Sicherheitsschlüssel. Die Vorgaben passen für eine normale Installation – lassen Sie die Werte leer, wenn Sie keinen Grund für etwas anderes haben. Siehe unten.
• Hosting:HttpsRedirectPort: der öffentliche HTTPS-Port (in der Regel 443). Dann leitet die Anwendung eingehende HTTP-Anfragen selbst dorthin um. Für den Testbetrieb per Doppelklick muss der Wert null bleiben. Siehe unten.
• RateLimits (optional): Obergrenzen gegen Missbrauch von Registrierung, Anmeldung und E-Mail-Versand. Die Vorgaben reichen für den Normalbetrieb. Siehe unten.
• Imprint: Ihre Angaben als Betreiber dieser Installation – sie erscheinen im Impressum, auf das die Datenschutzerklärung verweist. AddressLines wird zeilenweise ausgegeben, das Format ist also frei. Representative darf leer bleiben, dann gilt der Name des Betreibers. Siehe unten.
• Serilog: im Abschnitt WriteTo den Pfad der Logdatei auf einen Ordner zeigen lassen, in dem das Anwendungspool-Konto schreiben darf.

Impressum: Ihre eigenen Angaben

Bestell-Bar wird ohne Betreiberangaben ausgeliefert. Sobald Sie die Software selbst betreiben, sind Sie der Betreiber – und die öffentlichen Seiten Impressum und Datenschutz müssen Sie ausweisen, nicht den Hersteller.

Nicht betroffen sind Lizenz und Copyright der Software weiter unten auf der Impressum-Seite: Die bleiben beim Hersteller, unabhängig davon, wer die Installation betreibt.

Sicherheitsschlüssel: wo sie liegen und warum das zählt

Die Anwendung verschlüsselt mit einem Schlüsselbund, was sie den Browsern mitgibt: die Anmelde-Cookies, die Schutzmarken der Formulare und die Token in den Links aus den Bestätigungs- und Passwort vergessen-E-Mails.

Standardmässig legt die Anwendung diesen Schlüsselbund unter %ProgramData%\BestellBar\keys ab – also ausserhalb des Anwendungsordners, damit ein Update ihn nicht mitlöscht. Beim Start schreibt sie den verwendeten Pfad ins Log, dort können Sie ihn jederzeit nachsehen:

[INF] Data-Protection-Schlüssel: C:\ProgramData\BestellBar\keys (Installation 'BestellBar', DPAPI aktiv)

Die drei Einstellungen brauchen Sie nur, wenn Sie bewusst abweichen wollen:

HTTPS erzwingen

Die Anwendung gehört hinter HTTPS. Die Anmelde-Cookies werden ausserhalb der Entwicklungsumgebung ohnehin nur über eine verschlüsselte Verbindung gesendet – ruft jemand die Seite über http:// auf, kann er sich also gar nicht erst anmelden.

Damit niemand auf einer unverschlüsselten Seite landet, richten Sie die Umleitung ein. Zwei Wege, die sich ergänzen:

1. Im IIS – der übliche Weg: Der Website nur eine https-Bindung geben, oder bei zusätzlicher http-Bindung eine Umleitungsregel (URL Rewrite) auf https einrichten.
2. In der Anwendung – als zweite Absicherung: unter Hosting:HttpsRedirectPort den öffentlichen HTTPS-Port eintragen, meist 443. Die Anwendung beantwortet eine HTTP-Anfrage dann mit einer Umleitung auf dieselbe Adresse unter https://.

[WRN] Die Anwendung leitet HTTP-Anfragen NICHT selbst auf HTTPS um (Hosting:HttpsRedirectPort ist leer). …

Nur ein Arbeitsprozess

Die Anwendung muss in einem einzigen Prozess laufen. Zwei Dinge hält sie im Speicher genau dieses Prozesses: die Live-Verbindungen zu den Stationsboards und den Zwischenspeicher der Artikelbilder; auch die Anfragebegrenzung zählt je Prozess.

Häufigste Ursache ist ein Anwendungspool mit mehreren Arbeitsprozessen (eine sogenannte Webgarten-Konfiguration). So prüfen Sie das:

1. Im IIS-Manager Anwendungspools öffnen und den Pool auswählen.
2. Rechts Erweiterte Einstellungen… anklicken.
3. Unter Prozessmodell muss Maximale Anzahl von Arbeitsprozessen auf 1 stehen (das ist die Standardeinstellung).

Erkennt die Anwendung beim Start eine zweite laufende Instanz, schreibt sie eine Warnung ins Log:

[WRN] Es läuft bereits eine weitere Instanz dieser Installation ('BestellBar') auf diesem Rechner. …

Während eines Updates oder eines Neustarts kann diese Meldung kurz auftreten, weil der alte Prozess noch läuft – das ist normal. Erscheint sie im laufenden Betrieb, prüfen Sie den Anwendungspool.

Anfragebegrenzung: Schutz vor Missbrauch

Ein paar Stellen der Anwendung kann jeder aufrufen, ohne angemeldet zu sein – und sie bringen den Server dazu, etwas zu tun: einen Verein anzulegen oder eine E-Mail über Ihren SMTP-Server zu verschicken. Ohne Bremse könnte jemand damit tausende E-Mails in Ihrem Namen auslösen; darunter leidet vor allem der Ruf Ihrer Absenderadresse.

Die Anwendung begrenzt darum, wie oft diese Aktionen in einem Zeitfenster aufgerufen werden dürfen. Wer darüber liegt, bekommt die Seite Zu viele Anfragen und muss kurz warten.

Alle Grenzen gelten je Absenderadresse und Zeitfenster; nur AnonymousMailTotal zählt über alle zusammen. Limit ist die erlaubte Anzahl, WindowMinutes die Länge des Zeitfensters. Beim Start schreibt die Anwendung die geltenden Werte ins Log:

[INF] Anfragebegrenzung aktiv: Registrierung 3/60min, E-Mail 5/10min, Anmeldung 10/5min, anonymer Mailversand gesamt 20/60min

Notzugang für den Plattform-Administrator

Kommt der Plattform-Administrator wegen der Zwei-Faktor-Authentifizierung nicht mehr hinein, gehen Sie so vor:

1. In der appsettings.json "SuperAdminTwoFactorBypass": true setzen und speichern. Ein Neustart ist nicht nötig – die Datei wird sofort neu eingelesen.
2. Mit E-Mail und Passwort anmelden; der Code wird für dieses eine Konto übersprungen.
3. Unter Mein Konto die 2FA mit dem Passwort deaktivieren und bei Bedarf neu einrichten.
4. Den Schalter wieder auf false setzen.

Schritt 6: Hilfe-Seite einbinden

1. Den Ordner der Hilfe-Seite ausserhalb des Anwendungsordners ablegen, z. B. D:\Sites\bestellbar-help.
2. Im IIS-Manager unterhalb der Bestell-Bar-Anwendung ein virtuelles Verzeichnis mit Alias help anlegen, das auf diesen Ordner zeigt.

Damit funktioniert der Hilfe-Link im Seitenfuss der Anwendung, und die Seite bleibt bei Anwendungs-Updates unangetastet.

Schritt 7: Erster Start

1. Die Website im Browser aufrufen. Beim ersten Start legt die Anwendung die Datenbanktabellen an und erstellt das Administrator-Konto aus dem Seed-Abschnitt (das kann einige Sekunden dauern).
2. Mit dem Seed-Konto Anmelden.
3. Unter dem Zahnrad-Menü Administration → System-SMTP den zentralen E-Mail-Versand konfigurieren (Voraussetzung für Selbstregistrierung und «Passwort vergessen»).
4. Unter Vereine den ersten Verein samt Vereins-Admin anlegen – oder die Selbstregistrierung auf der Startseite nutzen.

Updates einspielen

1. Datenbank sichern.
2. Anwendungspool BestellBar stoppen.
3. Anwendungsdateien durch die neue Version ersetzen – appsettings.json und web.config dabei behalten (vorher sichern).
4. Anwendungspool wieder starten. Nötige Datenbank-Anpassungen führt die Anwendung beim Start automatisch aus.

Nur zum Testen: direkt starten (Konsole)

Dieselbe JKOrderManager.exe lässt sich auch direkt starten – per Doppelklick oder aus der Eingabeaufforderung. Es öffnet sich ein Konsolenfenster, und die Anwendung ist unter http://localhost:5000 erreichbar (ohne IIS).

• Einen anderen Port wählen Sie mit dem Schalter --urls:

  JKOrderManager.exe --urls http://localhost:8080

• Beenden: Fenster schliessen oder Strg+C drücken.
• Es gilt dieselbe appsettings.json wie im IIS-Betrieb – die Platzhalter aus Schritt 5 müssen also auch hier ersetzt sein.
• Das Konsolenfenster bleibt fast leer – das ist normal: protokolliert werden nur Warnungen und Fehler (die Logdatei aus dem Serilog-Abschnitt wird trotzdem geschrieben).

Alternativer Betrieb: als Windows-Dienst

Statt im IIS kann dieselbe Anwendung auch als Windows-Dienst laufen – praktisch, wenn auf dem Server kein IIS gewünscht ist. Der reguläre Weg bleibt der IIS-Betrieb.

1. Dienst anlegen (Eingabeaufforderung als Administrator; das Leerzeichen nach binPath= gehört zur Syntax von sc.exe):

   sc.exe create BestellBar binPath= "D:\Sites\bestellbar\JKOrderManager.exe --urls http://localhost:5000" start= auto
   sc.exe description BestellBar "Bestell-Bar Web-Anwendung"

2. Dienstkonto festlegen und diesem – wie in Schritt 4 – Zugriff auf die Datenbank geben. Ohne Angabe läuft der Dienst als LocalSystem:

   sc.exe config BestellBar obj= "DOMAIN\dienstkonto" password= "…"

3. Starten bzw. stoppen:

   sc.exe start BestellBar
   sc.exe stop BestellBar

4. Wieder entfernen (vorher stoppen): sc.exe delete BestellBar

• Der Dienst startet automatisch mit dem Server und wird von Windows nach einem Absturz neu gestartet (Wiederherstellungsoptionen in den Diensteigenschaften).
• Das Dienstkonto braucht Schreibrechte auf den Log-Ordner aus dem Serilog-Abschnitt der appsettings.json.
• Für Updates den Dienst stoppen, Dateien ersetzen (appsettings.json behalten), Dienst wieder starten.

Wenn es nicht läuft