Installation Instructions



Introduction

Thank you for downloading the Sub-Term Mapping Tools Java. This package includes one compressed file -- stmt2013.tgz.

Requirements

Installation

  • Download
    Download the stmt2013.tgz file from
    Sub-Term Mapping Tool web site

  • Uncompress
    Uncompress and un-archive this file into the location where you intend to have it installed. On a Linux machine, this would look like:
    shell> gtar -xzvf stmt2013.tgz

    If you are on a Windows platform, PKZIP and WinZip may be used to uncompress and un-archive this file. Please make sure the file you download has the right extension (tgz) before you unzip it. WinZip looks into the file to check if there is tar file within it, and it asks if it should create a temporary file with the tar file in it. The proper response is to allow this to happen. Once the temporary file has been created, WinZip reads it and displays the archive as it would any other zipped file. Unzip the resulting contents to the location you want to install to. Make sure that you preserve the directory structures when un-archiving.

    Once the files are in place, change the directory to the top level. This should be stmt2013. If you are on a windows platform, this will involve opening up a DOS command window (Start -> run -> cmd), and changing directories to where you have put these files. We will henceforth refer to this top level directory as the ${STMT_DIR} directory.

  • Install
    Invoke the appropriate installation command from the ${STMT_DIR} directory. These are installation scripts appropriate to the platforms we know about:

    PlatformsInstallation Scripts
    Linuxinstall_linux.sh
    Windowsinstall_win.bat

    Please do NOT run above scripts in the ${STMT_DIR}/install/bin directory.

    The scripts shown above will install a copy of the JRE (optional), then proceed to alter the configuration file settings to set the install location. If you install STMT on a PC platform, choose NOT to restart your computer after JRE is installed. You may restart your computer after finishing STMT installation.

    If you have lvg installed, you can use the lvg configuration file, lvg.properties by input the fll path during the installation. If not, the script will use a default lvg configuration file come with STMT package.

    Then, the script will create shell files in the ${STMT_DIR} bin directory for each of the lexical tools, with the proper environment set up. Also, it creates STMT configuration files under ${STMT_DIR}/data/Config directory.

    Once done, the script will attempt to verify that the installation was successful.

    If the installation was successful, there will be a congratulation message that finishes off this process.

    If the installation is not successful, there will be a message indicating so. Please refer to the ${STMT_DIR}/logs directory for a complete transcript of the process. It is likely that there were error messages indicating the source of the failure.

After a successful installation

The Sub-Term Mapping Tools package is now ready to be used. It can be found in the ${STMT_DIR}/bin directory. On the Linux platforms, they include the following shell scripts:

On the Windows platform, they include the following batch files:

  • lsf.bat
  • mt.bat
  • nt.bat
  • smt.bat
  • stmt.bat

ST MT may be used from any location on the machine. If you put the ${STMT_DIR}/bin path in your $PATH environment variable they do not have to be referenced with the whole path.

An Example Installation

Altering your environment to use the STMT, once they have been installed

You may invoke these tools from a command line. These tools are found in the ${STMT_DIR}/bin directory. You can add this ${STMT_DIR}/bin path to your ${PATH} environment variable. This would enable you to find and run these tools from any location.

In Linux, this would be done by adding this path to your ~/.cshrc or ~/.profile startup script.

In Windows, this would be done by appending this path to the PATH variable from the control panel->System->Advanced system settings->Environment variable->System variables->Path->Edit menu.

Manual installation (for platforms other than Linux or MS Windows)

The manual installation page shows details of how the installation script configures and installs Sub-Term Mapping Tools. Manual installation is used for developers or end users who want to install STMT in other platforms, such as Mac or Unix. Users may skip this section if they use installation script to install Sub-Term Mapping Tools.