The question about a requirement for X has come up over and over again. Also, tomcat
4 is released now. This patch removes the discusion about installing a custom servlet
and adds a short section about how to replace suns awt.
This patch is against the installing/index.xml document from HEAD. I assume it's the
same as the cocoon2 branch. I'd kind of like this to go into cocoon2.0 final if it's
possible.
Tim Myers
Index: index.xml
===================================================================
RCS file: /home/cvspublic/xml-cocoon2/documentation/xdocs/installing/index.xml,v
retrieving revision 1.2
diff -u -r1.2 index.xml
--- index.xml 2001/10/25 14:58:42 1.2
+++ index.xml 2001/11/26 03:04:34
@@ -272,43 +272,11 @@
</s2>
<s2 title="Installing on Tomcat 4.X">
-
- <p>Note that Tomcat-4.0 beta1 will not work with Cocoon. You
- must use Tomcat-4.0 beta3 or beta7, or a nightly build from
- <link
href="http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/";>http://jakarta.apache.org/builds/jakarta-tomcat-4.0/nightly/</link>.
- Tomcat-4.0 beta7 works with Cocoon out of the box.
- </p>
-
- <p>Recent builds of Tomcat 4 have largely solved the xml library problem
- described above. However Tomcat 4.X is not currently released, and the
- flip side of easier installation is alpha code. It is not recommended
- that you use Tomcat 4.X for production servers yet.
- (Having said that, I do :-)</p>
-
-
- <p>Tomcat 4.0 versions prior to beta7 do not expose the servlet.jar file to
Cocoon by default,
- so if you use any Tomcat 4.0 versions released earlier than beta7,
<strong>before you build the Cocoon webapp</strong> you will need to
- add the following to the Cocoon servlet definition in the web.xml file:</p>
-
- <source>
- <init-param>
- <!-- change param value to path to Catalina's servlet.jar -->
- <param-name>extra-classpath</param-name>
- <param-value>path\to\tomcat\common\lib\servlet.jar</param-value>
- </init-param>
- </source>
-
- <ol>
-
- <li>
- <strong>Modify cocoon/webapp/WEB-INF/web.xml</strong>
- Add the code shown above to the Cocoon web.xml file
- </li>
-
+ <p>Tomcat 4 is a really straight-forward installation.</p>
+ <ol>
<li>
<strong>Build the Cocoon webapp</strong>
- Build the webapp as described above. This will now include
- the corrected web.xml file.
+ Build the webapp as described above.
</li>
<li>
@@ -330,7 +298,29 @@
</li>
</ol>
-
+ <s3 title="Linux/Headless/Batik">
+ <p>If you are using unix with the sun jdk, it's awt implementation requires
+you to use X
+ even if you aren't actually displaying anything. One simple solution is to
+use a different
+ implementation of the awt.</p>
+
+ <ol>
+ <li>From www.eteks.com you can get an awt replacement that doesn't need X:
+ <link
+href="http://www.eteks.com/pja/en/";>http://www.eteks.com/pja/en</link>.</li>
+
+ <li>Unpack the jars into a place where your jdk will be able to use them--
+ $JAVAHOME/jre/classes works for j2sdk1.3</li>
+
+ <li>Then add to your tomcat startup script:
+ <source>
+export CATALINA_OPTS='-Dawt.toolkit=com.eteks.awt.PJAToolkit \
+ -Djava.awt.graphicsenv=com.eteks.java2d.PJAGraphicsEnvironment \
+ -Djava.awt.fonts=/usr/local/jdk/jre/lib/fonts/'
+ </source>
+ <p>(CATALINA_OPTS if it's 4, TOMCAT_OPTS if it's 3)</p>
+ </li>
+ <li><strong>(Re)start Tomcat and enjoy!</strong></li>
+ </ol>
+ </s3>
</s2>
<s2 title="Installing on BEA Weblogic 6.0">
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]
