vgritsenko 02/03/11 07:17:15
Modified: src/documentation/xdocs/installing index.xml
Log:
add a note about headless JDK1.4
Revision Changes Path
1.13 +21 -7 xml-cocoon2/src/documentation/xdocs/installing/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/installing/index.xml,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- index.xml 5 Mar 2002 04:37:23 -0000 1.12
+++ index.xml 11 Mar 2002 15:17:15 -0000 1.13
@@ -146,20 +146,34 @@
(SVG rasterization toolkit) to deliver SVG imaging capabilities. Batik
uses Java
<code>java.awt</code> library, which (at least in Sun JDK before 1.4)
requires
graphics display. This means that X server must be running and Cocoon
should
- have permission to connect to it.
- </p>
+ have permission to connect to it.</p>
+
<p>Easiest way to avoid X server connection problem (and to have mentioned
permission)
is to install and run Cocoon and entire servlet engine of your choice
under regular
- user account.
- </p>
+ user account.</p>
+
<p>For security, and many other reasons, X server can be replaced by Xfvb
or PJA (alternative awt implementation).</p>
- <note>Sun JDK 1.4 does not require graphics display anymore.</note>
+
+ <note>Sun JDK 1.4 does not require graphics display anymore, but Java has
to be
+ started with the argument <code>-Djava.awt.headless=true</code></note>
</s2>
<s2 title="Headless UNIX and PJA">
- <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
+ <p>If you are using unix with the Sun JDK 1.4, it can run in the
+ headless environment when following option is provided on Java
+ startup:</p>
+
+ <source>-Djava.awt.headless=true</source>
+
+ <note>If you use Tomcat, this can be done by setting environment variable
+ CATALINA_OPTS (Tomcat 4.x), or TOMCAT_OPTS (Tomcat 3.x):</note>
+
+ <source>export CATALINA_OPTS='-Djava.awt.headless=true'</source>
+
+ <p>If you are using unix with the Sun JDK 1.3.1 or earlier, 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>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
