From: <¥Ñ Microsoft Internet Explorer 5 Àx¦s> Subject: Galatea FlashGuide: Integrating Apache 2.0.36 and Tomcat 4.0.x on Windows Date: Sat, 19 Jul 2003 22:05:25 +0800 MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_NextPart_000_000B_01C34E41.DB4615B0"; type="text/html" X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1106 This is a multi-part message in MIME format. ------=_NextPart_000_000B_01C34E41.DB4615B0 Content-Type: text/html; charset="utf-8" Content-Transfer-Encoding: quoted-printable Content-Location: http://www.galatea.com/flashguides/apache-tomcat-24-win32.xml =EF=BB=BF Galatea FlashGuide: Integrating Apache 2.0.36 and = Tomcat 4.0.x on Windows

Galatea=20 FlashGuideTM: = Integrating Apache=20 2.0.36 and Tomcat 4.0.x on Windows

By Lajos Moczar
Last updated:=20 05/29/02

This=20 FlashGuideTM covers integrating Apache 2.0.36 and Tomcat 4.0.x on = Windows. These=20 instructions have been tested using mod_jk on Windows 98 and XP. Thanks = to Mark=20 Vlach for pointing me to a useful resource. You must use JDK 1.3.1 or = greater=20 when building mod_jk for Tomcat.

There = is a known=20 problem with Netscape 4.7.x, mod_jk and Apache 2.0. When access a Tomcat = page=20 using Netscape 4.x, part of the page displays, the browser hangs, and = eventually=20 displays "Document done" without showing the entire page. This is NOT = fixed in=20 2.0.36, as I reported earlier.

Installing Apache 2.0=20 binary on Windows
1. Download the Windows binary http://www.apache.org/dist/httpd/binaries/win32/apache= _2.0.43-win32-x86-no_ssl.msi.=20 Be sure to read the notes at http://www.apach= e.org/dist/httpd/binaries/win32.=20 If you want to build your own, you'll have to wait for my = forthcoming=20 FlashGuide explaining how.
2. Install Apache by double-clicking on the downloaded file = and=20 following the = prompts


Installing Tomcat on=20 Windows
1. Download Tomcat 4.0.5 at http://jakarta.apache.org/builds/jakarta-= tomcat-4.0/release/v4.0.5/bin/jakarta-tomcat-4.0.5.zip.=20 If you prefer, download Tomcat 4.1.12 instead from http://jakarta.apache.org/builds/jakart= a-tomcat-4.0/release/v4.1.12/bin/jakarta-tomcat-4.1.12.zip.
2. Install Tomcat by unzipping/untaring the download file = and placing=20 in the desired directory (I used c:\apps)
3. Note the location of your Tomcat installation - we will = refer to=20 this as = %CATALINA_HOME%.


Installing the mod_jk=20 binary
Follow=20 these next four sections if you want to use mod_jk=20
1. Download mod_jk at http://jakarta.apache.org/builds/jakarta-tomcat-co= nnectors/jk/release/v1.2.0/bin/win32.=20 Note that mod_jk.dll is different for Apache 1.3.x and Apache = 2.0.x, so=20 you'll be looking for something like = mod_jk-2.0.42.dll.
2. Copy mod_jk-2.0.42.dll to %APACHE_HOME%\modules=20


Building jk=20 jars
=
Tomcat=20 4.0 does not include jars for the jk connectors, so you have to = build your=20 own as described here.=20
1. Download the tomcat connectors source from http://jakarta.apache.o= rg/builds/jakarta-tomcat-4.0/release/v4.0.3/src/jakarta-tomcat-connectors= -4.0.2-01-src.zip.
2. Unpack the distribution in the desired = directory
3. Make sure you have ant installed and %ANT_HOME% set. If = not, follow=20 these steps:
a. Download=20 ant from http://jakarta.apache.org/builds/jakarta-ant/re= lease/v1.4.1/bin/jakarta-ant-1.4.1-bin.zip
b. Unpack=20 the distribution in the desired directory
c. Set=20 %ANT_HOME% in your environment to point to the ant=20 installation
4. Cd to the jk directory 
cd =
jakarta-tomcat-connectors-4.0.2-01-src\jk
5. Edit build.properties as follows:
a. Set=20 tomcat40.home to point to your Tomcat 4.0.x = installation
b. Set=20 apache2.home to point to your binary Apache 2.0 = installation
c. Comment=20 out tomcat33.home, tomcat41.home and iplanet.home, unless you need = them
d. Your=20 build.properties should look something like this: 
tomcat40.home=3Dc:/apps/jakarta-tomcat-4.0.3
apache2.home=3Dc:/progra~1/apache~1/apache2
apr.include=3D${apache2.home}/include
apr.lib=3D${apache2.home}/lib
so.debug=3Dtrue
so.optimize=3Dfalse
so.profile=3Dfalse
   =
