Installation guide

5. SERVLETEXEC APPLICATION SERVER (UNIX)

ServletExec 4.1 Installation Guide 79

6.5.3.5 Suffix Aliases

There are two methods for configuring suffix aliases with Apache. The most common

method is illustrated above. For each suffix alias that is configured using the ServletExec

Admin UI, add an AddHandler directive to httpd.conf with the following format:

ServletExecAliases <instance-name> <suffix-aliases>

AddHandler servlet-exec <suffix-alias>

You should use this method if the URL Rewriting option of the Session Tracking feature

is disabled, which it is by default. This method of configuring suffix aliases provides

better performance than the alternative method.

See the ServletExec User Guide for more information on Session Tracking and URL

Rewriting.

URL Rewriting Alternative

If you enabled the URL Rewriting option of the Session Tracking feature, you must use

an alternative method of configuring suffix aliases. For this method, you use a

Location

directive instead of the AddHandler directive. For each suffix alias that is configured

using the ServletExec Admin UI, add a Location directive to httpd.conf with the

following format:

SetHandler servlet-exec

</Location>

In addition, for each subdirectory level beneath the web server document root directory,

you must add an additional Location directive to httpd.conf. For example, assume

the web server root document directory is /usr/local/apache/htdocs and the

following subdirectories appear beneath htdocs:

htdocs/subdir1

htdocs/subdir2

htdocs/subdir2/subdir3

In this example, there are two levels of subdirectories beneath htdocs, so to create a

suffix alias of

.jsp, you should add three Location directives to httpd.conf, one for

htdocs and one for each subdirectory level:

# suffix alias for htdocs

SetHandler servlet-exec

</Location>

# suffix alias for htdocs/subdir1 and htdocs/subdir2

SetHandler servlet-exec

</Location>