Difference between revisions of "Conf/Server"

From AOLserver Wiki
Jump to navigation Jump to search
Line 1: Line 1:
== ns_section "ns/server/${servername}/adp" ==
+
== ns_section "ns/server/foo" ==
   
+
part of [[Conf|AOLServer Config Reference]]
'''ADP features'''
 
; [[Conf/Parameters/Map | map]]
 
:Extensions to parse as ADP's
 
  
; [[Conf/Parameters/Map(html) | map(html)]]
+
Define this Virtual Server
:Any extension can be mapped
 
  
; [[Conf/Parameters/Enableexpire | enableexpire]]
+
'''Server parameters'''
:Set "Expires: now" on all ADP's
+
; [[Conf/Parameters/Directoryfile | directoryfile]]
 +
:Comma separated list of default files to server under a directory path.
  
; [[Conf/Parameters/Enabledebug | enabledebug]]
+
; [[Conf/Parameters/Pageroot | pageroot]]
:Turn on Tclpro debugging with "?debug"
+
:Directory under which all pages live
  
; [[Conf/Parameters/Debuginit | debuginit]]
+
'''Tuning options'''
:Debug procedure
+
; [[Conf/Parameters/Connsperthread | connsperthread]]
 +
:Normally there's one conn per thread
  
'''ADP tuning'''
+
; [[Conf/Parameters/Maxthreads|maxthreads]]
 +
:Tune this to scale your server
  
; [[Conf/Parameters/Cache (Tuning) | cache (Tuning)]]
+
; [[Conf/Parameters/Minthreads|minthreads]]
:In-memory cache of ADP's
+
:Tune this to scale your server
  
; [[Conf/Parameters/Cachesize | cachesize]]
+
; [[Conf/Parameters/Threadtimeout|threadtimeout]]
:In-memory cache size of ADP's
+
:Idle timeout for connection threads
  
; [[Conf/Parameters/Errorpage | errorpage]]
+
; [[Conf/Parameters/Maxconnections|maxconnections]]
:Pretty-print ADP errors with an ADP
+
:Max connections per connection thread before it is shut down
  
; [[Conf/Parameters/Startpage | startpage]]
+
; [[Conf/Parameters/Spread|spread]]
:Page to include for all ADP's
+
: Variance factor for threadtimeout and maxconnections to prevent mass mortality of theads (e.g. +-20%)
 
'''ADP custom parsers -- see adp.c'''       
 
 
; [[Conf/Parameters/Adp | adp]]
 
:The simple parser looks for <\% ... \%>
 
  
; [[Conf/Parameters/Fancy | fancy]]
+
'''Limits'''
:The fancy parser does a lot more.
+
; [[Conf/Parameters/Maxline|maxline]]
+
:Max line length from client
'''Socket driver module (HTTP)  -- nssock'''
 
  
; [[Conf/Parameters/Port | port]]
+
'''Directory listings can be generated with an ADP or a Tcl proc'''
:Port for HTTP (typically 80)
+
; [[Conf/Parameters/Directoryadp|directoryadp]]
 +
:Choose one or the other
  
; [[Conf/Parameters/Hostname | hostname]]
+
; [[Conf/Parameters/Directoryproc|directoryproc]]
:This is not the same as your hostname
+
: ...but not both!
  
+
; [[Conf/Parameters/Directorylisting|directorylisting]]
 +
:Can be simple or fancy (for ns_dirlist)
  
; [[Conf/Parameters/Address  | address ]]
+
'''Miscellaneous'''
:This is not the same as your host addr
 
  
; [[Conf/Parameters/Location | location]]
+
; [[Conf/Parameters/Checkmodifiedsince|checkmodifiedsince]]
:URL for auto-redirects (trailing slash)
+
:Check url if no If-Modified-Since?
 
+
; [[Conf/Parameters/Enableaolpress|enableaolpress]]
; [[Conf/Parameters/Maxinput | maxinput]]
+
:Enable extra features used by AOLpress
:Maximum file size for uploads in bytes, default is 1MB, new in AOLserver 4.01
+
; [[Conf/Parameters/Headercase|headercase]]
 
+
:tolower, toupper, preserve
; [[Conf/Parameters/Keepwait | keepwait]]
 
:Max time conn is kept alive (keepalive)
 
:(set to 0 to disable keepalive)
 
 
'''Socket driver module (HTTPS) -- nsssl''' 
 
 
 
 
 
; [[Conf/Parameters/Port (HTTPS) | port (HTTPS)]]
 
:Port for HTTPS (typically 443)
 
 
 
; [[Conf/Parameters/Hostname  (HTTPS)  | hostname  (HTTPS)]]
 
:his is not the same as your hostname
 
 
 
; [[Conf/Parameters/Address (HTTPS) | address (HTTPS)]]
 
:This is not the same as your host addr
 
 
 
