← Back to branch summary

~ubuntu-branches/ubuntu/oneiric/libapache-mod-jk/oneiric

« back to all changes in this revision

Viewing changes to jk/xdocs/howto/quick.xml

  • Committer: Bazaar Package Importer
  • Author(s): Steve Kowalik
  • Date: 2006-08-05 16:30:53 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060805163053-myf66gm6j1a21ps6
Tags: 1:1.2.18-1ubuntu1
Merge from Debian unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
jk/xdocs/howto/quick.xml
1
 
<?xml version="1.0" encoding="ISO-8859-1"?>
2
 
<!DOCTYPE document [
3
 
  <!ENTITY project SYSTEM "project.xml">
4
 
]>
5
 
<document url="quick.html">
6
 
 
7
 
  &project;
8
 
<copyright>
9
 
   Copyright 1999-2004 The Apache Software Foundation
10
 
 
11
 
   Licensed under the Apache License, Version 2.0 (the "License");
12
 
   you may not use this file except in compliance with the License.
13
 
   You may obtain a copy of the License at
14
 
 
15
 
       http://www.apache.org/licenses/LICENSE-2.0
16
 
 
17
 
   Unless required by applicable law or agreed to in writing, software
18
 
   distributed under the License is distributed on an "AS IS" BASIS,
19
 
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20
 
   See the License for the specific language governing permissions and
21
 
   limitations under the License.
22
 
</copyright>
23
 
<properties>
24
 
<title>Quick Start HowTo</title>
25
 
<author email="hgomez@apache.org">Henri Gomez</author>
26
 
<date>$Date: 2005/07/04 08:01:01 $</date>
27
 
</properties>
28
 
<body>
29
 
<section name="Introduction">
30
 
<p>
31
 
  This document describes the configuration files used by JK on the
32
 
  Web Server side for the 'impatients':
33
 
    <ul>
34
 
    <li>
35
 
    <b>workers.properties</b> is a mandatory file used by the webserver and which
36
 
    is the same for all JK implementations (Apache/IIS/NES).
37
 
    </li>
38
 
    <li>
39
 
    <b>WebServers</b> add-ons to be set on the webserver side. 
40
 
    </li>
41
 
    </ul>
42
 
</p>
43
 
<p>        
44
 
  We'll give here minimum servers configuration and an example <b>workers.properties</b> 
45
 
  to be able to install and check quickly your configuration.
46
 
</p>
47
 
</section>
48
 
 
49
 
<section name="Minimum workers.properties">
50
 
<p>
51
 
    Here is a minimum <b>workers.properties</b>, using just ajp13 to connect your Apache webserver
52
 
    to the Tomcat engine, complete documentation is available in <a href="workers.html">Workers HowTo</a>. 
53
 
</p>
54
 
<p>
55
 
<source>
56
 
 
57
 
  # Define 1 real worker using ajp13
58
 
  worker.list=worker1
59
 
  # Set properties for worker1 (ajp13)
60
 
  worker.worker1.type=ajp13
61
 
  worker.worker1.host=localhost
62
 
  worker.worker1.port=8009
63
 
  worker.worker1.lbfactor=50
64
 
  worker.worker1.cachesize=10
65
 
  worker.worker1.cache_timeout=600
66
 
  worker.worker1.socket_keepalive=1
67
 
  worker.worker1.reclycle_timeout=300
68
 
 
69
 
</source>
70
 
</p>
71
 
</section>
72
 
 
73
 
<section name="Minimum Apache WebServer configuration">
74
 
<p>
75
 
   Here is a minimun informations about Apache configuration, a 
76
 
   complete documentation is available in <a href="apache.html">Apache HowTo</a>.
77
 
</p>
78
 
<p>
79
 
        You should first have <b>mod_jk.so</b> (unix) or <b>mod_jk.dll</b> (Windows) installed
80
 
        in your Apache module directory (see your Apache documentation to locate it).
81
 
</p>
82
 
<p>
83
 
        Usual locations for modules directory on Unix:
84
 
        <ul>
85
 
        <li>/usr/lib/apache/</li>
