Von JTL-Shop 4 auf JTL-Shop 5 upgraden

Allgemeine Informationen

JTL-Shop nutzt die Semantic Versioning Spezifikation (Semver). Wir nutzen entsprechend die Begriffe Major-, Minor- und Patch-Versionsnummer und geben Versionen im Format MAJOR.MINOR.PATCH an. Wir unterscheiden zwischen Upgrade und Update:

• Upgrade: Als Upgrade bezeichnen wir die Aktualisierung von einer Major-Version auf die nächsthöhere Major-Version, bspw. die Aktualisierung von JTL-Shop 4 auf JTL-Shop 5. Ein Upgrade bringt neue Features, kann jedoch auch inkompatible Änderungen bzgl. Templates oder Plugin-Schnittstellen mit sich bringen. Prüfen Sie daher, ob die von Ihnen genutzten Plugins und das gewünschte Template auch für die neue Shopversion zur Verfügung stehen.
• Update: Als Update bezeichnen wir die Aktualisierung von einer Minor-Version auf die nächsthöhere Minor-Version innerhalb einer Major-Version, bspw. die Aktualisierung von JTL-Shop 5.2 auf JTL-Shop 5.3. Ein Update enthält in der Regel Bugfixes und häufig neue Features.

Geänderte Vorgänge für jede Version finden Sie mit entsprechender Zielversion im IssueTracker für JTL-Shop. Zusätzlich finden Sie wichtige Informationen zu jedem Release im Releasebereich des JTL-Forums: Zum Releaseforum. Wir stellen zusätzlich Patch-Pakete für die Aktualisierung der Build-/Patch-Version bereit. Diese enthalten ausschließlich die veränderten Dateien, der Datei-Upload ist dadurch entsprechend schneller. Wenn Sie die Build-/Patch-Version via Patch-Paket updaten möchten, lesen Sie den folgenden Guide-Beitrag: JTL-Shop Build-Pakete.

Wenn Sie kein Upgrade durchführen, sondern nur die aktuellste Version einer bestimmten JTL-Shop Major-Version aufspielen wollen, lesen Sie bitte die folgenden Guide-Beiträge:

• JTL-Shop 5 auf eine neuere JTL-Shop 5 Minor-Version updaten (z.B. 5.0.x auf 5.1.x)
• JTL-Shop 5 auf einen neueren JTL-Shop 5 Patch/Build updaten (z.B. 5.0.0 auf 5.0.3)
• JTL-Shop 4 auf eine neuere JTL-Shop 4 Minor-Version updaten (z.B. 4.01.x auf 4.06.x)
• JTL-Shop 4 auf einen neueren JTL-Shop 4 Patch/Build updaten (z.B. 4.06.0 auf 4.06.17)

Upgrade durchführen

Voraussetzungen/Einschränkungen

• Sie haben eine Edition/Paketkonfiguration gebucht, in der JTL-Shop enthalten ist und haben ein gültiges Abonnement für JTL-Shop. Lesen Sie mehr zum Thema hier: Die JTL-Editionen im Überblick.
• Sie verfügen mindestens über JTL-Shop 4.02.
• Sie nutzen mindestens JTL-Wawi Version 1.0. Für die korrekte Verarbeitung von UTF-8 Zeichensätzen benötigen Sie mindestens JTL-Wawi 1.6.
• Sie verfügen über einen 64-bit-Apache-Webserver (PHP-Mode: FCGI oder Apache Module) 2.2 oder 2.4 mit mod_rewrite-Modul, .htaccess support. Der Webserver muss erlauben, dass Standardregeln überschrieben und ergänzt werden.
• Sie haben die offiziellen Standard-Systemvoraussetzungen konsultiert.

Schritt 1: Vorbereitungen

1. Melden Sie sich im Backend von JTL-Shop an und klicken Sie auf Darstellung > Einstellungen > Global. Wählen Sie im Dropdown-Menü Wartungsmodus die Option Ja. Der JTL-Shop befindet sich jetzt im Wartungsmodus.
2. Legen Sie eine Sicherungskopie aller Dateien von JTL-Shop an. Achten Sie dabei insbesondere darauf, die Template-Dateien (Ordner/templates/) sowie die Konfigurationsdatei des Shops (/includes/config.JTL-Shop.ini.php) zu sichern.
3. Führen Sie ab jetzt keinen Abgleich mehr mit JTL-Wawi durch! Falls Sie JTL-Worker nutzen, haben Sie die folgenden Möglichkeiten:

