Dieser Artikel beschreibt die Aktualisierung (Upgrade) einer bestehenden CONTENIDO-Installation. Um CONTENIDO neu zu installieren werfen sie bitte einen Blick in die Installationsanleitung.
Wichtig
Eine Aktualisierung auf die Version 4.9 wird ausschließlich für die aktuellste Version der Reihe CONTENIDO 4.8 unterstützt. Eine direkte Aktualisierung früherer Versionen (wie der 4.6) wird nicht unterstützt und nicht empfohlen. Bitte aktualisieren sie in diesem Fall ihre Installation zuvor auf die aktuellste Version der Reihe CONTENIDO 4.8 bevor sie eine Aktualisierung auf die Version 4.9 vornehmen.
Wichtige Information für eine Aktualisierung von der Version 4.8
Wenn sie eine Aktualisierung von einer Installation der Reihe CONTENIDO 4.8 durchführen, stellen sie bitte sicher, daß es sich dabei um die aktuellste Version dieser Reihe handelt.
Eine Aktualisierung von der Version CONTENIDO 4.8 ist nicht innerhalb weniger Minuten durchgeführt!
In der Version 4.9 stehen viele alte Klassen nicht mehr zur Verfügung und somit kann die Funktionalität ihrer Webseite beeinträchtigt werden. Eine Übersicht der technischen Änderungen finden sie in der Änderungsübersicht.
Sie sollten eine lokale Kopie ihrer Webseite installieren und dann ihre Module und Plugins anpassen.
Ärger während der Aktualisierung?
Sollten sie Probleme mit der Aktualisierung haben kann ihnen die Community im Support-Forum unter forum.contenido.org bei der Beantwortung ihrer Fragen helfen.
Empfehlungen für eine Aktualisierung
Es wird dringend empfohlen Aktualisierungen von früheren Versionen (besonders der Version 4.8) zunächst lokal oder auf einem Testsystem und nicht auf dem Produktivserver durchzuführen, da, abhängig von der Menge der verwendeten Module und Plugins, viele Korrekturen und Änderungen mit der Aktualisierung einhergehen.
Wenn sie die Aktualisierung auf ihrem lokalen System erfolgreich durchgeführt haben, könnne sie die Installation auf ihrem Produktivserver mit der akzualisierten Version von ihrem lokalen Sytsem ersetzen.
Hinweis
Das Aktualisieren auf einem lokalen oder Testsystem hat den riesigen Vorteil, daß ihr Produktivsystem nur für kurze Zeit nicht erreichbar sein wird und sie beleibig viel Zeit für die Aktualisierung haben. Besonders bei der Aktualisierung einer Version 4.8 ist dies empfehlenswert, da die händischen Anpassungen einige Zeit in Anspruch nehmen können.
Allerdings muß in diesem Fall sichergestellt werden, daß in der Zwischenzeit kein weiterer Content zu der Seite hinzugefügt wird, sobald sie eine Kopie des Systems angefertigt haben. Andernfalls wird dieser beim Zurückspielen der aktualisierten Version überschrieben.
Um die Wartungszeit der Webseite zu minimieren können sie ein weiteres Backup der Datenbank und der Dateien an dem Tag, an dem sie die Aktualisierung auf dem Produktivsystem durchführen, anfertigen. Stellen sie sicher, daß sie alle Schritte dieser Anleitung durchführen um Fehler zu vermeiden.
Prüfungen vor einer Aktualisierung
Eine Aktualisierung auf eine andere Version von CONTENIDO kann das Verhalten des Systems beeinflussen. Deshalb müssen Module und Plugins überprüft werden. Prüfen sie zuvor die von den Plugins unterstützten Versionen von CONTENIDO. Besonders bei der Aktualisierung von der Version 4.8 ist es notwendig, daß der Autor des fraglichen Plugins eine Version anbietet die mit der Version 4.9 kompatibel ist. Plugins für die Version 4.8 sind i.d.R. nicht kompatibel zu CONTENIDO 4.9, da sich das Plugin-System geändert hat. Chains sollten allerdings nachwievor funktionieren.
Prüfen sie bei der Aktualisierung alle Sprachen aller Mandanten, ob für diese ein Sprach- bzw. Ländercode konfigurert wurde. Die Aktualisierung kann nicht durchgeführt werden wenn diese fehlen. Konfigurieren sie diese Codes in der Sprachverwaltung von CONTENIDO indem sie einen Wert für Land und Sprache angeben.
Erstellen von Sicherungskopien des Dateisystems und der Datenbank
Zuallererst sollte eine Sicherungskopie aller Dateien ihrer Website (inklusive der Mandantenordner und deren Upload-Verzeichnisse) erstellt werden. Dasselbe gilt für die ganze Datenbank.
Warnung
Es wird dringend empfohlen diese Sicherungskopien anzufertigen um im Falle eines Fehlers bei der Aktualisierung, diese wieder einspielen zu können, so daß ihr System nachwievor funktionstüchtig ist. Ansonsten können ihre Inhalte unwiederbringlich verloren gehen.
Herunterladen und Entpacken der aktuellsten Version von CONTENIDO
Laden sie von contenido.org die aktuellste Version von CONTENIDO herunter. Verwenden sie hierbei am Besten keine anderen Quellen! Entpacken die das Archiv an einer beliebigen Stelle auf ihrem Computer.
Vorbereiten der Mandantenordner für die Aktualisierung
Hinweis
Wenn sie die Aktualisierung auf einem Produktivsystem durchführen sollten sie sicherstellen, daß alle Anfragen an eine Wartungsseite weitergeleitet werden, da während der Aktualisierung das Frontend beeinträchtigt ist und Fehler dargestellt würden.
Löschen sie (sofern vorhanden) in ihren Mandantenordnern folgende Verzeichnisse und Dateien:
- includes/
- dbfs.php
- error.php
- front_content.php
- front_crcloginform.inc.php
- index.php
Ersetzen früherer Systemdateien
Benennensie alle Verzeichnisse um indem sie ihnen den Suffix "_old" anhängen, mit Ausnahme von "data" bei Installationen die diesen Ordner besitzen.
Laden sie dann alle Verzeichnisse ihrer entpackten Verision von CONTENIDO 4.9 in dieses Verzeichnis hoch
Hinweis
Wenn sie mehrere Mandanten haben oder ihr Mandantenverzeichnis nicht "cms" lautet, müssen sie die Dateien in all diesen Mandantenverzeichnissen ersetzten.
Ausführen der Aktualisierung
Öffnen sie die Aktualisierungs-Oberfläche indem sie die URL http://<ihre_domain>/setup/ in ihrem Browser aufrufen.
Open the upgrade web interface by visitting "setup/" of your installation.
Note
Nochmal: stellen sie sicher, daß sie eine Sicherungskopie ihrer Datenbank angefertigt haben, da ab nun die Datenbankinhalte verändert werden"
Wählen sie den Setup-Typ "upgrade" und fahren sie fort.
Hinweis
Wenn sie gebeten werden die Zugangsdaten für ihre Datenbank anzugeben, sind dieselben Daten wie bei der Erstinstallation anzugeben. Andernfalls wird die Aktualisierung scheitern.
Test des Logins im Backend nach der Aktualisierung
Wenn der Aktualisierungs-Prozess erfolgreich abgeschlossen wurde, versuchen sie bitte sich im Backend mit dem von ihnen gewählten Paßwort anzumelden. Bitte löschen sie zuvor die Inhalte ihres Browser-Caches um Probleme bei der Darstellung zu vermeiden.
If you have installed custom plugins in the system, it may occur, that the backend header displays an error message. As long the plugins must be ported to the new plugin syntax (see below) these errors should be fixed then.
Sollten sie während der Aktualisierung irgendwelche Probleme haben werfen sie bitte einen Blick in das Support-Forum unter forum.contenido.org. Vielleicht hatte ein anderer Benutzer bereits dasselbe Problem, so daß sie dort eine Lösung finden können.
Moving configuration files
When you upgrade from version 4.8 you must move the configuration files stored in the root directory of your client to the folder data/config. Do not miss other local configuration files such as config.local.php and config.after.php!
If you had changed configurations for the backend, you must apply them to the new configuration files in data/config/ENVIRONMENT. We recommend you to use the config.local.php, so you must not modify any core files.
Fixing usage of removed functionality
Every time an update removes deprecated functionality (such as an upgrade from version 4.8) you must check your modules and plugins for outdated functionality. If you do not, backend and frontend will behave uncorrectly.
If the version you are upgrading to has any removed outdated functionality you can check in the Changelog area. For upgrade from version 4.8 please have a look at this page.
Please keep in mind, that plugins have other structure in version 4.9 and may not work immediately after update. It belongs to the plugin author to advise you what to do on upgrading the system.
Cleaning up and finish upgrade
Once you have downloaded a local copy of the filesystem backup you can delete any folder which is suffixed with "_old". These folders are not needed any longer.
Deactivate maintenance mode if activated, your website now should be running with the new version.
Replace productive installation with upgraded system
On top of this guide we recommended you to do the upgrade local. The changes made to your system now must be transferred to the production system. You must replace all files in the filesystem and import the whole database.
Note
Do not forget to set the write permissions for folders and files. You can check correct permissions in the system integrity check in the backend.
Restore an old installation on upgrade failure
To restore the old installation when upgrade failed you have to delete all directories, which are NOT suffixed with "_old" and remove that suffix from all directories. Additionally, you must overwrite the database with your backup.
Maybe it is necessary to delete your browser cache.
