Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Clone the Github repository to a local directory (e.g. c:/workspace/SNOMED-Terminology-Server)

Step 2

Build all modules with "mvn clean install" at the top level - either through Eclipse or via the command line.

Step 3

  Stock setup for Windows development

  • Create a directory to hold your admin, 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/data/icd9cm-2013.xml file into your data directory (e.g. c:/data)
  • Copy the Unpack the config/windows-dev/target/term-server-config/-windows-dev.*.zip file into your data directory (e.g. c:/data)

  Stock setup for Unix/Linux/Mac

  • Create a directory to hold your admin, configuration and data files (e.g. ~/data)
  • Copy the term-server-config/src/main/resources/data/snomedct-20140131-mini folder to your data directory (e.g. ~/data).
  • Copy the term-server-config.properties to /src/main/resources/data/icd9cm-2013.xml file into your data directory (e.g. c:~/data) and rename it to "config.properties"

...


  • Unpack the config/prod/target/term-server-config-prod.*.zip file into a directory (e.g. ~/)

Step 4

Edit the configuration file (now in config.properties in your data directory) 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)
  • ihtsdo.security.activated (set to false for dev environment)

Step 45

Set up environment:

  • Make sure the "mvn" executable for your local maven installation is in the path
    • On Windows this means adding to the PATH variable so that it runs in a "cmd" shell without fully qualified path.

Step 56

Create a MySQL UTF8 database. e.g.

  • CREATE database tsdb CHARACTER SET utf8 default collate utf8_unicode_ci;


Step 6

Deploy the admin tools and run the loader Run the corresponding load script for your environment;. 

...

  • Step 3 creates a bin directory in the chosen data directory.  There is a "load" script that can be used with the setup at this point to create a default development instance of the application
    • For Windows: run load.bat (e.g. c:/data/bin
    )
    • Edit the configuration settings at the top of "/load.bat"
    • Run load.bat
    For Mac, Linux, or other Unix (recommend ~/bin)
    • Edit the configuration settings at the top of "load.csh"
    • Run load.csh)
  • For Unix/Linux/Mac: run load.csh (e.g. ~/bin/load.bat)

NOTE: if re-running this, you first have to run the sql in "truncate_all.sql" to clear your database of tables (Recommend using MySQL Workbench for this in the dev environment).

...