Book: Software installation

min. 150 MB free hard disk space (includes space required during installation)

Please note: For Microsoft Windows, Linux and Solaris, the required Java Runtime Environment (JRE) is bundled with the respective download version of the TIGERSearch software. For Mac OS X, the JRE is part of the operating system installation.

2. Installation instructions

2.1 Windows

The installation on the Windows platform is realized by a self-extracting .exe file that also comprises the Java Virtual Machine which is necessary for using TIGERSearch. To install the TIGERSearch software suite on the Windows platform the following steps are necessary:

Double-click the installation file. The installation of TIGERSearch will be started.

Choose the destination directory. We recommend you to use the default destination directory c:\TIGERSearch.

Please note: Do not choose a destination path that comprises space characters
(e.g. c:\Program Files\TIGERSearch). Java-based programs often do not work properly if installed in such a destination directory.

Choose the shortcut directory. The installation tool will place links to the TIGERSearch and TIGERRegistry program in this directory. Please note that links to the HTML and PDF versions of the TIGERSearch User's Manual are also placed in the shortcut directory. It is recommended to choose the option Create a new Program Group for the TIGERSearch tool.

Start the TIGERSearch or TIGERRegistry program from the created Program Group (cf. subsection 1.1, chapter IV and subsection 2.1, chapter VI, respectively).

Enter the Windows System Control. Open the Software Properties. Mark the TIGERSearch entry in the software list and click the Remove button to start the uninstall process.

2.2 Unix (Linux/Solaris)

The installation on the Unix platform (Linux and Solaris) is realized by self-extracting .bin files that also comprise the Java Virtual Machines which are necessary for using TIGERSearch on Linux and Solaris. To install the TIGERSearch software suite on the Linux or Solaris platform the following steps are necessary:

Start the binary installation file.

Please note: The binary file must be executable, i.e. the file permission must be set to rwx (chmod u+rwx filename).

Choose the shortcut directory. The installation tool will place links to the TIGERSearch and TIGERRegistry program in this directory. For example, you might choose /usr/local/bin, /usr/bin or ~/bin. Please note that HTML and PDF versions of the TIGERSearch User's Manual are placed in the doc/ subdirectory of the destination directory.

Start the TIGERSearch or TIGERRegistry program by using the shortcuts created by the installation tool. If you did not create shortcuts, TIGERSearch and TIGERRegistry executables are located in the bin/ subdirectory of the installation directory. (cf. subsection 1.1, chapter IV and subsection 2.1, chapter VI, respectively).

Enter the UninstallerData/ subdirectory of the destination directory. Start the uninstall script Uninstall_TIGERSearch.

Please note: The script must be executable, i.e. the file permission must be set to rwx (chmod u+rwx filename).

2.3 Mac OS X

The installation on the Mac OS X platform is realized by a self-extracting .zip file. To install the TIGERSearch software suite on the Mac OS X platform the following steps are necessary:

