Installation

Der Server als Einzeldatei, als echter Windows-Dienst eingetragen: startet mit Windows, ohne Anmeldung, nach einem Absturz neu, und erscheint in der Dienstverwaltung. Die Anbindung an die Dienstverwaltung übernimmt WinSW, ein kleines freies Werkzeug (MIT-Lizenz).

1. Die Einzeldatei

   Aus der Auslieferung (win-x64 oder win-arm64) - oder aus dem Quellstand gebaut, mit dem .NET 10 SDK und PowerShell 7. Die .NET-Laufzeit ist darin enthalten, auf dem Zielrechner muss nichts installiert sein. Die folgenden Schritte laufen im Ordner mit der Einzeldatei und den Dateien unten.

   PowerShell

   powershell -ExecutionPolicy Bypass -File dist\einzeldatei-bauen.ps1
   cd einzeldatei\win-x64

2. Programm, Dienstdatei und WinSW

   Im Ordner mit der Einzeldatei und KuonenSQL-Dienst.xml. WinSW heisst danach wie seine Konfiguration - so findet es sie.

   PowerShell

   $ziel = "$env:ProgramFiles\KuonenSQL"
   New-Item -ItemType Directory -Force $ziel, "$env:ProgramData\KuonenSQL\Daten" | Out-Null
   Copy-Item .\Kuonen.Data.KuonenSql.Server.exe, .\KuonenSQL-Dienst.xml $ziel
   Invoke-WebRequest https://github.com/winsw/winsw/releases/download/v2.12.0/WinSW-x64.exe -OutFile "$ziel\KuonenSQL-Dienst.exe"

3. Kennwort eintragen

   Unter KUONENSQL_SA_PASSWORD, wenn gewünscht weitere Ports.

   PowerShell

   notepad "$env:ProgramFiles\KuonenSQL\KuonenSQL-Dienst.xml"

4. Dienst einrichten und starten

   Startet ab jetzt mit Windows (verzögert, nach dem Netz).

   PowerShell

   & "$env:ProgramFiles\KuonenSQL\KuonenSQL-Dienst.exe" install
   Start-Service KuonenSQL

5. Prüfen

   Status „Running“ und im Protokoll „TDS-Server lauscht auf [::]:1433“.

   PowerShell

   Get-Service KuonenSQL
   Get-Content "$env:ProgramData\KuonenSQL\Protokoll\KuonenSQL-Dienst.out.log" -Tail 20

6. Firewall öffnen (wenn andere Rechner zugreifen)

   Nur die Ports, die gebraucht werden.

   PowerShell

   New-NetFirewallRule -DisplayName "KuonenSQL (T-SQL)" -Direction Inbound -Protocol TCP -LocalPort 1433 -Action Allow

Die Dateien

KuonenSQL-Dienst.xml

Gehört nach C:\Program Files\KuonenSQL\KuonenSQL-Dienst.xml. Im Quellstand: dist/dienst/windows/KuonenSQL-Dienst.xml.

<!--
  KuonenSQL als Windows-Dienst über WinSW 2.12 (MIT-Lizenz, https://github.com/winsw/winsw) (U19.10).
  Ablage: C:\Program Files\KuonenSQL\KuonenSQL-Dienst.xml, neben WinSW-x64.exe, umbenannt in KuonenSQL-Dienst.exe, und dem Server.
  Die Schritte stehen im Prüfstand unter Installation → Windows. Der Server selbst spricht nicht mit der Dienstverwaltung von
  Windows; WinSW tut das für ihn und beendet ihn mit Strg+C, worauf er seinen Kontrollpunkt schreibt.
-->
<service>
  <id>KuonenSQL</id>
  <name>KuonenSQL</name>
  <description>KuonenSQL Datenbankserver (KSQL, T-SQL, MySQL, MariaDB, PostgreSQL, Redis, GraphQL)</description>
  <executable>%BASE%\Kuonen.Data.KuonenSql.Server.exe</executable>
  <arguments>1433 6379</arguments>
  <workingdirectory>%ProgramData%\KuonenSQL</workingdirectory>
  <env name="KUONENSQL_DATEN_PFAD" value="%ProgramData%\KuonenSQL\Daten" />
  <env name="DOTNET_BUNDLE_EXTRACT_BASE_DIR" value="%ProgramData%\KuonenSQL\net" />
  <!-- Kennwort von sa: gilt ab dem Start und bleibt als Hash im Datenordner; danach darf der Wert wieder leer werden. -->
  <env name="KUONENSQL_SA_PASSWORD" value="" />
  <!-- KSQL: TDS mit dem Kern als Sprache und ehrlicher Kennung (K33.1); leer = aus. -->
  <env name="KUONENSQL_KSQL_PORT" value="1333" />
  <!-- Weitere Zugänge auf dieselbe Ablage; leer = aus. -->
  <env name="KUONENSQL_MYSQL_PORT" value="" />
  <env name="KUONENSQL_POSTGRESQL_PORT" value="" />
  <env name="KUONENSQL_GRAPHQL_PORT" value="" />
  <startmode>Automatic</startmode>
  <delayedAutoStart>true</delayedAutoStart>
  <onfailure action="restart" delay="10 sec" />
  <stoptimeout>60 sec</stoptimeout>
  <logpath>%ProgramData%\KuonenSQL\Protokoll</logpath>
  <log mode="roll-by-size">
    <sizeThreshold>10240</sizeThreshold>
    <keepFiles>8</keepFiles>
  </log>
</service>

Im Betrieb

Get-Content "$env:ProgramData\KuonenSQL\Protokoll\KuonenSQL-Dienst.out.log" -Wait

Restart-Service KuonenSQL

Stop-Service KuonenSQL
Copy-Item .\Kuonen.Data.KuonenSql.Server.exe "$env:ProgramFiles\KuonenSQL\"
Start-Service KuonenSQL

Stop-Service KuonenSQL
& "$env:ProgramFiles\KuonenSQL\KuonenSQL-Dienst.exe" uninstall

Gut zu wissen

• Der Dienst läuft als LocalSystem; Daten und Protokoll liegen unter C:\ProgramData\KuonenSQL.
• WinSW beendet den Server mit Strg+C und wartet bis zu 60 Sekunden; der Server schreibt in der Zeit seinen Kontrollpunkt.
• Der Server selbst spricht noch nicht mit der Dienstverwaltung von Windows - darum WinSW. Eine eingebaute Anbindung steht auf der Roadmap.