Appendix A
Configuration Changes Between iWS 4.x and 6.0
This chapter summarizes major configuration file changes since the last version of iPlanet Web Server. The following 4.x files are described:
magnus.conf
The magnus.conf file has lost directives to other configuration files, gained directives from other configuration files, and acquired entirely new directives. Table 3-1 summarizes the changes.
Table 3-1 magnus.conf changes
|
4.x Directive
|
6.0 Directive
|
Comments
|
|
AccelFileCache
|
(none)
|
Obsolete because a file cache accelerator is no longer necessary
|
|
AcceptLanguage
|
(none)
|
See the VSCLASS and VS elements in server.xml
|
|
AcceptTimeout
|
(none)
|
IOTimeout is an approximate equivalent
|
|
ACLFile
|
(none)
|
See the ACLFILE element in server.xml
|
|
Address
|
(none)
|
See the LS and VS elements in server.xml
|
|
AdminLanguage
|
AdminLanguage
|
(unchanged)
|
|
AsyncDNS
|
AsyncDNS
|
(unchanged)
|
|
BlockingListenSockets
|
(none)
|
Obsolete due to virtual server implementation
|
|
CGIExpirationTimeout
|
CGIExpirationTimeout
|
(unchanged)
|
|
CGIStubIdleTimeout
|
CGIStubIdleTimeout
|
(unchanged)
|
|
CGIWaitPid
|
CGIWaitPid
|
(unchanged)
|
|
ChildRestartCallback
|
ChildRestartCallback
|
(unchanged)
|
|
Chroot
|
Chroot
|
(unchanged)
|
|
ChunkedRequestBufferSize
|
ChunkedRequestBufferSize
|
(unchanged)
|
|
ChunkedRequestTimeout
|
ChunkedRequestTimeout
|
(unchanged)
|
|
Ciphers
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
ClientLanguage
|
ClientLanguage
|
(unchanged)
|
|
Concurrency
|
(none)
|
Obsolete due to virtual server implementation
|
|
(none)
|
ConnQueueSize
|
(new)
|
|
DaemonStats
|
(none)
|
Obsolete due to new performance statistics system
|
|
DefaultCharSet
|
DefaultCharSet
|
(unchanged)
|
|
DefaultLanguage
|
DefaultLanguage
|
(unchanged)
|
|
DNS
|
DNS
|
(unchanged)
|
|
ErrorLog
|
ErrorLog
|
(unchanged)
|
|
ErrorLogDateFormat
|
ErrorLogDateFormat
|
(unchanged)
|
|
ExtraPath
|
ExtraPath
|
(unchanged)
|
|
HeaderBufferSize
|
HeaderBufferSize
|
(unchanged)
|
|
HTTPVersion
|
HTTPVersion
|
(unchanged)
|
|
(none)
|
IOTimeout
|
(new)
|
|
(none)
|
Init functions from obj.conf
|
All functions are present except for cache-init and load-types, which are obsolete (for load-types, see the MIME element in the server.xml file).
|
|
KeepAliveThreads
|
KeepAliveThreads
|
(unchanged)
|
|
KeepAliveTimeout
|
KeepAliveTimeout
|
(unchanged)
|
|
KernelThreads
|
KernelThreads
|
(unchanged)
|
|
ListenQ
|
ListenQ
|
(unchanged)
|
|
LoadObjects
|
(none)
|
See the VSCLASS element in server.xml
|
|
LogFlushInterval
|
LogFlushInterval
|
(unchanged)
|
|
LogVerbose
|
LogVerbose
|
(unchanged)
|
|
MaxCGIStubs
|
MaxCGIStubs
|
(unchanged)
|
|
MaxKeepAliveConnections
|
MaxKeepAliveConnections
|
(unchanged)
|
|
MaxProcs
|
MaxProcs
|
(unchanged)
|
|
MaxRqHeaders
|
MaxRqHeaders
|
(unchanged)
|
|
MaxThreads
|
(none)
|
Obsolete due to new thread handling system
|
|
MinCGIStubs
|
MinCGIStubs
|
(unchanged)
|
|
MinProcs
|
(none)
|
Obsolete due to new thread handling system
|
|
MinThreads
|
(none)
|
Obsolete due to new thread handling system
|
|
MtaHost
|
MtaHost
|
(unchanged)
|
|
NativePoolMaxThreads
|
NativePoolMaxThreads
|
(unchanged)
|
|
NativePoolMinThreads
|
NativePoolMinThreads
|
(unchanged)
|
|
NativePoolQueueSize
|
NativePoolQueueSize
|
(unchanged)
|
|
NativePoolStackSize
|
NativePoolStackSize
|
(unchanged)
|
|
NetSiteRoot
|
NetSiteRoot
|
(unchanged)
|
|
PidLog
|
PidLog
|
(unchanged)
|
|
Port
|
(none)
|
See the LS element in server.xml
|
|
PostThreadsEarly
|
PostThreadsEarly
|
(unchanged)
|
|
RcvBufSize
|
RcvBufSize
|
(unchanged)
|
|
RootObject
|
(none)
|
See the VSCLASS element in server.xml
|
|
RqThrottle
|
RqThrottle
|
(unchanged)
|
|
RqThrottleMinPerSocket
|
(none)
|
See the LS element in server.xml
|
|
(none)
|
RqThrottleMin
|
(new)
|
|
Security
|
Security
|
(unchanged)
|
|
ServerCert
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
(none)
|
ServerConfigurationFile
|
(new)
|
|
ServerID
|
ServerID
|
(unchanged)
|
|
ServerKey
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
ServerName
|
(none)
|
See the VS element in server.xml
|
|
#ServerRoot
|
#ServerRoot
|
(unchanged)
|
|
SndBufSize
|
SndBufSize
|
(unchanged)
|
|
SSL2
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
SSL3
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
SSL3Ciphers
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
SSL3SessionTimeout
|
SSL3SessionTimeout
|
(unchanged)
|
|
SSLCacheEntries
|
SSLCacheEntries
|
(unchanged)
|
|
SSLClientAuth
|
(none)
|
See the SSLPARAMS element in server.xml
|
|
SSLClientAuthDataLimit
|
SSLClientAuthDataLimit
|
(unchanged)
|
|
SSLClientAuthTimeout
|
SSLClientAuthTimeout
|
(unchanged)
|
|
SSLSessionTimeout
|
SSLSessionTimeout
|
(unchanged)
|
|
StackSize
|
StackSize
|
(unchanged)
|
|
StrictHttpHeaders
|
StrictHttpHeaders
|
(unchanged)
|
|
TerminateTimeout
|
TerminateTimeout
|
(unchanged)
|
|
ThreadIncrement
|
ThreadIncrement
|
(unchanged)
|
|
Umask
|
Umask
|
(unchanged)
|
|
UseNativePoll
|
UseNativePoll
|
(unchanged)
|
|
UseOutputStreamSize
|
UseOutputStreamSize
|
(unchanged)
|
|
User
|
User
|
(unchanged)
|
|
VirtualServerFile
|
(none)
|
Obsolete due to virtual server implementation
|
|
WincgiTimeout
|
WincgiTimeout
|
(unchanged)
|
obj.conf
The obj.conf file has lost its Init directives to the magnus.conf file and acquired new directives and parameters. Table 3-2 summarizes the changes. Only the new and changed directives are listed.
Table 3-2 obj.conf changes
|
4.x Directive
|
6.0 Directive
|
Comments
|
|
Init functions
|
(none)
|
All functions have moved to magnus.conf except for cache-init and load-types, which are obsolete (for load-types, see the MIME element in the server.xml file).
|
|
(none)
|
AuthTrans fn=qos-handler
|
(new)
|
|
Service fn=parse-html
|
Service fn=shtml_send
|
|
|
Service fn=send-cgi
|
Service fn=send-cgi
|
New parameters have been added.
|
|
(none)
|
Service fn=stats-xml
|
(new)
|
|
(none)
|
Error fn=qos-error
|
(new)
|
contexts.properties
The contexts.properties file is still supported for the default virtual server. For all other virtual servers, most of the same functions are in the web-apps.xml file.
A few contexts.properties functions are in the server.xml file. For more information about the server.xml file, see the NSAPI Programmer's Guide for iPlanet Web Server.
Table 3-3 lists the equivalent functions in the servlets.properties and web-apps.xml files.
Table 3-3 contexts.properties to web-apps.xml correspondences
|
contexts.properties Property
|
web-apps.xml Element or Attribute
|
Comments
|
|
sessionmgr
|
session-manager element
|
|
|
sessionmgr.initArgs
|
init-param subelements of session-manager element
|
|
|
initArgs
|
init-param subelements of elements that support them
|
|
|
respondCookieVersion
|
version attribute of response-cookie element
|
|
|
tempDir
|
tempdir element
|
|
|
reloadInterval
|
reload-interval attribute of class-loader element
|
|
|
bufferSize
|
size attribute of response-buffer element
|
|
|
docRoot
|
(none)
|
Specified in the server.xml file for each virtual server.
|
|
inputStreamLengthCheck
|
(none)
|
Obsolete due to web application support.
|
|
outputStreamFlushTimer
|
flush-timeout attribute of response-buffer element
|
|
|
uri
|
uri attribute of web-app element
|
|
|
authdb
|
authdb attribute of auth-native element
|
|
|
classpath
|
classpath attribute of class-loader element
|
|
|
singleClassLoader
|
(none)
|
Obsolete because by default each web application has a single class loader.
|
|
serverName
|
(none)
|
Specified in the server.xml file for each virtual server.
|
|
contentTypeIgnoreFromSSI
|
(none)
|
Obsolete due to web application support.
|
|
parameterEncoding
|
parameter-encoding element
|
|
|
isModifiedCheckAggressive
|
(none)
|
Obsolete due to web application support.
|
rules.properties
The function of the rules.properties file is now handled by the servlet-mapping element in the web.xml file. For more information, see the Servlet 2.2 API specification at:
http://java.sun.com/products/servlet/index.html
servlets.properties
The servlets.properties file is still supported for the default virtual server. For all other virtual servers, most of the same functions are in the web-apps.xml file.
A few servlets.properties functions are in the server.xml file. For more information about the server.xml file, see the NSAPI Programmer's Guide for iPlanet Web Server.
A few servlets.properties functions are in the web.xml file. For more information, see the Servlet 2.2 API specification at:
http://java.sun.com/products/servlet/index.html
Table 3-4 and Table 3-5 list the equivalent functions in the servlets.properties and web-apps.xml files.
Table 3-4 servlets.properties to web-apps.xml correspondences for individual (servlet) properties
|
servlets.properties Property
|
web-apps.xml Element or Attribute
|
Comments
|
|
code
|
(none)
|
Specified in a servlet-class element in the web.xml file.
|
|
context
|
(none)
|
Obsolete because web applications are supported.
|
|
classpath
|
classpath attribute of class-loader element
|
|
|
initArgs
|
(none)
|
Use the <SERVLET> tag, which takes servlet-specific initialization parameters.
|
|
startup
|
(none)
|
Specified in a load-on-startup element in the web.xml file.
|
Table 3-5 servlets.properties to web-apps.xml correspondences for general (servlets) properties
|
servlets.properties Property
|
web-apps.xml Element or Attribute
|
Comments
|
|
config.docRoot
|
(none)
|
Specified in the server.xml file for each virtual server.
|
|
config.realPathFromRequest
|
(none)
|
Deprecated in the Servlet 2.2 API.
|
|
config.respondCookieVersion
|
version attribute of response-cookie element
|
|
|
config.sessionExpireOnClose
|
(none)
|
Tracking session expiration in this way is no longer necessary.
|
|
sessionmgr
|
session-manager element
|
|
|
config.reloadInterval
|
reload-interval attribute of class-loader element
|
|
|
config.bufferSize
|
size attribute of response-buffer element
|
|
|
startup
|
(none)
|
Specified in a load-on-startup element in the web.xml file. There is no global servlet startup function.
|