getting-started.md

Getting Started

Prerequisites

• Java 8
• Maven 3
• SNOMED CT International Edition RF2 release files
• About 8G of memory

More on Memory Requirements

As a minimum Snowstorm should have 2G and Elasticsearch should have 4G of memory in order to import a Snapshot and perform ECL queries. Elasticsearch will work best with another 4G of memory left free on the server for OS level disk caching.

Setup

Install Elasticsearch

Download and install Elasticsearch 6.x (tested against 6.4.2).

Update the configuration file config/jvm.options with the memory options -Xms4g and -Xmx4g.

Build Snowstorm

Build Snowstorm using maven:

mvn clean package

Or download the most latest released jar from the repository releases.

Start Snowstorm

First start Elasticsearch from wherever it has been installed.

./bin/elasticsearch

On the first run of Snowstorm the SNOMED CT data needs to be loaded. Follow instructions here.

On subsequent runs just start Snowstorm (in read only mode).

java -Xms2g -Xmx2g -jar target/snowstorm*.jar --snowstorm.rest-api.readonly=true