Path

ez.no / documentation / ez publish / technical manual / 4.x / 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.

Troubleshooting

This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation!

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:

    [DebugSettings]
    DebugOutput=enabled
    

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 (22/05/2006 1:27 pm)

Ricardo Correia (17/04/2013 10:02 am)

Svitlana Shatokhina, Geir Arne Waaler, Ricardo Correia


Comments

There are no comments.