Script fuer den Erstkonfigurationsassistenten, gemeinsames Modul

kerio_trial_setup.py bringt eine frische Installation am Assistenten
vorbei, wenn dessen Lizenzschritt nicht durchlaufbar ist: der Link
"Im unregistrierten Modus aktivieren" fehlt je nach Version und die
verlinkte Registrierungsseite ist seit der GFI-Uebernahme teils tot.
Gesetzt wird ConfigWizardDone in mailserver.cfg; Kerio laeuft danach
30 Tage unregistriert, ohne Einschraenkung bei Benutzerverwaltung und
Admin-API.

Die Datei darf nur bei gestopptem Dienst bearbeitet werden, weil Kerio
seine Konfiguration beim Beenden aus dem Speicher zurueckschreibt. Das
Script stoppt den Dienst, liest danach neu ein, schreibt atomar ueber
eine temporaere Datei und liest den Wert nach dem Start zur Kontrolle
erneut. Backup vor jeder Aenderung, --restore spielt es zurueck.

API-Client und Dienststeuerung wandern nach kerio_common.py, damit
beide Scripts sie teilen.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

README.md

@@ -1,7 +1,19 @@
 # kerio-connect-rename-user
 
-Benennt einen Benutzer in Kerio Connect vollständig um — Login-Name in der
-Serverkonfiguration **und** das zugehörige Mailbox-Verzeichnis im Store.
+Werkzeuge für Kerio Connect auf der Kommandozeile.
+
+| Datei | Zweck |
+| --- | --- |
+| [`kerio_rename_user.py`](kerio_rename_user.py) | Benutzer umbenennen — Login-Name **und** Mailbox-Verzeichnis im Store |
+| [`kerio_trial_setup.py`](kerio_trial_setup.py) | Am Erstkonfigurationsassistenten vorbei, wenn dessen Lizenzschritt klemmt |
+| [`kerio_common.py`](kerio_common.py) | Gemeinsame Bausteine: API-Client, Dienststeuerung |
+
+Beide Scripts laufen **lokal auf dem Kerio-Server als root**, brauchen nur die
+Python-Standardbibliothek und bieten `--dry-run`.
+
+---
+
+# Benutzer umbenennen
 
 ## Warum
 
@@ -110,8 +122,62 @@ selbst gestoppt sein, bevor das Script läuft.
 - Weitere Adressen am Benutzer (`emailAddresses`) bleiben unverändert und werden
   im Plan zur Kontrolle mit angezeigt.
 
-## API-Referenz
+---
+
+# Erstkonfigurationsassistent überspringen
+
+## Warum
+
+Der Assistent verlangt im Schritt „Registrierte Testaktivierung" eine
+Testlizenznummer samt CAPTCHA. Der dokumentierte Link „Im unregistrierten Modus
+aktivieren" fehlt je nach Version oder ist im Fenster abgeschnitten, und die
+verlinkte Registrierungsseite ist seit der Übernahme durch GFI teilweise tot —
+man kommt im Assistenten nicht weiter.
+
+Kerio kennt dafür den Schalter `ConfigWizardDone` in `mailserver.cfg`. Steht er
+auf `1`, öffnet die Administrationskonsole den Assistenten nicht mehr und der
+Server läuft 30 Tage ab Installation im unregistrierten Modus.
+
+Im unregistrierten Modus fehlen Antivirus-Updates, ActiveSync, Greylisting und
+Hersteller-Support; nach 30 Tagen stoppt die Engine. **Benutzerverwaltung,
+Administrationskonsole und Admin-API sind nicht eingeschränkt** — für einen
+Testserver also unproblematisch.
+
+## Benutzung
+
+```bash
+./kerio_trial_setup.py --status              # Zustand anzeigen (kein root nötig)
+sudo ./kerio_trial_setup.py --skip-wizard    # Assistenten überspringen
+sudo ./kerio_trial_setup.py --restore        # Backup zurückspielen
+```
+
+`--status` zeigt Dienstzustand, `ConfigWizardDone`, `TrialID`, vorhandene
+Lizenzdateien und eine Schätzung, wann der Testzeitraum abläuft.
+
+## Der springende Punkt
+
+`mailserver.cfg` darf **nur bei gestopptem Dienst** bearbeitet werden. Kerio
+schreibt seine Konfiguration beim Beenden aus dem Speicher zurück und würde eine
+Änderung am laufenden Dienst wieder überschreiben. Das Script stoppt deshalb den
+Dienst, liest die Datei **danach neu ein** (die Version von vorher ist zu diesem
+Zeitpunkt bereits veraltet), schreibt atomar über eine temporäre Datei im selben
+Verzeichnis, startet den Dienst und liest den Wert zur Kontrolle noch einmal.
+
+Vor jeder Änderung wird ein Backup als `mailserver.cfg.bak-trial-setup` angelegt.
+
+## Falls du doch eine registrierte Trial willst
+
+Geht aus der laufenden Instanz heraus, ohne Installer: **Dashboard → „Become a
+registered trial user"**. Braucht ausgehendes HTTPS auf Port 443 zum
+GFI-Registrierungsserver.
+
+---
+
+## API- und Doku-Referenz
 
 - [Administration API for Kerio Connect — Users](https://manuals.gfi.com/en/kerio/api/connect/admin/reference/interfacekerio_1_1jsonapi_1_1admin_1_1_users.html)
 - [Sample communication (Session.login, X-Token)](https://manuals.gfi.com/en/kerio/api/connect/admin/reference/sample_communication.html)
 - [User struct](https://manuals.gfi.com/en/kerio/api/connect/admin/reference/structkerio_1_1jsonapi_1_1admin_1_1_user.html)
+- [Registering Kerio Connect (unregistered mode)](https://manuals.gfi.com/en/kerio/connect/content/registration-and-licenses/registering-kerio-connect-1134.html)
+- [Initial Wizard Settings Are Not Saving (ConfigWizardDone)](https://support.kerioconnect.gfi.com/article/114858-initial-wizard-settings-are-not-saving-in-kerio-connect)
+- [Modifying the mailserver.cfg](https://support.kerioconnect.gfi.com/en-us/article/114788-modifying-the-mailserver-cfg)