; [[Conf/Parameters/Keyfile | keyfile]]
 
 
 
; [[Conf/Parameters/Certfile | certfile]]
 
 
 
'''Control port -- nscp''' 
 
 
 
; [[Conf/Parameters/Port  (NSCP) | port (NSCP)]]
 
:Control port listens on port 9999
 
 
 
; [[Conf/Parameters/Address  (NSCP) | address (NSCP)]]
 
:For security, use 127.0.0.1 only
 
 
'''Control port users''' 
 
 
 
; [[Conf/Parameters/User | user]]
 
:sample user="nsadmin", pw="x"
 
   
 
'''Access log -- nslog'''
 
; [[Conf/Parameters/File | file]]
 
 
 
 
 
; [[Conf/Parameters/Formattedtime | formattedtime]]
 
:true=common log format
 
 
 
; [[Conf/Parameters/Logcombined | logcombined]]
 
:true==NCSA combined format
 
 
 
; [[Conf/Parameters/Maxbackup | maxbackup]]
 
:Max number to keep around when rolling
 
 
 
; [[Conf/Parameters/Rollhour | rollhour]]
 
:Time to roll log
 
 
 
; [[Conf/Parameters/Rolllog  | rolllog ]]
 
:Should we roll log?
 
 
 
; [[Conf/Parameters/Rollonsignal  | rollonsignal ]]
 
:Roll log on SIGHUP
 
   
 
'''CGI interface -- nscgi''' 
 
 
 
; [[Conf/Parameters/Debug(nscgi)  | Debug ]]
 
:Be chatty in log
 
 
 
; [[Conf/Parameters/gethostbyaddr  | gethostbyaddr ]]
 
:Whether to do reverse DNS lookups
 
 
 
; [[Conf/Parameters/limit  | limit  ]]
 
:Max number of concurrent CGI processes
 
 
 
; [[Conf/Parameters/maxoutput  | maxoutput ]]
 
:Max bytes allowed from external process
 
 
 
; [[Conf/Parameters/buffersize  | buffersize ]]
 
:Buffer output from external process
 
 
 
; [[Conf/Parameters/map(GET)  | map(GET)  ]]
 
:Where your CGI executables live (GET)
 
 
 
; [[Conf/Parameters/map(POST)  | map(POST)  ]]
 
:Where your CGI executables live (POST)
 
 
 
'''Unix domain socket driver -- nsunix''' 
 
; [[Conf/Parameters/hostname(NSUNIX)  |hostname(NSUNIX)  ]]
 
:Hostname used in response to client
 
 
 
; [[Conf/Parameters/Port(NSUNIX)  | Port(NSUNIX)  ]]
 
:Port to listen on
 
 
 
; [[Conf/Parameters/socketfile(NSUNIX)  | socketfile(NSUNIX) ]]
 
:UNIX domain socket driver
 
 
'''Virtual Hosting redirector -- nsvhr'''   
 
 
 
; [[Conf/Parameters/busyurl  | busyurl ]]
 
:Redirect here if back-end times out
 
 
 
; [[Conf/Parameters/errorurl  | errorurl ]]
 
:Redirect here on proxy errors
 
 
 
; [[Conf/Parameters/method  | method ]]
 
:Methods allowed to proxy
 
 
 
; [[Conf/Parameters/method (POST)  | method (POST) ]]
 
:Methods allowed to proxy (can have >1)
 
 
 
; [[Conf/Parameters/timeout  | timeout ]]
 
:Timeout waiting for back-end
 
 
'''Register hosts to proxy'''
 
 
 
 
 
; [[Conf/Parameters/"www.tcpsocket.com"  | "www.tcpsocket.com" ]]
 
:HTTP proxy
 
 
 
 
 
; [[Conf/Parameters/"www.domainsocket.com"  | "www.domainsocket.com"  ]]
 
: Domain socket
 

Revision as of 22:13, 21 December 2011

ns_section "ns/server/foo"

part of AOLServer Config Reference

Define this Virtual Server

Server parameters

directoryfile
Comma separated list of default files to server under a directory path.
pageroot
Directory under which all pages live

Tuning options

connsperthread
Normally there's one conn per thread
maxthreads
Tune this to scale your server
minthreads
Tune this to scale your server
threadtimeout
Idle timeout for connection threads
maxconnections
Max connections per connection thread before it is shut down
spread
Variance factor for threadtimeout and maxconnections to prevent mass mortality of theads (e.g. +-20%)

Limits

maxline
Max line length from client

Directory listings can be generated with an ADP or a Tcl proc

directoryadp
Choose one or the other
directoryproc
...but not both!
directorylisting
Can be simple or fancy (for ns_dirlist)

Miscellaneous

checkmodifiedsince
Check url if no If-Modified-Since?
enableaolpress
Enable extra features used by AOLpress
headercase
tolower, toupper, preserve