NonStop Servlets for JavaServer Pages (5.0) System Administrator's Guide

Configuring NSJSP

NonStop Servlets for JavaServer Pages (NSJSP) System Administrator’s Guide—525644-002

3-30

MemoryRealm

document is loaded from the $NSJSP_HOME/conf/tomcat-users.xml file).

Changes to the data in this file are not recognized until NSJSP is restarted.

Realm Element Attributes

To configure MemoryRealm, create a <Realm> element and nest it in your

$NSJSP_HOME/conf/iTP_server.xml file or in the <Context> element in the

context configuration file, as described in Example 3-20. The following attributes are

supported for MemoryRealm:

className

The value is org.apache.catalina.realm.MemoryRealm.

debug

The level of debugging detail logged by this realm to the associated <Logger>.

Higher numbers generate more detailed output. If not specified, the default

debugging detail level is zero (0).

digest

The digest algorithm used to store passwords in non-plain text formats.

Valid values are those accepted for the algorithm name by the

java.security.MessageDigest class. See Digested Passwords on page 3-45

for more information. If not specified, passwords are stored in clear text.

pathname

The absolute or relative pathname of the users file (XML document) containing

valid user names, passwords, and roles. See User File Format on page 3-30 for

more information about the format of this file. If not specified, the value

$NSJSP_HOME/conf/tomcat-users.xml is used. For example:

User File Format

The users file (by default, $NSJSP_HOME/conf/tomcat-users.xml) must be an

XML document, with a root element <tomcat-users>. Nested inside the root element

is a <user> element for each valid user, consisting of the following attributes:

name

The user name this user must use to log on.

password

The password this user must use to log on (in clear text if the digest attribute was

not set on the <Realm> element, or digested appropriately as described in

Digested Passwords on page 3-45).