Overview
Documents setting up code, config, and data in a development environment using Eclipse.
Prerequisites
- Java 7 installed
- Mysql 5.5 or 5.6 installed
- Maven 3.2.+ installed
- Tomcat 7 installed and configured
Details
Step 1
Clone the Github repository to a local directory (e.g. c:/workspace/SNOMED-Terminology-Server)
Step 2
Create a directory to hold your configuration and data files (e.g. c:/data)
Copy the term-server-config/src/main/resources/data/snomedct-20140131-mini folder to your data directory (e.g. c:/data);.
Copy the term-server-config/src/main/resources/config.properties.dev to your data directory (e.g. c:/data) and rename it to "config.properties"
Step 3
Edit the configuration file to set correctly for your environment. In particular, edit these:
- javax.persistence.jdbc.url
- javax.persistence.jdbc.user
- javax.persistence.jdbc.password
- hibernate.search.default.indexBase ( recommend choosing something below your data dir, e.g. c:/data/indexes)
- loader.SNOMEDCT.input.data (set to the path of your SNOMED data, e.g. c:/data/snomedct-20140131-mini)
- ihtsdo.security.activated (set to false for dev environment)
Step 4
Set three environment variables
- MVN_HOME - path to mvn installation (so bin/mvn is accessible from there)
- Only needed on Windows, assume "mvn" is in path on Linux
- SERVER_CONFIG - path to the configuration file (e.g. c:/data/config.properties).
- SERVER_HOME - path to where the code is installed, (e.g. c:/workspace/SNOMED-Terminology-Server)
Step 5
Create a MySQL UTF8 database. e.g.
- CREATE database tsdb CHARACTER SET utf8 default collate utf8_unicode_ci;
Step 6
Run the admin loader script for your platform. See term-server-admin/loader/src/main/resources/scripts
- load.bat - for Windows
- load.sh - for Linux