You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by na...@apache.org on 2002/06/30 05:32:02 UTC

cvs commit: jakarta-tomcat-connectors/jk/xdocs configweb.xml index.xml style.css.in style.xsl.in

nacho       2002/06/29 20:32:02

  Modified:    jk/xdocs configweb.xml index.xml style.css.in style.xsl.in
  Log:
  Adding some more docs,  i dont know already wich is the good layout for the components and his properties.. :), i hope we found it sound
  
  Revision  Changes    Path
  1.3       +539 -206  jakarta-tomcat-connectors/jk/xdocs/configweb.xml
  
  Index: configweb.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/configweb.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- configweb.xml	20 Jun 2002 20:38:41 -0000	1.2
  +++ configweb.xml	30 Jun 2002 03:32:01 -0000	1.3
  @@ -1,79 +1,438 @@
   <?xml version="1.0"?>
   <document>
  -  <properties>
  -    <title>Configuration in the Web Server</title>
  -    <author email="cmanolache@yahoo.com">Costin Manolache</author>
  -    <author email="jfrederic.clere@fujitsu-siemens.com">Jean-Frederic Clere</author>
  -  </properties>
  -
  -<section name="Intro">
  -<p>
  +    <properties>
  +        <title>Configuration in the Web Server</title>
  +        <author email="cmanolache@yahoo.com">Costin Manolache</author>
  +        <author email="jfrederic.clere@fujitsu-siemens.com">Jean-Frederic Clere</author>
  +    </properties>
  +    <section name="Intro">
  +        <p>
     This document describes the configuration file used by mod_jk2 on the
     Web Server site. Its default name is ${serverRoot}/conf/workers2.properties,
     where ${serverRoot} is something like /opt/apache.
   </p>
  -</section>
  -
  -<section name="Config options">
  -<p>
  +    </section>
  +    <section name="Installation">
  +        <subsection name="Apache 1"/>
  +        <subsection name="Apache 2"/>
  +        <subsection name="IIS"/>
  +    </section>
  +    <section name="Config file"/>
  +    <section name="Components">
  +        <p>Common properties for all components</p>
  +        <p>
  +            <table>
  +                <tr>
  +                    <th>Property name</th>
  +                    <th>Default</th>
  +                    <th>Description</th>
  +                </tr>
  +                <tr>
  +                    <td>disabled</td>
  +                    <td>0 (false)</td>
  +                    <td>"disabled" state for the component, 1=true 0=false</td>
  +                </tr>
  +                <tr>
  +                    <td>debug</td>
  +                    <td>0 (false)</td>
  +                    <td>"debug" state for the component, 1=true 0=false</td>
  +                </tr>
  +            </table>
  +        </p>
  +        <subsection name="workerEnv">
  +            <p>This component represent the core jk2, this has the default logger for all other components</p>
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>logger</td>
  +                        <td>logger</td>
  +                        <td>Default loger used by jk2 components, can be changed in the config file, normally it defaults to "logger" the Alias for the default logger for the Server/platform.</td>
  +                    </tr>
  +                    <tr>
  +                        <td>timing</td>
  +                        <td>0</td>
  +                        <td>Will jk2 get request timing (needs APR?)</td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +        <subsection name="config">
  +            <p>The config component, hold the detail of the conifg system, such config file name, create global defines</p>
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>debugEnv</td>
  +                        <td>0</td>
  +                        <td>Set the debug level of the hidden env component </td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +        <subsection name="uriMap"/>
  +        <subsection name="shm">
  +            <p>Shared memory descriptor</p>
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>file</td>
  +                        <td>No default value</td>
  +                        <td>Name of the file that will be mmapped to use as shared memory.</td>
  +                    </tr>
  +                    <tr>
  +                        <td>size</td>
  +                        <td>No default value</td>
  +                        <td>Size of the file.</td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +        <subsection name="uri">
  +            <p>Maps a resource to a worker</p>
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>worker</td>
  +                        <td>lb:0 (The default loadbalancer)</td>
  +                        <td>Name of the worker that process the request corresponding to the uri</td>
  +                    </tr>
  +                    <tr>
  +                        <td>context</td>
  +                        <td/>
  +                        <td>the context that will be served by this uri component (webapp style)</td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +        <subsection name="vm">
  +            <p>Represents the JVM when used as inprocess container
  +            </p>
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>JVM</td>
  +                        <td>(Autoguess)</td>
  +                        <td>JVM to use for this vm</td>
  +                    </tr>
  +                    <tr>
  +                        <td>OPT</td>
  +                        <td/>
  +                        <td>Option to pass to this vm, this is a multivalued property</td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +        <subsection name="channels">
  +            <subsection name="channel.un">
  +                <p>
  +    AF_UNIX socket. Only on UNIX like platform. These sockets are faster
  +    than "normal" sockets but they are limited to the machine. 
  +</p>
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>file</td>
  +                            <td>Name of socket</td>
  +                            <td>Name of the socket file (It is created by the Tomcat ChannelUn)</td>
  +                        </tr>
  +                    </table>
  +                </p>
  +            </subsection>
  +            <subsection name="channel.socket">
  +                <p>
  +    A communication transport to a remote Engine
  +    <b>Magic:</b> The local part of the name will be the Engine name,
  +    to use when defining the uri mappings. For example
  +    channel.socket.local_9009 will automatically define an engine named
  +    local_9009, and if no other setting is set ajp13 will be used for
  +    communication.
  +    <b>Magic:</b> If no channel is defined in the config, a default channel
  +    will be constructed with port=8009, engine=DEFAULT, worker=ajp13 -
  +    named 'channel.socket.DEFAULT'
  +</p>
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>port</td>
  +                            <td>8009</td>
  +                            <td>Port where Tomcat is listening</td>
  +                        </tr>
  +                        <tr>
  +                            <td>host</td>
  +                            <td>localhost</td>
  +                            <td>Remote host</td>
  +                        </tr>
  +                        <tr>
  +                            <td>keepalive</td>
  +                            <td>0</td>
  +                            <td>? </td>
  +                        </tr>
  +                        <tr>
  +                            <td>lbfactor</td>
  +                            <td>1</td>
  +                            <td>
  +    Load balancing factor to use. At this moment, it'll be set on the worker,
  +    but in future it should be possible to use lb on a channel level.
  +  </td>
  +                        </tr>
  +                        <tr>
  +                            <td>group</td>
  +                            <td>lb:0</td>
  +                            <td>loadbalanced groups to which this channel and the associated worker will be added, multivalued</td>
  +                        </tr>
  +                        <tr>
  +                            <td>tomcatId</td>
  +                            <td>?</td>
  +                            <td>?</td>
  +                        </tr>
  +                    </table>
  +                </p>
  +            </subsection>
  +            <subsection name="channel.jni">
  +                <p>The jni channel, used if tomcat is started inprocess</p>
  +            </subsection>
  +        </subsection>
  +        <subsection name="workers">
  +            <subsection name="jni">
  +                <p>worker used in inprocess, holds the details of the Tomcat class to startup, and paramters to pass</p>
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>class</td>
  +                            <td>org/apache/jk/apr/TomcatStarter</td>
  +                            <td>class that holds the main method called to start tomcat</td>
  +                        </tr>
  +                        <tr>
  +                            <td>ARG</td>
  +                            <td/>
  +                            <td>Arguments to pass to main method when called</td>
  +                        </tr>
  +                        <tr>
  +                            <td>stdout</td>
  +                            <td>NULL</td>
  +                            <td>file to redirect Standard output from the java process</td>
  +                        </tr>
  +                        <tr>
  +                            <td>stderr</td>
  +                            <td>NULL</td>
  +                            <td>file to redirect Standard output from the java process </td>
  +                        </tr>
  +                    </table>
  +                </p>
  +            </subsection>
  +            <subsection name="ajp13">
  +                <p>Default worker</p>
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>secretkey</td>
  +                            <td>NULL</td>
  +                            <td>
  +                                <b>Magic:</b> The secret key will be set automatically on the associated
  +    worker.
  +  </td>
  +                        </tr>
  +                        <tr>
  +                            <td>tomcatId</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>route</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>group</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>level</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>channel</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                    </table>
  +            </p>
  +            </subsection>
  +            <subsection name="status">
  +                <p>Worker that outputs a page with usefull information to monitor JK2</p>
  +                <p>To use it add a uri component assigned to this worker</p>
  +            </subsection>
  +            <subsection name="lb">
  +                <p>Loadbalanced worker</p>
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>worker</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>noWorkerMsg</td>
  +                            <td/>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>noWorkerCode</td>
  +                            <td>503</td>
  +                            <td></td>
  +                        </tr>
  +                        <tr>
  +                            <td>hwBalanceErr</td>
  +                            <td></td>
  +                            <td></td>
  +                        </tr>
  +                    </table>
  +                </p>
  +            </subsection>
  +        </subsection>
  +        <subsection name="loggers">
  +            <p>Any connector based on jk2, at least has a default logger, that can be reached using the "logger" alias, the logger used is the more appropiate for the plataform/server combination, Apache2 under in any platform has logger.apache2 as default, IIS on his only platform uses logger.win32, and Any apache 1 install uses logger.file as default.., the config file lets you change that defaults, you can end using logger.file in IIs i.e</p>
  +            <p>The properties shared by all loggers are:
   <table>
  -
  -  <tr>
  -  <th>Property name</th>
  -  <th>Default</th>
  -  <th>Description</th>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">logger</th>
  -  <td>Log jk messages to a file. Name: 'logger'</td>
  -  </tr>
  -
  -  <tr>
  -  <td>level</td>
  -  <td>INFO</td>
  -  <td>Log level. Supported: ERROR, INFO, DEBUG</td>
  -  </tr>
  -
  -  <tr>
  -  <td>file</td>
  -  <td>${serverRoot}/logs/jk2.log</td>
  -  <td>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <td>level</td>
  +                        <td>INFO</td>
  +                        <td>Log level. Supported: EMERG, ERROR, INFO, DEBUG</td>
  +                    </tr>
  +                </table>
  +            </p>
  +            <subsection name="logger.file">
  +                <p>
  +                    <table>
  +                        <tr>
  +                            <th>Property name</th>
  +                            <th>Default</th>
  +                            <th>Description</th>
  +                        </tr>
  +                        <tr>
  +                            <td>file</td>
  +                            <td>${serverRoot}/logs/jk2.log</td>
  +                            <td>
       Log file.  XXX you may be able to change this at runtime,
                  to implement rolling.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">shm</th>
  -  <td>Shared memory descriptor</td>
  -  </tr>
  -
  -  <tr>
  -  <td>file</td>
  -  <td>No default value</td>
  -  <td>Name of the file that will be mmapped to use as shared memory.</td>
  -  </tr>
  -
  -  <tr>
  -  <td>size</td>
  -  <td>No default value</td>
  -  <td>Size of the file.</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="3">Channels</th>
  -  </tr>
  -
  -  <tr>
  -  <td>debug</td>
  -  <td>0</td>
  -  <td>1 activates the debug of channel.</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">channel.socket</th>
  -  <td>
  +                        </tr>
  +                    </table>
  +                </p>
  +            </subsection>
  +            <subsection name="logger.win32">
  +                <p>logger used in the IIS server by default, it ends at native Application Event Log.</p>
  +            </subsection>
  +            <subsection name="logger.apache2">
  +                <p>Logger used in Apache2 servers, it normally in ends in error.log </p>
  +            </subsection>
  +        </subsection>
  +        <subsection name="old docs">
  +            <p>
  +                <table>
  +                    <tr>
  +                        <th>Property name</th>
  +                        <th>Default</th>
  +                        <th>Description</th>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2" name="logger"/>
  +                        <td>Log jk messages to a file. Name: 'logger'</td>
  +                    </tr>
  +                    <tr>
  +                        <td>level</td>
  +                        <td>INFO</td>
  +                        <td>Log level. Supported: ERROR, INFO, DEBUG</td>
  +                    </tr>
  +                    <tr>
  +                        <td>file</td>
  +                        <td>${serverRoot}/logs/jk2.log</td>
  +                        <td>
  +    Log file.  XXX you may be able to change this at runtime,
  +               to implement rolling.
  +  </td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">shm</th>
  +                        <td>Shared memory descriptor</td>
  +                    </tr>
  +                    <tr>
  +                        <td>file</td>
  +                        <td>No default value</td>
  +                        <td>Name of the file that will be mmapped to use as shared memory.</td>
  +                    </tr>
  +                    <tr>
  +                        <td>size</td>
  +                        <td>No default value</td>
  +                        <td>Size of the file.</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="3">Channels</th>
  +                    </tr>
  +                    <tr>
  +                        <td>debug</td>
  +                        <td>0</td>
  +                        <td>1 activates the debug of channel.</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">channel.socket</th>
  +                        <td>
       A communication transport to a remote Engine
       <b>Magic:</b> The local part of the name will be the Engine name,
       to use when defining the uri mappings. For example
  @@ -84,157 +443,136 @@
       will be constructed with port=8009, engine=DEFAULT, worker=ajp13 -
       named 'channel.socket.DEFAULT'
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>port</td>
  -  <td>8009</td>
  -  <td>Port where Tomcat is listening</td>
  -  </tr>
  -
  -  <tr>
  -  <td>host</td>
  -  <td>localhost</td>
  -  <td>Remote host</td>
  -  </tr>
  -
  -  <tr>
  -  <td>protocol</td>
  -  <td>ajp13</td>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <td>port</td>
  +                        <td>8009</td>
  +                        <td>Port where Tomcat is listening</td>
  +                    </tr>
  +                    <tr>
  +                        <td>host</td>
  +                        <td>localhost</td>
  +                        <td>Remote host</td>
  +                    </tr>
  +                    <tr>
  +                        <td>protocol</td>
  +                        <td>ajp13</td>
  +                        <td>
       The protocol to be used to forward the requests.
       No other value is supported at this moment.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>api</td>
  -  <td>ajp13</td>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <td>api</td>
  +                        <td>ajp13</td>
  +                        <td>
       API to be used when forwarding the requests.
       No other value is supported at this moment, ajp14 will be used to indicate
       that the Engine supports additional API methods like autoconfig.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>secretkey</td>
  -  <td>NULL</td>
  -  <td>
  -    <b>Magic:</b> The secret key will be set automatically on the associated
  +                    </tr>
  +                    <tr>
  +                        <td>secretkey</td>
  +                        <td>NULL</td>
  +                        <td>
  +                            <b>Magic:</b> The secret key will be set automatically on the associated
       worker.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>lbfactor</td>
  -  <td>1</td>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <td>lbfactor</td>
  +                        <td>1</td>
  +                        <td>
       Load balancing factor to use. At this moment, it'll be set on the worker,
       but in future it should be possible to use lb on a channel level.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">channel.un</th>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">channel.un</th>
  +                        <td>
       AF_UNIX socket. Only on UNIX like platform. These sockets are faster
       than "normal" sockets but they are limited to the machine. 
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>file</td>
  -  <td>Name of socket</td>
  -  <td>Name of the socket file (It is created by the Tomcat ChannelUn)</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="3">Workers</th>
  -  </tr>
  -
  -  <tr>
  -  <td>channel</td>
  -  <td>Name of channel</td>
  -  <td>Name of the channel used by the worker</td>
  -  </tr>
  -
  -  <tr>
  -  <td>debug</td>
  -  <td>0</td>
  -  <td>1 activates the debug of worker.</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">ajp13</th>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <td>file</td>
  +                        <td>Name of socket</td>
  +                        <td>Name of the socket file (It is created by the Tomcat ChannelUn)</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="3">Workers</th>
  +                    </tr>
  +                    <tr>
  +                        <td>channel</td>
  +                        <td>Name of channel</td>
  +                        <td>Name of the channel used by the worker</td>
  +                    </tr>
  +                    <tr>
  +                        <td>debug</td>
  +                        <td>0</td>
  +                        <td>1 activates the debug of worker.</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">ajp13</th>
  +                        <td>
       The forwarding worker using the ajp13 RPC protocol.
       It supports the basic ajp13 API and may support additional functions/APIs
       in future like ajp14 API.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>secretkey</td>
  -  <td>NULL</td>
  -  <td>
  +                    </tr>
  +                    <tr>
  +                        <td>secretkey</td>
  +                        <td>NULL</td>
  +                        <td>
       XXX deprecated - set it on channel ( socket needs it, jni doesn't,
       with unix we can use smarter things ).
       Special attribute to be sent with the first request, used to authenticate.
       Supported by Tomcat3.3 and Tomcat4.x if the authentication is configured,
       leave it NULL for Tomcat3.2.
     </td>
  -  </tr>
  -
  -  <tr>
  -  <td>lbfactor</td>
  -  <td>1</td>
  -  <td>XXX deprecated - set it on channel. Load balancing factor to use.</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">status</th>
  -  <td>Status report worker. The status worker does not need a channel.</td>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="3">Uri mapping.</th>
  -  </tr>
  -
  -  <tr>
  -  <th colspan="2">uri</th>
  -  <td>The string to map to the worker define in the uri entry.</td>
  -  </tr>
  -
  -  <tr>
  -  <td>worker</td>
  -  <td>No default value</td>
  -  <td>Name of the worker that process the request corresponding to the uri</td>
  -  </tr>
  -
  -  <tr>
  -  <td>debug</td>
  -  <td>0</td>
  -  <td>1 activates the logic associated with the mapping.</td>
  -  </tr>
  -
  -</table>
  -</p>
  -</section>
  -  
  -<section name="Examples">
  -<p>
  +                    </tr>
  +                    <tr>
  +                        <td>lbfactor</td>
  +                        <td>1</td>
  +                        <td>XXX deprecated - set it on channel. Load balancing factor to use.</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">status</th>
  +                        <td>Status report worker. The status worker does not need a channel.</td>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="3">Uri mapping.</th>
  +                    </tr>
  +                    <tr>
  +                        <th colspan="2">uri</th>
  +                        <td>The string to map to the worker define in the uri entry.</td>
  +                    </tr>
  +                    <tr>
  +                        <td>worker</td>
  +                        <td>No default value</td>
  +                        <td>Name of the worker that process the request corresponding to the uri</td>
  +                    </tr>
  +                    <tr>
  +                        <td>debug</td>
  +                        <td>0</td>
  +                        <td>1 activates the logic associated with the mapping.</td>
  +                    </tr>
  +                </table>
  +            </p>
  +        </subsection>
  +    </section>
  +    <section name="Examples">
  +        <p>
   The examples below are working when the Tomcat is configured according the 
   examples described in the configtc file.
   </p>
  -<subsection name="/example using normal socket">
  -<p> 
  +        <subsection name="/example using normal socket">
  +            <p> 
   Map /examples to the Tomcat /examples context using a normal socket. Note the 
   IP instead localhost (The JVM listens on the IPV4 address not no the IPV6).
   </p>
  -
  -<p>
  -<source>
  +            <p>
  +                <source>
   [shm]
   file=${serverRoot}/logs/shm.file
   size=1048576
  @@ -252,16 +590,14 @@
   [uri:/examples/*]
   worker=ajp13:localhost:8019
   </source>
  -</p>
  -</subsection>
  -
  -<subsection name="/jkstatus">
  -<p>
  +            </p>
  +        </subsection>
  +        <subsection name="/jkstatus">
  +            <p>
   Map /jkstatus to the status worker.
   </p>
  -
  -<p>
  -<source>
  +            <p>
  +                <source>
   [shm]
   file=${serverRoot}/logs/shm.file
   size=1048576
  @@ -273,12 +609,10 @@
   [uri:/jkstatus/*]
   worker=status:status
   </source>
  -</p>
  -</subsection>
  -
  -
  -<subsection name="/example using AF_UNIX socket">
  -<p>
  +            </p>
  +        </subsection>
  +        <subsection name="/example using AF_UNIX socket">
  +            <p>
   Map /examples to the Tomcat /examples context using a AF_UNIX socket.
   Socket file is create by the Tomcat becarefull when the Web Server runs in
   a different user than the Tomcat with the permission of the socket file:
  @@ -288,9 +622,8 @@
   </source>
   Here the Tomcat user and the Web Server user must be in the same group.
   </p>
  -
  -<p>
  -<source>
  +            <p>
  +                <source>
   [shm]
   file=${serverRoot}/logs/shm.file
   size=1048576
  @@ -307,7 +640,7 @@
   [uri:/examples/*]
   worker=ajp13:unixsocket
   </source>
  -</p>
  -</subsection>
  -</section>
  +            </p>
  +        </subsection>
  +    </section>
   </document>
  
  
  
  1.3       +15 -27    jakarta-tomcat-connectors/jk/xdocs/index.xml
  
  Index: index.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/index.xml,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- index.xml	20 Jun 2002 19:34:32 -0000	1.2
  +++ index.xml	30 Jun 2002 03:32:01 -0000	1.3
  @@ -1,29 +1,23 @@
   <?xml version="1.0"?>
  -
  +<!-- edited with XML Spy v4.2 U (http://www.xmlspy.com) by Ba-k (ZonaWarez.com) -->
   <document>
  -  <properties>
  -    <title>The mod_jk Module for the Apache Web Server</title>
  -    <author email="jfrederic.clere@fujitsu-siemens.com">Jean-Frederic Clere</author>
  -  </properties>
  -
  -  <section name="What is the mod_jk Module">
  -
  -    <p>
  -      <b>mod_jk2</b> is originated back to the old <b>mod_jserv</b>.
  +<properties>
  +<title>Overview</title>
  +<author email="jfrederic.clere@fujitsu-siemens.com">Jean-Frederic Clere</author>
  +</properties>
  +<section name="What is the mod_jk Module">
  +<p>
  +<b>mod_jk2</b> is originated back to the old <b>mod_jserv</b>.
         <b>mod_jk2</b> is a rewrite of <b>mod_jk</b>.
         The native part has been completly
         restructured and the configuration has been simplified a lot.
       </p>
  -
  -  </section>
  -
  -  <section name="Why should I use the mod_jk2 Module?">
  -
  -    <p>
  +</section>
  +<section name="Why should I use the mod_jk2 Module?">
  +<p>
         Because it offers a lot of different and flexible communications
         between a Web Server and the Tomcat Servlet Engine. 
       </p>
  -
   <!-- Pier's mod_webapp text we need our building.xml
       <p>
         If instead you're an adventurous geek who's up for a challenge, skip
  @@ -31,13 +25,9 @@
         section, there's where the fun starts.
       </p>
    -->
  -
  -  </section>
  -
  -
  -  <section name="Are there alternative ways to connect Apache and Tomcat?">
  -
  -    <p>
  +</section>
  +<section name="Are there alternative ways to connect Apache and Tomcat?">
  +<p>
         The alternative ways are better described in <b>mod_webapp</b>
         documentation.
         Check there for it and then decide if you want to go on reading. 
  @@ -47,7 +37,5 @@
         But it would be possible to implement the <b>WARP</b> protocol in
         <b>mod_jk2</b> ;-))
       </p>
  -    
  -  </section>
  -
  +</section>
   </document>
  
  
  
  1.2       +10 -0     jakarta-tomcat-connectors/jk/xdocs/style.css.in
  
  Index: style.css.in
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/style.css.in,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- style.css.in	1 Jun 2002 21:28:41 -0000	1.1
  +++ style.css.in	30 Jun 2002 03:32:01 -0000	1.2
  @@ -91,6 +91,16 @@
     font-weight: bold;
     font-size: bigger;
     color: @banner-fg@;
  +  padding: 1px;
  +  text-align: left;
  +}
  +
  +td.subsection {
  +  background-color: @banner-bg@;
  +  border-style: none;
  +  font-weight: bold;
  +  font-size: smaller;
  +  color: @banner-fg@;
     padding: 0px;
     text-align: left;
   }
  
  
  
  1.3       +8 -8      jakarta-tomcat-connectors/jk/xdocs/style.xsl.in
  
  Index: style.xsl.in
  ===================================================================
  RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/style.xsl.in,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- style.xsl.in	20 Jun 2002 19:33:10 -0000	1.2
  +++ style.xsl.in	30 Jun 2002 03:32:01 -0000	1.3
  @@ -75,7 +75,7 @@
                 <img src="images/pixel.gif" border="0" width="150" height="1" vspace="0" hspace="0"/>
               </td>
               <td width="*" bgcolor="{$body-bg}" height="1" class="nil">
  -              <img src="images/pixel.gif" border="0" width="570" height="1" vspace="0" hspace="0"/>
  +              <img src="images/pixel.gif" border="0" width="370" height="1" vspace="0" hspace="0"/>
               </td>
             </tr>
   
  @@ -144,7 +144,7 @@
                     name with the current URL, and then we process each "document"
                     within the index.
                   -->
  -                <xsl:variable name="root" select="document-location(.)"/>
  +                <xsl:variable name="root" select="/"/>
                   <xsl:for-each select="document('menu.idx')/index/document">
                     <tr>
                       <td bgcolor="#cccccc" width="150" colspan="2">
  @@ -163,12 +163,12 @@
                       and compare against it to see whether we are in the same file or
                       not. If we actually are, we expand to the "section" level.
                     -->
  -                  <xsl:if test="$root = document-location(document(@href))">
  +                  <xsl:if test="$root/document/properties/title = document(@href)/document/properties/title">
                       <xsl:for-each select="document(@href)/document/section">
                         <tr>
                           <td bgcolor="#cccccc" width="10"/>
                           <td bgcolor="#cccccc" width="140">
  -                          <a class="menu" href="#section_{position()}">
  +                          <a class="menu" href="#section_{generate-id(.)}">
                               <xsl:value-of select="@name"/>
                             </a>
                           </td>
  @@ -227,7 +227,7 @@
     </xsl:template>
   
     <xsl:template match="section">
  -    <a name="section_{position()}">
  +    <a name="section_{generate-id(.)}">
         <table border="0" cellspacing="0" cellpadding="0" width="100%">
           <tr>
             <td bgcolor="{$banner-bg}" class="section" valign="top" align="left">
  @@ -245,7 +245,7 @@
     </xsl:template>
   
     <xsl:template match="subsection">
  -    <a name="subsection_{position()}">
  +    <a name="subsection_{generate-id(.)}">
         <table border="0" cellspacing="0" cellpadding="0" width="100%">
           <tr>
             <td bgcolor="{$sub-banner-bg}" class="subsection" valign="top" align="left">
  @@ -258,7 +258,7 @@
           </tr>
         </table>
       </a>
  -    <xsl:apply-templates select="p|ul|img|screen|todo"/>
  +    <xsl:apply-templates select="subsection|p|ul|img|screen|todo"/>
       <br/>
     </xsl:template>
   
  @@ -303,7 +303,7 @@
   
     <!-- JFC added -->
     <xsl:template match="table">
  -    <table border="1"><xsl:apply-templates select="tr"/></table>
  +    <table border="0"><xsl:apply-templates select="tr"/></table>
     </xsl:template>
   
     <xsl:template match="tr">
  
  
  

--
To unsubscribe, e-mail:   <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>