Wie man von einer älteren Installation migriert

Diese Anleitung importiert Ihre vorhandenen Daten von einer älteren HandyCafe V3- oder V4-Installation auf einen modernen HandyCafe-Server. Die Migration ist nicht destruktiv für die Quelle: Die Originaldateien werden nicht verändert oder gelöscht.

Die Datenbankmigration läuft nur unter Windows. Laufzeitunterstützung für Legacy-Clients, die über das ursprüngliche Protokoll verbinden, funktioniert auf jeder Plattform (siehe Legacy Clients Einstellungen).

Was Sie benötigen

• Einen Windows-Rechner mit sowohl der Legacy-Installation als auch dem modernen HandyCafe-Server auf demselben System oder Zugriff auf die Legacy-Datenbankdatei.
• Admin-Zugriff auf den HandyCafe-Server.
• Der Legacy-Server muss gestoppt sein. Die Quelldatenbank sollte während der Migration nicht aktiv beschrieben werden.
• Freier Speicherplatz mindestens in der Größe der Legacy-Datenbank (für die neue Kopie der HandyCafe-Datenbank).
• 10 bis 30 Minuten ununterbrochene Zeit. Migrationen bei großen Datensätzen können mehrere Minuten dauern. Schließen Sie HandyCafe während des Vorgangs nicht.

Schritt 1: Stoppen Sie den Legacy-Server

Öffnen Sie die Legacy-HandyCafe-Serveranwendung. Beenden Sie alle Sitzungen und schließen Sie die Anwendung. Wenn der Legacy-Server als Windows-Dienst läuft, stoppen Sie den Dienst über services.msc.

Erwartetes Ergebnis: Der Legacy-Serverprozess läuft nicht mehr. Die Datenbankdatei ist nicht geöffnet.

Schritt 2: Öffnen Sie die Legacy Clients Einstellungsseite

1. Starten Sie HandyCafe.
2. Öffnen Sie Einstellungen in der Seitenleiste.
3. Klicken Sie auf Legacy Clients.
4. Scrollen Sie zum Abschnitt Datenbankmigration.

Erwartetes Ergebnis: Wenn das System eine Legacy-Installation erkennt, zeigt die Seite den Installationspfad, den Datenbankpfad, die Serverversion und die Anzahl der INI-Dateien an. Wenn nichts erkannt wird, sagt die Seite "Keine Legacy-Installation erkannt." In diesem Fall überprüfen Sie, ob die Legacy-Dateien an einem Standardort wie Program Files\HandyCafe oder C:\HandyCafe existieren.

Schritt 3: Überprüfen Sie die erkannte Installation

Überprüfen Sie, ob die erkannten Werte mit Ihrer bekannten Legacy-Installation übereinstimmen:

Wenn ein Feld falsch ist, schließen Sie HandyCafe, beheben Sie die Installation und öffnen Sie es erneut.

Schritt 4: Überprüfen Sie das Encoding-Feld

Bevor Sie die Migration starten, bestätigen Sie, dass das Encoding-Feld im Abschnitt Laufzeitprotokoll korrekt für Ihre Quelldaten eingestellt ist. Dies befindet sich auf derselben Einstellungsseite, weiter oben.

Wenn Sie das Encoding ändern, klicken Sie auf Speichern, bevor Sie fortfahren.

Erwartetes Ergebnis: Quelltexte werden während der Migration sauber dekodiert, was ein completed_with_warnings-Ergebnis vermeidet.

Schritt 5: Starten Sie die Migration

1. Klicken Sie auf Migration starten.
2. Ein Fortschrittsfenster öffnet sich. Es zeigt die aktuelle Phase und die Anzahl der bisher verarbeiteten Zeilen an.
3. Schließen Sie HandyCafe nicht und versetzen Sie den Computer nicht in den Ruhezustand.
4. Warten Sie auf den Abschluss. Kleine Datensätze sind in weniger als einer Minute fertig. Größere Datensätze können 5 bis 10 Minuten dauern.

Erwartetes Ergebnis: Das Fortschrittsfenster schließt sich und der Status ändert sich zu completed oder completed_with_warnings. Eine Benachrichtigung erscheint, die den Lauf bestätigt.

Schritt 6: Überprüfen Sie die migrierten Zählungen

Nach Abschluss zeigt die Seite die migrierten Datensatzanzahlen an:

Klicken Sie auf den Details-Expander, um die vollständige Aufschlüsselung zu sehen. Überprüfen Sie, ob die Zählungen vernünftig im Vergleich zu Ihren Erwartungen aussehen.

Erwartetes Ergebnis: Alle vier Kategorien (Mitglieder, Produkte, Bestellungen, Transaktionen) zeigen ungleich null Zählungen, wenn Ihre Quelle Daten in diesen Tabellen hatte.

Schritt 7: Behandeln Sie Warnungen (falls vorhanden)

Wenn der Status completed_with_warnings ist, erweitern Sie die Warnungsliste und überprüfen Sie die übersprungenen Datensätze.

Häufige Warnungen und deren Behebungen:

Erwartetes Ergebnis: Sie akzeptieren die Warnungen entweder als bekannte, akzeptable Verluste oder beheben das zugrunde liegende Problem und führen die Migration erneut aus.