• Beenden Sie JTL-Worker und starten Sie diesen erst nach erfolgreichem Upgrade wieder.
• Beenden Sie JTL-Worker und stellen Sie in den Hintergrundeinstellungen ein, dass kein Onlineshop-Abgleich durchgeführt werden soll. Starten Sie den JTL-Worker wieder, um weiter mit anderen Plattformen abzugleichen.
• Sperren Sie in JTL-Wawi unter Plattformen > Verkaufskanäle den betroffenen JTL-Shop für den Abgleich.

4. Falls Sie Objekt-Cache nutzen, deaktivieren Sie diesen im Backend von JTL-Shop unter Administration > System > Cache über die Schaltfläche Gesamten Objekt-Cache leeren.
5. Prüfen Sie Ihre Plugins:

• Deinstallieren Sie alle Plugins (gleichgültig ob aktiv oder inaktiv), von denen Sie wissen, dass Sie nach dem Update nicht mehr nutzen werden. Für diese Plugins müssen Sie die Dateien vom Webspace aus dem Verzeichnis /includes/plugins und/oder /plugins entfernen, da in seltenen Fällen selbst deinstallierte Plugins nach Updates Probleme bereiten können.
• Deaktivieren Sie alle Plugins, die Sie nach dem Upgrade weiter benutzen möchten.

6. Legen Sie eine Sicherungskopie der JTL-Shop-Datenbank an oder lassen Sie diese durch Ihren Hoster anlegen. Lesen Sie mehr zum Thema hier: Datenbank-Backups von JTL-Shop erstellen.

Schritt 2: JTL-Shop-Dateien aktualisieren

1. Loggen Sie sich im JTL-Kundencenter ein. Klicken Sie auf Bestellungen & Lizenzen > Onlineshop > Shop Editionen. Sie gelangen zur Lizenzübersicht.
2. Klicken Sie im Bereich Lizenzen – ungruppiert auf die Schaltfläche Aktionen > Downloads und laden Sie das entsprechende JTL-Shop-Installationspaket herunter.
3. Entpacken Sie die heruntergeladene ZIP-Datei lokal auf Ihrem Rechner in ein Verzeichnis, bspw. c:jtl-shop.
4. Löschen Sie die folgenden Dateien im heruntergeladenen Paket, da die gleichnamigen Dateien Ihres bestehenden JTL-Shop individuelle Daten enthalten und nicht von den neuen Dateien überschrieben werden sollten:

• install (kompletter Ordner)
• admin/.htaccess (nur falls Sie diese angepasst haben)
• robots.txt (nur falls Sie diese angepasst haben)
• shopinfo.xml

5. Wenn Sie für Ihr angepasstes Template einen Standardordner von JTL nutzen, benennen Sie die neuen Standard-Templates im Verzeichnis /templates/ um, damit Ihre angepassten Templates im nächsten Schritt nicht überschrieben werden. Überschrieben wird der Ordner /templates/NOVA.
6. Laden Sie die in Schritt 2.3 entpackten Dateien und Ordner bis auf die in Schritt 2.4 entfernten Dateien per FTP über die bestehenden JTL-Shop-Dateien, die Sie in Schritt 1.2 gesichert haben (Ordner zusammenführen, nur vorhanden Dateien überschreiben).

Schritt 3: Datenbank updaten

1. Melden Sie sich im Backend von JTL-Shop an. Sie werden automatisch zum Update-Menü weitergeleitet. Wenn Sie nicht automatisch weitergeleitet werden, rufen Sie das Menü über Administration > System > Aktualisieren auf.

2. Klicken Sie auf Sicherungskopie, um an dieser Stelle erneut ein Backup der JTL-Shop-Datenbank zu erstellen. Das Backup wird im Verzeichnis /export/backup abgelegt.
3. Klicken Sie auf die Schaltfläche Datenbank-Update starten, um das Update auf die neuere Version von JTL-Shop zu beginnen.

Schritt 4: Migration auf InnoDB/UTF-8 vornehmen

Nachdem Sie das Datenbank-Update auf die neue JTL-Shop-Version abgeschlossen haben, müssen Sie beim Upgrade von JTL-Shop 4 noch die Datenbank-Tabellen auf InnoDB und UTF8 umstellen.

1. Klicken Sie unter Administration auf Fehlerbehebung > Diagnose > Datenbankstruktur > Details. Alternativ können Sie über die Mitteilungs-Glocke auf den Hinweis Datenbankstruktur: Es liegen Fehler in der Datenbankstruktur vor. klicken.
2. Lesen Sie die Informationen auf dieser Seite aufmerksam durch und klicken Sie auf die Schaltfläche Migration starten, um mit der Migration zu beginnen.

Wenn die Migration beendet ist, sollten Sie entsprechend Anzahl modifizierter Tabellen: 0 sehen.

