Status colour Yellow title Work in progress, for testers Table of Contents
This section describes how to upgrade your existing eZ Publish 5.2 installation to version 5.4. 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.
...
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
...
Code Block |
---|
_ezpublishRestOptionsRoutes:
resource: "@EzPublishRestBundle/Resources/config/routing.yml"
prefix: %ezpublish_rest.path_prefix%
type: rest_options
_liip_imagine:
resource: "@LiipImagineBundle/Resources/config/routing.xml"
login:
path: /login
defaults: { _controller: ezpublish.security.controller:loginAction }
login_check:
path: /login_check
logout:
path: /logout |
...
If you had modified composer.json
to add your own requirements, you must re-apply those changes to the new version, and run composer update
.
Varnish (if applicable)
The recommended varnish (3 and 4) VCL configuration can now be found in the doc/varnish
folder. See also the Using Varnish page.
...
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.4.x Update Instructions.