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
418 Commits 662 Branches 129 Tags 1.2 GiB
Java 98.2%
HTML 0.8%
Ruby 0.7%
Shell 0.1%
Go to file
James Agnew e4f212c8dc Merge pull request #31 from preston/master 
Configuration files for automated provisioning with Vagrant and Chef Solo.
 		2014-10-17 15:09:54 -04:00
.settings Fix a number of unit tests 2014-07-02 15:24:29 -04:00
hapi-fhir-base Fix #33 - Server was incorrectly returning contained resources as 2014-10-15 16:46:28 -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 Fix #33 - Server was incorrectly returning contained resources as 2014-10-15 16:46:28 -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
vagrant Refreshing .war files on re-provisioning. 2014-10-07 12:31:16 -07:00
.classpath Just starting 2014-02-17 17:58:32 -05:00
.gitignore Moving all Vagrant and Chef files to their own suddirectory as to not pollute the root level. 2014-10-07 11:59:16 -07:00
.project Fix a number of unit tests 2014-07-02 15:24:29 -04:00
README.md Minor fixes. 2014-10-07 12:15:50 -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 off all project build artifacts in a single virtual machine (VM) image from scratch, allowing you to quickly bootstrap your own local copy of the project. 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 of 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. (Java SDK and Maven 3, specifically.)
  • VirtualBox
  • Vagrant

Creating Your VM

cd hapi-fhir-root/
mvn install # Creates web application .war files. Make sure they're built before proceeding!
cd vagrant
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