User Documentation Einführung
Hinweis: Vor einem Update immer eine Sicherung der Website vornehmen.
Die empfohlene Methode zum Aktualisieren von Joomla!-Installationen ist die Verwendung der Joomla-Update-Komponente.
Eine Standardinstallation von Joomla 4 und später enthält auf der Startseite nach der Anmeldung ein hilfreiches Benachrichtigungsfeld. Dort ist auf einen Blick erkennbar, ob ein Update verfügbar ist und welche Versionsnummer es hat.
Die im Benachrichtigungsfeld angezeigte Update-Meldung hängt vom Update-Kanal ab, der auf der Seite Joomla-Update: Optionen eingestellt ist, sowie von der aktuellen Minor-Version. Ist der Update-Kanal auf Standard eingestellt, werden Updates innerhalb der aktuellen Major-Version gemeldet. Ist der Parameter auf Joomla Next eingestellt, kann auf die aktuell neueste Version aktualisiert und anschließend über die Schaltfläche Auf Updates prüfen geprüft werden, ob die nächste Major-Version verfügbar ist.
Obwohl Joomla benachrichtigt, wenn ein Update verfügbar ist, muss das Update selbst durchgeführt werden. Es handelt sich um einen einfachen Vorgang, der bei nächster Gelegenheit durchgeführt werden sollte, damit die Website stets aktuell bleibt.
Aufrufen der Update-Komponente
Wird das Benachrichtigungsfeld auf der Startseite angezeigt, die Schaltfläche x.y.z verfügbar – Jetzt aktualisieren! wählen, um zur Update-Komponente zu gelangen.
Alternativ kann die Update-Komponente über das Administrator-Menü aufgerufen werden: System wählen, um über das System-Dashboard dorthin zu gelangen.
Das System-Dashboard verfügt über ein Update-Panel, das einen Joomla-Link enthält, der die verfügbare Update-Versionsnummer anzeigt. Den Link Joomla wählen, um zur Update-Komponente zu gelangen.
Durchführen des Updates
Joomla! 4 und 5 bieten eine Vorab-Prüfung (Pre-Update Check) für Updates auf Minor-Versionen. Diese Ansicht der Joomla-Update-Komponente zeigt technische Angaben zum Server, auf dem die Website läuft, sowie Core- und Drittanbieter-Erweiterungen, die den Update-Server nutzen, in Listenform.
Hinweis: Der Bildschirm Vorab-Prüfung wird nur bei Major- und Minor-Versionen angezeigt (z. B. 4 auf 5, oder 5.2 auf 5.3). Bei Patches (z. B. 5.3.1 auf 5.3.2) wird er nicht angezeigt.
Die Prüfergebnisse sorgfältig beachten und vor dem Update alle hervorgehobenen Probleme beheben. Möglicherweise müssen inkompatible Erweiterungen vor dem Joomla-Update aktualisiert, deaktiviert oder deinstalliert werden.
Es ist nicht ungewöhnlich, Warnungen zu Empfohlenen Einstellungen zu sehen, da diese oft serverspezifisch und hosting-bezogen sind. Vermutlich bestanden sie bereits bei der Installation von Joomla und werden den Abschluss des Updates höchstwahrscheinlich nicht verhindern.
Zur Erinnerung: Es wird dringend empfohlen, vorher eine Sicherung anzulegen, falls dies noch nicht geschehen ist!
Unterhalb der Update-Schaltfläche befindet sich ein Link. In den meisten Fällen kann dieser Link ignoriert werden. Er bietet die Möglichkeit, die Update-Dateien manuell hochzuladen, falls der Server sich hinter einer Firewall befindet oder aus anderen Gründen die Joomla-Update-Server nicht erreichen kann.
Nach Prüfung der Vorab-Prüfung und bei Zufriedenheit Update wählen.
Bestätigen des Updates
Das Kontrollkästchen anklicken, um zu bestätigen, dass eine Sicherung erstellt und die Kompatibilität der Erweiterungen geprüft wurde, dann auf Update starten klicken.
Update-Fortschritt
Sobald das Update beginnt, wird eine Fortschrittsanzeige angezeigt, während die Joomla-Dateien aktualisiert werden.
Abschluss
Wenn die Fortschrittsanzeige 100 % erreicht, bestätigt eine Systemmeldung, dass die Website aktualisiert wurde, zusammen mit der Versionsnummer. Die Versionsnummer wird auch in der oberen Symbolleiste neben dem Website-Namen aktualisiert.
Auf die Schaltfläche Zurück klicken, um zur Joomla-Update-Komponente zurückzukehren, wo erneut auf Updates geprüft werden kann.
Prüfungen nach dem Update
Sobald das Update abgeschlossen ist, sollten einige Prüfungen durchgeführt werden, um sicherzustellen, dass alles wie erwartet verlaufen ist, keine Fehler vorliegen und keine Änderungen weitere Maßnahmen erfordern.
Frontend-Prüfung
Zum Frontend der Website wechseln und prüfen, ob es wie vor dem Update funktioniert und angezeigt wird. Die Tastenkombination Umschalt + Neu laden verwenden, um den Browser zu zwingen, Änderungen an Stylesheets und Skripten neu zu laden.
Systemprüfungen
Im Seitenmenü System auswählen, um zum System-Dashboard zu gelangen. Dieses bietet einen Überblick über den aktuellen Status der Joomla-Website.
In diesem Beispiel ist zu sehen, dass seit dem Update zwei Einträge Aufmerksamkeit erfordern. Sie sind mit einer Kennzeichnung versehen, die eine Zahl enthält. Die Zahl gibt an, wie viele Einträge Aufmerksamkeit erfordern. Durch Anklicken jedes Eintrags können diese behoben werden.
Hinweis: Das System-Dashboard führt bei jedem Laden der Seite eine Prüfung durch. Zu beachten ist, dass Browser-Caching-Einstellungen dies beeinflussen können. Es empfiehlt sich, beim Prüfen den Browser-Cache mit Umschalt + Neu laden zu leeren.
Datenbankprüfung
Zu System → Wartung → Datenbank navigieren. Ist die Datenbank aktuell, sollte ein Bildschirm ähnlich dem folgenden angezeigt werden:
Ist die Datenbank nicht aktuell, wird ein Bildschirm mit den gefundenen Problemen angezeigt, ähnlich dem folgenden:
In diesem Fall die problematische Erweiterung unter Name auswählen und dann die Schaltfläche „Struktur aktualisieren“ in der Symbolleiste wählen. Joomla aktualisiert dann die Datenbank, um die aufgeführten Probleme zu beheben, und zeigt anschließend den Bildschirm erneut an. War die Behebung erfolgreich, zeigt die Anzeige, dass die Datenbank aktuell ist.
Hinweis: Falls weiterhin Fehler bestehen, sicherstellen, dass alle Datenbanktabellen freigegeben sind.
System-Erkennung
In manchen Fällen werden beim Update auf eine neue Joomla-Version neue Kernerweiterungen hinzugefügt. Gab es Probleme bei der Datenbankaktualisierung, wurden diese Erweiterungen möglicherweise nicht korrekt installiert. Um dies zu überprüfen, zu System → Erkennung navigieren. Anschließend das Symbol „Erkennung“ in der Symbolleiste auswählen. Der Bildschirm sollte wie folgt aussehen:
Ist dies der Fall, ist bekannt, dass alle während des Updates hinzugefügten neuen Erweiterungen korrekt in der Datenbank installiert wurden.
Gibt es nicht installierte Erweiterungen, werden diese ähnlich dem folgenden Bildschirm angezeigt:
Prüfen Sie in diesem Fall die Kontrollkästchen und klicken Sie auf das Installieren-Symbol in der Werkzeugleiste. Joomla installiert die Erweiterung(en) und zeigt anschließend den Bildschirm an, auf dem keine Erweiterungen gefunden wurden. Zu diesem Zeitpunkt wurden die neuen Erweiterungen in der Datenbank installiert.
Fehlerbehebung
Falls Fragen, Probleme oder Fehler vor, während oder nach dem Update auftreten, stellen Sie diese bitte im Forum Migrating and Upgrading to Joomla! 5.x.
Falls während des Updatevorgangs Probleme oder Fehler auftreten, finden Sie hier einige Tipps.
- Leeren Sie den Zwischenspeicher Ihres Browsers. Es könnten Änderungen an CSS oder Javascript vorgenommen worden sein, die nach einem Update von Ihrem Webbrowser neu geladen werden müssen.
- Falls nach dem Update Datenbankfehlermeldungen angezeigt werden, prüfen Sie unbedingt den Link System → Wartung → Datenbank. In manchen Fällen kann ein Datenbankfehler verhindern, dass alle Datenbankaktualisierungen ausgeführt werden. In diesem Fall können Sie diese über den Datenbank-Link ausführen und anschließend die Methode System → Installieren → Erkennung verwenden, um neue Erweiterungen zu prüfen und zu installieren.
- Der Updatevorgang erstellt oder ergänzt eine Protokolldatei mit dem Namen administrator/logs/joomla_update.php, die Sie mit einem Texteditor öffnen können, um die aufgezeichneten Schritte im Protokoll einzusehen. Es werden die wichtigsten Schritte angezeigt (Zip-Datei herunterladen, installieren, SQL-Anweisungen ausführen, Aufräumen), etwa so:
2024-04-17T09:13:16+00:00 INFO 127.0.0.1 update Update started by user Jimmy (139). Old version is 5.0.3.
2024-04-17T09:13:18+00:00 INFO 127.0.0.1 update Downloading update file from ...
2024-04-17T09:13:28+00:00 INFO 127.0.0.1 update File Joomla_5.1.0-Stable-Update_Package.zip downloaded.
2024-04-17T09:13:28+00:00 INFO 127.0.0.1 update Starting installation of new version.
2024-04-17T09:13:40+00:00 INFO 127.0.0.1 update Finalising installation.
2024-04-17T09:13:40+00:00 INFO 127.0.0.1 update Start of SQL updates.
2024-04-17T09:13:40+00:00 INFO 127.0.0.1 update The current database version (schema) is 5.0.0-2023-09-11.
... Lots of individual SQL queries
2024-04-17T09:13:41+00:00 INFO 127.0.0.1 update End of SQL updates.
2024-04-17T09:13:41+00:00 INFO 127.0.0.1 update Uninstalling extensions
2024-04-17T09:13:41+00:00 INFO 127.0.0.1 update Deleting removed files and folders.
2024-04-17T09:13:44+00:00 INFO 127.0.0.1 update Cleaning up after installation.
2024-04-17T09:13:44+00:00 INFO 127.0.0.1 update Update to version 5.1.0 is complete.