Configuration

The following feature changes in configuration are included in AOLserver Version 3.0

General Configuration Changes

The following table lists the general configuration changes that have been made in AOLserver Version 3.0

Feature	Where Documented
Configuration file format changed: The configuration file is now a Tcl file instead of an .ini file. The default configuration file name is nsd.tcl. Two new Tcl functions, ns_section and ns_param are used to define the sections and parameters in the configuration file. To convert your nsd.ini files to nsd.tcl files, use the translate-ini program. The syntax is: bin/translate-ini <nsd.ini> nsd.tcl See page 16 for detailed information on configuration file changes.	Administrator's Guide: Chapter 4 Tcl Developer's Guide: page 145, page 182
Aliases no longer supported: You can no longer configure URL to file mappings with AOLserver.	NA
Assets parameter and directory removed: Graphics files associated with pages must now reside in the PageRoot directory for the server.	NA
Caching configuration changed: Caching for static files is now supported through the fastpath mechanism. Caching for ADPs is configured with the new Cache parameter in the ADP section.	Administrator's Guide: page 56, page 58
CGI support now an optional module: CGI is now a module (nscgi) and is therefore configured in the ns/server/server-name/modules/nscgi section in the configuration file.	Administrator's Guide: page 63
Dynamo Server no longer supported: Support for ATG's Dynamo Server is no longer provided.	NA
Fastpath configuration for static files: The new fastpath section is now used to configure how AOLserver sends out static pages.	Administrator's Guide: page 58
FTP no longer supported: The nsftp module has been removed.	NA
Java Servlet API no longer supported: The nsdynamo module has been removed.	NA
Mime Icons no longer supported: AOLserver no longer generates directory listings, so file icons are not needed for directory listings.	NA
Network logging no longer supported: The nsnlog module has been removed.	NA
Realms for logging supported: You can now configure multiple realms to redirect logging from individual modules to different files.	Administrator's Guide: page 60
Redirects supported: You can configure status/URL pairs, such that a redirect is sent to the specified URL for the specified status.	Administrator's Guide: page 61
Select Loops no longer supported: The optional "select-loop" feature has been removed.	NA
Server Busy errors no longer returned: AOLserver no longer returns "Server Busy" errors. If more threads are requested than MaxThreads, the requests will be forced to wait until the number of waiting requests drops below MaxThreads.	NA
Server-parsed HTML no longer supported: AOLserver no longer supports server-parsed HTML, also called server-side includes.	NA
Setup Server removed: The Setup Server is no longer supported. All configuration must be done by editing the configuration file.	NA
SSL no longer supported: The nsssl module has been removed. It is intended that the nsssl module will be re-implemented in a later release.	NA
tclstate module removed: AOLserver no longer maintains state data in Tcl.	NA
Trailers no longer supported: The following parameters have been removed: TrailerFindEnd, TrailerFmt, TrailerText, and TrailerType.	NA
Virtual host redirection supported: This module allows you to proxy requests to different servers.	Administrator's Guide: page 70, page 71
Virtual hosting configuration changed: The nsvhost module has been removed. Virtual hosting is now supported through the nsvhr module, which proxies requests to different servers instead of internally redirecting requests to other virtual servers.	Administrator's Guide: page 70, page 71
Unix communications driver module: The nsunix module has been added to provide better performance for proxying connections by the nsvhr module. It allows the nsvhr module to proxy over a UNIX domain socket instead of a TCP socket.	Administrator's Guide: page 72
Virtual servers no longer supported: AOLserver no longer runs multiple virtual servers with one call to the nsd command line. You can still define multiple servers in the configuration file and specify which one is to be run on the nsd command line.	Administrator's Guide: page 5, Chapter 4

:

Configuration File Changes

The following table lists the changes that have been made to the configuration file in AOLserver Version 3.0. Many parameters have been removed, and some new sections and parameters have been added. Where parameters have been removed, the previous default setting is now in effect

