The dtSearch Engine for Linux

Product Information and Licensing

The dtSearch Text Retrieval Engine for Linux provides a way for C++ and Java developers to incorporate dtSearch text retrieval functions into their applications for the Linux platform. No dtSearch end-user products are currently available for Linux so some C++ or Java programming is needed to make any use of the Linux version. An Apache/Linux equivalent to the "dtSearch Web" product currently offered for Windows is planned but not yet available.

The dtSearch Engine for Linux is dynamically linked with these libraries:

    libz.so.1
    linux-gate.so.1
    libz.so.1
    libpthread.so.0
    libdl.so.2
    libstdc++.so.6
    libm.so.6
    libgcc_s.so.1
    libc.so.6
    /lib/ld-linux.so.2

The dtSearch Engine is built with GCC 4.1.3 under Ubuntu Linux 7.1. Because of GCC compatibility issues, applications that use the dtSearch Engine for Linux must be compiled with GCC 4.

The Java API requires Java version 1.4.1 or later.

Using the dtSearch Engine in C++

See the textdemo sample application, in <dtsearch>/examples/cpp/textdemo, for an example demonstrating how to build a C++ application using the dtSearch Engine.

To build the application:

cd dtsearch/examples/cpp/textdemo

make -f linux32.mak textdemo

make -f linux32.mak run

Making the "textdemo" target compiles and links the textdemo application.

Making the "run" target runs the application. (Because textdemo is dynamically linked to the dtSearch Engine library (libdtsearch.so.6.0), it will not execute unless LD_LIBRARY_PATH includes the folder where the dtSearch Engine library is located.)

To build and run the 64-bit version of textdemo:

cd dtsearch/examples/cpp/textdemo

make -f linux64.mak textdemo

make -f linux64.mak run

Using the dtSearch Engine in Java

For Java classes and sample code, see the <dtsearch>\examples\java folder. The Java interface to the dtSearch Engine is based on the Java Native Interface (JNI). Therefore, both the Java classes and a platform-specific binary executable are needed to use it.

The Java classes are in this file:

dtsearch/examples/java/classes/dtSearchEngine.jar

This file must be on the CLASSPATH. Adding the dtSearch examples/java/classes folder to the CLASSPATH, or copying its contents to a folder on the CLASSPATH, will make these classes available in Java.

Under Linux, the binary executable is libdtsearch.so, which must be accessed through a symbolic link named libdtsjava.so. To run the jdemo sample application:

cd dtsearch/examples/java/classes

chmod +x runjdemo.sh

./runjdemo.sh

If you get a Java "Unsatisfied Link" exception, it means that the necessary symbolic links are not set up in dtsearch/lib. To correct this:

cd dtsearch/lib

chmod +x makelinks.sh

./makelinks.sh

API Documentation

For API documentation, see help\dtSearchApiRef.chm and help\dtSearchJavaApi.chm in the Windows installation of the dtSearch Engine.

An HTML version of this help is included with the Linux version of the dtSearch Engine in dtSearchApiRef.zip and dtSearchJavaApi.zip.

The documentation is also available online: dtSearch Api Reference and dtSearch Java API

Differences between the dtSearch Engine for Linux and the dtSearch Engine for Windows

The dtSearch Engine for Linux includes all features of the Windows version except: (1) the COM interface, and (2) support for indexing of Microsoft Access databases via ODBC.