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.


Java Runtime Environment

The extension requires the Sun supplied Java Runtime Environment (JRE) version 5 for Linux and 6 for Windows, Mac OS and Solaris. This can be obtained from the Java download pages. Follow the corresponding installation instructions as described on the Java home pages.

Once the JRE is installed, you can reach the eZ Find extension on the eZ Publish community sources. Please note that the version of eZ Find which are bundled with eZ Publish community versions aren't certified for eZ Publish 5 Platform, and can't be support. The eZ Find extension has to be placed under your eZ Publish site location in the path ezpublish_legacy/extension/ezfind/.

Enable eZ Find and upgrade DB schema

To enable your eZ Find extension, open settings/override/site.ini.append.php and add the following parameter to the [ExtensionSettings] section:


Here you should add the eZ Find extensions before the ezwebin (Website Interface) and ezflow extensions, in order to use the correct templates for these extensions. Your [ExtensionSettings] section might then look like this:


Please note that from version 2.3 onwards eZ Find supports the new extension load ordering feature that makes the extension load ordering more automated. Please read more in What's new in eZ Find 2.3.

Clear the ini caches for the next settings to be updated:

php bin/php/ezcache.php --clear-tag=ini

Next, you will need to update the class autoloads by running the script from you ezpublish_legacy/ directory under your eZ Publish site location:

cd ezpublish_legacy/
php bin/php/ezpgenerateautoloads.php

You will also need to add a table to the database used by your eZ Publish installation. You can do this as follows from the eZ Publish root directory if you are using MySQL:

mysql -u <user> -p <database_name> < ezpublish_legacy/extension/ezfind/sql/<database>/<database>.sql

In case you are using another RDMS the procedure is very similar. You may want to have a look at sql/oracle (for Oracle) or sql/postgresql (for PostgreSQL). Please refer to the documentation reference for your DBMS if you are experiencing problems.

Finally, also clear the template override cache with following command:

php bin/php/ezcache.php --clear-id=template-override

Now that eZ Find is installed you are able to start solr, by running the following command from your ezpublish_legacy/extension/ezfind/java/ directory under your site's location:

java -Dezfind -jar start.jar

For more details please check the solr backend documentation.

To re-index the content of the site run the command from your ezpublish_legacy/ directory under your site's location:

php extension/ezfind/bin/php/updatesearchindexsolr.php -s <admin siteaccess>


Please visit the Basic and Advanced Configuration pages to learn how to configure your installation to suit your needs.

Ricardo Correia (12/09/2013 3:34 pm)

Ricardo Correia (24/06/2016 10:29 am)


There are no comments.