Files
Holzleitner---Backend--aktu…/install-service.ps1
Dennis Nemec d30d43df3a Backend als Windows-Dienst registrierbar (SCM, wie Mail-Client)
Das Backend kann jetzt — analog zum Mail-Client — als Windows-Dienst laufen.

- main() refaktoriert: App-Logik in run_app(shutdown, service_mode); eigene
  tokio-Runtime statt #[tokio::main]. Windows startet zuerst den SCM-Dispatcher,
  fällt bei interaktivem Start auf Konsolenmodus zurück (--console erzwingt ihn).
- src/service.rs (windows-only): SCM-Integration via windows-service-Crate,
  Stop/Shutdown-Handler, Running/Stopped-Status. Setzt das Arbeitsverzeichnis
  aufs EXE-Verzeichnis (Dienst startet sonst in System32), damit config.toml/
  data/logs daneben liegen. Fallback-Log bei Boot-Fehler.
- Graceful Shutdown: GSD-Lizenz-Freigabe in den Serve-Wrapper gezogen (greift
  in beiden Modi); Stop-Trigger ist das übergebene shutdown-Future.
- Logging: Konsolenmodus → stderr (wie bisher); Dienst-Modus → rollende
  Tagesdatei (tracing-appender) unter [logging] dir (Default logs/).
- install-service.ps1 / uninstall-service.ps1 (Dienst "Holzleitner Backend").
- README: Windows-Dienst-Abschnitt; .gitignore: /logs + Fatal-Log.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-01 18:12:12 +02:00

87 lines
3.4 KiB
PowerShell

#Requires -RunAsAdministrator
<#
.SYNOPSIS
Registriert das Holzleitner-Backend als Windows-Dienst "Holzleitner Backend".
.DESCRIPTION
Muss als Administrator ausgeführt werden. Erwartet die kompilierte EXE
(Default: neben diesem Skript) und eine config.toml IM SELBEN Verzeichnis
wie die EXE (der Dienst setzt sein Arbeitsverzeichnis auf das EXE-Verzeichnis,
daher werden config.toml, data/ und logs/ relativ zur EXE aufgelöst).
Release-Build erzeugen: cargo build --release -p holzleitner-api
Die EXE liegt dann unter target\release\holzleitner-server.exe.
.PARAMETER ExePath
Pfad zu holzleitner-server.exe. Default: neben diesem Skript.
.PARAMETER Credential
Optionales Dienstkonto. Ohne Angabe läuft der Dienst als LocalSystem. Für
Zugriff auf Postgres/Keycloak/ERPframe-MSSQL/GSD im Netzwerk ist oft ein
echtes Domänen-/Benutzerkonto nötig. Das Konto braucht das Recht
"Als Dienst anmelden".
.EXAMPLE
.\install-service.ps1
.EXAMPLE
.\install-service.ps1 -ExePath "C:\HolzleitnerBackend\holzleitner-server.exe" -Credential (Get-Credential)
#>
[CmdletBinding()]
param(
[string]$ExePath,
[string]$ServiceName = "HolzleitnerBackend",
[string]$DisplayName = "Holzleitner Backend",
[pscredential]$Credential
)
$ErrorActionPreference = 'Stop'
$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Definition
if (-not $ExePath) { $ExePath = Join-Path $ScriptDir 'holzleitner-server.exe' }
if (-not (Test-Path $ExePath)) {
throw "EXE nicht gefunden: $ExePath (zuerst 'cargo build --release -p holzleitner-api' und die EXE aus target\release\ neben dieses Skript kopieren)"
}
$ExePath = (Resolve-Path $ExePath).Path
$ExeDir = Split-Path $ExePath -Parent
if (-not (Test-Path (Join-Path $ExeDir 'config.toml'))) {
Write-Warning "config.toml fehlt neben der EXE ($ExeDir) - der Dienst startet sonst nicht (cp config.example.toml config.toml)."
}
# Vorhandenen Dienst stoppen & entfernen (Neuinstallation)
$existing = Get-Service -Name $ServiceName -ErrorAction SilentlyContinue
if ($existing) {
Write-Host "Dienst '$ServiceName' existiert bereits - stoppe & entferne..."
if ($existing.Status -ne 'Stopped') { Stop-Service -Name $ServiceName -Force }
& sc.exe delete $ServiceName | Out-Null
Start-Sleep -Seconds 2
}
# binPath in doppelten Quotes (Pfad kann Leerzeichen enthalten)
$bin = "`"$ExePath`""
$params = @{
Name = $ServiceName
DisplayName = $DisplayName
BinaryPathName = $bin
StartupType = 'Automatic'
Description = 'HTTP-Backend der Holzleitner-Lieferservice-App (REST-API, ERP-Sync, Lieferreports). Bindet standardmaessig auf den in config.toml gesetzten Port.'
}
if ($Credential) { $params['Credential'] = $Credential }
Write-Host "Registriere Dienst '$DisplayName' ($ServiceName) -> $ExePath"
New-Service @params | Out-Null
# Auto-Restart bei Absturz: 3x mit 60s Abstand, Fehlerzaehler nach 1 Tag zuruecksetzen
& sc.exe failure $ServiceName reset= 86400 actions= restart/60000/restart/60000/restart/60000 | Out-Null
# Verzoegerter Autostart (startet nach den System-Diensten, z. B. nach der DB)
& sc.exe config $ServiceName start= delayed-auto | Out-Null
Write-Host "Starte Dienst..."
Start-Service -Name $ServiceName
Start-Sleep -Seconds 1
Get-Service -Name $ServiceName | Format-List Name, DisplayName, Status, StartType
Write-Host "Config: $(Join-Path $ExeDir 'config.toml')"
Write-Host "Logs: $(Join-Path $ExeDir 'logs')"
Write-Host "Fertig."