Configuration File Section	Where Documented
ns/parameters: The following parameters are new: CrashCmd SockNoWarn The following parameters have been removed: AllowRoot, CatchExceptions, CheckInterval, DNSCachePurgeInterval, LogExpanded, LogPid, LogServer, LogTid, LogTime, LowMemorySleep, MaxStartThreads, MaxStartWait, MaxStopWait, ModuleDirectory, OpenMax, SelectLoopBufferSize, SelectLoopCount, SelectLoopMaxSize, SelectLoopThreshhold, SkipLocks, SmtpPort, Umask	Administrator's Guide: page 50
ns/mimeicons: This section has been removed. Since directory listings are no longer supported, there is no need to define icons for them.	NA
ns/mimetypes: This configuration file section has not changed for v3.0.	Administrator's Guide: page 53
ns/setup: This section has been removed. The Setup Server is no longer supported.	NA
ns/servers: This configuration file section has not changed for v3.0.	Administrator's Guide: page 55
ns/server/server-name: The following parameters are new: ConnsPerThread EnableAOLpress KeepAliveTimeout MaxConnections MaxKeepalive Realm SockTimeout ThreadTimeout The following parameters have been removed: Assets, CheckInterval, CheckModifiedSince, CheckStats, CheckStatsInterval, CreatMode, DirectoryListings, ElevateAcceptPriority, EnableTclPages, FileLocking, FlushContent, FlushQueue, ForbiddenResponse, HeaderCase, HideDotFiles, LogQueryOnTclError, MaxBusyThreads, MaxLine, MaxHeaders, MaxPost, MaxWait, MinBusyThreads, MinThreadAge, MkdirMode, NotFoundResponse, NoticeBackground, NoticeBgColor, QuotaSize, ReturnMWTopPage, SelectLoop, ServerBusyResponse, ServerInternalErrorResponse, TrailerFindEnd, TrailerFmt, TrailerText, TrailerType, UnauthorizedResponse, UserMapDir, Verbose, Webmaster	Administrator's Guide: page 55
ns/server/server-name/adp: The following parameters are new: Cache EnableExpire EnableDebug DebugInit StartPage The following parameters have been removed: AbsolutePath, Debug, GlobalInclude, HideSource, IgnoreErrors, MaxCallDepth	Administrator's Guide: page 56
ns/server/server-name/aliases: This section has been removed. Aliases are not supported in v3.0.	NA
ns/server/server-name/db: This configuration file section has not changed for v3.0.	Administrator's Guide: page 58
ns/server/server-name/fastpath: This is a new configuration file section to allow you to configure how AOLserver sends out static pages.	Administrator's Guide: page 58
ns/server/server-name/mimeicons: This section has been removed. Directory listings are not supported, so icons for them are not needed.	NA
ns/server/server-name/mimetypes: This section has been removed. Individual servers can no longer specify mime types to override those specified in ns/mimetypes.	NA
ns/server/server-name/realms: This is a new configuratin file section to support realms, which allow you to redirect logging from individual modules.	Administrator's Guide: page 60
ns/server/server-name/redirects: This is a new configuration file section to support redirects.	Administrator's Guide: page 61
ns/server/server-name/shtml: This section has been removed. Server-parsed HTML is no longer supported.	NA
ns/server/server-name/tcl: The following parameters have been removed: ClientDebug, EnableAdmin, InitScript, NumInterps, ReinitScript, SharedGlobals, SharedLibrary	Administrator's Guide: page 61
ns/server/server-name/modules: This configuration file section has not changed for v3.0.	Administrator's Guide: page 62
ns/server/server-name/module/nscache: This section has been removed. The associated sections have also been removed: ns/server/server-name/module/nscache/adp ns/server/server-name/module/nscache/static ns/server/server-name/module/nscache/tcl	NA
ns/server/server-name/module/nscgi: This section replaces the previous ns/server/server-name/cgi section. CGI support is now a module. The following parameters are new: BufferSize Limit Debug MaxOutput SystemEnvironment This parameter has been removed: MaxInput	Administrator's Guide: page 63
ns/server/server-name/module/nscp: This is a new configuration file section for the new nscp module, which enables the new control port interface.	Administrator's Guide: page 64
ns/server/server-name/module/nscp/users: This is a new configuration file section for the new nscp module.	Administrator's Guide: page 66
ns/server/server-name/module/nsdynamo: This section has been removed.ATG's Dynamo Server is no longer supported.	NA
ns/server/server-name/module/nsftp: This section has been removed. Ftp is no longer supported.	NA
ns/server/server-name/module/nslog: The following parameter is new: FormattedTime The following parameters have been removed: EnableHostnameLookup, ExtendedHeaders, LogRefer, LogUserAgent, RollDay, RollFmt	Administrator's Guide: page 68
ns/server/server-name/module/nsnlog: This section has been removed. Network logging is no longer supported.	NA
ns/server/server-name/module/nsperm: The following parameters are new: SkipLocks The following parameters have been removed: Directory, EnableHostnameLookup, Mode, UserDir	Administrator's Guide: page 69
ns/server/server-name/module/nsservlet: This section has been removed. The Java servlet API is no longer supported.	NA
ns/server/server-name/module/nssock: The following parameters have been removed: LogBusyRequests, Debug, HttpKeepAliveTimeout, KeepAlive, ListenBacklog, ReceiveBufferSize, SendBufferSize, SendMaxSize, TcpWrappers, TimeOut	Administrator's Guide: page 70
ns/server/server-name/module/nsssl: This section has been removed. SSL is no longer supported.	NA
ns/server/server-name/module/nstext: This section has been removed. Illustra is no longer supported.	NA
ns/server/server-name/module/nstclstate: This section has been removed. Maintaining Tcl state data is no longer supported.	NA
ns/server/server-name/module/nsvhost: This section has been removed. Virtual hosting is no longer supported. An associated section has also been removed: ns/server/server-name/module/nsvhost/server-name	NA
ns/server/server-name/module/nsvhr: This is a new configuration file section for virtual host redirection, which proxies requests to different servers.	Administrator's Guide: page 70
ns/server/server-name/module/nsvhr/maps: This is a new configuration file section for virtual host redirection.	Administrator's Guide: page 71
ns/server/server-name/module/nsunix: This is a new configuration file section to allow the nsvhr module to proxy over a UNIX domain socket instead of a TCP socket.	Administrator's Guide: page 72
ns/db/drivers: This configuration file section has not changed for v3.0, although the Illustra database drivers are no longer supported.	Administrator's Guide: page 73
ns/db/driver/illustra: This section has been removed. Illustra is no longer supported.	NA
ns/db/driver/extname: This configuration file section has not changed for v3.0, although the Illustra database drivers are no longer supported.	Administrator's Guide: page 73
ns/db/pools: This configuration file section has not changed for v3.0.	Administrator's Guide: page 74
ns/db/pool/pool-name: This parameter has been removed: ExtendedTableInfo	Administrator's Guide: page 75
ns/interps/interps-name: This configuration file section has not changed for v3.0.	Administrator's Guide: page 77
ns/environment/environment-name: This configuration file section has not changed for v3.0.	Administrator's Guide: page 77
ns/threads: The following parameters are new: MaxTLS PoolTrace StackSize The following parameters have been removed: ArenaFile, ArenaMktemp, ArenaSwapFile AutoGrow, AutoRest, SizePerUser	Administrator's Guide: page 78

.