Internet Express for Tru64 UNIX Version 6.8 Administration Guide (14233)

8.3 Apache Cocoon Servlet Administration
The IAEXML subset installs and configures the Apache Cocoon Servlet. Prerequisite subsets
include the IAETOMCAT and IAEXMLJLIB subsets. The Apache Cocoon Servlet will be configured
on all available public instances of the Secure Web Server (1.3 and 2.0) and Tomcat.
Cocoon can be used for the automatic creation of HTML from XML files as well as XSL:FO
rendering to PDF files. It also can be used for client-dependent transformations such as WML
formatting for WAP-enabled devices. For more information on Cocoon's capabilities, see the
Cocoon documentation at:
http://xml.apache.org/cocoon
Internet Express Version 5.9 upgraded Cocoon is to the Cocoon Version 2 code level. Because
Cocoon Version 2 is nearly a complete rewrite of the original Cocoon project, to serve custom
pages you must add configurations to the sitemap.xmap configuration file located in the
/usr/internet/httpd/tomcat/cocoon directory. In addition, the main cocoon configuration
file has changed and is now called cocoon.xconf. This file is located in the
/usr/internet/httpd/tomcat/cocoon/WEB-INF directory. See the comments in these
files and Cocoon documentation for more information on customizing the Cocoon configuration.
8.3.1 Managing the Apache Cocoon Servlet
When you install the IAEXML subset, a Web application directory is created in
/usr/internet/httpd/tomcat/cocoon. Place all files needed by the Cocoon Servlet in this
directory.
Code examples, included in the IAEXML subset, can be accessed from the following Web site:
http://localhost:port/cocoon/samples/
8.3.2 Enabling and Disabling the Cocoon Servlet
To enable or disable the Cocoon Servlet:
1. From the Manage Components menu, under XML Tools, choose Apache Cocoon Servlet.
The Apache Cocoon Servlet page is displayed.
2. From the Apache Cocoon Servlet page, choose Enable/Disable Apache Cocoon Servlet. The
current status of the Cocoon Servlet is displayed (that is, enabled or disabled).
3. If the status of the Apache Cocoon Servlet is enabled, click on the Disable button to disable
the servlet. Conversely, if the current status is disabled, click on the Enable button to enable
the servlet.
After you enable or disable the Apache Cocoon Servlet, the AdministrationSecure Web Server
utility makes the necessary configuration changes and the public instances and Tomcat process
are restarted as necessary. A status message is displayed. This process will enable or disable the
Cocoon Servlet on all available public instances of the Secure Web Server (1.3 and 2.0) and Tomcat.
8.3.3 Viewing the Cocoon Log Files
Cocoon logs information in the /usr/internet/httpd/tomcat/cocoon/WEB-INF/logs
directory in the following files:
access.log— Contains information on which pages were requested, the time of request,
and the processing time required.
core.log Provides warning and error messages produced by Cocoon's core components.
error.log— Contains all error messages produced by the Cocoon servlet.
sitemap.log— Provides warning and error messages related to the sitemap components
of Cocoon.
To view the log files from the Administration utility:
8.3 Apache Cocoon Servlet Administration 169