oxid CE & PE 4.2 Migrationstool von osCommerce & xtCommerce 3.04
Dieses Tool bemüht sich, für Sie die bestehenden
- Kunden mit all ihren Adressen
- Produkte inkl. Bildern und Varianten
- Kategorien
- Hersteller
- Bestellungen
- Newsletter und Newsletter-Abonnenten
von XTCommerce 3 zu Oxid mitzunehmen. Bitte beachten Sie, dass das nicht zu 100 % möglich ist, da die zwei Systeme zu unterschiedlich sind. Trotzdem werden Sie, nachdem das Tool durchgelaufen ist, im Admin-Bereich (Login: admin, Passwort: admin) von Oxid Ihre Daten wiederfinden. Dieses Tool ist für mysql Datenbanken gedacht! Außerdem sollte in der php.ini 'safe_mode: Off' eingestellt sein, da das Skript die 'max_execution_time' ändern muss. Dies ist im safe_mode nicht erlaubt.
Falls Sie während der Ausführung des Programms folgende Meldung bekommen:
Fatal error: Allowed memory size of [some size] bytes exhausted..,
erhöhen Sie die Einstellung "memory_limit" in der php.ini. 128 M sollten genügen, aber wenn nicht, probieren Sie mehr. Es ist abhängig von der Datenmenge Ihres Shops. Sie können die Einstellungen nach Beendigung des Programms natürlich sofort Rückgängig machen!
Es kann passieren, dass Umlaute in den Kunden- bzw. Produktdaten nicht korrekt dargestellt werden. Das liegt daran, dass sowohl von den Datenbanken als auch von Oxid bzw. XTCommerce unterschiedliche Zeichensätze verwendet werden (könnten). Sie haben allerdings die Möglichkeit, drei Methoden auszuprobieren, die versuchen, das Problem zu beheben. Diese finden Sie unten im Formular.
Es kann auch wichtig sein, dass Sie in XTCommerce und Oxid dasselbe CHARSET und COLLATE benutzen. Dies können Sie in Ihrer Datenbank einstellen. Lesen Sie dazu die Mysql-Dokumentation.
Eine Methode, die Funktioniert hat, wenn Sie 'latin1' benutzen und im Oxid Shop ausschließlich 'utf8' verwenden (lesen Sie dazu im Wiki von Oxid), ist:
- Stellen Sie als Converter-Funktion 'none' ein.
- Aktivieren Sie die Option convertOxidDump.
Weiterhin werden viele Felder im Admin-Bereich nicht ausgefüllt sein, was wiederum daran liegt, dass die von Oxid dargestellen Informationen nicht alle von XTCommerce zur Verfügung gestellt werden.
Sie werden nach dem Starten des Programms vier Dateien finden, und zwar:
- converter_sqldump.sql
- emails.txt
- errors_and_warnings.txt
- infos.txt
Sie können die Dateien unten im Formular umbenennen, falls Sie dies wünschen.
Die .sql Datei enthält alle sql-Befehle, die ausgeführt wurden, damit Sie nachvollziehen können, was geschehen ist. Diese Datei kann sofort gelöscht werden.
Die zweite Datei 'emails.txt' ist sehr wichtig. Sie enthält die Emailadressen aller Kunden sowie deren neue Passwörter. Da XTCommerce und Oxid verschiedene Verschlüsselungen für die Passwörter benutzen, können diese nicht übernommen werden. In der XTCommerce Datenbank stehen die Passwörter verschlüsselt und können nicht entschlüsselt werden (und das ist auch gut so). Daher müssen allen Kunden neue Passwörter gegeben werden. Sie müssen allen Kunden eine Email schreiben, in der Sie ihnen ihren Login - die Emailadresse - sowie ihr neues Passwort mitteilen.
Die dritte Datei, 'errors.txt', ist für Sie interessant, falls Sie das Gefühl haben, dass die Migration nicht korrekt funktioniert hat. In diesem Fall können Sie in der Datei alle Befehle sehen, die nicht ausgeführt werden konnten.
Die letzte Datei, 'infox.txt', enthät alle Informationen, die während der Migration gesammelt wurden. Diese können für Sie interessant sein. Die Datei wird Ihnen nach Abschluss der Migration im Browser angezeigt.
Um zu testen, ob die Migration erfolgreich war, sollten Sie im admin-Bereich gründlich herumschauen, sowie sich testweise mal als ein Kunde einloggen. Das sollte mit Hilfe von 'emails.txt' kein Problem sein.
Wichtig:
Bitte schließen Sie alle offenen Bestellungen mit Ihrem alten System ab. Die Bestellungen werden zwar so wie sie zum Zeitpunkt der Migration sind, übernommen (d.h. in Oxid steht bei einer offenen Bestellung auch 'offen'), trotzdem sollten Sie der Sicherheit halber alle in XTCommerce abgeschlossenen Bestellungen auch mit Hilfe von XTCommerce zuende bringen!
Was Sie nun tun und beachten müssen:
- Legen Sie eine Datenbank für den oxid Shop an. Der Datenbankbenutzer, der auch die XTCommerce Datenbank benutzt, soll vollen Zugriff auf die Oxid Shop Datenbank bekommen. Die Oxid Datenbank wird geleert. Falls Sie also schon einen Oxid-Shop haben, legen Sie eine neue Datenbank an!
- Die XTCommerce Datenbank wird temporär verändert, am Ende aber in den Ausgangszustand zurück versetzt. Sie sollen eine Kopie der XTCommerce Datenbank anlegen und mit dieser die Migration vornehmen. Falls dies nicht möglich ist, sollen Sie während der Migration den Shop abschalten (z.B. nachts)
- Installieren Sie den Oxid Shop. Dies ist nötig, weil das Tool Funktionen von Oxid benutzt. Abgesehen davon müssen Sie den Oxid Shop sowieso installieren, wenn Sie vorhaben, ihn zu benutzen.
- Füllen Sie die untenstehenden Felder aus und klicken Sie auf 'los'
- Haben Sie Geduld!!! Je nach Größe der Datenbank und Ihrem Rechner kann das Tool 30 min und länger laufen. Sie können im Admin-Bereich (diesen finden Sie standardmäßig unter http:/ihreurl/oxid/admin/ Login:admin, Passwort:admin) von Oxid live sehen, welche Daten schon eingefügt worden sind.
- Falls sie die Option convertOxidDump benutzen, wundern Sie sich nicht, dass Sie im Adminbereich - falls Sie dort herumschauen, während das Tool noch läuft - durchaus noch merkwürdige Zeichen sehen können. convertOxidDump läuft erst ganz am Ende.
- Falls Sie das Tool unterbrechen, kann es sein, dass die XTCommerce Datenbank noch nicht in den Ausgangszustand zurück versetzt wurde (siehe Punkt 2). Sie müssen dann den .sql Dump manuell in Ihre Datenbank einspielen. Besser ist es also, das Tool nicht zu unterbrechen.
- Überprüfen Sie das Ergebnis! Falls Fehler aufgetreten sind, schauen Sie nach, wieso und an welcher Stelle.
- Informieren Sie Ihre Kunden, wie der neue Shop erreichbar ist, und teilen Sie ihnen ihren Login mit! Hierzu können Sie die mitgelieferte Seite emails.html aufrufen, welches das Skript _emails_mailer.php verwendet
- Falls Sie Ideen zu Erweiterungen dieses Programms haben, oder uns einen anderen Kommentar schicken möchten, schreiben Sie an jana.rekittke@itratos.de
Falls Sie Probleme bzgl. des Zeichensatzes feststellen, d.h. wenn Umlaute nicht korrekt
dargestellt werden, können Sie versuchen, eine der folgenden Methoden zu verwenden.
- Die erste versucht, den Zeichensatz nach Latin1,
- die zweite, den Zeichensatz nach UTF8 zu konvertieren
- und die letzte wandelt alle Umlaute in ihre Umschreibung um (ö -> oe etc.).
Der Erfolg kann nicht garantiert werden.
Die beste Lösung ist: Stellen Sie alles auf UTF-8 um!!
Wenn Sie es wünschen, kann das Skript Ihnen, nachdem es beendet ist, eine Email zur Bestätigung schicken. Als Anhang werden die Dateien
- emails.txt
- infos.txt
- errors_and_warnings.txt
mitgeschickt. Tragen Sie Ihre Emailadresse ein, wenn Sie diesen Service in Anspruch nehmen möchten. Ansonsten lassen Sie das Feld frei.