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
- Archive program:
- Linux: gtar
- Windows: WinZip
- JRE V 1.6.0_26 (or later)
- 3.0 Gb disk space
Setup
Use 2013 release as example
- Create a new directory for the Sub-Term Mapping Tools on your machine.
- Download the zip archive: stmt2013.tgz, and place it in the newly created directory. "2013" is the version identification (year).
- 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
- Make sure your Java version is 1.6.0_26 or later (
java -version
)
Manual Installation
- Let's say the path of top directory of stmt2013 is ${STMT_DIR}, such as:
/Users/stmt/stmt2013
- 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
- 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:
- 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:
- ${STMT_DIR}/lib/stmt2013dist.jar file in the CLASSPATH environment variable to include all STMT Java classes, HSqlDb classes, etc.
- ${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