Page History

This section will guide you through the following steps:

Setting up a database

Status
colour Yellow title 5.x

A database must be created before running the setup wizard. The following text explains how to set up a database using either MySQL or PostgreSQL.

...

1. Log in as the postgres user (or any other PostgreSQL user that has sufficient privileges to create roles and databases):

   No Format
   $ psql -h <psql_host> -p <port> -U <psql_user> -W

   Note
   Note that if PostgreSQL is installed on the same server, the "-h" parameter can be omitted. If the "-p" parameter is omitted, the default port for PostgreSQL traffic will be used (in most cases, port 5432).

   The PostgreSQL client will ask you to specify the password that belongs to the <psql_user>. If the password is correct, the client should display a "<psql_user>=#" prompt.

2. Create a new database:

   No Format
   postgres=# CREATE DATABASE <database> ENCODING='utf8';

3. Create a new user:

   No Format
   postgres=# CREATE USER <user> PASSWORD '<password>';

4. Grant access permissions:

   No Format
   postgres=# GRANT ALL PRIVILEGES ON DATABASE <database> TO <user>;

    

   Import the "pgcrypto" module into the new database:

   No Format
   postgres=# \c <database> <database>=# \i '<path_to_pgcrypto>'

   Reference	Description
   <psql_host>	The hostname of the PostgreSQL database server.
   <port>	The port number that will be used to connect to the PostgreSQL database server.
   <psql_user>	The PostgreSQL user (if no user is set up, use "postgresql").
   <database>	The name of the database, for example "my_new_database".
   <user>	The username that will be used to access the database.
   <password>	The password you wish to set in order to limit access to the database.
   <path_to_pgcrypto>	The path to the "pgcrypto.sql" file, for example "/usr/share/pgsql/contrib/pgcrypto.sql".

   
   Note for version 9.1+ of PostgreSQL users:The following changes might be necessary for these users:

   No Format
   postgres=# \c <database> <database>=# CREATE EXTENSION pgcrypto;

Downloading eZ Publish

Status
colour Yellow title 5.x

Enterprise version is available in your support portal or via partner portal.

Unpacking eZ Publish

Status
colour Yellow title 5.x

Use your favorite tool to unpack the downloaded eZ Publish distribution to a web-served directory (a directory that is reachable using a web browser), or in case of virtual host mode it can be any folder.
The following example shows how to do this using the tar utility (to unpack a tar.gz file, assuming that the "tar" and the "gzip" utilities are installed on the system):

...

The extraction utility will unpack eZ Publish into a sub-directory called "ezpublish-<version_number>". Feel free to rename this directory to something more meaningful, for example "my_site".

Setting up folder permission

Status
colour Yellow title 5.x

...

• 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 and / 2014.05 and higher:

  Status
  colour Red 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
  colour Grey title 5.0

  Status
  colour Grey title 5.1

  Status
  colour Green title 5.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 and / 2014.05 and higher:

  Status
  colour Red 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
  colour Grey title 5.0

  Status
  colour Grey title 5.1

  Status
  colour Green title 5.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 and / 2014.05 and higher:  

  Status
  colour Red 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 xargs chmod -R 775 $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo xargs chmod -R 664

  5.0, 5.1 and 5.2:

  Status
  colour Grey title 5.0

  Status
  colour Grey title 5.1

  Status
  colour Green title 5.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 xargs chmod -R 775 $ sudo find {ezpublish/{cache,logs,config},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo xargs 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 and / 2014.05 and higher:   

  Status
  colour Red 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 xargs chmod -R 777 $ sudo find {ezpublish/{cache,logs,config,sessions},ezpublish_legacy/{design,extension,settings,var},web} -type f | xargs sudo xargs chmod -R 666

  5.0, 5.1 and 5.2:

  Status
  colour Grey title 5.0

  Status
  colour Grey title 5.1

  Status
  colour Green title 5.2

  
  

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

Updating Zetacomponents with Composer

...

Install Composer

Status
colour Yellow title >=5.3 / 2014.05

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

Install Composer by running one of the following command from you eZ Publish root folder :

If you have curl installed:

curl -sS https://getcomposer.org/installer | php

If you don't have curl installed:

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

After Composer installation run the following command from the ezpublish_legacy/ folder :

php ../composer.phar install

...

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

Optional : Link assets 

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

cd /<ezp5-root>
php ezpublish/console assets:install --relative --symlink web
php ezpublish/console ezpublish:legacy:assets_install --relative --symlink web
php ezpublish/console assetic:dump --env=prod web

Initiating the setup wizard

Status
colour Yellow title 5.x

The setup wizard can be started using a web browser immediately after the previous steps (described in this section) are completed. It will be automatically run the first time someone tries to access/browse the "/ezsetup" url.

...