Schritt 8: Überprüfen Sie importierte Daten stichprobenartig

Bevor Sie den Legacy-Server außer Betrieb nehmen, überprüfen Sie manuell eine Stichprobe jedes Datensatztyps.

1. Öffnen Sie Mitglieder in der Seitenleiste. Suchen Sie nach einem Mitglied, das Sie aus dem Legacy-System kennen. Bestätigen Sie Name, Guthaben und Kontaktinformationen.
2. Öffnen Sie Einstellungen > Preise. Bestätigen Sie, dass die Stundensätze dem Legacy-Zeitplan entsprechen.
3. Öffnen Sie Produkte. Bestätigen Sie Produktnamen und Preise.
4. Öffnen Sie Kassenbericht für einen kürzlich vergangenen Tag. Bestätigen Sie, dass die Summen mit dem übereinstimmen, was Sie vom Legacy-System erwarten.

Erwartetes Ergebnis: Zufällige Stichproben stimmen mit der Legacy-Quelle überein. Wenn ein bestimmter Datensatz falsch ist, notieren Sie das Problem. Geringfügige Formatierungsunterschiede sind normal. Größere Wertabweichungen deuten auf ein Encoding- oder Datenintegritätsproblem hin, das vor dem Live-Betrieb untersucht werden sollte.

Schritt 9: Aktivieren Sie die Laufzeitunterstützung für Legacy-Clients (optional)

Wenn Sie möchten, dass Ihre vorhandenen V3- oder V4-Client-Maschinen weiterhin verbinden, während Sie wechseln, aktivieren Sie jetzt das Laufzeitprotokoll.

1. Scrollen Sie zum Anfang der Legacy Clients Einstellungsseite.
2. Schalten Sie Legacy Client Support aktivieren ein.
3. Bestätigen Sie, dass die Listener-Ports (UDP 710, TCP 712, Dateiübertragung 717) nicht mit etwas anderem in Ihrem Netzwerk in Konflikt stehen.
4. Klicken Sie auf Speichern.

Erwartetes Ergebnis: Legacy-Clients im LAN erscheinen innerhalb von 5 bis 10 Sekunden im Admin-Panel. Siehe Legacy Clients, um zu erfahren, wie Sie sie vom Panel aus verwalten.

Wie man eine Migration rückgängig macht

Wenn die Migration unerwartete Ergebnisse produziert hat, können Sie sie vollständig zurücksetzen. Die ursprüngliche Legacy-Datenbank bleibt unberührt.

1. Öffnen Sie Einstellungen > Legacy Clients.
2. Scrollen Sie zum Abschnitt Datenbankmigration.
3. Klicken Sie auf Migration rückgängig machen.
4. Bestätigen Sie im Dialog.

Jede migrierte Zeile wird aus HandyCafe gelöscht. Der Status kehrt zu nie zurück. Sie können dann das zugrunde liegende Problem beheben (Encoding, Bereinigung der Quelldaten usw.) und die Migration erneut starten.

Wie man eine Migration erneut ausführt

Das erneute Ausführen ersetzt migrierte Daten durch frische Daten aus der Quelle.

1. Öffnen Sie Einstellungen > Legacy Clients.
2. Klicken Sie auf Migration erneut ausführen (die Schaltfläche wird nach dem ersten abgeschlossenen Lauf von Migration starten umbenannt).
3. Der Ablauf ist identisch mit dem ersten Lauf.

Das erneute Ausführen kann so oft wie nötig sicher verwendet werden. Es dupliziert keine Daten, da es die vorhandene Migrationsausgabe ersetzt.

Häufige Fehler, die vermieden werden sollten

• Migration ausführen, während der Legacy-Server aktiv ist. Die Quelldatenbank kann gesperrt sein oder teilweise beschriebene Daten enthalten. Stoppen Sie immer zuerst den Legacy-Server.
• Das Encoding-Feld ignorieren. Das Ausführen mit dem falschen Encoding beschädigt Mitgliedsnamen und Protokollnachrichten. Dies nachträglich zu beheben erfordert Rückgängig und erneut ausführen.
• HandyCafe während der Migration schließen. Der Lauf wird unterbrochen und teilweise Daten werden geschrieben. Die Wiederherstellung erfordert Rückgängig. Lassen Sie das Fortschrittsfenster immer vollständig abschließen.
• Den Schritt der Stichprobenüberprüfung überspringen. Den Datensatzanzahlen zu vertrauen, ohne Beispieldaten zu überprüfen, übersieht subtile Probleme wie Locale-Unstimmigkeiten oder Rundungsfehler.
• Die Legacy-Installation zu früh löschen. Bewahren Sie die Quelldateien mindestens einen vollen Zahlungszyklus nach der Migration auf. Wenn eine Diskrepanz in einem Monatsbericht auftaucht, können Sie auf die Originalaufzeichnungen zurückgreifen.
• Migration ohne Backup durchführen. Kopieren Sie den Legacy-Installationsordner vor der ersten Migration. Während die Quelle durch die Migration nicht verändert wird, können Festplattenprobleme oder Unfälle passieren. Ein Backup ist eine günstige Versicherung.