58 lines
2.6 KiB
Markdown
58 lines
2.6 KiB
Markdown
## Running hapi-fhir-jpaserver-example in Tomcat from IntelliJ
|
|
|
|
Install Tomcat.
|
|
|
|
Make sure you have Tomcat set up in IntelliJ.
|
|
|
|
- File->Settings->Build, Execution, Deployment->Application Servers
|
|
- Click +
|
|
- Select "Tomcat Server"
|
|
- Enter the path to your tomcat deployment for both Tomcat Home (IntelliJ will fill in base directory for you)
|
|
|
|
Add a Run Configuration for running hapi-fhir-jpaserver-example under Tomcat
|
|
|
|
- Run->Edit Configurations
|
|
- Click the green +
|
|
- Select Tomcat Server, Local
|
|
- Change the name to whatever you wish
|
|
- Uncheck the "After launch" checkbox
|
|
- On the "Deployment" tab, click the green +
|
|
- Select "Artifact"
|
|
- Select "hapi-fhir-jpaserver-example:war"
|
|
- In "Application context" type /hapi
|
|
|
|
Run the configuration.
|
|
|
|
- You should now have an "Application Servers" in the list of windows at the bottom.
|
|
- Click it.
|
|
- Select your server, and click the green triangle (or the bug if you want to debug)
|
|
- Wait for the console output to stop
|
|
|
|
Point your browser (or fiddler, or what have you) to `http://localhost:8080/hapi/base/Patient`
|
|
|
|
You should get an empty bundle back.
|
|
|
|
|
|
## Running hapi-fhir-jpaserver-example in a Docker container
|
|
|
|
Execute the `build-docker-image.sh` script to build the docker image.
|
|
|
|
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.
|