head	1.3;
access;
symbols;
locks; strict;
comment	@# @;


1.3
date	99.06.22.22.00.32;	author pcurtis;	state Exp;
branches;
next	1.2;

1.2
date	99.06.11.20.46.33;	author pcurtis;	state Exp;
branches;
next	1.1;

1.1
date	98.12.01.16.48.06;	author pier;	state Exp;
branches;
next	;


desc
@@


1.3
log
@Updated LICENSE text.
@
text
@/*
 *  JServ/NSAPI  -- A servlet runner for Netscape Enterprise/FastTrack
 *                  web servers.
 *
 *  This NSAPI module implements the Apache Jserv APJv1.1 protocol to
 *  communicate with Java VM servlet engines using Apache JServ 1.0x
 *
 *  This software contains derivative works as follows:
 *    MD5C.C - RSA Data Security, Inc., MD5 message-digest algorithm
 *    Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. 
 *    All rights reserved.
 *
 *
 */

The software should compile for both v2.x and v3.x Netscape Enterprise or FastTrack servers.

NOTES
The plugin does not have the ability to start a JVM for you. You must start the JVM manually.


KNOWN BUGS
* Authentication does not work.
* No status pages


INSTALLATION
1. You must edit the Makefile for your platform. See the NSAPI Programmer's Guide for details,
   or read the online documentation for the NSAPI interface at http://developer.netscape.com
   under the "Documentation" heading.

   Check the CC, OS_DEF, LD_SHARECMD, and INCLUDEDIR in the Makefile, and edit to your needs.

2. Type make

3. Copy the resulting .so file to the appropriate place. Most people put NSAPI libs below
   the server root in a directory like "plugins."

4. Now you must modify the obj.conf for your servers. Here is the syntax:

# This line loads the plugin, and enumerates the functions [REQUIRED]
Init funcs="jserv_jsp,jserv_init,jserv_servlet" fn="load-modules" \
shlib="/path/to/jserv_nsapi.so"

# This line initializes the plugin. The optional args set "defaults" for ALL directives that
# follow. The defaults can be overidden for each directive. The "debug=1" arg writes a lot of
# AJPV protocol information to a file called "/tmp/jrun.log" [REQUIRED]
Init fn="jserv_init" <debug=1> <default_jhost="host"> <default_jport="8888"> \
  <default_jzone="servlet-zone"> <default_auth="secret_key">

# This line sets a servlet path. The "mount" arg is the URI that will be translated. The
# optional args allow you to override the defaults set in the "Init" line [Optional]
Service fn="jserv_servlet" mount="/docs/common" <jhost="host"> <jport="8888"> \
  <jzone="servlet-zone"> <auth="secret_key">

# This line sets up a JSP mime-type to JSP class. The "jsp" arg is required. The
# optional args allow you to override the defaults set in the "Init" line. See the mime.types
# file below for the details on setting up an extension-to-mime-type mapping.
Service fn="jserv_jsp" type="magnus-internal/jserv" jsp="org.gjt.jsp.JSPServlet"
  <jhost="host"> <jport="8888"> <jzone="servlet-zone"> <auth="secret_key">


5. If you are using JSPs, add a line like this to th bottom of the "mime.types" file:
type=magnus-internal/jserv     exts=jsp

6. Restart the server.
@


1.2
log
@Initial whiteboard version of NSAPI module
@
text
@a7 4
 *  This software is covered under the GNU Public License version 2.
 *  See LICENSE.TXT for details
 *  Copyright (c) 1999 Paul Curtis, pcurtis@@netscape.com
 *
a12 2
 *    Portions of jserv_ajpv11.c
 *    Copyright (c) 1997-1999 The Java Apache Project.  All rights reserved.
@


1.1
log
@Moved these files to the right directory
@
text
@d1 72
a72 8
These files were developed against JServ 0.9.7, and should be considered
code in development. They DO NOT work with current CVS distribution and
need more extensive testing as well as generalization away from the specific
project for which they were built.

This code is provided courtesy of Organic Online, Inc.; Organic offers
no warrantis with respect to fitness for any purpose whatsoever.  Use
at your own risk.@

