Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page guides you through an upgrade of CONTENIDO . For an installation, please have a look at this guide.

Note
titleImportant

Upgrade to version 4.9 are only supported from the latest version of CONTENIDO 4.8. Direct upgrades from earlier versions (such as 4.6) are not supported and not recommended! Please upgrade your installation to the latest release of version 4.8 before doing the upgrade to version 4.9.

Info
titleImportant information for upgrade from version 4.8

If you are upgrading from version 4.8 make sure, you have the latest version installed.

An upgrade from version 4.8 is not done within a few minutes!

In version 4.9 many of the old classes are not available and therefore interrupt your web page (for an overview of technical changes please have a look here).

You should install a local copy of your web page and then fix your modules and plugins.

4.9. If you want to update an old version (e. g. CONTENIDO 4.8) to 4.9, pleade read the guide "Upgrade from CONTENIDO 4.8 to 4.9". For an installation, please have a look at this guide.

Note
titleTrouble during upgrade?

If you have any trouble during the upgrade, the community in the support forum at forum.contenido.org may can answer your questions.

...

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.

...

Info
titleNote

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.

...

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

...

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.

...

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/ENVIRONMENT. 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 If you have some problems with plugins, please contact the plugin authors to advise you what to do on upgrading the system.

Cleaning up and finish upgrade

...