Valeu Herbert, muito obrigado!!! '>'-- Mensagem Original -- '>'Reply-To: [EMAIL PROTECTED] '>'From: "Herbert Alexander Faleiros" <[EMAIL PROTECTED]> '>'To: <[EMAIL PROTECTED]> '>'Date: Fri, 7 Feb 2003 00:35:49 -0200 '>'Subject: Re: [java-list] Apache 2 + Tomcat 4 '>' '>' '>'Windows 2000/XP - Apache + JK + Tomcat HOWTO '>'DISCLAIMER: this is for Windows 2000 Professional and XP Professional. It '>'does not cover setting up Apache + Tomcat on a server such as Windows 2000 '>'Server/Advanced Server for production use. This is because I have no access '>'to a Windows 2000 server, nor do I use Windows servers for production use. '>'My only access to Windows are desktop installations of Windows 2000 '>'Professional and XP Professional. If you are a Windows 2000 server '>'administrator, my guess is that you have the skills to take these '>'instructions and adapt them to your platform accordingly. If you are unable '>'to do this, please consult the tomcat-user mailing list for help or go flag '>'down your neighborhood Windows sys-admin and ask them for help. '>' '>'This HOWTO is for Windows 2000 Professional and XP Professional. It assumes '>'that you have some basic knowledge of how to make things work on your '>'Windows computer, such as enabling and disabling services and creating new '>'directories. NOTE: this process is not a simple one-click "install this '>'software and use the defaults" process. If that's all you know how to do '>'with your computer, find a friend to help you, as things will be a little '>'bit more complicated than that, but certainly something someone with basic '>'system administration skills can handle. If you must have a JSP and Java '>'servlet environment, and you aren't comfortable configuring things manually, '>'then stick with Tomcat by itself, don't try to install Apache as well. '>'You'll be able to get started with your JSP and Java servlet development '>'much faster and easier that way. '>' '>'Installing the JDK '>' '>'1. You'll need to go to http://java.sun.com/j2se/1.4.1/download.html and '>'get '>'the JDK version of J2SE 1.4.1. The JRE version works for Tomcat in some '>'circumstances, but unless you know exactly what you are doing, the full JDK '>'is the better choice. Its a big download (38Mb), so plan accordingly. '>' '>'2. Run the installer. Take the defaults. This will install the JDK in '>'c:j2sdk1.4.1_01. '>' '>'3. Setup the JAVA_HOME environment variable. Click Start->Control '>'Panel->System. Then click Advanced, then click "Environment Variables". '>' '>'4. Under System variables, click "New". For Variable Name, use JAVA_HOME '>'(exactly like that, case and all). For Variable Value, use c:j2sdk1.4.1_01. '>'Click OK until the Control Panel is closed. '>' '>'5. Verify the setting. Click Start->Run, and in the command box type "cmd" '>'and click OK. At the command prompt, type echo %JAVA_HOME% and verify that '>'the value returned matches the Variable Value from step 4. '>' '>'Installing Apache '>' '>'1. First, make sure there is no web server running on port 80 on your '>'machine. It's possible that you have IIS installed and running, and you '>'don't even know it. Go to Start->Administrative Tools->Services, and look '>'for a service named "World Wide Web Publishing". If that service is listed, '>'click on it's name, then click the "Stop" button in the toolbar. The stop '>'button is a square. Then, choose Properties in the toolbar, and set "Startup '>'Type" to "Manual" instead of "Automatic". This will prevent IIS from '>'starting on your machine when it is rebooted. Only one service can run on '>'port 80 at a time, and in this HOWTO that service will be Apache, not IIS. '>' '>'2. Download the Apache binary for Windows. Choose a mirror site, and get '>'the '>'MSI installer. This will make things easier. The current version of Apache '>'is 2.0.43. The URL for the MSI installer is: '>'http://apache.mirrorcentral.com/dist/httpd/binaries/win32/apache_2.0.43-win3 '>'2-x86-no_ssl.msi '>' '>'3. Save the MSI installer to a location on your hard drive. Wherever you '>'put '>'it, remember that location. '>' '>'4. Click Start->Run->Browse, and browse to the location where you put the '>'MSI installer. Run the MSI installer. You will see a couple of screens '>'dealing with licenses, etc. Click through those, then you will see a screen '>'that says "Server Information" and has some values in the fields already. '>'Delete the Network Domain and Server Name values, and type "localhost" into '>'both fields. Put your email address in the field entitled "Administrator's '>'Email Address". Choose the option to install Apache for all users on port '>'80. Click Next. '>' '>'5. On the next screen, the default is "Typical". Select "Custom" and click '>'Next. '>' '>'6. The next screen says "Custom Setup". Click the "Change..." button to '>'change the installation directory. '>' '>'7. The next screen says "Change Current Destination Folder". Click UP to '>'the '>'C drive, that is, C:. Click the "new folder" icon (the folder with a "*" '>'on '>'it) and call the new folder "apache". Click "OK", then click Next. The goal '>'here is to install Apache 2.0.43 in a folder called C:apache, NOT in the '>'default installation folder that the installer wants to use. This is because '>'the default installation is a Windows-friendly location with spaces in the '>'pathname. Spaces in pathnames can cause problems with software developed '>'for '>'Linux, which is where most open source software is developed. '>' '>'8. Click "Install". The installer will do its thing, and you will see '>'various windows popping up and disappearing. This is normal. When the '>'installer is finished, you should see a "successful" message and there '>'should be a new icon in your system tray. '>' '>'9. The installer starts Apache by default, so once the installer completes, '>'you can open up a browser window and browse to http://localhost./ You should '>'see the default Apache home page. If you don't see this, go back to Step '>'3 '>'and try again. The MSI installer is about as painless as you can get. This '>'will leave you with c:apacheApache2 as your Apache home directory. '>' '>'10. Once you have verified that Apache is running on port 80, right click '>'on '>'the Apache System Tray icon and choose "Open Apache Monitor". Then click '>'the '>'"Stop" button to stop Apache. Apache will be started again after Tomcat and '>'JK are installed. '>' '>'Installing Tomcat '>' '>'1. Create a folder on your hard drive. Call it tomcat, and put it in the '>'C '>'drive root, so that you end up with C: omcat. '>' '>'2. Download the Tomcat binary. The latest version of Tomcat is 4.1.18. Get '>'the binary for Windows here: '>'http://apache.mirrorcentral.com/dist/jakarta/tomcat-4/binaries/tomcat-4.1.18 '>'.exe. Save the file to your hard drive, and remember where you put it. '>' '>'3. Execute the EXE file you downloaded in Step 2. This will start the '>'installer. Read the license, and if you agree, click "I Agree" and go to '>'the '>'next screen. '>' '>'4. On the next screen, select the box that says "NT Service". If you want '>'to '>'install the Tomcat source code (entirely optional, you don't need it to run '>'Tomcat) then select that option as well. Leave the default selections as '>'they are. Click Next. '>' '>'5. On the next screen, DON'T take the installation directory default. Click '>'the Browse button, and choose the folder you created in Step 1. This will '>'leave you with something like C: omcatTomcat 4.1. This isn't ideal...you '>'don't want spaces in the name. Change the last part of the path to something '>'like "tomcat-4-1-18" so that you end up with c: omcat omcat-4-1-18 in the '>'directory field. '>' '>'6. Click Next. The installer will start copying files. Eventually you will '>'be presented with a screen asking for a password for the admin user. Type '>'in '>'a password, making sure that you can remember it later. Leave the port '>'number at 8080. If you change it, you will have to manually edit Tomcat's '>'config files. Click Next. '>' '>'7. When the installer is finished, you will have a directory structure for '>'Tomcat at c: omcat omcat-4-1-18, and the service should be running. You can '>'verify the service is running by accessing http://localhost:8080/. Note that '>'since Tomcat is installed as a service, you can manage it with the Services '>'tool by clicking Start->Administrative Tools->Services and looking for '>'service called Apache Tomcat 4.1. '>' '>'8. Verify the JSP examples work at '>'http://localhost:8080/examples/jsp/index.html and that the servlet examples '>'work at http://localhost:8080/examples/servlets/index.html. '>' '>'Installing the JK Connector '>' '>'The JK connector is what Apache and Tomcat use to "speak" with each other. '>'It's a separate piece of software, distinct from both Apache and Tomcat. '>'There is also a JK2 connector, but in this HOWTO we will be working with '>'the '>'JK connector. The goal here is to get JSP and servlets to run on port 80, '>'without having to set Tomcat to run on port 80. It is possible to run Tomcat '>'on port 80 as a stand-alone web server, but in many situations, there is '>'a '>'need to use Apache on port 80. The connector acts as the conduit between '>'Apache and Tomcat in that scenario. '>' '>'1. Download the JK connector here: '>'http://jakarta.apache.org/builds/jakarta-tomcat-connectors/jk/release/v1.2.1 '>'/bin/win32/ In our case, we want the file called mod_jk-2.0.43.dll because '>'we are using Apache 2.0.43. '>' '>'2. The file is an Apache module, it is NOT a Tomcat JAR file or WAR file. '>'It '>'doesn't belong in Tomcat's directory structure, it belongs in a place where '>'Apache can find it. For Apache 2.0.43, that is APACHE_HOMEmodules, where '>'APACHE_HOME is equal to your Apache install location. In our case, that is '>'c:apacheApache2, so we want to put the JK DLL file into '>'c:apacheApache2modules. You should end up with a file called '>'c:apacheApache2modulesmod_jk-2.0.43.dll on your hard drive. If you notice '>'that the other files in c:apacheApache2modules end in "*.so", that's OK. '>'Both "*.so" and "*.dll" are valid Apache module extensions on Windows '>'systems. '>' '>'NOTE: from now on, APACHE_HOME = c:apacheApache2 or the name of your Apache '>'home directory. '>' '>'3. Edit Apache's configuration file. It is located in APACHE_HOMEconf and '>'is '>'called httpd.conf. Don't be nervous, there is a copy in the same directory '>'called httpd.default.conf. You can always revert back to the default '>'settings if you need to by copying that file. '>' '>'4. Edit httpd.conf in your favorite text editor. DO NOT edit it in Micro$oft '>'Word!! Use Notepad or another editor. Scroll down to where you see a bunch '>'of lines that say "LoadModule". At the end of this list, add a line that '>'says: '>' '>'LoadModule jk_module modules/mod_jk-2.0.43.dll '>' '>' '>'Save the file you just edited to the APACHE_HOMEconf directory, and before '>'going any further, verify that you have things setup correctly. Open a '>'command prompt window by clicking Start->Run and typing cmd and clicking '>'OK. '>'At the prompt, type c:apacheApache2 inApache.exe -t and hit return. You '>'should see a message that says "Syntax OK". If you don't see this message, '>'go back to Step 1 and review any changes you have made to determine the '>'error. Note that using "-t" on the command line WILL NOT start the Apache '>'service, it just checks the changes that you made to httpd.conf for any '>'errors. '>' '>'5. Edit Tomcat's configuration. First, make a copy of c: omcat '>'omcat-4-1-18confserver.xml. Now edit c: omcat omcat-4-1-18confserver.xml. '>'Look for a line that says '>' '>'<Server port="8005" shutdown="SHUTDOWN" debug="0"> '>' '>' '>'Just below that line, add the following: '>' '>'<Listener className="org.apache.ajp.tomcat4.config.ApacheConfig" '>'modJk="c:/apache/Apache2/modules/mod_jk-2.0.43.dll" /> '>' '>' '>'Now look for a line that says '>' '>'<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" '>'autoDeploy="true"> '>' '>' '>'Just below that line, add the following: '>' '>'<Listener className="org.apache.ajp.tomcat4.config.ApacheConfig" '>'append="true" forwardAll="false" '>'modJk="c:/apache/Apache2/modules/mod_jk-2.0.43.dll" /> '>'(note that this line, while similar to the first one, is different) '>' '>'Save the changes you made to server.xml. Restart the Tomcat service. Wait '>'a '>'few seconds, and then check to see if there is a file called mod_jk.conf '>'in '>'c: omcat omcat-4-1-18confauto (c: omcat omcat-4-1-18confautomod_jk.conf). '>'If '>'there is, all is well. If there isn't, go back to the beginning of Step 5 '>'and verify the changes you made to server.xml. '>' '>'By adding the two Listener elements to server.xml, you are causing Tomcat '>'to '>'generate the necessary Apache configuration directives for mod_jk '>'automatically. You don't need to type them by hand. This is a very '>'convenient feature, but it is optional. If you want to configure Apache by '>'hand, you are welcome to do so, but that is not covered here in this HOWTO. '>' '>'6. Almost done on the Tomcat side. JK, in the Apache module, uses the '>'concept of a "worker" to send and receive info to Tomcat. We need to tell '>'the worker where Tomcat is, and what port we want it to use. This is done '>'with a workers.properties file. We want to put the workers.properties file '>'into c: omcatTomcat-4-1-18confjk, though it can be anywhere. So, open up '>'Notepad or your favorite text editor with a blank file, and add the '>'following lines to it: '>' '>'# BEGIN workers.properties '>'# Definition for Ajp13 worker '>'worker.list=ajp13 '>'worker.ajp13.port=8009 '>'worker.ajp13.host=localhost '>'worker.ajp13.type=ajp13 '>'# END workers.properties '>' '>' '>' '>'Save the file as c: omcatTomcat-4.1.18confjkworkers.properties. Note that '>'the default name for a JK worker is "ajp13". You can call it what you like, '>'but my advice is don't change it until you have a completely working '>'installation and can see how all the pieces fit together. '>' '>'7. Now go back to Apache's httpd.conf file, and edit it '>'(c:apacheApache2confhttpd.conf). At the very end of the file, add the '>'following lines: '>' '>'JkWorkersFile "c: omcatTomcat-4-1-18confjkworkers.properties" '>'JkLogFile "c: omcatTomcat-4-1-18logsmod_jk.log" '>'Include c:/tomcat/tomcat-4-1-18/conf/auto/mod_jk.conf '>' '>' '>' '>'Save the file, and verify your syntax by running c:apacheapache2 '>'inapache.exe -t at a command prompt. You should see a message that says '>'"Syntax OK". If you don't see this message, review the edits you just made '>'and make sure that c:/tomcat/tomcat-4-1-18/conf/auto/mod_jk.conf and '>'workers.properties actually exist where they should. '>' '>'Installation Checklist '>' '>'OK, that was a lot of work. By now, you should have the following '>'environment: '>' '>' '>'JDK installed in c:j2sdk1.4.1_01 '>'JAVA_HOME environment variable set for all users (System level) to '>'c:j2sdk1.4.1_01 '>'The JK DLL downloaded from the Jakarta site and placed in '>'c:apacheApache2modules '>'Apache installed in c:apacheapache2, with "Syntax OK" messages after both '>'the LoadModule edit and the Jk/Include edit, and able to view the Apache '>'welcome page at http://localhost/ '>'Tomcat installed in c: omcat omcat-4-1-18, successfully restarted with both '>'Listener element edits to server.xml, and able to view the Tomcat welcome '>'page and execute the Tomcat examples at http://localhost:8080/ '>'A file called workers.properties located in c: omcatTomcat-4-1-18confjk '>'Checking Your Installation '>' '>'1. Start Tomcat as a service using the service control panel. '>'Start->Application Tools->Services. If Tomcat is running, stop it and then '>'start it. Wait a few seconds before continuing. '>' '>'2. Start Apache using the Apache Monitor in your System Tray. Right click '>'on '>'the System Tray icon, and choose "Open Apache Monitor", then click "Start". '>'Wait a few seconds before continuing. '>' '>'3. Verify the Apache welcome page at http://localhost/ '>' '>'4. Verify the Tomcat examples at '>'http://localhost:8080/examples/jsp/index.html '>' '>'5. Verify Tomcat examples available on port 80 at '>'http://localhost/examples/jsp/index.html '>' '>'If you can execute the Tomcat examples successfully without "8080" on the '>'URL, then mod_jk is working correctly. '>' '>'For more info, consult the Tomcat documentation as well as the tomcat-user '>'mailing list. If you want to use this HOWTO for something other than '>'"localhost", then all you have to do is use "www.your-domain.com" everywhere '>'it says "localhost". My advice in that scenario would be to copy the '>'existing, default Host container in Tomcat's server.xml, and change the '>'"name" parameter to "www.your-domain.com", then restart Tomcat (to re-gen '>'mod_jk.conf with the new hostname) and restart Apache. Making a copy of the '>'localhost Host container in server.xml will leave the localhost container '>'as '>'a failsafe default, which might cut down on problems in the future. '>' '>'NOTE: in Tomcat, virtual hosts are "Hosts". That is, as far as Tomcat is '>'concerned, localhost is a virtual host. So, if you want to setup '>'http://www.server-a.com/ and http://www.server-b.com/, you just need more '>'copies of the Host container included in the default server.xml that comes '>'with Tomcat. Doing it in production is a little more complicated than that, '>'but that's the essence of how to get Tomcat to work for more than localhost. '>'Because this HOWTO describes using the Apache auto-config option of JK, '>'getting Tomcat to work with your virtual hosts means Apache will work. This '>'means that you can test your URL and your application contexts using ":8080" '>'on your URL without affecting Apache. When you have it working, simply '>'restart Apache so that it picks up the new mod_jk.conf file generated by '>'Tomcat and you should be well on your way. '>' '>'Copyright © 2002 John Turner. All rights reserved. '>' '>'Herbert Alexander Faleiros '>'PHYSIS - Diretor jurídico '>'Desenvolvedor Java '>'Administrador de redes '>'Graduando em Física - UFSCar '>'[EMAIL PROTECTED] '>'[EMAIL PROTECTED] '>'55 (16) 9117 2962 '>' '>' '>' '>'----- Original Message ----- '>'From: "Alvaro Seixas" <[EMAIL PROTECTED]> '>'To: <[EMAIL PROTECTED]> '>'Sent: Thursday, February 06, 2003 8:57 AM '>'Subject: [java-list] Apache 2 + Tomcat 4 '>' '>' '>'Ola a todos! '>'Estou tentando fazer a integracao entre o Apache 2 e o Tomcat 4.1.18 no '>'Win2k, porem nao estou tendo sucesso. Consigo rodar os 2, mas qdo vou rodar '>'os exemplos da erro. '>'Li o manual do Tomcat mas nao ajudou muito. O que fiz ate agora foi o '>'seguinte: '>'httpd.conf: '>'<IfModule !mod_jk.c> '>'LoadModule jk_module modules/mod_jk-2.0.43.dll '>'</IfModule> '>'JkWorkersFile "C:/Program Files/Apache '>'Group/Apache2/conf/workers2.properties" '>' '>'JkLogFile "C:/Program Files/Apache Group/Tomcat 4.1/logs/mod_jk2.log" '>'JkMount /servlet/* ajp13 '>'JkMount /*.jsp ajp13 '>' '>'workers2.properties: '>'# Define the communication channel '>'[channel.socket:localhost:8009] '>'info=Ajp13 forwarding over socket '>'CATALINAId=10.0.0.3:8009 '>' '>'# Map the CATALINA examples webapp to the Web server uri space '>'[uri:/examples/*] '>'info=Map the whole webapp '>' '>'jk2.properties: '>'channelSocket.port=8009 '>'channelSocket.address=10.0.0.3 '>' '>'Por favor, alguem poderia me ajudar???? '>' '>' '>'------------------------------ LISTA SOUJAVA ---------------------------- '>'http://www.soujava.org.br - Sociedade de Usuários Java da Sucesu-SP '>'dúvidas mais comuns: http://www.soujava.org.br/faq.htm '>'regras da lista: http://www.soujava.org.br/regras.htm '>'historico: http://www.mail-archive.com/java-list%40soujava.org.br '>'para sair da lista: envie email para [EMAIL PROTECTED] '>'------------------------------------------------------------------------- '>' '>' '>' '>'------------------------------ LISTA SOUJAVA ---------------------------- '>' '>'http://www.soujava.org.br - Sociedade de Usuários Java da Sucesu-SP
'>'dúvidas mais comuns: http://www.soujava.org.br/faq.htm '>'regras da lista: http://www.soujava.org.br/regras.htm '>'historico: http://www.mail-archive.com/java-list%40soujava.org.br '>'para sair da lista: envie email para [EMAIL PROTECTED] '>' '>'------------------------------------------------------------------------- '>' ------------------------------ LISTA SOUJAVA ---------------------------- http://www.soujava.org.br - Sociedade de Usuários Java da Sucesu-SP dúvidas mais comuns: http://www.soujava.org.br/faq.htm regras da lista: http://www.soujava.org.br/regras.htm historico: http://www.mail-archive.com/java-list%40soujava.org.br para sair da lista: envie email para [EMAIL PROTECTED] -------------------------------------------------------------------------
