Predictive Text-Mining Software

For readers of our books we provide free single-user single-machine licenses for our Text-Mining Software Kit (TMSK) and Rule Induction Kit for Text (RIKTEXT).

Please read the licenses carefully as you will be required to accept the terms of licenses before downloading the software.

Installation instructions are available in the online documentation and are also provided below for convenience:

• Installing TMSK
• Installing RIKTEXT

TMSK Installation Instructions

TMSK is available for any hardware that has a java interpreter (version 1.3.1 or higher). Its modules are run as java applications with command-line arguments. Java must be installed on the hardware. To verify that java is installed on your system, is accessible and is the appropriate version, type "java -version" in a shell window (for PC-Windows, an MS-DOS or command-prompt window). If you don't have java, you first need to obtain and install it (a process that we do not describe here. Refer to your administrator or consult web resources for java installation). TMSK will not run without java.

Assuming that you have java running on your system, the TMSK installation consists of the following steps:

• Create a directory named "tmsk" and download the appropriate install file from the data-miner.com website to this directory:
  • Windows: Working in an MS-DOS or command-prompt window, save as "installtmskj.exe"; type "cd \tmsk" to connect to the directory; and finally type "installtmskj" to run the installtmskj.exe program which will install TMSK.
  • Unix/Linux: Save as "tmskj.tgz"; connect to directory "tmsk"; and finally type the command "tar -xvzf tmskj.tgz" which will install TMSK.
• Make sure that the file tmsk.zip appears in the tmsk directory. DO NOT UNZIP tmsk.zip.
• Add the full path for tmsk.zip to the environment variable CLASSPATH. Also add the current directory to the CLASSPATH. The process depends on your operating system. For example, in Windows XP, click on the System icon in Control Panel (in the "Performance and Maintenance" category), then on the Advanced tab click "Environment Variables", then click "New" to add variable CLASSPATH with value ".;c:\tmsk\tmsk.zip" (if tmsk.zip resides in the directory c:\tmsk) or, if CLASSPATH already exists, click "Edit" and add ".;c:\tmsk\tmsk.zip" to the existing value of CLASSPATH. The same process works for Windows NT/2000. For older PCWindows 9x, add "set classpath=.;c:\tmsk\tmsk.zip" to the autoexec.bat file. For other operating systems, consult their documentation on how to add environment variables.
• Notes: The TMSK programs are run from shell windows (For PC-windows, in an MS-DOS or command-prompt window). The environment changes may not take effect until the next login or restart. A drive other than c: may be used. Make sure both the current directory and the tmsk.zip directory are in the CLASSPATH.

Verifying the Installation

If the installation was successful, the user should be able to type the command "java mkdict" without arguments in any directory and get a message on usage. If, instead, an error message is obtained, make sure that the tmsk directory has the tmsk.zip file and that the CLASSPATH variable is properly set and has taken effect.

Cleaning Up

Following successful installation, the following files may be deleted or moved to backup storage:

• For Unix/Linux: tmskj.tgz
• For Windows: installtmskj.exe

RIKTEXT Installation Instructions

RIKTEXT is available for PC-Linux, and Windows. The installation process differs for each.

Linux Installation

The linux installation consists of the following steps:

• Create a directory named riktext ("mkdir riktext")
• Download the file from the data-miner.com website to directory "riktext" and save as "riktext.tgz"
• Type "tar -xvzf riktext.tgz"
• Add the directory "riktext" to your path

Windows Installation

The windows installation consists of the following steps (most of them require the user to type commands in either a command-prompt or MSDOS-prompt window):

• Create a directory named riktext ("mkdir c:\riktext")
• Download the file from the data-miner.com website to c:\riktext and save as "installriktext.exe".
• Type "cd \riktext" and run installriktext.exe by typing "installriktext".
• Add directory "\riktext" to your path and set environmental variable LFN to y.
  • Windows 9x: edit autoexec.bat using "notepad c:\autoexec.bat"; add "c:\riktext;" to the PATH line. (Alternative: add new line "PATH c:\riktext;%PATH%" at the end of the file). Also add new line "set LFN=y" (enables long file names). A single space follows the words "PATH" and "set". These lines should contain no additional spaces.
  • Windows NT/2000/XP: click on the System icon in Control Panel (in XP, its in the "Performance and Maintenance" category), then on the Advanced tab click "Environment Variables", then click "Edit" to add "c:\riktext;" (no spaces) to the environmental variable PATH. Create the environmental variable LFN and set it to a value of y.

Notes: The RIKTEXT program is run from an MS-DOS (or command-prompt) window. The path and environment changes may not take effect until the next login or restart. A disk other than c: may be used.

Verifying the Installation

If the installation was successful, the user should be able to type the command "riktext" without arguments in any directory and get usage instructions (as shown in the documentation). If, instead, a "command not found" message is obtained, make sure that the riktext directory has the program (check for the file "riktext" or "riktext.exe"), that the program's executable permission is switched on, and that the path variable is changed and has taken effect.

Cleaning Up

• For Linux: riktext.tgz
• For Windows: installriktext.exe