Dieser Artikel beschriebt beschreibt die Aktualisierung (Upgrade) einer bestehenden CONTENIDO-Installation . Um CONTENIDO neu zu installieren werfen sie bitte einen Blick in die Installationsanleitung.
...
| title | Wichtig |
|---|
...
4.9
...
. Wenn Sie eine ältere Version (z. B. CONTENIDO 4.8
...
| title | 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 einiger 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.
...
) auf 4.9 aktualisieren möchten, lesen Sie bitte die Anleitung "Aktualisierung von CONTENIDO 4.8 auf 4.9 oder 4.10". Um CONTENIDO neu zu installieren, werfen Sie bitte einen Blick in die Installationsanleitung.
| Note | ||
|---|---|---|
| ||
Sollten sie Sie Probleme mit der Aktualisierung haben, kann ihnen Ihnen die Community im Support-Forum unter forum.contenido.org ihre Fragen beantworten bei der Beantwortung Ihrer Fragen helfen. |
Empfehlungen für eine Aktualisierung
It is highly recommended that upgrades from an earlier version (especially from version 4.8!) are done local (or one a second installation) and not on the production system, as many fixes and changes might came along with the upgrade depending on the amount of modules and plugins used in the system.
When you are done with the upgrade on your local system, you can replace your productive installation with the local installation.
| Info | ||
|---|---|---|
| ||
Doing an update on a local or second system has the major advantage that your productive page is only a few minutes not reachable and you can take as long as you want doing the upgrade. Especially on upgrade from version 4.8 this is very useful, as fixing all old functionality may take some time. However, as an update can take a long time, you must ensure, that no new content is being added to the page once you have taken a backup of all files and the database. Otherwise, the replace of your local installation also would replace any content entered in the meantime. To shorten the maintenance time of the page you could take another backup of database and files on the day, you are performing the upgrade of productive system. Take care, that you are doing all steps according to the guide, to prevent any mistakes. |
Checks before upgrade
Upgrading to another version of CONTENIDO can change the systems behaviour. Thus, modules and plugins must be checked. Please have a look for compatibility of all plugins you are using. Especially on upgrades from version 4.8 the author of the plugin must offer a version that works with version 4.9. Plugins of version 4.8 definitely do NOT work with version 4.9 because the plugin system was changed. Chains should work as before.
On upgrade from version 4.8 to 4.9 check all languages of all clients if they have a configured language and country code. The upgrade process will not proceed if it detects any language without a country and/or language code. Set these codes in the language administration of CONTENIDO by selecting a value for "Country" and "Language".
Create a backup of filesystem and database
The very first step of a upgrade is the backup of ALL existing files of your web page (including all clients with their uploads and so on) in the filesystem and of course the whole database.
| Warning | ||
|---|---|---|
| ||
It is highly recommended doing a backup of all stuff to restore your page if upgrade process fails. If you are not performing a backup of your installation you might can not restore your old installation if anything went wrong. This can cause irreparable content loss! |
Download and unzip latest version of CONTENIDO
Get a copy of the latest download release archive from the website contenido.org. Do not use other sources for downloads! Unzip the archive to a destination of your choice on your computer.
Prepare client folder(s) for upgrade
| Info | ||
|---|---|---|
| ||
| If you are performing the upgrade on your productive system you should ensure that from now on all requests are redirected to a maintenance page or so, because the frontend now gets affected and would display errors. |
Delete the following resources (if existing) in the client folder(s) of your installation:
...
Es wird dringend empfohlen, Aktualisierungen von früheren Versionen 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 aktualisierten Version von Ihrem lokalen Sytsem ersetzen.
| Info | ||
|---|---|---|
| ||
Das Aktualisieren auf einem lokalen oder Testsystem hat den riesigen Vorteil, dass Ihr Produktivsystem nur für kurze Zeit nicht erreichbar sein wird und Sie beliebig viel Zeit für die Aktualisierung haben. Allerdings muss in diesem Fall sichergestellt werden, dass 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 Website 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, dass Sie alle Schritte dieser Anleitung durchführen um Fehler zu vermeiden. |
| Info | ||
|---|---|---|
| ||
Ab Version 4.10.0 setzt CONTENIDO nicht mehr Verzeichnis-Rechte 777, sondern nur noch 755 voraus. Ihre Verzeichnisse sollten deshalb die CHMOD-Rechte 755 besitzen. Allerdings funktioniert CONTENIDO weiterhin auch mit CHMOD-Rechten 777, da diese weitergehend sind. Beachten Sie bitte unbedingt, dass Sie nicht nur die Verzeichnis-Rechte korrekt setzen (755), sondern auch die Eigentümer-Rechte (chown) auf Ihrem Webserver berücksichtigen. Diese müssen so gesetzt sein, dass von CONTENIDO angelegte und ggf. über das Backend bearbeitbare Dateien und Ordner ausführbar sind. |
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.
Bewährt hat sich auch ein Vergleich der eingesetzten Dateien des Grundsystems mit der originalen Version von der CONTENIDO-Homepage, damit etwaige Anpassungen am Core-System, die mit dem Update überschrieben würden, zu identifizieren, sichern und nach dem Update wieder zu integrieren. Hierzu ist es ratsam, den Vergleich mittels eines geeigneten Programms, z.B. WinMerge, durchzuführen. Core-Anpassungen sollten nach Möglichkeit vermieden werden und durch Plugins und Chains realisiert werden.
Erstellen von Sicherungskopien des Dateisystems und der Datenbank
Zu aller erst sollte eine Sicherungskopie aller Dateien Ihrer Website (inklusive der Mandantenordner und deren Upload-Verzeichnisse) erstellt werden. Dasselbe gilt für die ganze Datenbank.
| Warning | ||
|---|---|---|
| ||
Es wird dringend empfohlen, diese Sicherungskopien anzufertigen, um im Falle eines Fehlers bei der Aktualisierung, diese wieder einspielen zu können, sodass Ihr System nach wie vor funktionstüchtig ist. Ansonsten können Ihre Inhalte unwiderruflich 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 Sie das Archiv an einer beliebigen Stelle auf Ihrem Computer.
Vorbereiten der Mandantenordner für die Aktualisierung
| Info | ||
|---|---|---|
| ||
Wenn Sie die Aktualisierung auf einem Produktivsystem durchführen, sollten Sie sicherstellen, dass alle Anfragen an eine Wartungsseite weitergeleitet werden, da ab jetzt 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:
- dbfs.php
- error.php
- front_content.php
- front_crcloginform.inc.php
- index.php
Replace previous system files
Rename all directories by appending the suffix "_old" to the directory name, excepting "data" on installations where this folder already exists.
...
Ersetzen früherer Systemdateien
Benennen Sie alle Verzeichnisse um, indem Sie ihnen das Suffix "_old" anhängen. Im Ursprung belassen sollten Sie dabei jedoch die Ordner Ihrer Mandanten (im Beispielmandanten "cms" genannt) sowie zunächst den Ordner "data", der sich im Hauptverzeichnis Ihrer CONTENIDO-Installation befindet.
Laden Sie dann alle Verzeichnisse Ihrer entpackten Version von CONTENIDO 4.9 in dieses Verzeichnis hoch.
| Info | ||
|---|---|---|
| ||
If you have multiple clients or your clients directory name is not "cms" you have to replace the files in all other client directories, too. |
Executing upgrade interface
Open the upgrade web interface by visitting "setup/" of your installation.
| Info | ||
|---|---|---|
| ||
Once again make sure you have a copy of your database backupped because the database now gets affected. |
Choose setup type "upgrade" and proceed with the upgrade.
| Info | ||
|---|---|---|
| ||
When you are asked for entering the database credentials you must use the same as the old installation. Otherwise the upgrade fails. |
Test backend login after upgrade
If the upgrade process was successful, try to login into the backend with your previous password. Please delete any content of your browser cache before to avoid display problems.
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.
When you encountered any problems during update, please have a look into our support forum on forum.contenido.org. Maybe other persons did have the same problem and you can find a solution for this problem there.
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.
| Info | ||
|---|---|---|
| ||
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.
...
| |
Wenn Sie mehrere Mandanten haben oder Ihr Mandantenverzeichnis nicht "cms" lautet, müssen Sie in jeden Mandantenordner die Dateien aus dem Ordner "cms" des Downloads kopieren. Achten Sie darauf, keine individuellen Änderungen zu überschreiben. |
"data"-Ordner aktualisieren
Der Data-Ordner ("data") beinhaltet unter anderem diverse Konfigurationsdateien (in der Regel: "data/config/production") und die Übersetzungen ("data/locale"). Bei der Aktualisierung von CONTENIDO müssen Sie auch den "data"-Ordner aus dem Download-Archiv auf Ihren Server kopieren. Bitte achten Sie darauf, keine individuellen Änderungen in Ihren Konfigurationsdateien zu überschreiben. Tipp: Sofern Sie individuelle Anpassungen vorgenommen haben, notieren Sie sich diese vorher und tragen sie bei Ihrer Aktualisierung von CONTENIDO in den neuen Dateien wieder ein.
| Info |
|---|
Wenn Sie mehrere Umgebungen haben oder Ihre Umgebung nicht "production" lautet, müssen Sie in jedem Umgebungsordner unter "data/config" die Dateien aus dem Ordner "production" des Downloads kopieren. Ansonsten kann es zu einer Fehlfunktion von CONTENIDO kommen. |
Wiederherstellen dritter Plugins
Die im alten CONTENIDO-Ordner befindlichen Plugins von Dritten müssen wieder in den Plugin-Ordner der neuen CONTENIDO-Installation verschoben werden, da ansonsten unerwartete Fehler bei der Ausführung des Upgrade-Prozesses auftreten können.
Ausführen der Aktualisierung
Öffnen Sie die Aktualisierungs-Oberfläche, indem Sie die URL http://<ihre_domain>/setup/ in Ihrem Browser aufrufen.
| Info | ||
|---|---|---|
| ||
Stellen Sie nochmals sicher, dass 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.
| Info | ||
|---|---|---|
| ||
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 sich bitte im Backend mit dem von Ihnen gewählten Kennwort anzumelden. Bitte löschen Sie zuvor die Inhalte Ihres Browser-Caches, um Probleme bei der Darstellung zu vermeiden.
Wenn Sie eigene Plugins installiert haben, kann es vorkommen, dass im oberen Frame des Backends eine Fehlermeldung ausgegeben wird. Die Fehlermeldung wird nicht mehr angezeigt, sobald Sie das Plugin deaktiviert/deinstalliert bzw. auf eine aktuelle, zur neuesten CONTENIDO-Installation kompatible Version aktualisiert haben.
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, sodass Sie dort eine Lösung finden können.
Anpassung von veralteter Funktionalität
Jedesmal, wenn eine Aktualisierung veraltete Funktionen entfernt, sind die verwendeten Module und Plugins daraufhin zu überprüfen. Wenn Sie dies nicht tun, kann sich das Backend und Frontend unerwartet verhalten.
Ob in der Version, zu der Sie aktualisieren, veraltete Funktionen entfernt wurden, können Sie in der Änderungshistorie nachlesen. Bitte kontaktieren Sie bei Problemen mit installierten Plugins deren Autoren, um zu erfahren, wie Sie mit diesem bei einer Aktualisierung vorgehen sollen.
Aufräumen und Beenden der Aktualisierung
Sobald Sie eine lokale Kopie der Sicherungskopie des Dateisystems heruntergeladen haben, können Sie die Verzeichnisse, denen Sie den Suffix "_old" gegeben haben, löschen. Diese Verzeichnisse werden nicht mehr benötigt.
Deaktivieren Sie nun den Wartungsmodus (sofern Sie diesen aktiviert hatten), Ihre Website sollte nun mit der neuen CONTENIDO-Version laufen.
Ersetzen des Produktivsystems mit dem aktualisierten System
Zu Beginn dieser Anleitung wurde empfohlen, die Aktualisierung zunächst lokal durchzuführen. Die dort durchgeführten Änderungen müssen nun auf das Produktivsystem übertragen werden. Dazu sind alle Dateien der CONTENIDO-Installation zu kopieren und die Datenbank zu ersetzen.
| Info | ||
|---|---|---|
| ||
Vergessen Sie nicht, die Schreibrechte für Dateien und Verzeichnisse zu setzen. Sie können diese im Backend im Bereich Systemintegrität überprüfen. |
Wiederherstellen einer alten Installation bei einem Fehler während der Aktualisierung
Um Ihre alte Installation wiederherzustellen - sollte die Aktualisierung fehlschlagen -, sind alle Verzeichnisse zu löschen, die nicht den Suffix "_old" haben. Anschließend ist dieser Suffix von diesen Verzeichnissen zu entfernen. Schließlich ist die Datenbank mit Ihrer Sicherungskopie wiederherzustellen.
Womöglich ist es notwendig, Ihren Browser-Cache zu löschen.
Module des Beispielmandanten: Verhalten bei einer CONTENIDO-Aktualisierung
Wurden in einer neuen CONTENIDO-Version Fehler in den Modulen des Beispielmandanten behoben, so werden diese Fehlerbehebungen, aber auch Verbesserungen oder neue Funktionen, bei einer Aktualisierung von CONTENIDO nicht berücksichtigt. Ihr Modul-Ordner im Beispielmandanten verbleibt in seinem bisherigen Stand. Dies hat den Hintergrund, dass ansonsten mögliche individuelle Anpassungen von Ihnen an den Modulen des Beispielmandanten überschrieben werden würden. Wenn Sie auf aktualisierte Module angewiesen sind, so müssten Sie die Module manuell aktualisieren. Sie finden die aktuellsten Modul-Dateien stets im Ordner setup/data/examples/data/modules innerhalb der CONTENIDO-Verzeichnisstruktur. Zur Aktualisierung eines Modules können Sie den gesamten Ordner auf Ihrem Server mit dem äquivalenten Ordner aus dem Setup-Verzeichnis überschreiben - insoweit Ihnen klar ist, dass Sie damit ggf. individuelle Anpassungen überschreiben.
Mail-Server
| Info | ||
|---|---|---|
| ||
Dies gilt ab CONTENIDO-Version 4.10.0 |
CONTENIDO stellt automatisch den Mail-Transport-Typ "SMTP" ein. Damit E-Mails über CONTENIDO versendet werden können, beispielsweise für "Passwort vergessen" oder für das Kontaktformular, müssen Sie im Backend die Zugangsdaten zu einem Mail-Server hinterlegen. Hierzu klicken Sie im Backend bitte auf den Hauptmenüpunkt "System" und dort auf "Konfiguration". Sollten Sie kein SMTP nutzen wollen oder können, gibt es auch die Möglichkeit, den Transport-Typ auf "PHP mail" zu ändern. Damit wird auf die Standard-E-Mail-Funktion von PHP zurückgegriffen. Dies funktioniert allerdings lediglich dann, wenn auf Ihrem Webserver die Mail-Komponente von PHP eingerichtet ist.