6. Now build and install the jars 
ant
ant install
   =


Building=20 mod_jk
1. You can download a binary mod_jk.dll binary from http://www.acg-gmbh.de/mod_jk/.=20 If want to build your own, however, follow these instructions. =
This=20 distribution also includes mod_webapp - feel free to experiment = with=20 it!=20
2. Download Apache 2.0.36 source at http://www.= apache.org/dist/httpd/httpd-2.0.36.tar.gz
3. Unpack the distribution into a development directory (I = used=20 c:\devel)
The=20 distribution directory will be httpd_2.0.36=20
4. Set %APACHE2_HOME% to point to the Apache source=20 distribution
5. Make sure %JAVA_HOME% is set and pointing to your JDK=20 installation
6. With Visual C++, open the=20 = jakarta-tomcat-connectors-4.0.2-01-src\jk\native\apache-2.0\mod_jk.dsp=20 project
7. Select the proper project (Release or Debug) and build = mod_jk.dll=20
8. Copy mod_jk.dll to the modules directory of your binary = Apache=20 2.0.36 installation


Configuring=20 Tomcat
The=20 Listener tags are what causes Tomcat to automatically create the=20 conf/auto/mod_jk.conf file on startup. You can always write your = own and=20 ignore this file.=20
1. Edit %CATALINA_HOME%\conf\server.xml
a. Add the=20 following lines immediately after the <Server port=3D"8005" = ...>=20 declaration: 
   <Listener className=3D"org.apache.ajp.tomcat4.config.ApacheConfig"
      modJk=3D"c:/Program Files/Apache Group/Apache2/modules/mod_jk.dll" =
jkDebug=3D"info"
      =
workersConfig=3D"c:/apps/jakarta-tomcat-4.0.3/conf/jk/workers.properties"=

      jkLog=3D"c:/apps/jakarta-tomcat-4.0.3/logs/mod_jk.log"/>
Changes=20 the paths as appropriate. We need to specify the fully qualified = paths for=20 workersConfig and jkLog because otherwise, mod_jk won't be able to = find=20 them using the defaults. If you have a path for mod_jk.dll that = includes=20 spaces, you will probably have to edit=20 %CATALINA_HOME%\conf\auto\mod_jk.conf after Tomcat starts up and = add=20 quotes around the path. And yes, you'll have to do this every time = Tomcat=20 starts up unless you want to make a static version of mod_jk.conf=20 somewhere else.=20
b. Add the=20 following lines after the <Service = name=3D"Tomcat-Standalone">=20 declaration: 
    <!-- Define an AJP 1.3 Connector on port 8009 -->
    <Connector className=3D"org.apache.ajp.tomcat4.Ajp13Connector"
               port=3D"8009" minProcessors=3D"5" maxProcessors=3D"75"
               acceptCount=3D"10" debug=3D"0"/>
c. Finally,=20 after any <Host name=3D"localhost"> declarations, add a = listener:=20 
           <Listener =
className=3D"org.apache.ajp.tomcat4.config.ApacheConfig"=20
                        append=3D"true"  />
The=20 append attribute means to append to the existing = conf/auto/mod_jk.conf=20 file=20
2. Create a directory called "jk" under=20 $CATALINA_HOME/conf
3. Add workers.properties to the jk directory - you can = either use one=20 you have in a Tomcat 3.x installation, or copy this one (yes, I = removed=20 all the comments): 
workers.tomcat_home=3Dc:/apps/jakarta-tomcat-4.0.3
workers.java_home=3D$(JAVA_HOME)
ps=3D\

