Servlet
|
Description
|
AdminServlet
|
Implements iServer Administrator.
Normally defined as a Servlet aliased as /admin.html.
|
CgiServlet
|
This Servlet implements Common Gateway Interface (CGI).
bindir
|
The base directory which contains CGI scripts.
Normally ./cgi-bin.
If the path specified is a relative path then it is
relative to the current virtual-host path.
|
exec
|
The shell to use.
Normally c:\\command.com /c for Windows 9x,
c:\\winnt\\system32\\cmd.exe /c for Windows NT
and /bin/sh for UNIX.
|
Normally defined as a Servlet aliased as /cgi-bin.
Before CGI can be used Shell Access must be enabled in
the iServer Administration - Server form.
|
ClusterProxy
|
The Cluster Proxy provides load balancing and fault
tolerance by proxying client requests to an available
workgroup of servers.
hosts
|
The comma delimited list of the names of the servers
in the workgroup that requests will be proxy to.
For example:
p2:8080,p3:8080
|
interval
|
Used to specify in milliseconds how often the
workgroup servers status is updated.
A value greater than or equal to 50 milliseconds.
If an interval is not specified or if 0 is
used then the workgroup server status is only checked
if the method is best when the request is made.
1000 milliseconds is a good value to use.
A value too small may have a negative impact on
performance and a value too large when method is best
may delay use of a recovered workgroup server.
|
method
|
The method used to determine which server within
the workgroup will service the current request.
best - the server with the best response time.
next - the next available server.
If a method is not specified then next is used.
|
retry
|
The number of workgroup servers to try to connect
to, normally 3.
|
Normally defined as a Servlet aliased to the base URI to
proxy.
AVAILABLE ONLY IN ENTERPRISE EDITION
|
ClusterRedirector
|
The Cluster Redirector provides load balancing and fault
tolerance by redirecting client requests to an available
workgroup of servers.
hosts
|
The comma delimited list of the names of the servers
in the workgroup that requests will be redirected to.
For example:
p2:8080,p3:8080
|
interval
|
Used to specify in milliseconds how often the
workgroup servers status is updated.
A value greater than or equal to 50 milliseconds.
If an interval is not specified or if 0 is
used then the workgroup server status is only checked
if the method is best when the request is made.
1000 milliseconds is a good value to use.
A value too small may have a negative impact on
performance and a value too large when method is best
may delay use of a recovered workgroup server.
|
method
|
The method used to determine which server within
the workgroup will service the current request.
best - the server with the best response time.
next - the next available server.
If a method is not specified then next is used.
|
retry
|
The number of workgroup servers to try to connect
to, normally 3.
|
Normally defined as a Servlet aliased to the base URI to
redirect.
AVAILABLE ONLY IN ENTERPRISE EDITION
|
FileServlet
|
This Servlet provides access to both files directories.
cache_size
|
The amount of memory in megabytes to use to cache files.
4 is the default for iServer.
Must be 1 or more megabytes in size. Use 0 to disable the cache.
A file cache may improve performance.
|
files
|
Comma delimited list of paths to files to preload into the cache.
The size of file cache must be large enough to contain all of the files.
Preloading commonly used files into the cache may improve performance.
|
sort
|
Whether to display a case-insensitive sorted directory
listing.
y is used to display a sorted directory listing and
n is used to display a directory listing with
files ordered as they exist.
y is the default.
Setting this value to y may have a negative impact on
performance.
|
System-wide parameters used by FileServlet are defined in iServer
Administrator -> Manager -> Server
Default Files
|
The default document to use when one is not specified.
index.html is the default for iServer.
Zero or more comma delimited file names can be specified.
|
Directory Access
|
Whether to allow directories to be displayed.
No is the default for iServer.
Setting this value to Yes is potentially a security
hole.
FileServlet uses /iws/html/directory.html and
/iws/html/directory_item.tf html templates when
displaying directories.
|
Root Directory
|
The root directory for html files and documents.
./wwwroot is the default for iServer.
./public_html is also a popular value used by
Web Servers.
All references to files are made relative the base directory.
|
Normally defined as a Servlet aliased as /.
|
InvokerServlet
|
This Servlet allows iServer to run Servlets found in the
CLASSPATH without the Servlet first having to be defined.
Servlets can be run by entering:
http://hostname:port/servlet/{package.}class{path}{?args}
hostname
|
The server running iServer.
Normally localhost.
|
port
|
The port iServer is using.
Normally 8080.
|
package
|
The Java Class package name.
|
class
|
The Java Class name.
|
path
|
Any path info.
|
args
|
Any parameters.
Normally URL encoded key=value pairs.
|
Currently there is no way to pass initialization parameters to
the Servlets invoked. If you need to pass initialization
parameters you will need to directly define the Servlet in
servlets.ini or using the iServer Administrator.
The CLASSPATH will be searched for the specified Servlet.
Normally defined as a Servlet aliased as /servlet.
Example
http://localhost:8080/servlet/HelloServlet?World
|
ServletTagServlet
|
Provides support for Servlet includes using
<servlet></servlet> tag in the form:
<servlet name=servlet {code=class} {init_param_name=init_param_value}...>
{<param name=param_name value=param_value>}...
</servlet>
class
|
The name of a class file that can be found using the
CLASSPATH.
code is used to load the Servlet when name
is not specified.
When code is used the Servlet is loaded,
initialized and destroyed each time it is used.
|
init_param_name
|
The name of an initialization parameter.
|
init_param_value
|
The value that will be associated with the named initialization parameter.
|
param_name
|
The name of a parameter.
|
param_value
|
The value that will be associated with the named parameter.
|
servlet
|
A Servlet Alias defined in
iws_dir/config/servlets.ini,
where iws_dir is the directory where iServer was
installed.
If name is not specified then the class defined in
code will be used to load the Servlet.
When name is used the Servlet is loaded and
initialized only once and destroyed when the server is
shutdown.
|
Normally defined as a Filter aliased as .ssi file
extension.
Example
<servlet name=HelloServlet></servlet>
|
SSIncludeServlet
|
Provides support for SSI.
bindir
|
The base directory which contains CGI scripts.
Normally ./.
If the path specified is a relative path then it is
relative to the current virtual-host path.
|
exec
|
The shell to use when executing #exec cgi
directives.
Normally c:\\command.com /c for Windows 9x,
c:\\winnt\\system32\\cmd.exe /c for Windows NT
and /bin/sh for UNIX.
|
Normally defined as a Filter aliased as .shtml file
extensions.
Before #exec directive can be used Shell Access
must be enabled in the iServer Administration - Server form.
|
StatusServlet
|
Used by workgroup servers to provide the Cluster Redirector with
load and availability status.
Normally defined as a Servlet aliased as /status.
|