Contents

About This Book

Who Should Use This Guide
Using the Documentation
How This Guide Is Organized
Documentation Conventions

General Conventions
Conventions Referring to Directories

Product Support

Basics of Server Operation

Configuration Files

server.xml
init.conf
obj.conf
mime.types

Dynamic Reconfiguration
Manually Editing Configuration Files

Server Configuration Files

The sun-server_1_0.dtd File

Subelements
Data
Attributes

Elements in the server.xml File
General Elements

server
property
description
admin-service
server-instance

Listener Service Elements

http-service
http-listener
ssl
mime
acl
virtual-server-class
virtual-server
http-qos
auth-db
iiop-service
orb
ssl-client-config
iiop-listener

Container Elements

web-container
ejb-container
mdb-container

J2EE Service Elements

jms-service
log-service
security-service
auth-realm
transaction-service

Java Configuration Elements

java-config
profiler
jvm-options

Resource Elements

resources
custom-resource
external-jndi-resource
jdbc-resource
mail-resource
jms-resource
persistence-manager-factory-resource
jdbc-connection-pool

Application Elements

applications
lifecycle-module
j2ee-application
ejb-module
web-module
connector-module

User Database Selection
The Sun ONE LDAP Schema

The Convergence Tree
The Domain Component (dc)Tree

Variables

Format of a Variable
The id Variable
Other Important Variables
Variable Evaluation

Sample server.xml File

Syntax and Use of init.conf

Init Functions
Server Information

NetSiteRoot
TempDir
TempDirSecurity
User (UNIX only)

DNS Lookup

AsyncDNS
DNS

Threads, Processes and Connections

ConnQueueSize
HeaderBufferSize
IOTimeout
KeepAliveThreads
KeepAliveTimeout
KernelThreads (Windows only)
ListenQ
MaxKeepAliveConnections
PostThreadsEarly
RcvBufSize
RqThrottle
RqThrottleMin
SndBufSize
StackSize
StrictHttpHeaders
TerminateTimeout
ThreadIncrement

Native Thread Pools

NativePoolStackSize
NativePoolMaxThreads
NativePoolMinThreads
NativePoolQueueSize

CGI

CGIExpirationTimeout
CGIStubIdleTimeout
MaxCGIStubs
MinCGIStubs
WincgiTimeout (Windows only)

Error Logging

ErrorLogDateFormat
LogFlushInterval
PidLog

ACL

ACLCacheLifetime
ACLUserCacheSize
ACLGroupCacheSize

Security

Security
SSLCacheEntries
SSLClientAuthDataLimit
SSLClientAuthTimeout
SSLSessionTimeout
SSL3SessionTimeout

Chunked Encoding

UseOutputStreamSize
ChunkedRequestBufferSize
ChunkedRequestTimeout

Miscellaneous

ChildRestartCallback
HTTPVersion
MaxRqHeaders
ReentrantTimeFunctions (Solaris only)
Umask (UNIX only)

MIME Types

Introduction
Determining the MIME Type
How the Type Affects the Response
What Does the Client Do with the MIME Type?
Syntax of the MIME Types File
Sample MIME Types File

Other Configuration Files

dbswitch.conf
Deployment Descriptors
generated.instance.acl
nsfc.conf
password.conf
server.policy

Time Formats

Alphabetical List of Server Configuration Elements

Alphabetical List of Directives in init.conf

Index