86
 
        <li>/usr/lib/apache2/</li>
87
 
        <li>/usr/local/apache/libexec/</li>
88
 
        </ul>
89
 
</p>
90
 
<p>
91
 
        Usual locations for modules directory on Windows :
92
 
        <ul>
93
 
        <li>C:\Program Files\Apache Group\Apache\modules\</li>
94
 
        <li>C:\Program Files\Apache Group\Apache2\modules\</li>
95
 
        </ul>
96
 
</p>
97
 
<p>
98
 
        You'll find prebuilt binaries <a href="http://jakarta.apache.org/site/binindex.cgi/">here</a>
99
 
</p>
100
 
<p>
101
 
    Here is the minimum which should be set in <b>httpd.conf</b> directly or 
102
 
    included from another file:
103
 
</p>    
104
 
<p>
105
 
        Usual locations for configuration directory on Unix:
106
 
        <ul>
107
 
        <li>/etc/httpd/conf/</li>
108
 
        <li>/etc/httpd2/conf/</li>
109
 
        <li>/usr/local/apache/conf/</li>
110
 
        </ul>
111
 
</p>
112
 
<p>
113
 
        Usual locations for configuration directory on Windows :
114
 
        <ul>
115
 
        <li>C:\Program Files\Apache Group\Apache\conf\</li>
116
 
        <li>C:\Program Files\Apache Group\Apache2\conf\</li>
117
 
        </ul>
118
 
</p>
119
 
<p>
120
 
<source>
121
 
 
122
 
  # Load mod_jk module
123
 
  # Update this path to match your modules location
124
 
  LoadModule    jk_module  libexec/mod_jk.so
125
 
  # Declare the module for &lt;IfModule directive&gt; (remove this line on Apache 2.x)
126
 
  AddModule     mod_jk.c
127
 
  # Where to find workers.properties
128
 
  # Update this path to match your conf directory location (put workers.properties next to httpd.conf)
129
 
  JkWorkersFile /etc/httpd/conf/workers.properties
130
 
  # Where to put jk logs
131
 
  # Update this path to match your logs directory location (put mod_jk.log next to access_log)
132
 
  JkLogFile     /var/log/httpd/mod_jk.log
133
 
  # Set the jk log level [debug/error/info]
134
 
  JkLogLevel    info
135
 
  # Select the log format
136
 
  JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
137
 
  # JkOptions indicate to send SSL KEY SIZE, 
138
 
  JkOptions     +ForwardKeySize +ForwardURICompat -ForwardDirectories
139
 
  # JkRequestLogFormat set the request format 
140
 
  JkRequestLogFormat     "%w %V %T"
141
 
  # Send everything for context /examples to worker named worker1 (ajp13)
142
 
  JkMount  /examples/* worker1
143
 
 
144
 
</source>
145
 
</p>
146
 
</section>
147
 
 
148
 
<section name="Minimum Domino WebServer configuration">
149
 
<p>
150
 
        A complete documentation is available in <a href="domino.html">Domino HowTo</a>.
151
 
<todo>
152
 
More informations to be added!
153
 
</todo>
154
 
</p>
155
 
</section>
156
 
 
157
 
<section name="Minimum IIS WebServer configuration">
158
 
<p>
159
 
        A complete documentation is available in <a href="iis.html">IIS HowTo</a>.
160
 
</p>
161
 
<todo>
162
 
More informations to be added!
163
 
</todo>
164
 
</section>
165
 
 
166
 
<section name="Minimum NES/iPlanet WebServer configuration">
167
 
<p>
168
 
        A complete documentation is available in <a href="nes.html">Netscape/iPlanet HowTo</a>.
169
 
<todo>
170
 
More informations to be added?
171
 
</todo>
172
 
</p>
173
 
</section>
174
 
 
175
 
 
176
 
<section name="Test your configuration">
177
 
<p>
178
 
        (Re)start the Web server and browse to the <a href="http://localhost/examples/">http://localhost/examples/</a>
179
 
</p>
180
 
 
181
 
</section>
182
 
</body>
183
 
</document>