[ You are here:
XTF ->
Deployment Guide -> Run-Time Environment Installation/Configuration ]
Run-Time Environment Installation/Configuration
Successfully running the XTF tools and servlets depends on the prior installation and configuration of a minimum run-time environment. This environment consists of the
Java run-time environment and a servlet container to run the
dynaXML and
crossQuery servlets.
The installation and configuration of each of these run-time environment components is discussed in turn in the following sub-sections. Once these items are installed and configured, the XTF system may be installed and run.
Java
Since the dynaXML and crossQuery servlets and textIndexer are all Java programs, you need to install the Sun Microsystems
Java 2 Platform Standard Edition (J2SE) , version 1.5.0 or higher. The J2SE run-time can be downloaded directly from Sun via
this page.
Since the J2SE package is a separate package maintained by Sun Microsystems, its installation and configuration is beyond the scope of this document. Please refer to Sun's own installation and configuration instructions for the J2SE.
Servlet Container
For the
dynaXML and
crossQuery servlets to be accessible on-line, they must be run under a
Servlet Container application. At this time, the
XTF system is known to work with the
Apache Tomcat and
Caucho Resin servlet containers. Please download one or the other of these servlet containers, and follow the accompanying instructions on how to install and configure the selected container.
Note: it has been reported that Tomcat version 4.1.27 is
not compatible with XTF. If you are running this version or a version very close to it, it is recommended that you upgrade to Tomcat 5.x.
Included Libraries (no installation required)
The XTF distribution also includes two libraries,
Saxon and
Lucene, needed for proper operation. Generally no configuration will be required for these, unless other servlets are to be run in the same servlet container that require different versions of Saxon and/or Lucene. The code in XTF is customized to work very closely with both of these libraries, so it is not currently possible for XTF to use different versions than those included with the distribution.
The source text documents that are indexed and queried by the XTF system are
XML based documents. Consequently, dynaXML, crossQuery, and textIndexer all use Michael Kay's
Saxon Library for Java to parse the structure of the source documents and run stylesheets to transform them in various ways.
The textIndexer tool uses a library called
Lucene to construct a search index of the XML source text documents in an XTF system. The crossQuery servlet then uses the resulting index to locate matching documents based on user generated queries. If queries are used in dynaXML, it also utilizes Lucene to perform them.