worker.list=3Dajp13, ajp14
worker.ajp13.port=3D8009
worker.ajp13.host=3Dlocalhost
worker.ajp13.type=3Dajp13
worker.ajp13.lbfactor=3D1

worker.ajp14.port=3D8010
worker.ajp14.host=3Dlocalhost
worker.ajp14.type=3Dajp14
worker.ajp14.secretkey=3Dsecret
worker.ajp14.credentials=3Dmyveryrandomentropy
worker.ajp14.lbfactor=3D1

worker.loadbalancer.type=3Dlb
worker.loadbalancer.balanced_workers=3Dajp13
worker.inprocess.type=3Djni
worker.inprocess.class_path=3D$(workers.tomcat_home)$(ps)lib$(ps)tomcat.j=
ar
worker.inprocess.cmd_line=3Dstart
worker.inprocess.jvm_lib=3D$(workers.java_home)$(ps)jre$(ps)bin$(ps)class=
ic$(ps)jvm.dll
worker.inprocess.stdout=3D$(workers.tomcat_home)$(ps)logs$(ps)inprocess.s=
tdout
worker.inprocess.stderr=3D$(workers.tomcat_home)$(ps)logs$(ps)inprocess.s=
tderr
Naturally, you will take care to set workers.tomcat_home, = workers.java_home and worker.inprocess.jvm_lib as approriate for = your=20 environment.=20
4. Start or restart Tomcat. If everything worked correctly, = you will=20 now have a mod_jk.conf file in %CATALINA_HOME%\conf\auto. If not, = better=20 look over this section again = ;)


Configuring=20 Apache
There are=20 two ways to do this: either simply include the auto-generated = mod_jk.conf=20 file (first step) or manually put in all the jk directives in = httpd.conf.=20 If you have a straight-forward Tomcat installation, do the former. = If you=20 want finer grained control over what is available via mod_jk, or = if your=20 webapps are not located in %CATALINA_HOME%\webapps, do the latter. = A good=20 reason to use the latter method is if the path to mod_jk.dll has = spaces in=20 it. If it does, you'll need to enclose the path as shown in = mod_jk.conf in=20 double-quotes. This applies, for example, if you install Apache 2 = in=20 "c:\Program Files\Apache Group\Apache".=20
1. Option 1: edit httpd.conf to inclucde mod_jk.conf
a. Add the=20 following lines to the end of the LoadModule section: 
Include =
c:/apps/jakarta-tomcat-4.0.3/conf/auto/mod_jk.conf
Remember,=20 Tomcat (re)creates mod_jk.conf on every startup, so don't try to = edit it!=20 You'll lose your changes on the next startup.=20
2. Option 2: Hard-code the mod_jk directives in httpd.conf: =
a. Add the=20 following to the LoadModules section: 
<IfModule !mod_jk.c>
  LoadModule jk_module modules/mod_jk.dll
</IfModule>
b. Add the=20 following to the end of httpd.conf: 
JkWorkersFile "c/apps/jakarta-tomcat-4.0.3/conf/jk/workers.properties"
JkLogFile "c/apps/jakarta-tomcat-4.0.3/logs/mod_jk.log"

JkLogLevel debug

