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.
Stellen sie sicher, daß sie alle Schritte dieser Anleitung durchführen um Fehler zu vermeiden.
Prüfungen vor einer Aktualisierung
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
Note
Delete the following resources (if existing) in the client folder(s) of your installation:
- Directory includes
- 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.
Then upload all directories from your unpacked download archive in this directory.
Note
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.
Note
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.
Note
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.
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.
