mturk 2005/03/23 22:42:34 Modified: jk/xdocs/howto nes.xml project.xml Log: Netscape is now SunONE Web Server. Start updating documentation. Also now we have two config files obj.conf and magnus.conf. Revision Changes Path 1.2 +44 -32 jakarta-tomcat-connectors/jk/xdocs/howto/nes.xml Index: nes.xml =================================================================== RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/howto/nes.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- nes.xml 18 Nov 2004 18:30:36 -0000 1.1 +++ nes.xml 24 Mar 2005 06:42:34 -0000 1.2 @@ -21,21 +21,23 @@ limitations under the License. </copyright> <properties> -<title>Netscape/iPlanet HowTo</title> +<title>SunOne -- Netscape/iPlanet HowTo</title> <author email="[EMAIL PROTECTED]">Henri Gomez</author> <author email="[EMAIL PROTECTED]">Gal Shachor</author> +<author email="[EMAIL PROTECTED]">Mladen Turk</author> <date>$Date$</date> </properties> <body> <section name="Introduction"> <p> -This document explains how to set up Netscape web servers to cooperate with Tomcat. +This document explains how to set up Sun ONE Web Server previously known as +Netscape web servers to cooperate with Tomcat. </p> <p> -Normally the Netscape web servers come with their own Servlet engine, +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 -using the Tomcat redirector plugin. +using the NSAPI redirector plugin. </p> <p> @@ -63,23 +65,23 @@ </p> <p> In all the examples in this document ${tomcat_home} will be <b>c:\jakarta-tomcat</b>. -A worker is defined to be a tomcat process that accepts work from the Netscape/iPlanet server. +A worker is defined to be a tomcat process that accepts work from the Sun ONE Web Server. </p> </subsection> <subsection name="Supported Configuration"> <p> -The Netscape-Tomcat redirector was developed and tested on: +The NSAPI-Tomcat redirector was developed and tested on: <ul> <li> -WinNT4.0-i386 SP4/SP5/SP6a (should be able to work with other service packs) and some Unixes +WINNT 2000/XP/2003 (should be able to work with other service packs) and some Unixes </li> <li> -Netscape Enterprise 3.0 and 3.61 +Sun ONE Web Server 6.1 </li> <li> -Tomcat 3.2.x, 3.3.x, Tomcat 4.0.x, Tomcat 4.1.x and Tomcat 5 +Tomcat 4.1.x , Tomcat 5.0.x and Tomcat 5.5.x </li> </ul> </p> @@ -116,7 +118,7 @@ <p> <ol> <li> -The Netscape-Tomcat redirector is an Netscape service step plugin, +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. </li> @@ -146,10 +148,9 @@ <section name="Installation"> <p> -A pre-built version of the Netscape redirector, nsapi_redirect.dll, may be available under +A pre-built version of the NSAPI redirector, nsapi_redirect.dll, may be available under the win32/i386 directory of jakarta-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. You can also build a copy locally from the source present in jakarta-tomcat-connectors distribution. @@ -157,7 +158,7 @@ The Tomcat redirector requires two entities: <ul> <li> -nsapi_redirect.dll - The Netscape server plugin, either obtain a pre-built DLL or build it yourself +nsapi_redirect.dll - The NSAPI server plugin, either obtain a pre-built DLL or build it yourself (see the build section). </li> <li> @@ -190,41 +191,51 @@ <ul> <li> -If the Netscape built in servlet support is working disable it. +If the built in servlet support is working disable it. </li> <li> Add the redirector plugin into the Netscape server configuration. -Edit your server <b>obj.conf</b> and add the following lines: +Edit your server <b>magnus.conf</b> and add the following lines: </li> </ul> <source> - In the Init section: - Init fn="load-modules" funcs="jk_init,jk_service" shlib="c:/jk/lib/nsapi_redirect.dll" + Init fn="load-modules" funcs="jk_init,jk_service" shlib="c:/jk/lib/nsapi_redirect.dll" shlib_flags="(global|now)" Init fn="jk_init" worker_file="c:/jk/conf/workers.properties" log_level="debug" log_file="c:/jk/logs/nsapi.log" +</source> +<ul> +<li> +Edit your server <b>obj.conf</b> and add the following lines: +</li> +</ul> +<source> + In the default object NameTrans section - - NameTrans fn="assign-name" from="/servlet/*" name="servlet" - NameTrans fn="assign-name" from="/examples/*" name="servlet" + <Object name="default"> + + NameTrans fn="assign-name" from="/servlets-examples(|/*)" name="jknsapi" + NameTrans fn="assign-name" from="/jsp-examples(|/*)" name="jknsapi" + .... + </Object> Create a new configuration object by adding the following lines to the end of the obj.conf file - <Object name=servlet> + <Object name="jknsapi"> ObjectType fn=force-type type=text/plain - Service fn="jk_service" worker="worker1" + Service fn="jk_service" method="*" worker="worker1" </Object> </source> <ul> <li> -Restart Netscape (stop and start the server) +Restart Web Server (stop and start the server) </li> </ul> <p> -That's all, now you should start tomcat and ask Netscape for http://server:port/examples/ +That's all, now you should start tomcat and ask for http://server:port/servlets-examples/ </p> <subsection name="Adding additional Contexts"> @@ -247,7 +258,7 @@ </p> <source> - NameTrans fn="assign-name" from="/<context name>/*" name="servlet" + NameTrans fn="assign-name" from="/<context name>/*" name="jknsapi" </source> <p> @@ -318,12 +329,12 @@ <source> For the examples context it requires to replace the following line: - NameTrans fn="assign-name" from="/examples/*" name="servlet" + NameTrans fn="assign-name" from="/examples/*" name="jknsapi" with the following two lines: - NameTrans fn="assign-name" from="/examples/jsp/*.jsp" name="servlet" - NameTrans fn="assign-name" from="/examples/servlet/*" name="servlet" + NameTrans fn="assign-name" from="/examples/jsp/*.jsp" name="jknsapi" + NameTrans fn="assign-name" from="/examples/servlet/*" name="jknsapi" </source> <p> @@ -337,7 +348,7 @@ </p> <source> - NameTrans fn="assign-name" from="/examples/servletname" name="servlet" + NameTrans fn="assign-name" from="/examples/servletname" name="jknsapi" Instructs Netscape to assign the redirector request whose URL-Path equals /example/servletname </source> @@ -357,12 +368,13 @@ <source> #An entry that lists all the workers defined. For example: - worker.list=worker1, worker2 + worker.list=worker1,worker2 # Entries that define the host and port associated with these workers. worker.worker1.host=localhost worker.worker1.port=8009 worker.worker1.type=ajp13 + worker.worker2.host=otherhost worker.worker2.port=8009 worker.worker2.type=ajp13 @@ -381,7 +393,7 @@ </p> <source> - <Object name=servlet> + <Object name="jknsapi"> ObjectType fn=force-type type=text/plain Service fn="jk_service" worker="worker1" path="/examples/*" Service fn="jk_service" worker="worker2" path="/webpages/*" 1.3 +1 -1 jakarta-tomcat-connectors/jk/xdocs/howto/project.xml Index: project.xml =================================================================== RCS file: /home/cvs/jakarta-tomcat-connectors/jk/xdocs/howto/project.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- project.xml 23 Feb 2005 08:10:20 -0000 1.2 +++ project.xml 24 Mar 2005 06:42:34 -0000 1.3 @@ -21,7 +21,7 @@ <item name="Apache" href="apache.html"/> <item name="IIS" href="iis.html"/> <item name="Domino" href="domino.html"/> - <item name="Netscape" href="nes.html"/> + <item name="SunOne (Netscape)" href="nes.html"/> </menu> <menu name="Get Involved"> <item name="Contibute documentation" href="doccontrib.html"/>
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]