--- title: KuferWEB-Versionen und Rollback description: Wie KuferWEB-Versionen über das Verzeichnis-Schema verwaltet werden, welche Sicherungen KuferTransfer und BAS_DMZ aufbewahren, wann und wie ein Rollback durch Verzeichnis-Tausch durchgeführt wird und welche Aufräum-Arbeiten nach erfolgreichem Update anstehen. --- [Zu Content springen](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-versionen-und-rollback#main-content) [![logo](https://cs.kufer.de/hubfs/CI/logo.svg)](https://cs.kufer.de/kufer-wissensdatenbanken?hsLang=de-de) - [Website](https://www.kufer.de/) Hauptnavigation öffnen Hauptnavigation schließen - [Website](https://www.kufer.de/) Wie können wir Ihnen helfen? - Es gibt keine Vorschläge, da das Suchfeld leer ist. 1. [KuferWEB](https://cs.kufer.de/de-de/kb/kuferweb?hsLang=de-de) 2. [KuferWEB-Betrieb](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-betrieb?hsLang=de-de) 9\. Oktober 2026 # KuferWEB-Versionen und Rollback ## Versionierung des KuferWEB-Verzeichnisses über \`kuferweb\_alt\[Datum\]\`, Sicherungs- und Aufräum-Strategie für KuferTransfer und BAS\_DMZ, Rollback durch Verzeichnis-Tausch KuferWEB verwendet ein einfaches, aber wirkungsvolles Versions-Konzept: Vor jedem Update wird das aktive `kuferweb`-Verzeichnis als `kuferweb_alt[Datum]` aufbewahrt, KuferTransfer und BAS\_DMZ werden separat gesichert, und die neue Version wird ausschließlich in einem parallelen `kuferweb_neu`-Verzeichnis aufgebaut. Falls die neue Version Probleme macht, ist ein Rollback durch reines Verzeichnis-Umbenennen möglich. Dieser Artikel beschreibt das Versions-Konzept und die Aufräum-Strategie. ℹ️ **BAS\_Replikat:** BAS\_Replikat wird nicht mehr ausgeliefert. Läuft es bei Ihnen noch, stellen Sie auf KuferTransfer um — siehe [KuferTransfer Konfigurator: Verbindung, Übertragung, Fotos und Stammdaten einrichten](https://cs.kufer.de/de-de/kb/uebergreifend/kufertransfer-konfigurator-oberflaeche-uebertragung-stammdaten?hsLang=de-de#umstieg-von-bas-replikat-konfiguration-importieren). ℹ️ **Voraussetzung:** Ein abgeschlossenes oder geplantes KuferWEB-Update gemäß [KuferWEB-Update-Prozess](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-update-prozess?hsLang=de-de) — die in diesem Artikel beschriebenen Sicherungen und Verzeichnisse entstehen während des Update-Workflows. ⚠️ **Achtung:** Aufräum-Arbeiten erst durchführen, wenn der **fehlerfreie Betrieb der neuen Version gesichert** ist. Werden Sicherungen zu früh gelöscht, ist ein Rollback nicht mehr möglich. Kufer empfiehlt mindestens **einen Monat Wartezeit** vor dem endgültigen Löschen der Sicherungen. ## Das Versions-Konzept im Überblick Während eines KuferWEB-Updates entstehen drei zueinander parallele Verzeichnisstände, die nacheinander aktiv werden: - **`kuferweb`** — die aktuell live geschaltete Version, die KuferWEB-Frontend und MySQL-Datenbank ansprechen. - **`kuferweb_neu`** — die neue Version während des Update-Aufbaus. Hier werden die Web-Anwendungen kopiert, Standard-Sichten ergänzt und die KuferTransfer-Pfade temporär hingebogen. - **`kuferweb_alt[Datum]`** — die archivierte vorherige Version nach Liveschaltung. Dient als Rollback-Möglichkeit und für nachträgliche Datei-Vergleiche. Parallel dazu pflegen KuferTransfer und BAS\_DMZ eigene Sicherungs-Ordner mit der zuvor aktiven Code-Basis. Damit besteht zu jedem Zeitpunkt nach einem Update ein vollständiger Rückweg auf die alte Version. Wie diese Komponenten im laufenden Betrieb zusammenspielen, ordnet der [Überblick zu Betrieb und Systemarchitektur](https://cs.kufer.de/de-de/kb/uebergreifend/hub-betrieb-und-systemarchitektur-im-ueberblick?hsLang=de-de) ein. ℹ️ **Datum-Konvention:** Das `[Datum]`-Suffix in `kuferweb_alt[Datum]` ist eine Empfehlung. Üblich sind Schreibweisen wie `kuferweb_alt_20251015` oder `kuferweb_alt-2025-10-15`. Wichtig ist, dass das Datum eindeutig ist, falls mehrere Updates kurz hintereinander erfolgen. ## Verzeichnis-Tausch bei der Liveschaltung Der Wechsel von `kuferweb` zu `kuferweb_neu` ist der zentrale Versions-Sprung. Er wird durch reines Umbenennen der Verzeichnisse vollzogen — schnell und ohne Datentransfer. So läuft der Verzeichnis-Tausch ab: 1. Nach erfolgreichem **Update-Transfer** des KuferTransfer steht die neue Datenbankstruktur bereit. 2. Im Webserver-Verzeichnis (in der Regel `fileadmin/` bei TYPO3 oder `wp-content/` bei WordPress) befinden sich nebeneinander `kuferweb` (alt, live) und `kuferweb_neu` (neu, vorbereitet). 3. `kuferweb` wird in `kuferweb_alt[Datum]` umbenannt — die alte Version bleibt damit als Rückfall-Option erhalten. 4. `kuferweb_neu` wird in `kuferweb` umbenannt — die neue Version ist sofort live. 5. Der MySQLoverHTTP-Pfad im KuferTransfer wird von `kuferweb_neu` zurück auf `kuferweb` korrigiert. 💡 **Tausch ohne Datentransfer:** Umbenennen verschiebt keine Dateien, der Wechsel ist deshalb deutlich schneller als ein Kopiervorgang. ⚠️ **Kurze Nichterreichbarkeit zwischen den beiden Umbenennungen:** Der Tausch besteht aus **zwei** Umbenennungen (Schritte 3 und 4) — dazwischen existiert kurzzeitig kein `kuferweb`-Verzeichnis. Teilnehmer, die die Seite genau in diesem Moment aufrufen, erhalten den HTTP-Status **`503`**. Führen Sie die beiden Schritte deshalb direkt nacheinander aus, damit das Zeitfenster so klein wie möglich bleibt. ## Was wird gesichert? Während des Update-Workflows entstehen mehrere Sicherungen — jede mit einem konkreten Zweck: - **`kuferweb_alt[Datum]`** (Webserver) — vollständige alte Code-Basis von KuferWEB, inkl. Sichten, Settings und Logs (z. B. `log/Anmeldelog.txt`, `log/anmeldungen`). - **KuferTransfer-Sicherung** (lokaler Server) — der alte KuferTransfer-Ordner vor dem Überschreiben mit der neuen Auslieferung. - **BAS\_DMZ-Sicherung** (lokaler Server) — der alte BAS\_DMZ-Ordner vor dem Überschreiben, inkl. der maschinenabhängig verschlüsselten `DmzServer.exe.config`. - **`imports/*.sql.old`** (KuferTransfer) — die alten Datenbankskripte werden beim Import automatisch in `.old` umbenannt und bleiben damit nachverfolgbar. Wie die Datenbankskripte eingespielt werden, beschreibt der [KuferWEB-Update-Prozess](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-update-prozess?hsLang=de-de#kufertransfer-aktualisieren). 💡 **Zusätzliche Empfehlung — KuferSQL-Datenbanksicherung:** Die Update-Anleitung selbst verlangt keine Sicherung der KuferSQL-Datenbank. Ein vollständiger Rollback setzt sie aber voraus, weil der Update-Transfer die Datenbankstruktur verändert (siehe Sektion „Rollback durchführen” weiter unten). Sichern Sie die KuferSQL-Datenbank daher vor dem Update nach den bei Ihnen üblichen Vorgaben — dies ist eine Empfehlung dieses Artikels, keine Vorgabe aus der Update-Anleitung. ⚠️ **DmzServer.exe.config nicht weiterverwenden:** Die Konfigurationsdatei `DmzServer.exe.config` enthält maschinenabhängig verschlüsselte Datenbank-Zugangsdaten. Bei einem Server-Umzug oder einem Restore auf einem **anderen** Rechner ist die Datei **nicht** wiederverwendbar — sie muss komplett neu erstellt werden. Beim Restore auf derselben Maschine funktioniert sie weiterhin. ## Rollback durchführen Treten nach der Liveschaltung gravierende Probleme auf — z. B. inkompatible Sichten-Versionen, Fehler in der Datenbankstruktur, Funktionsausfälle bei bestimmten Anmelde-Pfaden — kann auf die vorherige Version zurückgewechselt werden. Der Rollback besteht aus mehreren parallelen Wiederherstellungen. ⚠️ **Rollback ist KEIN Standardvorgang:** Ein Rollback nach erfolgtem Update-Transfer ist heikel, weil die KuferSQL-Datenbankstruktur durch den Update-Transfer bereits geändert wurde. Ein vollständiger Rollback erfordert in der Regel auch das Einspielen einer **KuferSQL-Datenbanksicherung von vor dem Update**. Sprechen Sie einen Rollback **immer mit Kufer-Support ab**, bevor Sie ihn durchführen. Die wesentlichen Schritte eines Rollbacks: 1. **Dienste anhalten:** Den KuferServiceWrapper bzw. die Aufgabenplanung des Übertragungsprogramms deaktivieren. Den BAS\_DMZ\_Dienst stoppen. 2. **KuferSQL-Datenbank zurückspielen:** Die vor dem Update erstellte Datenbanksicherung wieder einspielen — sonst passen Code und Datenbankstruktur nicht zueinander. 3. **Webserver-Verzeichnisse zurücktauschen:** `kuferweb` (die neue Version) in z. B. `kuferweb_neu_rueckgetauscht` umbenennen, dann `kuferweb_alt[Datum]` zurück in `kuferweb` umbenennen. Wie bei der Liveschaltung existiert zwischen den beiden Umbenennungen kurzzeitig kein `kuferweb`-Verzeichnis — Teilnehmer erhalten in diesem Moment den HTTP-Status `503`. 4. **KuferTransfer-Ordner zurückspielen:** Den vor dem Update gesicherten KuferTransfer-Ordner wieder aktiv setzen (z. B. aktuellen Ordner umbenennen und den gesicherten Stand unter dem ursprünglichen Ordnernamen einsetzen). 5. **BAS\_DMZ-Ordner zurückspielen** (sofern eingesetzt): Den vor dem Update gesicherten BAS\_DMZ-Ordner wieder aktiv setzen — `DmzServer.exe.config` ist nur wiederverwendbar, wenn es sich um **dieselbe Maschine** handelt; auf einem anderen Server muss die Datei komplett neu erstellt werden. 6. **MySQLoverHTTP-Pfad prüfen:** Im KuferTransfer sicherstellen, dass der Pfad auf das nun wieder live geschaltete `kuferweb` zeigt. 7. **Dienste wieder starten** und Funktionstest durchführen. 💡 **Schneller Rollback bei reinen Web-Problemen:** Wenn die Probleme **nur** auf dem Webserver liegen (z. B. fehlerhafte Sichten oder JavaScript-Probleme) und Datenbankstruktur sowie KuferTransfer/BAS\_DMZ einwandfrei laufen, kann ein eingeschränkter Rollback **nur** auf der Webserver-Ebene oft helfen — `kuferweb_alt[Datum]` zurück zu `kuferweb`, ohne KuferSQL-Restore. Diesen Sonderfall **vor** Durchführung mit Kufer-Support abklären. ## Aufräum-Arbeiten nach erfolgreichem Update Wenn die neue Version mindestens einen Monat fehlerfrei läuft, werden die nicht mehr benötigten Sicherungen entfernt. Damit halten Sie Webserver und lokale Server schlank, behalten aber bewusst die für den laufenden Betrieb wichtigen Daten. ### Tests vor dem Aufräumen Bevor irgendetwas gelöscht wird, testen Sie nach dem Update: - **Kategorien** in der Kursübersicht — werden alle Hauptkategorien angezeigt? - **Kursübersicht** — werden Kurse mit aktuellem Status (Plätze frei, ausgebucht, abgesagt) richtig angezeigt? - **Anmeldung** — funktioniert die Online-Anmeldung von Teilnehmer bis Bestätigungs-E-Mail? - **[DMZ-Anbindung](https://cs.kufer.de/de-de/kb/kuferweb/dmz-betrieb-fuer-kuferweb?hsLang=de-de)** — kommen Anmeldungen in KuferSQL im Echtzeit-Kanal an? - **Foto-Übertragung** — wird die Bilddatei-Übertragung im KuferTransfer wieder ausgeführt? Sollte es **Darstellungs- oder Funktionsfehler** geben, wenden Sie sich bitte an Kufer-Support — **bevor** Sie aufräumen. ### Arbeitsordner des KuferTransfer leeren In allen Arbeitsordnern des KuferTransfer — `backups`, `exports`, `imports`, `pictures`, `reports` — können die Dateien bis auf die `readme.txt` gelöscht werden. Diese Ordner sammeln Arbeits-Dateien aus dem Update-Transfer und der täglichen Datenübertragung; sie sind nach Abschluss nicht mehr nötig. ℹ️ **`readme.txt` nicht löschen:** Die Update-Anleitung nimmt die `readme.txt` in jedem dieser Ordner ausdrücklich vom Löschen aus. Lassen Sie die Datei deshalb unangetastet. ### Sicherungen löschen Nach mindestens einem Monat fehlerfreien Betriebs können folgende Sicherungen gelöscht werden: - Die **KuferTransfer-Sicherung** auf dem lokalen Server. - Die **BAS\_DMZ-Sicherung** auf dem lokalen Server. - Das **`kuferweb_alt[Datum]`**-Verzeichnis auf dem Webserver. 💡 **Webspace-Bedarf prüfen:** Das `kuferweb_alt[Datum]`-Verzeichnis kann mehrere Gigabyte umfassen — insbesondere bei großen Bildersammlungen und langer Log-Historie. Ist der Webspace Ihres Hosting-Pakets knapp bemessen — die maßgebliche Mindestgröße führen die [Systemvoraussetzungen für KuferSQL, KuferWEB und KuferTools](https://cs.kufer.de/de-de/kb/uebergreifend/systemvoraussetzungen-kufersql-kuferweb-kufertools?hsLang=de-de) —, lohnt sich das Aufräumen schon allein wegen des freigegebenen Speichers. ## Version dokumentieren Pflegen Sie eine **Update-Historie** Ihrer KuferWEB-Installation — sie hilft bei Support-Tickets, bei Audit-Anfragen und bei der Planung künftiger Updates. Eine schlanke Dokumentation reicht aus; die folgende Tabelle ist ein Formatvorschlag mit erfundenen Beispielwerten: | **Datum** | **Auslieferungs-Datei** | **Bemerkungen** | | --- | --- | --- | | 2025-10-15 | `20251005_wb_up.zip` | TYPO3-Extension mitaktualisiert | | 2025-04-22 | `20250410_wb_up.zip` | BAS\_DMZ mitaktualisiert | ℹ️ **Auslieferungs-Datei als Versions-Anker:** Die Update-Auslieferung von Kufer ist meist als „KuferWEB-Update” oder nach dem Schema `[Datum]_wb_up` (ggf. `_wb_wt_up`) benannt. Notieren Sie diesen Dateinamen in der Historie — er identifiziert den eingespielten Stand eindeutig, auch ohne interne Versions-Nummer. ## Ergebnis Mit dem `kuferweb_alt[Datum]`-Schema, getrennten KuferTransfer- und BAS\_DMZ-Sicherungen sowie einer schriftlichen Update-Historie haben Sie eine vollständige Versions-Verwaltung für Ihre KuferWEB-Installation. Im Notfall können Sie auf jeden dokumentierten Stand zurückspielen, im Normalfall halten Sie Webspace und lokale Server durch turnusmäßiges Aufräumen schlank. ✅ **Geschafft:** Ihre KuferWEB-Versionen sind sauber archiviert, Rollback-Pfade sind bekannt, und nach mindestens einem Monat fehlerfreien Betriebs räumen Sie die alten Sicherungen kontrolliert weg. - [KuferWEB-Funktionen](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-funktionen?hsLang=de-de) - [CMS-Integration](https://cs.kufer.de/de-de/kb/kuferweb/cms-integration?hsLang=de-de#main-content) - [WordPress](https://cs.kufer.de/de-de/kb/kuferweb/cms-integration?hsLang=de-de#wordpress) - [TYPO3](https://cs.kufer.de/de-de/kb/kuferweb/cms-integration?hsLang=de-de#typo3) - [Webadmin](https://cs.kufer.de/de-de/kb/kuferweb/webadmin?hsLang=de-de) - [KuferWEB-Betrieb](https://cs.kufer.de/de-de/kb/kuferweb/kuferweb-betrieb?hsLang=de-de) © 2026 Kufer Software [Datenschutz](https://www.kufer.de/datenschutz) [Impressum](https://www.kufer.de/impressum)