JTL-Shop updaten

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. Laden Sie die aktuelle Version von JTL-Shop im JTL-Kundencenter herunter.
• Sie verfügen mindestens über JTL-Shop 5.0.0. Für ein Upgrade von vorherigen Versionen lesen Sie bitte den Abschnitt Allgemeine Informationen. Wenn Sie ein Update auf eine neuere JTL-Shop 4 Version durchführen möchten, lesen Sie die JTL-Shop4-Version dieser Seite.
• Sie haben vor jedem Update die offiziellen Standard-Systemvoraussetzungen konsultiert und alle Hinweise aus den Releaseposts zur jeweiligen Version im Releaseforum beachtet. Hierzu gehören auch Releaseposts von Versionen, die Sie ggf. überspringen.

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.

JTL-Shop updaten

Schritt 1: Vorbereitungen treffen

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. Sie werden bei einem Update nicht benötigt:

• install (kompletter Ordner)
• shopinfo.xml

5. Nehmen Sie an den folgenden Dateien im heruntergeladenen Paket die Änderungen vor, die Sie auch an den gleichnamigen Dateien Ihres bestehenden Shops vorgenommen haben:

• .htaccess
• admin/.htaccess
• robots.txt

Wenn Sie in Ihrem bestehenden JTL-Shop keine Anpassungen an diesen Dateien vorgenommen haben, können Sie die Dateien im heruntergeladenen Paket ohne Änderungen übernehmen.

6. 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 werden die Ordner /templates/Evo und /templates/NOVA.
7. 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: 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 Servicepartner übergeben können.

Schritt 5: 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. 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.
6. Aktivieren Sie unter Administration > System > Cache ggf. den ObjectCache.
7. 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.

Hilfe beim Shop-Update

Wenn Probleme mit bzw. nach dem Shop-Update auftreten sollten, prüfen Sie zunächst unter Administration > Fehlerbehebung > Diagnose, ob es Probleme mit Server, Dateien, Verzeichnisrechten oder Datenbank gibt. Sollte es bspw. modifizierte Dateien geben, achten Sie beim erneuten Übertragen darauf, dass Sie den binären Übertragungsmodus nutzen und es keine Übertragungsfehler gibt. Stellen Sie zudem sicher, dass Sie alle Punkte im Abschnitt Schritt 5: Nacharbeiten durchführen geprüft haben.

Wenn Sie das Problem nicht beheben können, erstellen Sie ein Ticket im Support-Bereich des JTL-Kundencenters mit der Produktauswahl JTL-Shop unter Angabe einer aussagekräftigen Fehlerbeschreibung und Titel. Alternativ können Sie sich an Ihren Servicepartner wenden. Beschreiben Sie dazu alle wichtigen Schritte, die zu dem Problem führten und hinterlegen Sie für eine schnellstmögliche Lösung alle JTL-Shop-Zugangsdaten im entsprechenden Feld (nicht im Beschreibungsfeld).

Bei Updateproblemen benötigen wir ggf. Zugang zum Administrationsbereich, Webspace (FTP) und zur Datenbank (PHPMyAdmin oder Hostingverwaltung). Ihr individueller Hostingprovider kann Ihnen erklären, wie Sie uns Zugriff zur Datenbank gewähren können. Sollten Sie weder Support bei JTL gebucht haben noch einen Servicepartner haben, können Sie einen Thread in unserem JTL-Shop-Forumsbereich eröffnen. Achten Sie darauf, einen aussagekräftigen Titel zu verwenden und keine Zugangsdaten zu veröffentlichen.