NonStop Servlets for JSP System Administrator's Guide

Configuring NSJSP
NonStop Servlets for JavaServer Pages (NSJSP) System Administrator’s Guide—525644-001
3-19
Configuring Realms
name
The host name of this virtual host. This name must match the name submitted on
the Host: header in incoming requests. This attribute is required, and must be
unique among the virtual hosts running in this servlet container. Note that
hostname matching is not case-sensitive. If the host name does not match the
Host header in incoming requests, then localhost will be used.
debug
The level of debugging detail logged by this <Host> to the associated <Logger>,
with higher numbers generating more detailed output. If not specified, the
debugging detail level will be set to zero (0).
unpackWARs
Set this to true if you want web applications that are deployed from a Web
Application Archive (WAR) file to be unpacked into a disk directory structure, or
use false to run the application directly from the WAR file. If not specified, the
default value is true for backwards compatibility. See Example 3-17:
Configuring Realms
NSJSP allows the use of realms. A realm is a database of usernames and passwords
that identify valid users of a web application (or set of web applications), plus an
enumeration of the list of roles associated with each valid user. You can think of roles
as similar to groups in Unix-like operating systems, because access to specific web
application resources is granted to all users possessing a particular role (rather than
enumerating the list of associated usernames). A particular user can have any number
of roles associated with their usernames.
The following types of storage may be used to contain the realm database:
MemoryRealm
Accesses authentication information stored in an in-memory object collection,
which is initialized from an XML document (iTPWS_INSTALL_DIR/servlet_jsp
/conf/tomcat-users.xml).
JDBCRealm
Obtains authentication information stored in a relational database, accessed via a
Java Database Connectivity (JDBC) driver.
Example 3-17. Unpacking a WAR File
<Host name="www.hp.com" debug="0" appBase="webapps"
unpackWARs="true">
...
...
</Host>