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.

...

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.

For upgrading the database, you have to jump from 5.1 to 5.2 and then from 5.2 to 5.3.

...

  • 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
    

Step 4: Apply 5.2 & 5.3 configuration changes

YAML files

Since default configuration files have been overwritten during step one, the few additions to those files that were made in 5.3 need to be applied manually to the configuration files. All of those changes are additions, none of them replaces what you already have. For most of them, at least one, if not all hierarchy elements (monolog, handler, framework, router...) will already be there. All you have to do is add the missing bits in the existing configuration blocks.

...

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.