Difference between revisions of "Ns pools"
Jump to navigation
Jump to search
Line 15: | Line 15: | ||
: 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. | ||
+ | : The legal ''option''s 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. | |
+ | |||
+ | * '''ns_pools get''' ''poolname'' | ||
+ | |||
+ | : Returns a list of attribute value pairs of the actual configuration and runtime values for the specified pool. The values can be set with the Tcl command ''array set''. The command returns values for the following attributes ''minthreads'', ''maxthreads'', ''idle'', ''current'', ''maxconns'', ''queued'', ''timeout'' and ''spread'' | ||
+ | |||
+ | * '''ns_pools list''' | ||
− | : | + | : Returns a list of the configured pools |
+ | * '''ns_pools register''' ''pool server method url'' | ||
'''EXAMPLES''' | '''EXAMPLES''' |
Revision as of 10:00, 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 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.
- ns_pools get poolname
- Returns a list of attribute value pairs of the actual configuration and runtime values for the specified pool. The values can be set with the Tcl command array set. The command returns values for the following attributes minthreads, maxthreads, idle, current, maxconns, queued, timeout and spread
- ns_pools list
- Returns a list of the configured pools
- ns_pools register pool server method url
EXAMPLES
- ns_startcontent -type "text/html; charset=[ns_config ns/parameters OutputCharset iso-8859-1]"
SEE ALSO