After downloading, the Mac installer included in the .zip file will be automatically recognized and decoded by Stuffit Expander. If your system does not handle the file automatically, download and install a current version of the StuffIt Expander software (cf.

http://www.aladdinsys.com/expander/).

After downloading ( http://www.tigersearch.de), a new icon named tssetup is placed on your desktop. Double-click this icon. The installation of the TIGERSearch suite will be started.

Choose the destination directory (typically the directory where programs are installed on your system).

Choose the alias folder. The installation tool will place links to the TIGERSearch and TIGERRegistry program in this directory. We recommend you to choose the option Place into Home Folder. Please note that links to the HTML and PDF versions of the TIGERSearch User's Manual are also placed in the alias folder.

Start the TIGERSearch or TIGERRegistry program by clicking the corresponding icon in your dock.

Enter the UninstallerData/ subdirectory of the destination directory. Double-click the Uninstall_TIGERSearch icon.

3. Internationalization

3.1 Unicode fonts

As the TIGERSearch software suite has been entirely implemented in Java, it is able to process corpora using the Unicode encoding. For the import of corpora, an XML-based approach is used to read any Unicode characters (cf. chapter V). The query processor is also able to process Unicode characters (cf. subsection 3.3, chapter IV).

As a platform-independent software, the TIGERSearch software suite is not able to analyze the font configuration of the user's platform in order to automatically detect an appropriate Unicode font. Therefore only the following two popular Unicode fonts are supported by the software:

Arial Unicode MS (Arialuni.ttf, 52,000 characters; 23 MB installed)

This font package is not freely available. However, it is included in the following commercial software packages: Microsoft Windows XP, Microsoft Office 2000, and Microsoft Publisher. You can easily check in the Windows System Control if the font package has already been installed on your computer. Otherwise, you will find the package on the CD-ROM of your commercial software.

Cyberbit Bitstream (Cyberbit.ttf, 30,000 characters; 12.5 MB installed)

This font package is freely available on the following web page: ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/. Please pay attention to the license agreement of the font package.

If one of these two font packages has been installed on your system, the TIGERSearch software will automatically detect and use it. Please consult the manual of your operating system how to install font packages on your computer.

Please note: If you are working on a system where you do not have the user rights to install a font package, but you have already installed the TIGERSearch system on your computer, there is a workaround to install the font package to be used by the TIGERSearch software only: Just copy the font file (suffix .ttf) to the following subdirectory of the TIGERSearch installation directory: jre/lib/fonts/

3.2 Input methods

If you have installed a Unicode font package to be used by the TIGERSearch software, TIGERSearch will be able to display any Unicode character which is supported by the font package. However, typing in Unicode characters is a different story. So how can you type in a Unicode character in the corpus query editor, e.g. the Greek capital letter Omega?

On most platforms, specialized tools have been developed for this purpose. These tools are usually called input methods. As e.g. Greek characters do not exist on a German keyboard, these charaters are typed in as an abbreviation. For example, the string Omega might be used as an abbreviation for the Greek character that will be automatically expanded if the abbreviation has been typed in. Please consult the manual of your operating system to find out which tools are available for your platform.

For the TIGERSearch software we have developed Java-based input methods for 16 European languages (in alphabetic order): Czech, Danish, Dutch, Finnish, French, German, Greek (classic and modern), Hungarian, Italian, Latin, Norwegian, Portugese, Romanian, Spanish, Swedish, and Turkish.

These input methods are automatically plugged into the TIGERSearch software suite during the installation process. In subsection 3.3, chapter IV you will find detailed instructions how to use the TIGERSearch input methods for typing in Unicode characters in your corpus queries. A description of the language mapping tables (file europe.pdf) is placed in the doc/pdf/ subdirectory of your TIGERSearch installation.

Readers who are interested in the implementation of the input methods should consult the TIGERSearch homepage for additional information.

4. Software suite preferences

The main memory configuration of both the TIGERSearch and TIGERRegistry tool and the corpus base directory used by the two tools can be modified in the Software suite preferences window. It is opened by selecting the Software preferences item in the Options menu of the TIGERRegistry tool:

Whereas the TIGERRegistry tool will always work fine if you have the required 256 MB main memory on your system, the TIGERSearch tool could lack on main memory if you work with very large corpora. Unfortunately, a typical feature of Java applications is that the initial main memory size (used when starting an application) and the maximum main memory size (that can be used by an application) have to be specified before the application is launched. So if you have more than 256 MB main memory installed on your system, this additional memory will not be used automatically.

If you want to increase the maximum main memory used by the TIGERSearch tool, just type in the new memory size in the max text field. We recommend you also to increase the initial memory used when an application is started - preferably a quarter of the maximum main memory. This will increase the corpus loading speed.

The TIGERRegistry tool should work without any problems using 256 MB memory. Nevertheless you can also change its memory configuration.

The corpus base directory used by the TIGERSearch software suite is created during the software installation as a subdirectory TIGERCorpora of the installation directory.

You can move the directory to another location (e.g. to another hard disc drive) as follows:

If you modified the memory or corpus directory configuration, press the Submit button. The modifications will be checked and the software suite configuration will be changed. As the status of the sofware suite has changed, the TIGERRegistry tool will be closed automatically. To profit from the new software configuration you will have to restart your current TIGERSearch session.

Please note: The modification of the software configuration files is realized in a platform-independent way. Thus, the file permissions of the modified configuration files may change, depending on your default settings. So if you have installed the TIGERSearch software on a multi-user system, please check the file permissions of the modified configuration files. These are the two files TIGERSearch.lax and TIGERRegistry.lax in the bin/ subdirectory of your TIGERSearch installation directory.

II. Software installation

1. General system requirements