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.
Note
The requirements for doing a normal installation must be met, read the "Requirements for doing a normal installation" section first!
Info
titleInstalling eZ Platform?

This page covers install of eZ Publish 5.x (including community versions like v2014.11), for eZ Platform see own installation documentation.

 

This section will guide you through the following steps:

...

  • Using ACL on a system that supports chmod +a
    These shell commands will give proper permission to the web server and command line users.

    5.3 / 2014.05 and higher:

    Status
    colourRed
    title>= 5.3 / 2014.05

    No Format
        $ cd /<ezp5-root>/
        $ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" \
          ezpublish/{cache,logs,config,sessions} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" \
          ezpublish/{cache,logs,config,sessions} ezpublish_legacy/{design,extension,settings,var} web

    5.0, 5.1 and 5.2:

    Status
    colourGrey
    title5.0
    Status
    colourGrey
    title5.1
    Status
    colourGreen
    title5.2

    No Format
        $ cd /<ezp5-root>/
        $ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" \
          ezpublish/{cache,logs,config} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" \
          ezpublish/{cache,logs,config} ezpublish_legacy/{design,extension,settings,var} web


  • Using ACL on a system that does not support chmod +a
    Some systems don't support chmod +a, but do support another utility called setfacl. You may need to enable ACL support on your partition and install setfacl before using it (as is the case with Ubuntu).
    5.3 / 2014.05 and higher:

    Status
    colourRed
    title>= 5.3 / 2014.05

    No Format
        $ cd /<ezp5-root>/
        $ sudo setfacl -R -m u:www-data:rwx -m u:www-data:rwx \
          ezpublish/{cache,logs,config,sessions} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx \
          ezpublish/{cache,logs,config,sessions} ezpublish_legacy/{design,extension,settings,var} web

    5.0, 5.1 and 5.2:

    Status
    colourGrey
    title5.0
    Status
    colourGrey
    title5.1
    Status
    colourGreen
    title5.2

    No Format
        $ cd /<ezp5-root>/
        $ sudo setfacl -R -m u:www-data:rwx -m u:www-data:rwx \
          ezpublish/{cache,logs,config} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx \
          ezpublish/{cache,logs,config} ezpublish_legacy/{design,extension,settings,var} web
  • Using chown on systems that don't support ACL
    Some systems don't support ACL at all. You will either need to set your web server's user as the owner of the required directories.
    5.3 / 2014.05 and higher:

    Status
    colourRed
    title>= 5.3 / 2014.05

    No Format
        $ cd /<ezp5-root>/
        $ sudo chown -R www-data:www-data ezpublish/{cache,logs,config,sessions} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type d | xargs sudo chmod -R 775
        $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo chmod -R 664

    5.0, 5.1 and 5.2:

    Status
    colourGrey
    title5.0
    Status
    colourGrey
    title5.1
    Status
    colourGreen
    title5.2

    No Format
        $ cd /<ezp5-root>/
        $ sudo chown -R www-data:www-data ezpublish/{cache,logs,config} ezpublish_legacy/{design,extension,settings,var} web
        $ sudo find {ezpublish/{cache,logs,config},ezpublish_legacy/{design,extension,settings,var},web} -type d | xargs sudo chmod -R 775
        $ sudo find {ezpublish/{cache,logs,config},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo chmod -R 664
  • Using chmod
    If you can't use ACL and aren't allowed to change owner, you can use chmod, making the files writable by everybody. Note that this method really isn't recommended as it allows any user to do anything.
    5.3 / 2014.05 and higher:

    Status
    colourRed
    title>= 5.3 / 2014.05

    No Format
        $ cd /<ezp5-root>/
        $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type d | xargs sudo chmod -R 777
        $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo chmod -R 666

    5.0, 5.1 and 5.2:

    Status
    colourGrey
    title5.0
    Status
    colourGrey
    title5.1
    Status
    colourGreen
    title5.2

    No Format
        $ cd /<ezp5-root>/
        $ sudo find {ezpublish/{cache,logs,config},ezpublish_legacy/{design,extension,settings,var},web} -type d | xargs sudo chmod -R 777
        $ sudo find {ezpublish/{cache,logs,config},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo chmod -R 666

Install Composer
Status
colourYellow
title>=5.

...

3 / 2014.05

If you use a version control system, take care of versioning the composer.lock file.

...

No Format
php -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));"

...

Status
colourRed
title>= 5.3 / 2014.05


When Composer is installed, run composer update to get latest versions of packages before you continue with installation.

Info
Learn more on how to keep system further up to date  Using Composer

...

 

...

Status
title< 5.3

As of eZ Publish 5.2, if you plan to use eZ Publish legacy only, as standalone (as in pointing apache to ezpublish_legacy folder or extracting only ezpublish_legacy), then Zetacomponents must be installed if you don't already have it via PEAR.

After Composer installation (see above for Composer installation instructions) run the following command from the ezpublish_legacy/ folder :

No Format
php composer.phar install
Note

Composer will need PHP extensions like GD/Imagemagic and Intl to run, see system requirements for further information.

 

...

Status
title< 5.2
Note
titlePure legacy setup

If you are running a pure legacy setup, then commands such as composer install should be done within the legacy root folder, this will take care about installing latest versions of Zeta Components and defined eZ Publish (legacy) extension dependencies.

Optional : Link assets 

Info
The download file should already have generated these assets for you as of 5.2 / 2013.07 during composer install, but in case file has been extracted on Windows, make sure to run these commands.

To be able to run eZ Publish 5 correctly, assets need to be exposed in the public "web" folder, this is automatically done for you when you install / update vendors via composer which you did a few steps up. However during development you will need to execute these (especially last one) to get assets to be updated in prod environment, so they are kept here for reference.

The following commands will first symlink eZ Publish 5 assets in "Bundles" and the second will symlink assets (design files like images, scripts and css, and files in var folder)  from eZ Publish Legacy

...