iPlanet

This page shows an example configuration of Expresso for iPlanet 4.1 running under Windows NT 4.0

Of course, you should refer to the release notes and install documents for iPlanet first, to ensure you have iPlanet up and operational before attempting to install or configure Expresso.

Be sure you have both Servlet and JSP support activated for your iPlanet installation.

Directories

Assuming iPlanet was installed in d:\iplanet, there will be a directory d:\iplanet\bin\https\jar which contains the servlet.jar file - you need to include this file in your path when compiling to make sure you're using the same servlet API at runtime.

The key configuration files for registering servlets are located in d:\iplanet\https-<servername;gt;\config.

In the above config directory are servlets.properties and rules. properties, the contents of which are shown below. I'm not sure why rules.properties must list each servlet, and there is probably a far better way, but this does work.

The exact same properties file for Expresso (read by DefaultInit) can be used as would be used for any other web server - the properties file tends to vary more with the database than with the web server.

servlets.properties

# @(#)servlets.properties (autogenerated)
#
# Servlets Properties
#
# servlet.<servlet name>.code=class name (foo or foo.class)
# servlet.<servlet name>.context=name of the context
# servlet.<servlet name>.classpath=the url or path to the directory where classes are located (no backslashes)
#                          or the list of directories (but not urls) or jar files, just like CLASSPATH
# servlet.<servlet name>.initArgs=list of {name, value} pairs which can be accessed
#                          by the servlet using the servlet API calls
# servlet.<servlet_name>.startup=true
#
# For example:
# servlet.wasp.code=WASPServlet
# servlet.wasp.classpath=this is optional
# servlet.wasp.initArgs=initial=0
# servlet.wasp.context=global
# servlet.wasp.startup=true
#
# General properties:
#
# Deprecated (use contexts.properties instead):
# servlets.config.docRoot=E:/Netscape/SuiteSpot/docs (forward slashes only)
# servlets.config.realPathFromRequest=false
# servlets.config.respondCookieVersion=0
# servlets.config.sessionExpireOnClose=false
# servlets.sessionmgr=com.netscape.server.http.session.SimpleSessionManager
# servlets.sessionmgr.initArgs=
# servlets.startup=hello,byebye

# Servlets for Expresso App Framework

servlets.startup=DefaultInit

servlet.Status.classpath=c:/java/lib
servlet.Status.code=com.jcorporate.expresso.services.servlet.Status

servlet.DefaultInit.classpath=c:/java/lib
servlet.DefaultInit.code=com.jcorporate.expresso.core.servlet.DefaultInit
servlet.DefaultInit.initArgs=configDir=d:/iplanet/docs/config
servlet.DefaultInit.startup=true

servlet.InitServletProps.code=com.jcorporate.expresso.core.servlet.Props
servlet.Search.code=com.jcorporate.expresso.ext.servlet.Search
servlet.ChangePassword.code=com.jcorporate.expresso.core.servlet.ChangePassword
servlet.SendNotice.code=com.jcorporate.expresso.ext.servlet.SendNotice
servlet.Download.code=com.jcorporate.expresso.ext.servlet.Download
servlet.Login.code=com.jcorporate.expresso.core.servlet.
servlet.RegisterUser.code=com.jcorporate.expresso.ext.servlet.RegisterUser
servlet.DBCreate.code=com.jcorporate.expresso.services.servlet.DBCreate
servlet.DBMaint.code=com.jcorporate.expresso.core.servlet.DBMaint
servlet.ShowLog.code=com.jcorporate.expresso.services.servlet.ShowLog
servlet.Status.code=com.jcorporate.expresso.services.servlet.Status
servlet.ClearLogs.code=com.jcorporate.expresso.services.servlet.ClearLogs
servlet.Test.code=com.jcorporate.expresso.core.servlet.Test
servlet.Logout.code=com.jcorporate.expresso.core.servlet.
servlet.RunSQL.code=com.jcorporate.expresso.ext.servlet.RunSQL
servlet.ControllerServlet.code=com.jcorporate.expresso.core.servlet.ControllerServlet
servlet.ControllerActionServlet.code=com.jcorporate.expresso.core.servlet.ControllerActionServlet
#

rules.properties

# Servlet rules properties	(autogenerated)
#
# This file specifies the translation rules for invoking servlets.
# The syntax is:
#	<virtual-path>=<servlet-name>
#	or
#	@regular_expression=<servlet-name> (use double back-slashes)
#
# where <virtual-path> is the virtual path used to invoke the servlet,
# and <servlet-name> is the name of the servlet. Surrounding white space
# is ignored. The ordering of the rules is not important, as the longest
# match will always be used first. Use of regular expression can lead to
# a heavy peformance penalty
#
# Example:
# /simple=SimpleServlet
# @.*\.foo=wasp
################################# rules ################################
/servlet/Status=Status
/servlet/DefaultInit=DefaultInit
/servlet/Search=Search
/servlet/ChangePassword=ChangePassword
/servlet/SendNotice=SendNotice
/servlet/Download=Download
/servlet/Login=Login
/servlet/RegisterUser=RegisterUser
/servlet/DBCreate=DBCreate
/servlet/DBMaint=DBMaint
/servlet/ShowLog=ShowLog
/servlet/Status=Status
/servlet/ClearLogs=ClearLogs
/servlet/Logout=Logout
/servlet/ControllerServlet=ControllerServlet
/servlet/ControllerActionServlet=ControllerActionServlet

Please report any difficulties or updates to this configuration example to support at support@jcorporate.com