honeymoose
/
hapi-fhir
mirror of https://github.com/hapifhir/hapi-fhir.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
🔥 HAPI FHIR - Java API for HL7 FHIR Clients and Servers
411 Commits 671 Branches 130 Tags 1.2 GiB
Java 98.2%
HTML 0.8%
Ruby 0.7%
Shell 0.1%
Go to file
Preston Lee b1e1b7725a More documentation. 2014-10-06 19:14:12 -07:00
.settings Fix a number of unit tests 2014-07-02 15:24:29 -04:00
chef Vagrant configuration\! 2014-10-06 18:47:56 -07:00
data/build Vagrant configuration\! 2014-10-06 18:47:56 -07:00
docs/screenshots More documentation. 2014-10-06 19:14:12 -07:00
hapi-fhir-base One more windows unit test break 2014-10-01 16:27:47 -04:00
hapi-fhir-jpaserver-base Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-fhir-jpaserver-test Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-fhir-jpaserver-uhnfhirtest Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-fhir-oauth2 Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-fhir-structures-dstu Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-fhir-testpage-overlay Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-tinder-plugin Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
hapi-tinder-test Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
restful-server-example Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
restful-server-example-test Argh. Fix to 0.7-SNAPSHOT, not 0.6-SNAPSHOT 2014-09-30 13:16:09 -04:00
.classpath Just starting 2014-02-17 17:58:32 -05:00
.gitignore Vagrant configuration\! 2014-10-06 18:47:56 -07:00
.project Fix a number of unit tests 2014-07-02 15:24:29 -04:00
README.md More documentation. 2014-10-06 19:14:12 -07:00
Vagrantfile Vagrant configuration\! 2014-10-06 18:47:56 -07:00
check_for_maven_updates.sh Fix up examples 2014-09-03 18:03:44 -04:00
pom.xml Fix broken unit tests on Windows 2014-10-01 16:02:22 -04:00
pom.xml.versionsBackup More resource generation 2014-04-02 18:42:16 -04:00
update_version.sh Documentation updates and bump to 0.5-SNAPSHOT 2014-07-15 18:36:13 -04:00

README.md

hapi-fhir

HAPI FHIR - Java API for HL7 FHIR Clients and Servers

Complete project documentation is available here: http://jamesagnew.github.io/hapi-fhir/

A demonstration of this project is available here: http://fhirtest.uhn.ca/

Creating your own demo server with Vagrant

This source code repository includes configuration files to materialize an entire server implementation in a single virtual machine (VM) image from scratch, allowing you to quickly bootstrap your own instance. The server will be completely encapsulated within the created VM image. The process should run on OSX, Linux and Windows, but YMMV. The built-in settings support creation of a VirtualBox-based image on Ubuntu Linux, though with tuning the base image you should be able to create images suitable for other hypervisors and cloud-based IaaS providers such as VMware and Amazon Web Services (AWS), respectively.

Dependencies

Prior to running, please ensure you have all .war files built, and the following installed and functioning propertly.

  • All normal Java development dependencies. (SDK and Maven, specifically.)
  • VirtualBox
  • Vagrant

Creating Your VM

cd hapi-fhir-root/
mvn install # Creates web application .war files. Make sure they're built before proceeding!
vagrant up # Will take a few minutes to boot up.

Your new server environment should now be running in a headless virtual machine on your local computer. The following step are performed automatically for you within the VM sandbox environment:

  • A complete Ubuntu 14.04 Server VM is launched in headless mode, bridged to whatever host network interface you've selected.
  • An IPv4 address is assigned via DHCP.
  • MySQL Server (Community Edition) is installed from the official 10gen repository. (See the Vagrantfile for the default root password.)
  • Oracle Java 8 is installed.
  • Tomcat 7 is installed and configured as a system service.
  • All compiled *.war applications are deployed automatically and started.
  • A "fhir" user is added to tomcat-users.xml. See fhir.json for the default password.

Tomcat will now be running on the VM on port 8080 with the management GUI available. For example, you can now visit:

  • Tomcat Manager: assigned_ip:8080/manager/html
  • HAPI FHIR JPA Server: assigned_ip:8080/hapi-fhir-jpaserver/

Screenshots

Tomcat Manager

Demo Server

Advanced Configuration

The Vagrant documentation is the best place to start, but a few more commands of note are:

vagrant ssh # Command-line access to the VM.
vagrant destoy # Shuts down and completely destroys the VM.

Credits

Vagrant and Chef configuration by Preston Lee preston.lee@prestonlee.com