Auf 4.7.0/5.0.0 aktualisieren

Auf 4.7.0/5.0.0 aktualisieren
Diese Anleitung beschreibt das Update auf OXID eShop Version 4.7.0 (Community und
Professional Edition) und Version 5.0.0 (Enterprise Edition). Es unterscheidet sich grundlegend
vom Standard-Update und kann nur auf einen OXID eShop Version 4.6.5, 4.6.6, 4.6.7 oder 4.6.8
angewandt werden. Haben Sie eine vorhergehende Shopversion im Einsatz, muss diese zuerst
auf eine dieser Versionen aktualisiert werden.
Hinweis: Um das Update nach dieser Anleitung ausführen zu können, müssen OXID eShop
4.6.5 bis 4.6.8 und OXID eShop 4.7.0/5.0.0 auf dem gleichen Server installiert sein. Der OXID
eShop 4.6.5 bis 4.6.8 ist der zu aktualisierende Shop. Beim OXID eShop 4.7.0/5.0.0 handelt es
sich um eine komplette Neuinstallation.
Wir empfehlen dringend, das Update erst in einer Test- oder Entwicklungsumgebung, einer Kopie
Ihres aktuellen Shops, auszuführen. Testen Sie anschließend den Shop und legen Sie dabei
besonderen Wert auf die Funktionen des Bestellprozesses, auf Zahlungs- und Versandarten.
Arbeitet der Shop korrekt, kann der Shop im Live-System durch den aus der Test- oder
Entwicklungsumgebung ersetzt werden. Alternativ können Sie das Update auch im Live-System
erneut ausführen. Kopieren Sie während des Updates im Live-System eine index.html in das
Hauptverzeichnis des Shops, in der Sie auf aktuelle Wartungsarbeiten hinweisen. Sie können
den Shop auch deaktivieren und die Datei offline.html zur Informationen Ihrer Kunden nutzen.
Das Update kann unter Verwendung der Anwendung updateApp ausgeführt werden. Dabei wird
die Datenbank aktualisiert und es werden ein eigenes Theme und/oder installierte Module in den
neuen Shop verschoben. Wenn Sie einen stark angepassten Shop haben und Theme und/oder
Module selbst kopieren oder verschieben wollen, lesen Sie bitte den Abschnitt Manuelles Update
.
Update per Script
1. Sicherungskopien anfertigen
Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden
OXID eShop 4.6.5 bzw. 4.6.6.
2. Neuen Shop installieren
Installieren Sie einen OXID eShop 4.7.0/5.0.0 auf dem gleichen Server, auf dem der OXID eShop
4.6.5 bzw. 4.6.6 läuft.
3. Alte Datenbank verbinden
Verbinden Sie den OXID eShop 4.7.0/5.0.0 mit der Datenbank des OXID eShop 4.6.5 bzw. 4.6.6.
Editieren Sie dafür die Konfigurationsdatei config.inc.php des OXID eShop 4.7.0/5.0.0 und
ändern Sie die Einträge für den Datenbanknamen, den Datenbankbenutzer und dessen
Passwort.
4. updateApp ausführen
Das Update-Paket enthält das Verzeichnis /updateApp mit einem kleinen Programm, welches
die Datenbank bearbeitet sowie Theme und/oder Module in den neuen Shop verschiebt.
Kopieren Sie das Verzeichnis /updateApp in das Hauptverzeichnis des installierten OXID eShop
4.7.0/5.0.0.
Rufen Sie in Ihrem Browser www.ihreshopurl.de/updateApp auf. Ersetzen Sie dabei
www.ihreshopurl.de durch die URL Ihres OXID eShop 4.7.0/5.0.0. Das Programm fragt, ob
es Theme und Module in den neuen Shop verschieben soll. Bejahen Sie diese Frage, müssen
Sie den Pfad zum OXID eShop 4.6.5 bzw. 4.6.6 angeben. Sie finden den Pfad in der
Konfigurationsdatei config.inc.php des OXID eShop 4.6.5 bzw. 4.6.6.
Bitte beachten Sie, dass Updates bei großen Datenbanken viel Zeit beanspruchen können.
Setzen Sie den Parameter max_execution_time in der php.ini der Test- oder
Entwicklungsumgebung auf einen angemessenen Wert, um ein Timeout bei der Verarbeitung zu
vermeiden. Löschen Sie das Verzeichnis /updateApp, wenn das Datenbank-Update fertig ist.
5. Views aktualisieren
Gehen Sie im Administrationsbereich des OXID eShop 4.7.0/5.0.0 zu Service -> Tools und
aktualisieren Sie die Views. Falls Sie sich nicht im Administrationsbereich anmelden können,
setzen Sie vorübergehend den Parameter blSkipViewUsage in der Konfigurationsdatei
config.inc.php auf "true".
6. Artikelbilder kopieren
Kopieren Sie alle Artikelbilder aus dem OXID eShop 4.6.5 bzw. 4.6.6 in den OXID eShop
4.7.0/5.0.0. Diese befinden sich standardmäßig im Verzeichnis /out/pictures.
7. Templates anpassen
Passen Sie die Templates eines eigenen Themes an den OXID eShop 4.7.0/5.0.0 an. Die
Template-Dokumentation befindet sich im Update-Paket und unterteilt sich in
/templ_docu_application_views_admin, /templ_docu_application_views_azure und
/templ_docu_out_azure. Theme "Basic" ist nicht mehr länger Bestandteil des Shops. Basiert Ihr
eigenes Theme darauf, sollten Sie auf Theme "Azure" umstellen. Wie das Theme "Basic" weiter
mit OXID eShop 4.7.0/5.0.0 verwendet werden kann, erklärt dieses englische Tutorial auf
OXIDforge: http://oxidforge.org/en/use-basic-theme-from-version-4-7-and-5-0-on.html.
8. Temporäre Dateien löschen
Löschen Sie alle Dateien und Ordner außer der .htaccess aus dem Verzeichnis /tmp des Shops.
9. Theme und Module aktivieren
Aktivieren Sie im Administrationsbereich ggf. das eigene Theme und/oder die Module.
Manuelles Update
1. Sicherungskopien anfertigen
Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden
Erstellen Sie eine Sicherungskopie aller Shopdateien und der Datenbank Ihres bestehenden
OXID eShop 4.6.5 bzw. 4.6.6.
2. Neuen Shop installieren
Installieren Sie einen OXID eShop 4.7.0/5.0.0 auf dem gleichen Server, auf dem der OXID eShop
4.6.5 bzw. 4.6.6 läuft.
3. Alte Datenbank verbinden
Verbinden Sie den OXID eShop 4.7.0/5.0.0 mit der Datenbank des OXID eShop 4.6.5 bzw. 4.6.6.
Editieren Sie dafür die Konfigurationsdatei config.inc.php des OXID eShop 4.7.0/5.0.0 und
ändern Sie die Einträge für den Datenbanknamen, den Datenbankbenutzer und dessen
Passwort.
4. Datenbank aktualisieren
Führen Sie die SQL-Anweisungen aus der Datei 49955.sql aus. Verwenden Sie dafür
beispielsweise die Eingabemöglichkeiten im Administrationsbereich des Shops unter Service ->
Tools oder Tools wie phpMyAdmin. Die Datei 49955.sql befindet sich im Verzeichnis
/updateApp/updates/sql des Update-Paketes.
5. Views aktualisieren
Gehen Sie im Administrationsbereich des OXID eShop 4.7.0/5.0.0 zu Service -> Tools und
aktualisieren Sie die Views.
6. Theme installieren
Soll ein eigenes Theme verwendet werden, führen Sie bitte nachfolgende Installationsschritte
aus.
Legen Sie Verzeichnisse für das Theme unter /out und /application/views an
Kopieren Sie die Verzeichnisse mit den Sprachdateien, den Templates und die Metadata-Datei
theme.php in das Verzeichnis /application/views/[theme]
Kopieren Sie die Verzeichnisse mit den Stylesheet- und JavaScript-Dateien sowie Bilder des
Themes nach /out/[theme]
7. Module installieren
Stellen Sie sicher, dass die Module für die neue Shopversion vorbereitet sind.
Kopieren Sie die Module in das Verzeichnis /modules
8. Artikelbilder kopieren
Kopieren Sie alle Artikelbilder aus dem OXID eShop 4.6.5 bzw. 4.6.6 in den OXID eShop
4.7.0/5.0.0. Diese befinden sich standardmäßig im Verzeichnis /out/pictures.
9. Templates anpassen
Passen Sie die Templates eines eigenen Themes an den OXID eShop 4.7.0/5.0.0 an.
10. Theme und Module aktivieren
Aktivieren Sie im Administrationsbereich ggf. das eigene Theme und/oder die Module.
Das Update ist abgeschlossen. Tragen Sie die korrekte Shop-URL in die Konfigurationsdatei
config.inc.php des OXID eShop 4.7.0/5.0.0 ein. Die Dateien des OXID eShop 4.6.5 bzw. 4.6.6
werden nicht mehr benötigt, sobald der aktualisierte Shop live geht. Auch die bei der
Neuinstallation des OXID eShop 4.7.0/5.0.0 erstellte Datenbank kann gelöscht werden.