The Legacy Servlets Tab

The Legacy Servlets tab allows you to specify servlet properties as in iPlanet Web Server 4.x. It is included for backward compatibility. The Legacy Servlets tab contains the following pages:

• The Configure Global Attributes for Servlets Page

• The Configure Servlet Attributes Page

• The Configure Servlet Virtual Path Translation Page

• The Servlet Directory Page

The Configure Global Attributes for Servlets Page

---

The Configure Global Attributes for Servlets page allows you to specify general servlet properties as in iPlanet Web Server 4.x. It is included for backward compatibility only.

The following elements are displayed:

Startup Servlets. Specifies the servlets that will be loaded upon starting the server. Do not include the .class extension.

Session Manager. Specifies the session manager class.

Session Manager Args. Specifies comma-separated name=value session manager initialization parameters.

Reload Interval. Specifies the interval (in seconds) in which servlets and JSPs are reloaded. If the servlet class file changes, a servlet instance (reflecting the changes) can be reloaded. Enter an integer value between 0 and 600 inclusive. The default is 5 seconds.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

The Configure Servlet Attributes Page

---

The Configure Servlet Attributes page allows you to add servlets to the servlets.properties file and to specify input parameters, class path, and virtual path translation for existing servlets as in iPlanet Web Server 4.x. It is included for backward compatibility only.

You can set up virtual path translations for servlets regardless of whether they reside in registered servlet directories. When you add a servlet through this interface, the servlet is automatically added to the servlets.properties file in iPlanet Web Server's config directory.

The following elements are displayed:

Choose Servlet. Specifies the servlet to edit. Upon choosing the servlet from this drop-down list, the servlet's information is displayed in the lower portion of this page (ignore this field if you are adding a new virtual path entry).

---

Note	To add a servlet to the servlets.properties file, fill out the following fields in the lower portion of the page.

---

Servlet Name. Specifies an identifier for the servlet. This identifier is used internally by iPlanet Web Server; it is not used in the URL for accessing the servlet. This identifier can be the same name or a different name than the servlet class name.

Servlet Code (class name). Specifies the name of the servlet's main class file. The .class extension is not required. Do not specify any directories in this field.

Servlet Classpath. Specifies the absolute path or URL to the classpath for the servlet. The classpath can point anywhere in the file system. The servlet classpath may contain a directory, a .jar or .zip file, or a URL to a directory (You cannot specify a URL as a classpath for a .zip or .jar file.). If the servlet classpath is not a registered servlet directory, you must provide a servlet virtual path translation (in the The Configure Servlet Virtual Path Translation Page) to make the servlet accessible to browsers.

Servlet Args. Lists optional initial arguments passed to the servlet. Input must be in the format name=value [,name=value], for example, name1=arg1, name2=arg2.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

The Configure Servlet Virtual Path Translation Page

---

The Configure Servlet Virtual Path Translation page allows you to add and edit virtual paths for your servlets as in iPlanet Web Server 4.x. It is included for backward compatibility only.

For example, you can set a virtual path for the servlet named servplan1 in the docs/products/mrktplans directory to allow users to invoke this servlet by using the URL http://server_name/plans/plan1.

You can specify virtual paths only for servlets that are listed in the servlets.properties file. (To add a servlet to this file, use the The Configure Global Attributes for Servlets Page.)

The following elements are displayed:

Choose Virtual Path Entry. Specifies a virtual path to modify. Upon choosing the servlet from this drop-down list, the virtual path information will be displayed in the lower portion of this page (ignore this field if you are adding a new virtual path entry).

---

Note	To add a virtual path to the rules.properties file, fill out the following fields in the lower portion of the page.

---

Virtual Path. Specifies a new virtual path to add, or an existing one to modify. If you want to add a new path, you can overwrite the text (if any) in this field. If you want to modify the virtual path, choose the path from the list in Choose Virtual Path Entry above this field.

Servlet Name. Specifies a name for the servlet as entered in The Configure Servlet Attributes Page. You can create the servlet identifier in this field before specifying it in The Configure Servlet Attributes Page, but you must specify it in The Configure Servlet Attributes Page before the virtual path will work.

To remove an existing translation, select the name of the virtual path in the Choose Virtual Path Entry menu, then click Remove.

OK. Saves your entries.

Remove. Deletes the selected virtual path from the rules.properties file.

Help. Displays online help.

The Servlet Directory Page

---

The Servlet Directory page allows you to specify directories where servlets are located as in iPlanet Web Server 4.x. It is included for backward compatibility only.

The following elements are displayed:

URL Prefix. Specifies the prefix used in URLs for accessing the servlet directory. For example, if you want the URL http://server_name/plans to map to the directory D:/netscape/server4/docs/plans then enter plans in this field.

Servlet Directory. Specifies the absolute path to the directory to be registered as a servlet directory. Servlets in this directory are invoked by URLs that use the URL prefix specified in the previous field. iPlanet Web Server treats all files in these directories as servlets.

OK. Saves your entries.

Reset. Erases your changes and resets the elements in the page to the values they contained before your changes.

Help. Displays online help.

Current Servlet Directories. Lists the current servlet directories. To modify a servlet directory, click Edit in the servlet directory row. To unregister a servlet directory, click Remove in the servlet directory row.

Edit. Allows you to edit an existing servlet directory. The URL prefix and directory path appear in the upper portion of the page, ready to be edited. After making the changes, click OK.

Remove. Removes a directory from the list of registered servlet directories. The directory itself is not deleted.