Dienst WKL Database Update (Referenz)

Der Dienst „WKL Database Update“ spielt signierte Datenbank-Update-Pakete ein, ohne dass der Datendienst läuft. Er nimmt denselben Ablauf wie das Update-Modul des Datendienstes: Pakete aus dem Eingangsordner einer Datenbank prüfen, sichern, einspielen, ankündigen und melden. Wer den Datendienst betreibt, braucht diesen Dienst nicht. Die Schritte zur Einrichtung beschreibt So spielen Sie Datenbank-Updates ohne Datendienst ein.

msiexec /i Wkl.Data.Update-<Fassung>.msi [EIGENSCHAFT=Wert]… [/qn]
Wkl.Data.Update.exe <Befehl> [<id>] [Argumente] [--json]

Die Befehle laufen auf dem Server in einer Eingabeaufforderung als Administrator.

Wkl.Data.Update-<Fassung>.msi installiert das Programm nach C:\Program Files\Wkl\Database Update (eigenständig veröffentlicht, ohne .NET-Laufzeit auf dem Server, mit dem SQL-Server-Provider), richtet den Windows-Dienst Wkl.Data.Update mit automatischem Start ein und startet ihn. Es ist vom Installationsprogramm des Datendienstes getrennt.

Bei der Installation legt das Programm (setup-host) die Ordner unten mit eigenen Rechten an und registriert die Ereignisquelle WKL Database Update im Anwendungsprotokoll. Beim Entfernen nimmt es die Ereignisquelle wieder weg.

Die Ordner liegen fest unter %ProgramData%\WKL\Database Update. Keiner erbt die Rechte von %ProgramData%.

Eine Datei <id>.json in databases richtet eine Datenbank ein. Aufbau und Felder sind dieselben wie beim Update-Modul, mit drei Unterschieden:

• Anmeldung. Ohne connection.secret meldet sich der Dienst mit seinem eigenen Windows-Konto an (Integrated Security=True in connection.string); das Konto braucht in der Datenbank die Rechte, Struktur zu ändern und zu sichern. Mit connection.secret meldet er sich mit der SQL-Anmeldung aus connection.string an, das Kennwort kommt aus der Umgebungsvariablen oder Datei (env:NAME, file:PFAD).
• gatewayAlias hat keine Wirkung: Anwendungen erreichen die Datenbank nicht über einen Datendienst. Offene Sitzungen älterer Anwendungen sieht der Dienst über die Datenbank selbst.
• mail nennt den Mailserver für den Meldeweg email: server, port (Vorgabe 25), from und optional secret (env:NAME, file:PFAD). Port 465 verbindet verschlüsselt ab dem ersten Byte, jeder andere Port verlangt STARTTLS; unverschlüsselt sendet der Dienst nie, und das Zertifikat des Mailservers muss gültig sein. Mit secret meldet er sich mit der Absenderadresse als Benutzername an, ohne secret sendet er ohne Anmeldung, etwa über ein internes Relay. Das Update-Modul des Datendienstes nimmt stattdessen `Gateway:Mail`.

"mail": { "server": "smtp.example.com", "port": 587, "from": "updates@example.com", "secret": "file:C:\\ProgramData\\WKL\\Database Update\\mail.txt" }

Eine Datei, die andere als Administratoren und SYSTEM ändern können, ein Kennwort in connection.string oder ein Dateiname, der nicht der id entspricht, lassen die Datenbank aus; databases nennt die Datei und den Grund.

Die Datei <id>.json in settings schreibt der Dienst über den Befehl settings. Fehlt ein Schlüssel oder die Datei, gilt die Vorgabe. Eine Datei, die kein gültiges JSON ist oder einen Wert außerhalb des Bereichs hat, ersetzt der Dienst nicht durch Vorgaben: Die Datenbank wartet, bis die Datei stimmt.

{
  "expand": "automatic", "contract": "confirm", "noticeMinutes": 60, "sessionWindowMinutes": 15,
  "backup": { "keepCount": 10, "keepDays": 30 },
  "notify": { "channels": ["eventlog", "file"], "email": { "to": null } }
}

Die Aufbewahrung der Sicherungen arbeitet wie beim Update-Modul. Mails des Meldewegs email gehen über den Mailserver aus mail der geschützten Konfiguration an notify.email.to, abseits des Durchlaufs: Ein langsamer oder nicht erreichbarer Mailserver verzögert die Mail, nie ein Paket. Fehlt mail, lässt sich secret nicht auflösen oder nimmt der Mailserver die Mail nicht an, steht eine Warnung im Ereignisprotokoll; die Meldung selbst steht dort ohnehin.

<paket> ist die Spalte id aus status. --json gibt die Daten als JSON aus; status --json hat dasselbe Format wie update-status des Datendienstes.

Rückgabewert. 0 erledigt; 1 Aufruf falsch, Datenbank oder Paket unbekannt, Paket in einem anderen Status, Datenbank nicht erreichbar oder Dienst nicht erreichbar; 10 ein Durchlauf spielt gerade ein Paket ein (gleich wieder versuchen); sonst der Code des Pakets, etwa 7 wartet auf Bestätigung.

Im Anwendungsprotokoll unter der Quelle WKL Database Update stehen die Ereignisse der Pakete mit den IDs 4101 bis 4106 (wie beim Update-Modul), dazu der Start des Dienstes und jeder Verwaltungsbefehl mit dem Windows-Konto, das ihn aufgerufen hat. Der Meldeweg file schreibt je Tag (UTC) log\<JJJJ-MM-TT>.jsonl; der Dienst löscht diese Dateien nie.

• Wer verwalten darf. Die Befehle reichen den Auftrag über die Named Pipe \\.\pipe\Wkl.Data.Update an den laufenden Dienst. Sie ist nur für Administratoren und SYSTEM offen und weist jede Verbindung aus dem Netzwerk ab; eine Verwaltung von einem anderen Rechner gibt es nicht. Ohne erhöhte Eingabeaufforderung lehnt Windows den Zugriff ab.
• Wer handelt. Der Dienst führt jeden Befehl mit seinem eigenen Konto aus. Der Administrator braucht keine Rechte in der Datenbank. Bei einer Bestätigung trägt der Dienst das Windows-Konto des Aufrufers (DOMÄNE\name) als Bestätigenden in die Datenbank ein.
• Nur zum Dienst. Die Befehlszeile sendet nur, wenn am anderen Ende der Pipe der laufende Dienst Wkl.Data.Update sitzt.
• Keine Überschneidung. Befehle und Durchläufe laufen nacheinander. Läuft gerade ein Paket, wartet ein Befehl bis zu zehn Sekunden und endet sonst mit 10.
• Durchlauf. Alle 15 Sekunden; ohne Datei in databases tut der Dienst nichts.

C:\> "C:\Program Files\Wkl\Database Update\Wkl.Data.Update.exe" status kunden
Stand von kunden.
  Kunden, Schema 13
  Paket 41  Kunden-schema-14.zip  Schema 14  contract  waiting  Grund 7
    Ein nicht abwärtsverträgliches Paket (contract) wartet auf Bestätigung.
 
C:\> "C:\Program Files\Wkl\Database Update\Wkl.Data.Update.exe" confirm kunden 41

• So spielen Sie Datenbank-Updates ohne Datendienst ein
• Konfiguration des Dienstes (Referenz)
• HTTP: Verwaltung (Referenz)