Difference between revisions of "Ns pools"

From AOLserver Wiki
Jump to navigation Jump to search
Line 11: Line 11:
 
'''DESCRIPTION'''
 
'''DESCRIPTION'''
  
: This command enables configuration of one or more pools of connection processing threads. The pools allow certain requests to be handled by specific threads. This could, for example, ensure multiple long running requests don't block other short running requests. Pools are selected based on method/url pairs similar to the mappings managed by the [[ns_register_proc]] command. By default, all requests
+
: This command enables configuration of one or more pools of connection processing threads. The pools allow certain requests to be handled by specific threads. This could, for example, ensure multiple long running requests don't block other short running requests. Pools are selected based on method/url pairs similar to the mappings managed by the [[ns_register_proc]] command. By default, all requests are handled by a single, unlimited, "default" pool. There is also an "error" pool as described below. Coupled with the [[ns_limits]] command, pools can provide for sophisticated resource management.
are handled by a single, unlimited, "default" pool. There is also an "error" pool as described below. Coupled with the [[ns_limits]] command, pools can provide for sophisticated resource management.
 
  
 
: This command can be used to set to retrieve various pieces of information about a pool configuration.
 
: This command can be used to set to retrieve various pieces of information about a pool configuration.
Line 19: Line 18:
 
: The legal ''option''s (which may be abbreviated) are:
 
: The legal ''option''s (which may be abbreviated) are:
  
* '''ns_pools set''' ''poolname'' ''?'' '''-maxthreads''' ''maxt?'' ?-minthreads mint? ?-maxconns maxc? ?-timeout t? ?-spread s?''
+
* '''ns_pools set''' ''poolname'' ''?'' '''-maxthreads''' ''value?'' ''?'' '''-minthreads''' ''value?'' ''?'' '''-maxconns''' ''value? ?'' '''-timeout''' ''value? ?'' '''-spread''' ''value?''
 +
 
 +
: Configure the specified pool with the given values. ''maxthreads'' specifies the maximum number of connections threads, ''maxthreads'' specifies the minimum number of connection threads, ''maxconns' is the maximum number of requests sent to a single thread before it stops, ''timeout'' is the idle timeout per thread in this pool per second, ''spread'' is a factor of variance used for setting ''maxconns'' and ''timeout'' to avoid simultaneous shutdowns of many threads. A ''spread'' of 20 (the default value) means the every thread gets the specified value +- 20%. For instance, if ''maxconns'' is specified with a value of 100, every particular thread of this pool will get a random value between 80 and 120. If ''spread'' is set to 0, the specified values are used as specified, like in older versions of aolserver.
  
: Configure the specified pool with the given values
 
  
 
'''EXAMPLES'''
 
'''EXAMPLES'''

Revision as of 09:51, 30 January 2009

<manpage>ns_startcontent</manpage>

NAME

ns_pools - Set connection to streaming state for streaming content via ns_write

SYNOPSIS

ns_pools option ?arg arg ...?

DESCRIPTION

This command enables configuration of one or more pools of connection processing threads. The pools allow certain requests to be handled by specific threads. This could, for example, ensure multiple long running requests don't block other short running requests. Pools are selected based on method/url pairs similar to the mappings managed by the ns_register_proc command. By default, all requests are handled by a single, unlimited, "default" pool. There is also an "error" pool as described below. Coupled with the ns_limits command, pools can provide for sophisticated resource management.
This command can be used to set to retrieve various pieces of information about a pool configuration.


The legal options (which may be abbreviated) are:
  • ns_pools set poolname ? -maxthreads value? ? -minthreads value? ? -maxconns value? ? -timeout value? ? -spread value?
Configure the specified pool with the given values. maxthreads specifies the maximum number of connections threads, maxthreads specifies the minimum number of connection threads, maxconns' is the maximum number of requests sent to a single thread before it stops, timeout is the idle timeout per thread in this pool per second, spread is a factor of variance used for setting maxconns and timeout to avoid simultaneous shutdowns of many threads. A spread of 20 (the default value) means the every thread gets the specified value +- 20%. For instance, if maxconns is specified with a value of 100, every particular thread of this pool will get a random value between 80 and 120. If spread is set to 0, the specified values are used as specified, like in older versions of aolserver.


EXAMPLES

ns_startcontent -type "text/html; charset=[ns_config ns/parameters OutputCharset iso-8859-1]"

SEE ALSO

ns_limits