NonStop Servlets for JSP System Administrator's Guide

Configuring NSJSP

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

3-21

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-plaintext formats.

Valid values are those accepted for the algorithm name by the

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

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 usernames, passwords, and roles. See User File Format on page 3-21 for

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

iTPWS_INSTALL_DIR/servlet-jsp/conf/tomcat-users.xml is used. For

example:

User File Format

The users file (by default, iTPWS_INSTALL_DIR/servlet_jsp/conf/tomcat-

users.xml must be an XML document, with a root element <tomcat-users>. Nested

inside the root element will be a <user> element for each valid user, consisting of the

following attributes:

name

Username this user must log on with.

password

Password this user must log on with (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-31).

roles

Comma-delimited list of the role names associated with this user.

The default installation of NSJSP is configured with a MemoryRealm nested inside the

<Engine> element, so that it applies to all virtual hosts and web applications.

The default contents of the iTPWS_INSTALL_DIR/servlet_jsp/conf/tomcat-

users.xml file are shown in Example 3-19: