Manual Installation Instructions

(What Installation Script Does)



Introduction

This page shows what the Sub-Term Mapping Tools installation script does. A manually installation can be performed to replace the installation script. This step by step instruction can be used to install STMT on platforms other than Linux or MS Windows, such as Mac or Unix. It is not recommended for general end users to install the Sub-Term Mapping Tools manually. You may skip this section if you use the STMT script for the installation. Please refer to installation instructions for installing the Sub-Term Mapping Tools.

Prerequisites

Setup
Use 2013 release as example

  1. Create a new directory for the Sub-Term Mapping Tools on your machine.
  2. Download the zip archive: stmt2013.tgz, and place it in the newly created directory. "2013" is the version identification (year).
  3. Uncompress or unzip the archive. Be careful to use a version of unzip that allows long filenames and that will recreate the full directory structure.

    You should now have three files and eight sub-directories under stmt2013, as shown in follows:

    • build.xml
    • overview.xml
    • ReadMe.txt

    • /bin
    • /data
    • /docs
    • /install
    • /lib
    • /loadDb
    • /logs
    • /sources
  4. Make sure your Java version is 1.6.0_26 or later (java -version)

Manual Installation

  1. Let's say the path of top directory of stmt2013 is ${STMT_DIR}, such as:
    /Users/stmt/stmt2013
    

  2. Edit configuration files as follows,
    • ${STMT_DIR}/data/Config/lsf.properties:
    • ${STMT_DIR}/data/Config/smt.properties:
    • ${STMT_DIR}/data/Config/stmt.properties:
      • ROOT_DIR: Change the value to the full path of the top directory of stmt2013
      • LVG_CONFIG_FILE: Change the value to the full path of lvg configuration file (if you don't have lvg installed, use the default lvg in STMT, ${STMT_DIR}/data/Config/lvg.properties)
      • DB_NAME: Change the value to the name of Database (stmt2013)
    • ${STMT_DIR}/data/Config/lvg.properties:
      • LVG_DIR: Change the value to the full path of LVG directory

    For example, if the ${STMT_DIR} is /Users/stmt/stmt2013, the modified variable should look like:

    ROOT_DIR=/Users/stmt/stmt2013/
    LVG_CONFIG_FILE=/Users/stmt/stmt2013/data/Config/lvg.properties
    DB_NAME=stmt2013

    LVG_DIR=/Users/stmt/stmt2013/data/Lvg/lvg2011lite/

    Please refer to configuration setup for details

  3. Edit executable files,
    • ${STMT_DIR}/bin/lsf
    • ${STMT_DIR}/bin/mt
    • ${STMT_DIR}/bin/nt
    • ${STMT_DIR}/bin/smt
    • ${STMT_DIR}/bin/stmt
    • ROOT_DIR: Change the value to the full path of the top directory of stmt2013

    For example, if the ${STMT_DIR} is /Users/stmt/stmt2013, the modified variable should look like:

    ROOT_DIR="/Users/stmt/stmt2013/"
    

Test Run

Now you are ready to run stmt, for example:

  1. Run stmt:
    shell> ${STMT_DIR}/bin/smt -p -pt
    	Cold
    	Cold|cold|C0009264|0|Cold Temperature
    	Cold|cold|C0009443|0|Common Cold
    	Cold|cold|C0010412|0|Cold Therapy
    	Cold|cold|C0024117|0|Chronic Obstructive Airway Disease
    	Cold|cold|C0234192|0|Cold Sensation
    	Cold|cold|C0719425|0|Cold brand of chlorpheniramine-phenylpropanolamine
    	Cold|cold|C1949981|0|Colds homeopathic medication
    	

Please refer to STMT documents for how to use STMT (Help -> Documents (h))

Others

Please note that the stmt executable file includes:

  1. ${STMT_DIR}/lib/stmt2013dist.jar file in the CLASSPATH environment variable to include all STMT Java classes, HSqlDb classes, etc.

  2. ${STMT_DIR}, the full path of the top directory of stmt2013, in the CLASSPATH environment variable. This allows STMT to find the default configuration file, ./data/Config/stmt.properties