Imago Requirements

• A Java runtime (JRE) version 1.3.1 or above. A complete Java SDK is needed to compile the source code.
• A servlet container such as Apache Tomcat or JBoss .
• Apache Xalan XSLT processor for transforming XML documents into HTML, text, or other XML document types. Preferably version 2.3.1 or above.
• Jakarta ORO , version 2.0.4 or above, for regular-expression processing.
• Jakarta Log4J for flexible log file handling.
• The Xenei Utilities .

Optional Packages

• A JDBC driver and the LDBC package if you wish to use the database caching mechanism of Imago. The JDBC driver must be one of those supported by LDBC.
• Apache Ant version 1.5.2 or above if you plan to compile the source code.
• The ImagoX Extensions package of standard and contributed Imago XSLT extensions.

Imago Configuration Notes

The complete configuration of Imago in a servlet container is beyond the scope of this documentation. This documentation assumes you understand how your servlet container (e.g. Tomcat or JBoss) works and how to deploy new applications within that container.

Imago uses four basic configuration files:

• imago.properties : The location and name of this file must be specified in the properties init-param for the servlet. An example can be found in the /webapps/imago/WEB-INF/web.xml file. This file defines the basic parameters of the servlet. In addition extension elements often require their configuration to be placed here as well.
• log4j.properties : The location and name of this file must be specified in the log.config init-param for the servlet. An example can be found in the /webapps/imago/WEB-INF/web.xml file. This file defines the logging properties for the servlet.
• ClientMap.xml : The location and name of this file is defined in the imago.properties file. It specifies how to map user-agent strings to client types.
• ProcessMap.xml : The location and name of this file is defined in the imago.properties file. It specifies how to transform requested XML documents into a format understood by the client.