Helios FHIR Server Installation Guide
Simple Install (Quick Start)
Prerequisites
- Java 11 installed
- Cassandra installed locally (Cassandra quickstart)
Cassandra Quickstart
Cassandra Prerequisites
- Java 8 or Docker installed
Cassandra install (Docker)
The easiest way to get started with Cassandra is by using the Cassandra Docker container. All you have to do is run the following command:
The Docker Cassandra installation is not recommended for production; however, it is a fantastic and easy way to start your exploration of the Helios FHIR Server!
Cassandra install (Native)
For a more permanent or performant Cassandra, we recommend you install the application natively.
First, make sure you have Java 8 installed and that it is your current version.
From here, you can follow the instructions provided by
Apache Cassandra
(Stop when you get to the header Installing the Debian packages
)
Alternatively, we have reproduced the necessary steps here:
Download the Apache Cassandra distribution
$ curl -OL https://mirrors.sonic.net/apache/cassandra/3.11.8/apache-cassandra-3.11.8-bin.tar.gzUnpack the Apache Cassandra distribution
$ tar xzvf apache-cassandra-3.11.8-bin.tar.gzStart Apache Cassandra
$ cd apache-cassandra-3.11.8$ bin/cassandraCheck the status of Cassandra
$ bin/nodetool statusOnce the result is
UN
, which stands forUp/Normal
, the Cassandra installation is ready to use with Helios FHIR Server
Installing Helios FHIR Server
Set
$JAVA_HOME
to point to your Java 11 installation$ export JAVA_HOME=`/usr/libexec/java_home -v 11`Download the current Helios FHIR Server distribution
$ curl -OL <insert the HFS download link here>Extract the Helios FHIR Server distribution
$ tar xzvf ${helios-fhir-server-distribution.tar.gz}Start Helios FHIR Server
$ cd ${helios-fhir-server-distribution}$ bin/karafThis starts the Helios FHIR Server and presents you with an interactive shell. Here you can try
log:tail
orbundle:list
to interact with the Helios FHIR Server and see some interesting information about the system.log:tail
tails the Helios FHIR Server system log. You can inspect this log for a message that looks liketo know when the Helios FHIR Server has completed its startup12:32:55.471 INFO [features-3-thread-1] Deployment finished. Registering FeatureDeploymentListener12:32:55.770 INFO [features-3-thread-1] Done.bundle:list
lists all the Bundles that are running in the Helios FHIR Server. This can be an easy way to check if your system is healthy and if the features you want are running.
Check the health of Helios FHIR Server
Navigate to
http://localhost:8181/fhir/healthcheck
in a browser. The JSON response should be[]
. This indicates that all the desired Bundles are installed and active.tip
In certain distributions of the Helios FHIR Server, some bundles and features are deliberately disabled and thus the healthcheck response is not the
[]
even though the system is healthy. A good secondary check is to execute the commandbundle:list | grep -i failure
in the Karaf terminal. If that returns empty, your system is healthy.In some cases, if the Helios FHIR Server was started too soon after Cassandra was started, the database connection will fail. This will present as a line like
37 โ Failure โ 80 โ 0.19.0 โ cassandra-session Bundlein the response from
bundle:list | grep -i failure
. If this happens, simply shutdown the system (shutdown -f
), wait a few minutes, and boot it up again using thebin/karaf
command.Log in to the Helios FHIR Server interactive web user interface
Navigate to
http://localhost:8181/ui
in a browser. You will be prompted to login, the default credentials are username:admin@heliossoftware.com
and password:admin
.From here, you can check the status of the system at a glance on the landing dashboard, configure the system, enable and disable FHIR Resources and Search Parameters, and manage the Helios FHIR Server users.