JkMount /examples ajp13
JkMount /examples/* ajp13

JkMount /jk ajp13
JkMount /jk/* ajp13

JkMount /cocoon ajp13
JkMount /cocoon/* ajp13
This is=20 all an example. You will have to set the paths for JkWorkersFile = and=20 JkLogFile as approriate. You should make one entry for each webapp = you=20 want to expose via mod_jk.=20
3. Test httpd.conf by typing the following: 
cd %APACHE_HOME%\bin
Apache
   =


Testing=20
1. Always start Tomcat first and then start Apache. If you = have to=20 bounce Tomcat, remember to take down Apache first and restart it = after=20 Tomcat restarts. mod_webapp is very sensitive that way. In fact, = some=20 users have reported that it is necessary to put in 10 second delay = between=20 starting Tomcat and Apache.
2. If you set up a test to point to the "examples" web app = in Tomcat,=20 first double-check "examples" in Tomcat: in your browser, type:=20 http://[host]:[port]/examples, where [port] refers to where you = have=20 Tomcat running (usually 8080).
3. Now try the URL that you defined in httpd.conf to point = to=20 "examples": in your browser, type: http://[host]:[port]/examples, = where=20 [port] refers to where you have Apache running. If you don't get = anything,=20 try restarting Tomcat and then = Apache.



=C2=A92001-2002 Galatea Information Strategies. All rights=20 reserved

 ------=_NextPart_000_000B_01C34E41.DB4615B0 Content-Type: image/gif Content-Transfer-Encoding: base64 Content-Location: http://www.galatea.com/flashguides/images/Btflyblue10.gif R0lGODlhIAAgALMAAAAAAB6Q/76+vgAAgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA AAAAACH5BAEAAAIALAAAAAAgACAAQAS5UMhJq50g63sBBUE4BGMZepykBVoWvmyrimRtjifMCiCM ph/M63ZKtTIzm7L4GSpNMRcNF9NZX1IoE8gVXnfdH2+6FBu9RKpZ1Vk9dWte73r8gufpJXZeO/Xy VCxkTBtjUYUVUnBdjCp8W41Ng5BAP3h6cR1ob5QcYn+cYJVIhm84maRybmSBa6gtk50fin6rtKJJ TlB1uoS9RHuKu4aAfY+3VayYTkWKwno+vbi5Vkel1W2RR6kTEQAAOw== ------=_NextPart_000_000B_01C34E41.DB4615B0 Content-Type: image/gif Content-Transfer-Encoding: base64 Content-Location: http://www.galatea.com/flashguides/images/galatea1.gif R0lGODlhyAA8APcAAEKUvVKcxlqlxmOlxmutznOtznu1zoS11oy91pTG3pzG3qXO3q3O57XW573W 58be787n79bn797v9+fv9+/39/f3//////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////ywAAAAAyAA8AAAI/gAtCBxI sKDBgwgTKlzIsKHDhxAjSpxIsaLFixgzatzIsaPHjyBDihxJsqTJkyhTqlzJsqXLlzBjypxJE6aE BwsU5HwAoabPnxsjIAgAoKhRowUWTHAo4WiAhgqMXlxw1EBCCEezat3aU+DWr1IXEjUqoaWEAWC1 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 ------=_NextPart_000_000B_01C34E41.DB4615B0 Content-Type: image/gif Content-Transfer-Encoding: base64 Content-Location: http://www.galatea.com/flashguides/images/v_bar1.gif R0lGODlhvAIFAPcAAEqcvf////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// //////////////////////////////////////////////////////////////////////////// /////////////////////////////////////////////////////ywAAAAAvAIFAAAIYQABCBxI sKDBgwgTKlzIsKHDhxAjSpxIsaLFixgzatzIsaPHjyBDihxJsqTJkyhTqlzJsqXLlzBjypxJs6bN mzhz6tzJs6fPn0CDCh1KtKjRo0iTKl3KtKnTp1CjSp3qMCAAOw== ------=_NextPart_000_000B_01C34E41.DB4615B0 Content-Type: text/css; charset="big5" Content-Transfer-Encoding: quoted-printable Content-Location: http://www.galatea.com/flashguides/styles.css A { TEXT-DECORATION: none } .title-text { FONT-WEIGHT: bold; COLOR: #547180; FONT-FAMILY: verdana, helvetica, = sans serif } .tbl-text { FONT-SIZE: 10pt; COLOR: black; FONT-FAMILY: verdana, helvetica, sans = serif } .base-text { FONT-SIZE: 10pt; COLOR: black; FONT-FAMILY: verdana, helvetica, sans = serif } .base2-text { FONT-SIZE: 10pt; COLOR: black; FONT-FAMILY: verdana, helvetica, sans = serif } .alert-text { FONT-SIZE: 10pt; COLOR: red; FONT-FAMILY: verdana, helvetica, sans = serif } .small-base-text { FONT-SIZE: 8pt; COLOR: black; FONT-FAMILY: verdana, helvetica, sans = serif } .bold-base-text { FONT-WEIGHT: bold; FONT-SIZE: 12pt; COLOR: black; FONT-FAMILY: verdana, = helvetica, sans serif } ------=_NextPart_000_000B_01C34E41.DB4615B0--