This section describes how to manually configure eZ Publish instead of using the setup wizard to do all the work. Keep in mind that the manual installation method is for expert users only. It should only be used by people who know what they are doing. The following steps will work on both Linux/UNIX and Windows environments.
A clean eZ Publish database is created using two very important SQL scripts: "
kernel_schema" and "
cleandata" (note that an empty database should be created before launching these scripts). The first of them initializes the necessary database structure and the second one imports the pre-defined data to the database. While the "
kernel_schema" script differs for each database engine, the "
cleandata" script is the same for all solutions.
Use the following command to run the MySQL specific "
In eZ Publish 4.0.1 and later versions, the script will use the InnoDB storage engine when creating new tables. This storage engine is recommended (and will be required in the future) for running eZ Publish on a MySQL database. Contact your database administrator if you are unsure about whether InnoDB is available on your server.
In eZ Publish 4.0.0, the
CREATE TABLE statements in the "
kernel_schema" script do not specify which storage engine to use (no
TYPE option), and thus the default storage engine will be used. Normally, it is
MyISAM. Because of this, it is highly recommended to set the default storage engine to
InnoDB before you run the "
kernel_schema" script (refer to the MySQL documentation for information about how to set the default engine). Alternatively, you can run the "
kernel_schema" script first and then convert the newly created tables to
InnoDB. You can either use the "
bin/php/ezconvertmysqltabletype.php" script for database conversion (recommended) or convert the tables individually by using the following SQL query for each table:
Use the following command to run the generic "
The MySQL user (if no user is set up, use "root").
The password that belongs to the username.
The name of the database, for example "my_database".
The full path to the root directory of your eZ Publish installation, for example "/opt/ezp".
Windows users can skip this part.
Cache, storage, log and configuration folders must be writable both by the web server and the command line user. The easiest way is to give the web server user ownership of those folders:
One import thing to keep in mind is that all command line scripts must be run as the webserver user in order not to break permissions.
In a development environment, it is often easier to set the server to run as your own user.
To be able to run eZ Publish 5 correctly, assets need to be exposed in the public "
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
Note: In both cases "
web" is the default folder and can be skipped from the command. Further information about alternative options is available with
-h just like it is with "
php ezpublish/console -h".
Warning regarding APC
If you are planning to use APC to speed up your site, please be sure to check the available notes here, before entering the setup wizard chapter.
Configuring eZ Publish
site.ini.append.php" configuration file located in the "
ezpublish_legacy/settings/override" directory of your eZ Publish installation must be changed, or else eZ Publish will not function properly. This file is the global override for the site.ini configuration file. There are a lot of things that need to be configured (database, mail transport system, var directory, etc.). The following text shows a generic example of a configuration that can be used:
In the example above the "
AvailableSiteAccessList" array located in the "
[SiteAccessSettings]" section of this file determines the available siteaccesses called "
example" and "
example_admin". The "
CheckValidity" setting located in the same section should be set to false, otherwise the setup wizard will be initiated when trying to access the site.
In addition, two siteaccess configurations must be created, a public siteaccess ("
example") and an administration siteaccess ("
example_admin"). The following sub-directories have to be created in the root of your eZ Publish installation:
Both siteaccesses must have a file called "
The public siteaccess
The following text shows a generic solution for the "
The admin siteaccess
The following text shows a generic solution for the "
Note that database settings, mail settings, regional and other settings defined in "
" will be used for each siteaccess regardless of what is specified in the siteaccess settings. In the example above, the "
Database=my_database" is specified under the "
[DatabaseSettings]" section of this file so this database will be used for both "
example" and "
example_admin" siteaccesses. Refer to the "Site management" and "Configuration" sections of the "Concepts and basics" chapter for more information.
Activate base extensions
There are some legacy extensions that need to be active, as eZ Publish depends on them. This is usually done in the
settings/override/site.ini.append.php settings file.
Here's an example of the extensions that you should activate:
Available languages and their priorities can be controlled per siteaccess using the "SiteLanguageList" configuration setting located under the "
[RegionalSettings]" section of the siteaccess "
site.ini.append.php" file. If this setting is not specified, the system will use the old "
ContentObjectLocale" setting and thus only the default language will be shown. Refer to the "Configuring the site languages" section for more information and examples.
cleandata.sql" script creates only one language which is the British English (eng-GB). All other languages should be added using the "Setup - Languages" part of the administration interface (
in the example above).
As of eZ Publish 5.2 the maximum number of languages supported for 64 bit servers has been improved, allowing up to 62 languages simultaneously. For 32 bit servers the maximum number of simultaneous languages supported is 30.
Dynamic tree menu
If you have a large site with many nodes, it is strongly recommended to enable the "Dynamic" switch for your administration siteaccess. This will make the left tree menu in the administration interface work much faster and decrease the usage of network bandwidth.
Administrator's log-in and password
The following user name and password are set by the "
cleandata.sql" script and can be used for logging in to the administration interface.
- User name:
It is strongly recommended to change this password as soon as possible. Note that if you need another user name for site administrator, you can create a new administrator user, log in as this user and remove the old one.
Generate eZ Publish autoloads
The autoloads can be generated by running the
ezpgenerateautoloads.php as shown in the example below:
Generate eZ Publish .yml configuration
To generate yml configuration for the new Symfony stack a console command has been provided to cover single site setups.
Perform the following command where
<group> represents the siteaccess group name which will be created for your configurations in
ezpublish.yml, for instance package name like "
ezwebin_site" or "
<admin_siteaccess> represents your admin siteaccess, for instance, "
If you instead would like to manually create your yml config, do the following: