Path

ez.no / documentation / extensions / ez publish extensions / ez find / upgrading ez find / upgrading to ez find ls 5.4.0


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.

Upgrading to eZ Find LS 5.4.0

Back-up

Before starting the eZ Find upgrading process make sure that you have a working backup of the existing website state including database, extensions, INI settings, etc. During the upgrade process the existing eZ Find extension will be removed and replaced with a new version.

Download

Note: First make sure you familiarize with the "Using Composer" page on doc.ez.no.

  1. Install composer in your eZ Publish Platform folder
  2. Run "php composer.phar require --prefer-dist <package>"
    • Example: php composer.phar require --prefer-dist --update-no-dev ezsystems/ezfind-ls:5.4.*

You can find it under ezpublish_legacy/extension/ezfind.

Make sure the extension is activated under the [ExtensionSettings] block in the "ezpublish_legacy/settings/override/site.ini.append.php" like this:

[ExtensionSettings]
 
ActiveExtensions[]=ezfind
[...]

It is important that eZ Find is activated before eZ Webin and eZ Flow, if you use those extensions, to ensure that your installation uses the correct search templates.

Clear ini and template override cache

Clear the ini and template override caches (mandatory) with the following command from your "ezpublish_legacy" folder:

php bin/php/ezcache.php --clear-all

Autoload update

Next the autoload array needs to be updated for the extension. To do this, execute following command from your "ezpublish_legacy" folder:

$ php bin/php/ezpgenerateautoloads.php -e -p

Update the core configuration

Starting in ezfind 5.3, SOLR is by default used in multicore. A default multicore configuration is provided (ezp-default) in order to work out of the box like it used to for users not using multicore.
For those using multicore on version below 5.3, the configuration needs to be recreated.

Using multicore setup:

In ezfind/java/solr/ copy the ezfind/java/solr/ezp-default as a base for your core.
For example: ezfind/java/solr/my-custom-core

Then, edit ezfind/java/solr/solr.xml and add new <core> to <cores adminPath="/admin/cores" defaultCoreName="ezp-default">.
You can also specify the default core in the <cores> tag.

If you core is using content in another language than english. Copy the content of the folder ezfind/java/solr.languages/<my-language> into your core's conf folder.
For example: cp -a ezfind/java/solr.languages/fr/* ezfind/java/solr/my-custom-core/conf

For more information check out the README file.

Re-index

Next re-index the content of the site by running the command, also from your "ezpublish_legacy" folder:

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

Note: Internally the schema used by Solr has changed, this means that to upgrade to eZ Find LS 5.4.0 a full index update is required. This also means that some attribute names from the old schema might have a different name/format/properties now so every site specific code using Solr defined field names for eZ Publish attributes directly has to be reviewed.

Yannick Roger (15/10/2015 1:19 pm)

Yannick Roger (21/10/2015 1:02 pm)


Comments

There are no comments.