add mini tutorial about the elasticsearch integration in ReadMe

This commit is contained in:
Jiajing LIANG 2017-12-21 17:17:33 +01:00
parent c3841d1bcc
commit 27c9f3bd30
1 changed files with 14 additions and 0 deletions

View File

@ -41,3 +41,17 @@ Use this command to start the container:
`docker run -d --name hapi-fhir-jpaserver-example -p 8080:8080 hapi-fhir/hapi-fhir-jpaserver-example`
Note: with this command data is persisted across container restarts, but not after removal of the container. Use a docker volume mapping on /var/lib/jetty/target to achieve this.
#### Using ElasticSearch as the search engine instead of the default Apache Lucene
1. Install ElasticSearch server and the phonetic plugin
* Download ElasticSearch from https://www.elastic.co/downloads/elasticsearch
* ```cd {your elasticsearch directory}```
* ```bin/plugin install analysis-phonetic```
* start ElasticSearch server: ```./bin/elasticsearch```
2. Replace configuration in web.xml
* replace the configuration class ```ca.uhn.fhir.jpa.demo.FhirServerConfig``` in web.xml by ```ca.uhn.fhir.jpa.demo.elasticsearch.FhirServerConfig```
3. Start server by runing: ```mvn jetty:run```
4. Limitations:
* Hibernate search are not compatible with all ElasticSearch version. If you are using Hibernate search: 5.6 or 5.7, the compatible ElasticSearch version is 2.0 - 2.4. If you are using Hibernate search: 5.8 or 5.9, the compatible ElasticSearch version is
2.0 - 5.6.
* Please check all the limitations in the reference documentation: https://docs.jboss.org/hibernate/search/5.7/reference/en-US/html_single/#elasticsearch-limitations before use the integration.