Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
     Glossary
   eZ Publish 4.x / legacy

 
eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Versions Compared

Key

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

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
    languagebash
    titleMySQL 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
    languagebash
    titlePostGreSQL : ezpublish.yml or config.yml
    collapsetrue
    doctrine:
        dbal:
            connections:
                my_connection:
                    driver:   pdo_pgsql
                    host:     localhost
                    port:     5432
                    dbname:   my_database
                    user:     my_user
                    password: my_password
                    charset:  UTF8
    Info
    titlePro Tip
    Set your base DB params in your parameters.yml/parameters.yml.dist and refer them here.
    Code Block
    titleparameters.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
    titleezpublish.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
    titleezpublish.yml
    ezpublish:
      repositories:
          main: { engine: legacy, connection: my_connection }
  • (Optional) Make your SiteAccess config point to the right repository

    Code Block
    titleezpublish.yml
    collapsetrue
    ezpublish:
      system:
          my_siteaccess_group:
              repository: main

     

     

    Info
    titleRemove the old connection information

    Note : to benefit from the new configuration, don't forget to remove the old configuration

    Code Block
    titleOld 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 WebineZ 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.