Schritt 5: Verwaiste Dateien entfernen

Sie müssen die Dateien, die ggf. durch das Update Ihres JTL-Shops nicht mehr benötigt werden, löschen.

1. Klicken Sie auf Administration > Fehlerbehebung > Diagnose > Dateistruktur > Details. Alternativ können Sie über die Mitteilungs-Glocke auf den Hinweis Dateistruktur: Es liegen Fehler in der Dateistruktur vor. klicken.
2. Sie sehen hinter Anzahl verwaister Dateien, wie viele Dateien verwaist sind. Klappen Sie den entsprechenden Eintrag auf und scrollen Sie zum Ende der Seite.
3. Wenn Sie über die nötigen Schreibrechte verfügen, können Sie die Daten direkt löschen oder ein Skript generieren, welches Sie Ihrem Hosting-Provider oder JTL-Servicepartner übergeben können.

Schritt 6: Nacharbeiten durchführen

1. Prüfen Sie die ordnungsgemäße Funktion Ihres Onlineshops. Nutzen Sie hierfür die integrierten Prüfmethoden im Backend von JTL-Shop unter Administration > Fehlerbehebung > Diagnose. Prüfen Sie ebenfalls das Frontend des JTL-Shops. Sie können dies prüfen, auch wenn der Wartungsmodus weiterhin aktiviert ist, solange Sie in der selben Browser-Sitzung im Administrationsbereich angemeldet sind. Prüfen Sie mindestens, ob Registrierung und Kaufprozess erfolgreich durchlaufen werden können.
2. Prüfen Sie Ihr individuell angepasstes Template. Sollte Ihr Template nicht aktuell sein, lassen Sie es von Ihrem Template-Designer/JTL-Servicepartner auf die aktuellste Version bringen, da es sonst Fehler verursachen kann. Mit dem neu ausgelieferten Standard-Template können Sie gegentesten, ob ein Fehler durch Ihr angepasstes Template verursacht wird.
3. Prüfen Sie Ihre Plugins. Ob ein Update bereitsteht, sehen Sie im Backend von JTL-Shop unter Plugins > Meine Käufe, nachdem Sie JTL-Shop mit Ihrem JTL-Kundenkonto verbunden haben. Über die Schaltfläche Alle Extensions aktualisieren können Sie alle vorhandenen Plugins aktualisieren. Wechseln Sie anschließend über Plugins > Plugin-Manager in die Pluginverwaltung, prüfen Sie auf ausstehende Updates und führen Sie diese durch. Plugins, bei denen kein Warnhinweis angezeigt wird und deren Version korrekt ist, können Sie wieder aktivieren und nachkonfigurieren. Bei Fehlern deaktivieren Sie alle Plugins und prüfen dann, ob das Problem weiterhin auftritt. Reaktivieren Sie Ihre Plugins der Reihe nach, um das verantwortliche Plugin zu ermitteln.

4. Nach einem Update ist es möglich, dass die E-Mail-Vorlagen aktualisiert werden. Diese Aktualisierungen werden nicht automatisch eingespielt, da individuelle Anpassungen überschrieben werden würden. Individuelle Anpassungen, die Sie an den Vorlagen vorgenommen haben, müssen Sie anschließend erneut durchführen. Sichern Sie daher vorab alle E-Mail-Vorlagen, um diese nach dem Update wieder einrichten/nachbauen zu können. Wechseln Sie dazu im Backend von JTL-Shop in den Bereich Administration > E-Mail > Vorlagen. Klicken Sie bei den Vorlagen auf die Schaltfläche Zurücksetzen.

5. Klicken Sie im Backend von JTL-Shop unter Darstellung auf Eigene Inhalte > Seiten. Prüfen und pflegen Sie alle Übersetzungen.
6. Deaktivieren Sie den Wartungsmodus unter Darstellung > Einstellungen > Global, wenn keine Fehler aufgetreten sind. Ab jetzt können Sie wieder Abgleiche durchführen und den JTL-Worker aktivieren.
7. Aktivieren Sie unter Administration > System > Cache ggf. den ObjectCache.
8. Prüfen Sie erneut, ob keine Fehler auftreten und achten Sie auf Backend-Hinweise (Hinweis-Glocke) in den 3 Bereichen unter: Administration > Fehlerbehebung > Logbuch und Marketing > Bestellungen sowie Administration > E-Mail > Logbuch.

Weitere Fragestellungen und Antworten zum Upgrade von JTL-Shop 4 auf JTL-Shop 5 lesen Sie hier: FAQ zum Upgrade von JTL-Shop 4 auf JTL-Shop 5.