Modified: tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html (original) +++ tomcat/site/trunk/docs/connectors-doc/webserver_howto/iis.html Thu Oct 6 09:00:17 2016 @@ -1,12 +1,12 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Webserver HowTo - IIS HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Yoav Shapira"><meta name="email" value="yo...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td co lspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.propertie s</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server</a></li><li><a href="../reference/iis.html">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&email assigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">20 08</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Webserver HowTo</h1><h2>IIS HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/iis.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Web Server HowTo - ISAPI redirector for Micrsoft IIS HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Yoav Shapira"><meta name="email" value="yo...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><! --HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Web Server HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/workers.html">worker s.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=& ;bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><l i><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Web Server HowTo</h1><h2>ISAPI redirector for Micrsoft IIS HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/iis.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <p> -This document explains how to set up IIS to cooperate with Tomcat. +This document explains how to set up the ISAPI redirector for IIS to cooperate with Tomcat. </p> <p> Normally IIS can not execute Servlets and Java Server Pages (JSPs), -configuring IIS to use the JK ISAPI redirector plugin will let IIS send servlet and +configuring IIS to use the ISAPI redirector plugin will let IIS send servlet and JSP requests to Tomcat (and this way, serve them to clients). </p> @@ -47,7 +47,7 @@ A worker is defined to be a tomcat proce <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Supported Configuration"><strong>Supported Configuration</strong></a></font></td></tr><tr><td><blockquote> <p> -The IIS-Tomcat redirector works for: +The IIS to Tomcat redirector works for: <ul> <li> WinNT4.0-i386 SP4/SP5/SP6a (should be able to work with other service packs), Win98, WinXP, Win2K, @@ -63,8 +63,8 @@ Tomcat 3.2 to Tomcat 8. </p> <p> -The redirector uses <b>ajp12</b> and <b>ajp13</b> to send requests to the Tomcat containers. There is also an option to use Tomcat in process, -more about the in-process mode can be found in the in process howto. +The mod_jk module uses the AJP protocol to send requests to the Tomcat containers. +The AJP version typically used is <b>ajp13</b>. </p> </blockquote></td></tr></table> @@ -92,22 +92,15 @@ because the library is not loadable into </p> </blockquote></td></tr></table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Who support ajp protocols ?"><strong>Who support ajp protocols ?</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Who supports AJP protocols?"><strong>Who supports AJP protocols?</strong></a></font></td></tr><tr><td><blockquote> <p> -The ajp12 protocol is only available in Tomcat 3.2.x and 3.3.x. +Tomcat supports ajp13 since Tomcat 3.2. +Others servlet engines such as <b>Jetty</b> or <b>JBoss</b> also support the ajp13 protocol </p> <p> -The <b>ajp12</b> has been <b>deprecated</b> with Tomcat 3.3.x and you should use instead -<b>ajp13</b> which is the only ajp protocol known by Tomcat 4 and above. -</p> - -<p> -Of course Tomcat 3.2.x and 3.3.x also support ajp13 protocol. -</p> - -<p> -Others servlet engines such as <b>jetty</b> have support for ajp13 protocol +The <b>ajp12</b> protocol has been <b>deprecated</b> and you should no longer use it. +The <b>ajp14</b> protocol is considered experimental. </p> </blockquote></td></tr></table> @@ -116,7 +109,7 @@ Others servlet engines such as <b>jetty< <p> <ol> <li> -The IIS-Tomcat redirector is an IIS plugin (filter + extension), IIS load the redirector plugin and calls its +The ISAPI redirector is a Microsoft IIS plugin (filter + extension). IIS loads the redirector plugin and calls its filter function for each in-coming request. </li> <li> @@ -137,18 +130,16 @@ The extension collects the response from </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Installation"><strong>Installation</strong></a></font></td></tr><tr><td><blockquote> <p> -A pre-built version of the ISAPI redirector server plugin, isapi_redirect.dll, is available under -the win32/i386 directory of tomcat-connectors distribution. -For those using Netscape as your browser, try downloading a zip version of the file, if available. -There can be problems using Netscape to download DLL files. +A pre-built version of the ISAPI redirector plugin, isapi_redirect.dll, is available under +the win32/i386 directory of the Tomcat Connectors distribution. -You can also build a copy locally from the source present in tomcat-connectors distribution. +You can also build a copy locally from the Tomcat Connectors source distribution. -The Tomcat redirector requires three entities: +The ISAPI redirector requires three entities: <ul> <li> -<b>isapi_redirect.dll</b> - The IIS server plugin, either obtain a pre-built DLL or build it yourself (see the build section). +<b>isapi_redirect.dll</b> - The ISAPI redirector for Microsoft IIS plugin, either obtain a pre-built DLL or build it yourself (see the build section). </li> <li> <b><a href="../reference/workers.html">workers.properties</a></b> - A file that describes the host(s) and port(s) used by the workers (Tomcat processes). @@ -224,7 +215,7 @@ you need to insert the full path to isap <li> If you're using IIS 6.0 you must also do the following: <br> -Using the IIS management console, add the Tomcat Isapi Redirector to the Web +Using the IIS management console, add the ISAPI Redirector to the Web Service Extensions. <ol> <li>Right-click on Web Service Extensions and choose Add a new Web Service @@ -245,8 +236,8 @@ PWS will still keep the DLLs in memory. </p> <p> That's all, you should now start Tomcat and ask IIS to serve you the /examples context. -Try <a href="http://localhost/examples/jsp/index.html";>http://localhost/examples/jsp/index.html</a> for example and -execute some of the JSP examples. +Try <a href="http://localhost/examples/";>http://localhost/examples/</a> for example and +execute some of the Servlet or JSP examples. </p> <p> If this does not work successfully, refer to the Troubleshooting section below for help on correcting the problem. @@ -303,7 +294,7 @@ even if these files are part of a contex Tomcat somewhat, by using it only to process requests that only Tomcat can handle (e.g. requests to JSP pages and java servlets). </p> <p> -For example, consider the html and gif files in the examples context : you could serve these files directly +For example, consider the html and gif files in the examples context: you could serve these files directly with IIS; there is no need to serve them from the Tomcat process. </p> <p><font color="#ff0000">However, you should be very careful when you implement the following configuration style, because by doing so you are @@ -330,7 +321,7 @@ For example adding a /example IIS virtua <p> Configuring the redirector is somewhat harder, you will need to specify the exact URL-Path pattern(s) which you want Tomcat to handle (usually only JSP files and servlets). -This requires a change to the uriworkermap.properties : +This requires a change to the uriworkermap.properties: <div class="example"><pre> For the examples context it requires to replace the following line @@ -351,12 +342,12 @@ whose name ends with .jsp. You can even be more explicit and provide lines such as: <div class="example"><pre> - /example/servletname=defworker + /example/servlets/chat=defworker </pre></div> </p> <p> -that instructs the redirector to redirect all requests whose URL-path matches the leading string "/example/servletname" +that instructs the redirector to redirect all requests whose URL-path matches the leading string "/example/servlets/chat" to the worker named defworker. </p> @@ -372,8 +363,8 @@ In particular, each servlet application which contains sensitive configuration data and Java classes, and which should always be kept hidden from web users. Using the IIS management console it is possible to protect the WEB-INF directory from user access, but considering that this is a general requirement, and considering that it is easy to forget to implement this protection -at the IIS level, the redirector plugin does it automatically for you, and it will reject any request -which contains WEB-INF in its URL-path. +at the IIS level, the ISAPI redirector plugin does it automatically for you, and it will reject any request +which contains WEB-INF in its URL path. It will also reject any request which contains META-INF in its URL path. </p> </blockquote></td></tr></table> @@ -423,27 +414,72 @@ and in the <a href="../reference/workers </blockquote></td></tr></table> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building ISAPI redirector"><strong>Building ISAPI redirector</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building the ISAPI redirector"><strong>Building the ISAPI redirector</strong></a></font></td></tr><tr><td><blockquote> <p> -The redirector was developed using Visual C++ Ver.6.0, so having this environment is a prerequisite if you want -to perform a custom build. You should also have the IIS developer SDK. - -The steps that you need to take are: +The redirector was developed using Microsoft Visual C++, so having Visual Studio installed +is a prerequisite if you want to perform your own build.</p> +<p> +You can build the source using the IDE GUI, or using a pure +commandline build based on nmake. The IDE build currently only +supports building 32 Bit binaries. The nmake builds are available +for 32 Bit, 64 Bit and Itanium binaries. +</p> +<p> +The common steps for all build procedures are: +<ul> +<li> +Set up your build environment for 32 Bits or 64 Bits. +The IDE build only supports 32 Bits. +</li> +<li> +Download the sources as a zip file and unpack it. +</li> +<li> +Change directory to the ISAPI redirector source directory. +</li> +</ul> +<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><div class="screen">Set up 32 or 64 Bit build environment</div><code><nobr><em class="screen">c:\></em><b class="screen">setenv /Release /X86</b></nobr></code><br><div class="screen">or (not available for IDE build)</div><code><nobr><em class="screen">c:\></em><b class="screen">setenv /Release /X64</b></nobr></code><br><div class="screen">Download tomcat-connectors-xxx-src.zip from</div><div class="screen">https://tomcat.apache.org/download-connectors.cgi</div><div class="screen">and unpack it</div><code><nobr><em class="screen">c:\></em><b class="screen">unzip tomcat-connectors-xxx-src.zip</b></nobr></code><br><div class="screen">Change directory to the ISAPI redirector source directory</div><code><nobr><em class="screen">c:\></em><b class="screen">cd tomcat-connectors-xxx-src\native\iis</b></nobr></code><br></td></tr ></table></div></p> +</p> +<p> +The steps for an IDE build are then: <ul> <li> -Change directory to the isapi plugins source directory. +Start Visual Studio using "start isapi.dsw" +</li> +<li> +During IDE startup choose "Yes" in all conversion popups. +</li> +<li> +Next choose "Debug" or "Release" in the Configuration dropdown. </li> <li> -Make the source with MSDEV +Finally choose "Build Solution" in the "Build" menu. </li> </ul> -<p class="screen"><div align="left"><table width="80%" border="1" cellspacing="0" cellpadding="2" bgcolor="#000000"><tr><td bgcolor="#000000" align="left"><div class="screen">Change directory to the isapi plugins source directory</div><code><nobr><em class="screen">c:\></em><b class="screen">cd c:\home\apache\jk\iis</b></nobr></code><br><div class="screen">Build the sources using MSDEV</div><code><nobr><em class="screen">c:\></em><b class="screen">MSDEV isapi.dsp /MAKE ALL</b></nobr></code><br></td></tr></table></div></p> +The resulting file isapi_redirect.dll (and the debug symbol file +isapi_redirect.pdb) is located in the "Debug" resp. "Release" sub +directory depending on the build Configuration chosen. As an +intermediate step the build first creates a static PCRE library +named pcre.lib in the sub directory "pcre/LibD" resp. "pcre/LibR". </p> <p> -If msdev is not in your path, enter the full path to msdev.exe. -This will build both release and debug versions of the redirector plugin. -An alternative will be to open the isapi workspace file (isapi.dsw) in msdev and -build it using the build menu. +Alternatively the steps for an nmake commandline build are: +<ul> +<li> +Issue "nmake -f Makefile.x86" for a 32 Bit build, or +</li> +<li> +Issue "nmake -f Makefile.amd64" for a 64 Bit build, or +</li> +<li> +Issue "nmake -f Makefile.i64" for a Itanium Bit build +</li> +</ul> +The resulting file isapi_redirect.dll (and the debug symbol file +isapi_redirect.pdb) is located in the "Release_x86" resp. "Release_amd64" +resp. "Release_ia64" sub directory. As an intermediate step the build +first creates a static PCRE library named pcre.lib in the sub directory +"pcre/Release_x86" resp. "pcre/Release_amd64" resp. "pcre/Release_ia64. </p> </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Troubleshooting"><strong>Troubleshooting</strong></a></font></td></tr><tr><td><blockquote> <p> @@ -496,17 +532,17 @@ Check the log_file setting for typos, na If the above are set correctly, the ISAPI redirector should be able to create the log file. </ul> <p> -Invoke the URL <a href="http://localhost/examples/jsp/index.html";>http://localhost/examples/jsp/index.html</a> +Invoke the URL <a href="http://localhost/examples/";>http://localhost/examples/</a> in your browser. Case is important in Tomcat. The characters following "localhost" in the URL must be lower case. If the page fails to appear, stop the IIS service (required to view the IIS log file). -Then examine the last line in the IIS log file in found in SYSTEM/LogFiles/W3SVC1 : +Then examine the last line in the IIS log file in found in SYSTEM/LogFiles/W3SVC1: </p> <p> If the last line contains: </p> <div class="example"><pre> - GET "/examples/jsp/index.html HTTP/1.1" 404 + GET "/examples/ HTTP/1.1" 404 </pre></div> <p> then the ISAPI redirector is not recognising that it should be handling requests for the "/examples" context. @@ -538,7 +574,7 @@ but is not successful at getting Tomcat </p> <p> -You should check the HTTP error code following GET "/..." : +You should check the HTTP error code following GET "/...": </p> <div class="example"><pre> @@ -569,7 +605,7 @@ Make sure the extension_uri data begins Make sure that "isapi_redirect.dll" follows "/jakarta/" in the extension_uri setting. </li> <li> -Check the workers.properties file and make sure the port setting for worker.ajp12.port is the same as the port specified in the server.xml for the "Apache AJP12 support". +Check the workers.properties file and make sure the port setting for worker.ajp13.port is the same as the port specified in the server.xml for the "AJP" connector. </li> </ul> @@ -588,7 +624,7 @@ for the jakarta virtual directory in the <p> If the above settings are correct, the index.html page should appear in your browser. -You should also be able to click the Execute links to execute the JSP examples. +You should also be able to click the links to execute some Servlet or JSP examples. </p> </blockquote></td></tr></table> @@ -629,7 +665,7 @@ If the above are set correctly, the gree </ul> <p> -Invoke the URL <a href="http://localhost/examples/jsp/index.html";>http://localhost/examples/jsp/index.html</a> +Invoke the URL <a href="http://localhost/examples/";>http://localhost/examples/</a> in your browser. Case is important in Tomcat. The characters following "localhost" in the URL must be lower case. If the page fails to appear, examine the last line in the IIS server log file in found in SYSTEM32/LogFiles/W3SVC1. </p> @@ -640,7 +676,7 @@ which indicates the ISAPI redirector is </p> <p> -You should check the HTTP error code following GET "/..." : +You should check the HTTP error code following GET "/...": </p> <div class="example"><pre> @@ -667,7 +703,7 @@ Make sure the virtual directory created Make sure that the extension_uri setting is correct. </li> <li> -Check the workers.properties file and make sure the port setting for worker.ajp12.port is the same as the port specified in the server.xml for the "Apache AJP12 support". +Check the workers.properties file and make sure the port setting for worker.ajp13.port is the same as the port specified in the server.xml for the "AJP" connector. </li> </ul> @@ -686,11 +722,11 @@ Advanced Options of the Personal Web Man <p> If the above settings are correct, the index.html page should appear in your browser. -You should also be able to click the Execute links to execute the JSP examples. +You should also be able to click the links to execute some Servlet or JSP examples. </p> </blockquote></td></tr></table> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file
Modified: tomcat/site/trunk/docs/connectors-doc/webserver_howto/nes.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/connectors-doc/webserver_howto/nes.html?rev=1763527&r1=1763526&r2=1763527&view=diff ============================================================================== --- tomcat/site/trunk/docs/connectors-doc/webserver_howto/nes.html (original) +++ tomcat/site/trunk/docs/connectors-doc/webserver_howto/nes.html Thu Oct 6 09:00:17 2016 @@ -1,13 +1,15 @@ -<html><head><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>The Apache Tomcat Connectors - Webserver HowTo - SunOne -- Netscape/iPlanet HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Jim Jagielski"><meta name="email" value="j...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Mladen Turk"><meta name="email" value="mt...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; ali gn="right" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Webserver HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server</a></li><li><a href="../webserver_howto/iis.html">IIS</a></li><li><a href="../webserver_howto/nes.html">Netscape/SunOne/Sun</a></li></ul><p><strong>Reference Guide</strong></p><ul><li><a href="../reference/wo rkers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server</a></li><li><a href="../reference/iis.html">IIS</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_stat us=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.html">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101. html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Webserver HowTo</h1><h2>SunOne -- Netscape/iPlanet HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/nes.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version +<html><head><META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"><title>The Apache Tomcat Connectors - Web Server HowTo - Planet web server HowTo</title><meta name="author" value="Henri Gomez"><meta name="email" value="hgo...@apache.org"><meta name="author" value="Jim Jagielski"><meta name="email" value="j...@apache.org"><meta name="author" value="Gal Shachor"><meta name="email" value="shac...@il.ibm.com"><meta name="author" value="Mladen Turk"><meta name="email" value="mt...@apache.org"><link href="../style.css" type="text/css" rel="stylesheet"></head><body bgcolor="#ffffff" text="#000000" link="#525D76" alink="#525D76" vlink="#525D76"><table border="0" width="100%" cellspacing="4"><!--PAGE HEADER--><tr><td colspan="2"><!--TOMCAT LOGO--><a href="http://tomcat.apache.org/";><img src="../images/tomcat.gif" align="left" alt="Apache Tomcat" border="0"></a><!--APACHE LOGO--><a href="http://www.apache.org/";><img src="http://www.apache.org/images/asf-logo.gif"; align="righ t" alt=" :: Apache Software Foundation" border="0"></a></td></tr><!--HEADER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><tr><!--LEFT SIDE NAVIGATION--><td width="20%" valign="top" nowrap="true"><p><strong>Links</strong></p><ul><li><a href="../index.html">Docs Home</a></li></ul><p><strong>Common HowTo</strong></p><ul><li><a href="../common_howto/quick.html">For the impatient</a></li><li><a href="../common_howto/workers.html">All about workers</a></li><li><a href="../common_howto/timeouts.html">Timeouts</a></li><li><a href="../common_howto/loadbalancers.html">Load Balancing</a></li><li><a href="../common_howto/proxy.html">Reverse Proxy</a></li></ul><p><strong>Web Server HowTo</strong></p><ul><li><a href="../webserver_howto/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../webserver_howto/iis.html">Microsoft IIS (ISAPI redirector)</a></li><li><a href="../webserver_howto/nes.html">iPlanet Web Server (NSAPI redirector)</a></li></ul><p><strong>Reference G uide</strong></p><ul><li><a href="../reference/workers.html">workers.properties</a></li><li><a href="../reference/uriworkermap.html">uriworkermap.properties</a></li><li><a href="../reference/status.html">Status Worker</a></li><li><a href="../reference/apache.html">Apache HTTP Server (mod_jk)</a></li><li><a href="../reference/iis.html">Microsoft IIS (ISAPI redirector)</a></li></ul><p><strong>AJP Protocol Reference</strong></p><ul><li><a href="../ajp/ajpv13a.html">AJPv13 (ajp13)</a></li><li><a href="../ajp/ajpv13ext.html">AJPv13 Extension Proposal</a></li></ul><p><strong>Miscellaneous Documentation</strong></p><ul><li><a href="../miscellaneous/faq.html">Frequently asked questions</a></li><li><a href="../miscellaneous/changelog.html">Changelog</a></li><li><a href="http://issues.apache.org/bugzilla/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=Tomcat+Connectors&long_desc_type=substring&long_desc=&bug_file_loc_type=allwordssu bstr&bug_file_loc=&keywords_type=allwords&keywords=&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&bugidtype=include&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Reuse+same+sort+as+last+time&field0-0-0=noop&type0-0-0=noop&value0-0-0=">Current Tomcat Connectors bugs</a></li><li><a href="../miscellaneous/doccontrib.html">Contribute documentation</a></li><li><a href="../miscellaneous/jkstatustasks.html">JK Status Ant Tasks</a></li><li><a href="../miscellaneous/reporttools.html">Reporting Tools</a></li><li><a href="http://tomcat.apache.org/connectors-doc-archive/jk2/index.html";>Old JK/JK2 documentation</a></li></ul><p><strong>News</strong></p><ul><li><a href="../news/20140201.html">2014</a></li><li><a href="../news/20120301.htm l">2012</a></li><li><a href="../news/20110701.html">2011</a></li><li><a href="../news/20100101.html">2010</a></li><li><a href="../news/20090301.html">2009</a></li><li><a href="../news/20081001.html">2008</a></li><li><a href="../news/20070301.html">2007</a></li><li><a href="../news/20060101.html">2006</a></li><li><a href="../news/20050101.html">2005</a></li><li><a href="../news/20041100.html">2004</a></li></ul></td><!--RIGHT SIDE MAIN BODY--><td width="80%" valign="top" align="left"><table border="0" width="100%" cellspacing="4"><tr><td align="left" valign="top"><h1>The Apache Tomcat Connectors - Web Server HowTo</h1><h2>Planet web server HowTo</h2></td><td align="right" valign="top" nowrap="true"><small><a href="printer/nes.html"><img src="../images/printer.gif" border="0" alt="Printer Friendly Version"><br>print-friendly<br>version </a></small></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Introduction"><strong>Introduction</strong></a></font></td></tr><tr><td><blockquote> <p> -This document explains how to set up Sun ONE Web Server previously known as -Netscape web servers to cooperate with Tomcat. +This document explains how to set up the iPlanet Web Server +to cooperate with Tomcat. The iPlanet Web Server was previously known under +various names, including Netscape Enterprise Server, SunOne Web Server and +Sun Enterprise System web server. </p> <p> -Normally the Sun ONE Web Servers come with their own Servlet engine, -but you can also configure them to send servlet and JSP requests to Tomcat +Normally the iPlanet Web Server comes with its own Servlet engine, +but you can also configure it to send servlet and JSP requests to Tomcat using the NSAPI redirector plugin. </p> @@ -36,14 +38,14 @@ ${tomcat_home}\bin - Where you place web </p> <p> In all the examples in this document ${tomcat_home} will be <b>c:\tomcat</b>. -A worker is defined to be a tomcat process that accepts work from the Sun ONE Web Server. +A worker is defined to be a tomcat process that accepts work from the iPlanet Web Server. </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Supported Configuration"><strong>Supported Configuration</strong></a></font></td></tr><tr><td><blockquote> <p> -The NSAPI-Tomcat redirector was developed and tested on: +The NSAPI redirector was developed and tested on: <ul> <li> WINNT 2000/XP/2003 (should be able to work with other service packs) and some Unixes @@ -58,52 +60,43 @@ Tomcat 4.1 to Tomcat 8. </p> <p> -The redirector uses <b>ajp12</b> and <b>ajp13</b> to send requests to the Tomcat containers. -There is also an option to use Tomcat in process, -more about the in-process mode can be found in the in process howto. +The redirector uses the AJP protocol to send requests to the Tomcat containers. +The AJP version typically used is <b>ajp13</b>. </p> </blockquote></td></tr></table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Who support ajp protocols ?"><strong>Who support ajp protocols ?</strong></a></font></td></tr><tr><td><blockquote> +<table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Who supports AJP protocols?"><strong>Who supports AJP protocols?</strong></a></font></td></tr><tr><td><blockquote> <p> -The ajp12 protocol is only available in Tomcat 3.2.x and 3.3.x. +Tomcat supports ajp13 since Tomcat 3.2. +Others servlet engines such as <b>Jetty</b> or <b>JBoss</b> also support the ajp13 protocol </p> <p> -The <b>ajp12</b> has been <b>deprecated</b> with Tomcat 3.3.x and you should use instead -<b>ajp13</b> which is the only ajp protocol known by Tomcat 4 and above. -</p> - -<p> -Of course Tomcat 3.2.x and 3.3.x also support ajp13 protocol. -</p> - -<p> -Others servlet engines such as <b>jetty</b> have support for ajp13 protocol +The <b>ajp12</b> protocol has been <b>deprecated</b> and you should no longer use it. +The <b>ajp14</b> protocol is considered experimental. </p> </blockquote></td></tr></table> - <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="How does it work ?"><strong>How does it work ?</strong></a></font></td></tr><tr><td><blockquote> <p> <ol> <li> -The NSAPI-Tomcat redirector is an Netscape service step plugin, -Netscape load the redirector plugin and calls its service handler -function for request that are assigned to the "servlet" configuration object. +The NSAPI redirector is a web server plugin based on the NSAPI web server API. +The web server loads the NSAPI redirector plugin and calls its service handler +function for all requests that are assigned to the "servlet" configuration object. </li> <li> -For each in-coming request Netscape will execute the set of NameTrans directives -that we added to obj.conf, the assign-name function will check if it's from +For each in-coming request the web server will execute the set of NameTrans directives +that we added to obj.conf, the assign-name function will check if it's <b class="code">from</b> parameter matches the request URL. </li> <li> If a match is found, assign-name will assign the servlet object name to the request. -This will cause Netscape to send the request to the servlet configuration object. +This will cause the web server to send the request to the servlet configuration object. </li> <li> -Netscape will execute our jk_service extension. The extension collects the +The web server will execute our jk_service extension. The extension collects the request parameters and forwards them to the appropriate worker using the ajp13 protocol (the worker="defworker" parameter in jk_service inform it that the worker for this request is named <b>defworker</b>). the workers properties files, <b>workers.properties</b>, will indicate that defworker use ajp13 protocol. @@ -118,21 +111,19 @@ The extension collects the response from </blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Installation"><strong>Installation</strong></a></font></td></tr><tr><td><blockquote> <p> A pre-built version of the NSAPI redirector, nsapi_redirect.dll, may be available under -the win32/i386 directory of tomcat-connectors distribution. -For those using Netscape as your browser, try downloading a zip version of the file, if available. - -You can also build a copy locally from the source present in tomcat-connectors distribution. - - -The Tomcat redirector requires two entities: +the win32/i386 directory of the Tomcat Connectors distribution. +You can also build a copy locally from the Tomcat Connectors source distribution. +</p> +<p> +The NSAPI redirector requires two files: <ul> <li> -nsapi_redirect.dll (Windows) -or- nsapi_redirector.so (Unix) - The NSAPI server plugin, either obtain a pre-built DLL/so or build it yourself +nsapi_redirect.dll (Windows) -or- nsapi_redirector.so (Unix) - The NSAPI web server plugin, either obtain a pre-built DLL/so or build it yourself (see the build section). </li> <li> workers.properties - A file that describes the host(s) and port(s) used by the workers (Tomcat processes). -A sample workers.properties can be found under the conf directory. +A sample workers.properties can be found under the conf directory of the source distribution. </li> </ul> @@ -141,10 +132,10 @@ The installation includes the following <ul> <li> Configuring the NSAPI redirector with a default /examples context and checking that you can serve servlets -with Netscape. +with your browser. </li> <li> -Adding more contexts to the configuration. +Adding your own contexts to the configuration. </li> </ul> @@ -161,7 +152,7 @@ and you created a log directory <b>c:\jk If the built in servlet support is working disable it. </li> <li> -Add the redirector plugin into the Netscape server configuration. +Add the NSAPI redirector plugin into the iPlanet Web Server configuration. Edit your server <b>magnus.conf</b> and add the following lines: </li> </ul> @@ -182,8 +173,7 @@ Edit your server <b>obj.conf</b> and add In the default object NameTrans section <Object name="default"> - NameTrans fn="assign-name" from="/servlets-examples(|/*)" name="jknsapi" - NameTrans fn="assign-name" from="/jsp-examples(|/*)" name="jknsapi" + NameTrans fn="assign-name" from="/examples(|/*)" name="jknsapi" .... </Object> @@ -214,12 +204,12 @@ Edit your worker definition file <b>work <ul> <li> -Restart Web Server (stop and start the server) +Restart the web server (stop and start the server) </li> </ul> <p> -That's all, now you should start tomcat and ask for http://server:port/servlets-examples/ +That's all, now you should start tomcat and ask for http://server:port/examples/ </p> <p><font color="#ff0000"> The file <b>obj.conf</b> seems to be sensitive to leading white space in lines, especially in @@ -247,41 +237,41 @@ all you need to do is to edit <b>obj.con </p> <div class="example"><pre> - NameTrans fn="assign-name" from="/<context name>/*" name="jknsapi" + NameTrans fn="assign-name" from="/<context_name>/*" name="jknsapi" </pre></div> <p> -After saving <b>obj.conf</b> restart Netscape and it will serve the new context. +After saving <b>obj.conf</b> restart the web server and it will serve the new context. </p> </blockquote></td></tr></table> <table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#828DA6"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Advanced Context Configuration"><strong>Advanced Context Configuration</strong></a></font></td></tr><tr><td><blockquote> <p> -Sometimes it is better to have Netscape serve the static pages (html, gif, jpeg etc.) -even if these files are part of a context served by Tomcat. For example, consider the html and gif files in the examples context, there is no need to serve them from the Tomcat process, Netscape will suffice. +Sometimes it is better to have the web server serve the static pages (html, gif, jpeg etc.) +even if these files are part of a context served by Tomcat. For example, consider the html and gif files in the examples context, there is no need to serve them from the Tomcat process. The web server can do it on its own. </p> <p> -Making Netscape serve static files that are part of the Tomcat contexts requires the following: +Making the web server serve static files that are part of the Tomcat contexts requires the following: </p> <ul> <li> -Configuring Netscape to know about the Tomcat contexts +Configuring the web server to know about the Tomcat contexts </li> <li> -Make sure that the WEB-INF directory is protected from access. +Make sure that the WEB-INF and META-INF directories are protected from access. </li> <li> -Configuring Netscape to assign the NSAPI redirector only specific requests that requires JSP/Servlet handling. +Configuring the web server to assign the NSAPI redirector only specific requests that requires JSP/Servlet handling. </li> </ul> <p> -Adding a Tomcat context to Netscape requires the addition of a new Netscape virtual directory +Adding the contents of a Tomcat context to the web server requires the addition of a new virtual directory that covers the Tomcat context. </p> <p> -For example, adding a /example Netscape virtual directory that +For example, adding a /example virtual directory that covers the <b>c:\tomcat\webapps\examples</b> directory. </p> @@ -296,17 +286,20 @@ To add a new virtual directory add the f <p> WEB-INF protection requires some explanation; Each servlet application (context) has a special directory named <b>WEB-INF</b>, this directory contains sensitive configurations data and Java classes and must be kept hidden from web users. -WEB-INF can be protected by adding the following line to the PathCheck section in the default configuration object: +A second directory that should be protected is META-INF. +Those directories can be protected by adding the following line to the PathCheck section in the default configuration object: </p> <div class="example"><pre> PathCheck fn="deny-existence" path="*/WEB-INF/*" - - This line instructs the Netscape server to reject any request with a URL that contain the path /WEB-INF/. + PathCheck fn="deny-existence" path="*/META-INF/*" </pre></div> +These lines instruct the web server to reject any request with a URL that contains the path /WEB-INF/ +or /META-INF/. + <p> -Configuring Netscape to assign the NSAPI redirector only specific requests is somewhat harder, +Configuring the web server to assign the NSAPI redirector only specific requests is somewhat harder, you will need to specify the exact URL-Path pattern(s) that you want Tomcat to handle (usually only JSP files and servlets). </p> @@ -328,7 +321,7 @@ This requires a change to NameTrans port <p> As you can see the second configuration is more explicit, it actually instructs -Netscape to assign the redirector with only requests to resources under +the web server to assign the redirector with only requests to resources under <b>/examples/servlet/</b> and resources under <b>/examples/</b> whose name ends with <b>.jsp</b>. </p> @@ -337,9 +330,9 @@ You can be even more explicit and provid </p> <div class="example"><pre> - NameTrans fn="assign-name" from="/examples/servletname" name="jknsapi" + NameTrans fn="assign-name" from="/examples/servlets/chat" name="jknsapi" - Instructs Netscape to assign the redirector request whose URL-Path equals /example/servletname + Instructs the web server to assign the redirector requests whose URL path equals /example/servlets/chat </pre></div> </blockquote></td></tr></table> @@ -397,18 +390,18 @@ and in the <a href="../reference/workers </p> </blockquote></td></tr></table> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building NSAPI DLL redirector for Windows"><strong>Building NSAPI DLL redirector for Windows</strong></a></font></td></tr><tr><td><blockquote> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building the NSAPI redirector for Windows"><strong>Building the NSAPI redirector for Windows</strong></a></font></td></tr><tr><td><blockquote> <p> The redirector was developed using Visual C++ Ver.6.0, so having this environment is a prereq if you want -to perform a custom build. You should also have NES developer SDK +to perform a custom build. You should also have web server developer SDK for your version of the web server. The steps that you need to take are: <ul> <li> -Change directory to the nsapi plugins source directory. +Change directory to the <b class="code">native/netscape</b> source directory. </li> <li> -Edit <b>nsapi.dsp</b> and update the include and library path to reflect your own Netscape server installation +Edit <b>nsapi.dsp</b> and update the include and library path to reflect your own web server installation (search for a <b>/I compiler</b> option and <b>/libpath</b> linker option) </li> <li> @@ -416,36 +409,39 @@ Make the source with MSDEV </li> </ul> <screendos> -<notedos>Change directory to the nsapi plugins source directory</notedos> -<code><nobr><em class="screen">c:\></em><b class="screen">cd c:\home\apache\jk\nsapi</b></nobr></code><br> +<notedos>Change directory to the NSAPI redirector source directory</notedos> +<code><nobr><em class="screen">c:\></em><b class="screen">cd c:\tomcat-connectors-xxx-src\native\netscape</b></nobr></code><br> <notedos>Build the sources using MSDEV</notedos> <code><nobr><em class="screen">c:\></em><b class="screen">MSDEV nsapi.dsp /MAKE ALL</b></nobr></code><br> </screendos> </p> <p> If msdev is not in your path, enter the full path to msdev.exe. -This will build both release and debug versions of the redirector plugin. +This will build both release and debug versions of the NSAPI redirector plugin. An alternative will be to open the nsapi workspace file (nsapi.dsw) in msdev and build it using the build menu. </p> -</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building NSAPI so plugin redirector for Unix"><strong>Building NSAPI so plugin redirector for Unix</strong></a></font></td></tr><tr><td><blockquote> +<p> +After the build, you will have the required nsapi_redirect.dll plugin. +</p> +</blockquote></td></tr></table><table border="0" cellspacing="0" cellpadding="2" width="100%"><tr><td bgcolor="#525D76"><font color="#ffffff" face="arial,helvetica.sanserif"><a name="Building the NSAPI redirector for Unix"><strong>Building the NSAPI redirector for Unix</strong></a></font></td></tr><tr><td><blockquote> <p> The redirector requires either gcc (Linux) or gcc or the Sun cc compiler (Solaris). The steps that you need to take are: <ul> <li> -Change directory to the nsapi plugins source directory (src/native). +Change directory to the <b class="code">native</b> source directory. </li> <li> -configure for Netscape/iPlanet/SunONE webserver. +configure for the iPlanet Web Server. </li> <li> -Change directory to the nsapi netscape directory (./netstape). +Change directory to the <b class="code">netscape</b> sub directory. </li> <li> Set environment variables JAVA_HOME resp. SUITSPOT_HOME to the location of your Java installation -resp. Netscape server installation. Depending on the web server version, you must add the subdirectory +resp. web server server installation. Depending on the web server version, you must add the subdirectory "plugins" to SUITSPOT_HOME. The variable is correct, if the file $SUITSPOT_HOME/include/nsapi.h exists. </li> @@ -459,11 +455,11 @@ Make the source with gmake. </li> </ul> <screendos> -<notedos>Change directory to the nsapi plugins source directory</notedos> +<notedos>Change directory to the NSAPI redirector source directory</notedos> <code><nobr><em class="screen">c:\></em><b class="screen">cd /usr/local/src/tomcat-connectors-xxx-src/native</b></nobr></code><br> -<notedos>configure for Netscape/iPlanet/SunONE webserver</notedos> +<notedos>configure for iPlanet Web Server</notedos> <code><nobr><em class="screen">c:\></em><b class="screen">./configure --enable-netscape</b></nobr></code><br> -<notedos>Change directory to the nsapi netscape directory</notedos> +<notedos>Change directory to the netscape directory</notedos> <code><nobr><em class="screen">c:\></em><b class="screen">cd netscape</b></nobr></code><br> <notedos>Set JAVA_HOME (ksh example)</notedos> <code><nobr><em class="screen">c:\></em><b class="screen">export JAVA_HOME=/path/to/my/java</b></nobr></code><br> @@ -479,5 +475,5 @@ Make the source with gmake. After the build, you will have the required nsapi_redirector.so plugin. </p> </blockquote></td></tr></table></td></tr><!--FOOTER SEPARATOR--><tr><td colspan="2"><hr noshade size="1"></td></tr><!--PAGE FOOTER--><tr><td colspan="2"><div align="center"><font color="#525D76" size="-1"><em> - Copyright © 1999-2015, Apache Software Foundation + Copyright © 1999-2016, Apache Software Foundation </em></font></div></td></tr></table></body></html> \ No newline at end of file --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}