IMPORTANT:  this has only been tested against Tomcat 4.1-dev


Please contact Martin Dengler [root@martindengler.com] with any questions


1) cd $TOMCAT_HOME

2) unzip CGIGatewayServlet.zip

   This will create the following files/directories:

   -  jakarta-tomcat-4.1/catalina/src/share/org/apache/catalina/servlets
         ... CGIGatewayServlet.java

   -  build/tomcat-4.1/webapps/ROOT
         ... /cgidir
         ... /cgidir/testcgi.sh
         ... /cgidir/index.html   [JAVADOC]
         ... /cgidir/[other javadoc files]

3) ensure the script is executable:

   chmod a+x build/tomcat-4.1/webapps/ROOT/cgidir/testcgi.sh

4) add a mapping for the CGIGatewayServlet in the Tomcat web.xml (or
   any webapp's web.xml that you prefer):
   
   build/tomcat-4.1/conf/web.xml:
   ... servlet definition:
     <!-- The CGI Gateway servlet that executes cgi scripts -->
       <servlet>
           <servlet-name>cgiGateway</servlet-name>
	       <servlet-class>org.apache.catalina.servlets.CGIGatewayServlet
	       </servlet-class>
	           <init-param>
		         <param-name>debug</param-name>
			 <param-value>3</param-value>
		   </init-param>
		   <init-param>
			 <param-name>clientInputTimeout</param-name>
			 <param-value>100</param-value>
	           </init-param>
           <load-on-startup>5</load-on-startup>
        </servlet>


   ... servlet mapping section:

     <!-- The mapping for the CGI Gateway servlet -->
     <!-- Comment this out if you do not want "CGI Gateway" service -->
       <servlet-mapping>
           <servlet-name>cgiGateway</servlet-name>
	       <url-pattern>/cgi-bin/*</url-pattern>
       </servlet-mapping>



5) rebuild tomcat (only the one file & dependant jar should change):
   
   cd jakarta-tomcat-4.1
   ./build.sh

6) restart tomcat

7) access http://localhost:8080/cgi-bin/cgidir/testcgi.sh to test