Edit Edit

Java Servlet FAQ


How do you install a servlet on Lotus Domino?


Most of the servlet configuration can be set from the Domino Administrator: click the Configuration tab, choose Server, and then open the Server document. Click the Internet Protocols - Domino Web Engine tab. Here you can set the CLASSPATH, the servlet engine to use (you can use WebSphere instead of the native Domino servlet engine), the servlet extensions to handle, etc.

The standard Java libraries installed with Domino are automatically in the class path. This setting allows you to add additional paths. You may specify directories, JAR files, and ZIP files. Paths may be absolute or relative to the Domino data directory. The following are examples of valid Class path entries:

  1. domino\servlet specifies files in the c:\lotus\domino\data\domino\servlet directory
  2. c:\apps\myservlets specifies files in the c:\apps\myservlets directory
  3. c:\javamail\mail.jar specifies the mail.jar file in the c:\javamail directory
  4. domino\servlet\sql.zip specifies the sql.zip file in the c:\lotus\domino\data\domino\servlet directory

The underlying HTTP stack in Lotus Domino is from IBM's Go Webserver. Because of this, there is a standard servlets.properties file in the Domino data directory. You can use this to set up initial parameters to servlets and set up alias names for servlets. For example, the following lines in the servlets.properties file:
  servlet.counter.code=keysolutions.tools.HitCounter
  servlet.counter.initArgs=saveperiod=50,width=7
will let you invoke the servlet, which is named "HitCounter" in a package called "keysolutions.tools", by using the URL "http://<your machine>/servlet/counter". The servlet is invoked with the parameters "saveperiod" and "width".

If your servlet reads/writes files directly, the servlet's "home" directory is the Domino executable directory since the servlet engine is run from there.



Last updated 12/24/1999 09:58:00 PM