See the full documentation on readthedocs.
- Less than 5 minutes:
- Download & install Java
- Download & install Elastic Search
- bin/elasticsearch
- Step by Step for Ubuntu:
- add-apt-repository ppa:webupd8team/java
- apt-get update
- apt-get install git curl oracle-java7-installer
- wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.6.0-linux-x86_64.tar.gz
- wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.6.0-linux-x86_64.tar.gz.sha512
- shasum -a 512 -c elasticsearch-7.6.0-linux-x86_64.tar.gz.sha512
- tar -xzf elasticsearch-7.6.0-linux-x86_64.tar.gz
- cd elasticsearch
- bin/elasticsearch &
- Does it work?
- curl http://localhost:9200/
- Do you see the Hudsucker Proxy reference? "You Know, for Search"
- Use Elastic Search in Plone:
- Add collective.elasticsearch to eggs & re-run buildout
- Restart Plone
- Goto Control Panel
- Add "Elastic Search" in Add-on Products
- Click "Elastic Search" in "Add-on Configuration"
- Enable
- Click "Convert Catalog"
- Click "Rebuild Catalog"
You now have a insanely scalable modern search engine. Now live the life of the Mind!
This package aims to index all fields the portal_catalog indexes and allows you to delete the Title, Description and SearchableText indexes which can provide significant improvement to performance and RAM usage.
Then, ElasticSearch queries are ONLY used when Title, Description and SearchableText text are in the query. Otherwise, Plone's default catalog will be used. This is because Plone's default catalog is faster on normal queries than using ElasticSearch.
Only tested with Plone 5 with Dexterity types.
It should also work with Plone 4.3 and archetypes.
Deployed with Elasticsearch 7.6.0
Support for all index column types is done EXCEPT for the DateRecurringIndex index column type. If you are doing a full text search along with a query that contains a DateRecurringIndex column, it will not work.
This package comes with Celery support where all indexing operations will be pushed into celery to be run asynchronously.
Please see instructions for collective.celery to see how this works.
Run elasticsearch for tests to utilize:
- docker run
- -e "discovery.type=single-node" -e "cluster.name=docker-cluster" -e "ES_JAVA_OPTS=-Xms512m -Xmx512m" -p 9200:9200 docker.elastic.co/elasticsearch/elasticsearch-oss:7.6.0
Then, you can use one of the travis buildout test files:
virtualenv . bin/pip install -r requirements.txt bin/buildout bin/test