Table of Contents
This section describes how to upgrade your existing eZ Publish 5.1 2 installation to version 5.23. Make sure that you have a working backup of the site before you do the actual upgrade, and make sure that the installation you are performing the upgrade on is offline.
...
If you are using custom extensions, the sub-directories inside the "extension" directory will also have to be copied from the existing 5.1 installation 2 installation into "/<ezp5-root>/ezpublish_legacy/extension/". However, make sure that you do not overwrite any extensions that are included in eZ Publish distribution, which currently are (Note: As of eZ Publish 5.2, these extensions have the same version number as eZ Publish):
...
Step 3: upgrade the database
Info |
---|
This step assumes use of the built in database drivers, mysql (incl mariadb) and PostgreSQL, for other databases supported via extension please use scripts and documentation provided by extension. |
Import to your database the changes provided in
...
Define a Doctrine connection
Code Block language bash title MySQL settings : ezpublish.yml or config.yml doctrine: dbal: connections: my_connection: driver: pdo_mysql host: localhost port: 3306 dbname: my_database user: my_user password: my_password charset: UTF8
Code Block language bash title PostGreSQL : ezpublish.yml or config.yml collapse true doctrine: dbal: connections: my_connection: driver: pdo_pgsql host: localhost port: 5432 dbname: my_database user: my_user password: my_password charset: UTF8
Info title Pro Tip Set your base DB params in your parameters.yml
/parameters.yml.dist
and refer them here.Code Block title parameters.yml parameters: database_driver: pdo_mysql database_host: localhost database_port: 3306 database_name: ezdemo database_user: my_user database_password: my_password database_charset: UTF8
Code Block title ezpublish.yml / config.yml doctrine: dbal: connections: my_connection: driver: %database_driver% host: %database_host% port: %database_port% dbname: %database_name% user: %database_user% password: %database_password% charset: %database_charset%
Define one or several repositories
Code Block title ezpublish.yml ezpublish: repositories: main: { engine: legacy, connection: my_connection }
(Optional) Make your SiteAccess config point to the right repository
Code Block title ezpublish.yml collapse true ezpublish: system: my_siteaccess_group: repository: main
Info title Remove the old connection information Note : to benefit from the new configuration, don't forget to remove the old configuration
Code Block title Old database access to remove ezpublish: system: my_siteaccess_group: database: type: mysql user: my_user password: my_password server: localhost database_name: ezdemo
...
Next, depending on if you originally installed eZ Flow, eZ Webin or eZ Demo site, follow the steps mentioned in the eZ Webin, eZ Flow or eZ Demo upgrade documentation.
Minor Versions Update Warning
Please have in mind that, after the upgrade to a major version of eZ Publish, you will need to perform regular updates with composer.
Before any minor update with composer, please execute all require steps described in the 5.3.x Update Instructions.