Installation

Der Server als Einzeldatei mit eingebauter .NET-Laufzeit, gestartet und überwacht von systemd: unter einem eigenen Benutzer ohne Anmeldung, schreiben darf er nur in seinen Datenordner. Läuft auf jeder Verteilung mit systemd (Debian, Ubuntu, Fedora, RHEL, SUSE).

1. Die Einzeldatei

   Aus der Auslieferung (linux-x64 oder linux-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.

   bash

   pwsh dist/einzeldatei-bauen.ps1 -Plattform linux-x64
   cd einzeldatei/linux-x64

2. Benutzer und Programm

   Ein Systembenutzer ohne Heimatverzeichnis und ohne Anmeldung; das Programm gehört root.

   bash

   sudo useradd --system --no-create-home --shell /usr/sbin/nologin kuonensql
   sudo install -d -m 755 /opt/kuonensql
   sudo install -m 755 Kuonen.Data.KuonenSql.Server /opt/kuonensql/

3. Einstellungen

   Die Datei kann nur root lesen - das sa-Kennwort steht darin. Kennwort eintragen, wenn gewünscht weitere Ports.

   bash

   sudo install -d -m 755 /etc/kuonensql
   sudo install -m 600 kuonensql.env /etc/kuonensql/kuonensql.env
   sudoedit /etc/kuonensql/kuonensql.env

4. Dienst einrichten und starten

   enable --now startet ihn sofort und bei jedem Systemstart. Den Datenordner /var/lib/kuonensql legt systemd selbst an.

   bash

   sudo install -m 644 kuonensql.service /etc/systemd/system/kuonensql.service
   sudo systemctl daemon-reload
   sudo systemctl enable --now kuonensql

5. Prüfen

   „active (running)“ und im Protokoll „TDS-Server lauscht auf [::]:1433“.

   bash

   systemctl status kuonensql

6. Firewall öffnen (wenn andere Rechner zugreifen)

   Je nach Verteilung ufw oder firewalld; nur die Ports, die gebraucht werden.

   bash

   sudo ufw allow 1433/tcp
   # oder: sudo firewall-cmd --permanent --add-port=1433/tcp && sudo firewall-cmd --reload

Die Dateien

kuonensql.service

Gehört nach /etc/systemd/system/kuonensql.service. Im Quellstand: dist/dienst/linux/kuonensql.service.

# KuonenSQL als systemd-Dienst (U19.10).
# Ablage: /etc/systemd/system/kuonensql.service - die Schritte stehen im Prüfstand unter Installation → Linux.
# Einstellungen (Ports, sa-Kennwort) gehören in /etc/kuonensql/kuonensql.env, nicht hierher: so bleibt diese Datei bei
# einer neuen Fassung austauschbar, und das Kennwort liegt in einer Datei, die nur root lesen kann.

[Unit]
Description=KuonenSQL Datenbankserver
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=kuonensql
Group=kuonensql
ExecStart=/opt/kuonensql/Kuonen.Data.KuonenSql.Server 1433 6379
WorkingDirectory=/var/lib/kuonensql
# Daten und Protokoll; die Einzeldatei entpackt ihre nativen Bibliotheken nach DOTNET_BUNDLE_EXTRACT_BASE_DIR (ohne die Angabe
# unter $HOME/.net - der Dienstbenutzer hat kein Heimatverzeichnis). Werte in der env-Datei gehen diesen beiden vor.
Environment=KUONENSQL_DATEN_PFAD=/var/lib/kuonensql
Environment=DOTNET_BUNDLE_EXTRACT_BASE_DIR=/var/cache/kuonensql
EnvironmentFile=-/etc/kuonensql/kuonensql.env
StateDirectory=kuonensql
StateDirectoryMode=0750
CacheDirectory=kuonensql
# Beenden mit SIGTERM: der Server schreibt einen Kontrollpunkt und meldet "Server ordnungsgemaess heruntergefahren".
TimeoutStopSec=60
Restart=on-failure
RestartSec=5
LimitNOFILE=65536
# Härtung: schreiben darf der Dienst nur in /var/lib/kuonensql und /var/cache/kuonensql.
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
PrivateDevices=true
ProtectKernelTunables=true
ProtectControlGroups=true

[Install]
WantedBy=multi-user.target

kuonensql.env

Gehört nach /etc/kuonensql/kuonensql.env. Im Quellstand: dist/dienst/linux/kuonensql.env.

# Einstellungen des Dienstes kuonensql (U19.10). Ablage: /etc/kuonensql/kuonensql.env, Rechte 600 (root).
# Eine Zeile je Einstellung, NAME=Wert, ohne Anführungszeichen. Nach einer Änderung: sudo systemctl restart kuonensql

# Kennwort von sa. Es gilt ab dem Start und bleibt als Hash im Datenordner - die Zeile darf danach wieder leer werden.
KUONENSQL_SA_PASSWORD=

# KSQL: TDS mit dem Kern als Sprache und ehrlicher Kennung (K33.1); leer = aus.
KUONENSQL_KSQL_PORT=1333

# Weitere Zugänge auf dieselbe Ablage; leer = aus.
KUONENSQL_MYSQL_PORT=
KUONENSQL_MARIADB_PORT=
KUONENSQL_POSTGRESQL_PORT=
KUONENSQL_GRAPHQL_PORT=

# Sortierung von master, tempdb und jeder neuen Datenbank ohne eigenes COLLATE.
KUONENSQL_SORTIERUNG=SQL_Latin1_General_CP1_CI_AS

Im Betrieb

journalctl -u kuonensql -f

sudo systemctl restart kuonensql

sudo systemctl stop kuonensql
sudo install -m 755 Kuonen.Data.KuonenSql.Server /opt/kuonensql/
sudo systemctl start kuonensql

sudo systemctl disable --now kuonensql
sudo rm /etc/systemd/system/kuonensql.service
sudo systemctl daemon-reload

Gut zu wissen

• Bricht der Start mit „Couldn't find a valid ICU package“ ab, fehlt ICU (siehe Voraussetzungen).
• systemd beendet den Dienst mit SIGTERM und wartet bis zu 60 Sekunden; der Server schreibt in der Zeit seinen Kontrollpunkt.
• Das Kennwort gilt ab dem Start und bleibt als Hash im Datenordner; die Zeile in kuonensql.env darf danach wieder leer werden.