Path / documentation / ez publish / technical manual / 4.4 / installation / troubleshooting

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.


This section will explain what can be done if installation fails because of some unknown reason. First of all, make sure that all the requirements without exception are met. The requirements are strict and extremely important. Please read them very carefully.

If all the requirements are met but you still have problems, it is recommended to check the debug information during the installation process. To enable the debug output, do the following:

  1. Go to the "settings/override" directory of your eZ Publish installation.
  2. Create a new file called "site.ini.append.php" and put the following lines to it:

The debug output will appear at the bottom of the page as shown in the following screenshot.

Debug output

The debug output appears at the bottom of the page

The debug output will be displayed in the setup wizard, in the administration interface and on the actual site. This option can be disabled at any time by replacing "enabled" with "disabled" in the same place of the configuration file.

Note that the "CheckValidity" setting located in the "[SiteAccessSettings]" section of the same file controls if the setup wizard should automatically start the first time the site is accessed/browsed. If you want to restart the wizard after its successful finishing, you can specify "CheckValidity=true" in the "settings/override/site.ini.append.php" file so that the setup wizard will be initiated when trying to access the site.

Svitlana Shatokhina (14/09/2010 7:43 am)

Geir Arne Waaler (27/09/2010 8:03 pm)

Svitlana Shatokhina, Geir Arne Waaler


There are no comments.