Configuring the Novell Servlet Gateway for NetWare

Novell Servlet Gateway for NetWare allows you to develop Java Servlets using the standard Java Servlet SDK. To do this, Novell JVM for NetWare and Netscape FastTrack or Enterprise Server for NetWare must be configured to use the Servlet Gateway for NetWare.

NOTE: These instructions assume that you have configured the Servlet Gateway for NetWare successfully. If you have not yet configured the Servlet Gateway, please do so before proceeding.

  1. Begin by setting the servletclasspath in SYS:\etc\java.cfg:

    SERVLETCLASSPATH=$SERVLETCLASSPATH;SYS:\java\lib\classes.zip;\iasp\lib\classes 
    SERVLETCLASSPATH=$SERVLETCLASSPATH;\iasp\lib\iasplib.jar;\iasp\lib\buttons.jar;\iasp\lib\jsdk.jar;\iasp\lib\rjax.jar 
    SERVLETCLASSPATH=$SERVLETCLASSPATH;\iasp\lib\iasp_image.jar;\iasp\lib\iasp_sock.jar;\iasp\lib\iasp_mail.jar 
    SERVLETCLASSPATH=$SERVLETCLASSPATH;\iasp\lib\ejbcorba.jar;\iasp\lib\iasp_chart.jar;\iasp\lib\activation.jar 
    SERVLETCLASSPATH=$SERVLETCLASSPATH;\iasp\lib\iasp_pop3.jar;\iasp\lib\iasp_exec.jar 


    NOTE: The above procedure presumes the root path of iASP program is installed as sys:\iasp folder. It must be adjusted to the fit with the Netware file/directory structure.

    The Servlet Gateway for NetWare now supports JSDK 2.0. The installation process updates the java.cfg file in the sys:\etc directory, adding a SERVLETCLASSPATH environment variable. The Java environment must be unloaded and restarted for this change to take effect. Enter the following commands to restart the Java environment:

    java -exit
    load java

  2. Next, copy SYS:\java\servlet\urlmap.sample to SYS:\java\servlet\urlmap.properties.

    You should open the urlmap.properties file and add the following two lines:

    *.ASP=Dispatcher.DispatcherServlet
    *.asp=Dispatcher.DispatcherServlet

  3. Finally, configure the servlet SYS:\Novonyx\suitespot\HTTPS-NW-SERVER\config\obj.conf.

    You can complete this step using either the Netscape server management pages or manually.

Using Netscape Fastrack or Enterprise Web Server configuration pages

Specify *.asp or *.ASP in the Configuration Styles|Assign a Style window of Netscape FastTrack or Enterprise web server. You should end up with a display similar to the following:

servletgateway.gif (3500 bytes)

NOTE: For further information on configuration options for Netscape FastTrack or Enterprise Web Servers, please consult your documentation.

Manual Configuration

To specify Java options for the Java portion of the ServletGate, edit the obj.conf file located in the config directory of your web server. This will typically be of the form SYS:\Novonyx\Suitespot\https-<NW ServerName>\config. The file should contain the following lines:

Init funcs="ServletGateInit,ServletGateService" shlib="SYS:/java/bin/nssgc.nlm" fn="load-modules"
Init fn="ServletGateInit" javaparms="-envCWD=sys:/java/servlets -classpath $SERVLETCLASSPATH" requestthreads="1"

<Object name="default">

NameTrans from="*.asp" fn="assign-name" name="Servlet Gateway for NetWare"
NameTrans from="*.ASP" fn="assign-name" name="Servlet Gateway for NetWare"

...

</Object>

...

<Object name="Servlet Gateway for NetWare">

service fn="ServletGateService"

</Object>

If you encounter any problems or errors, please contact support@halcyonsoft.com.


Copyright © 1998-2002, Halcyon Software Inc. All rights reserved.