SWS Thread Pools Test

For web server instances that are configured with the default settings, threads from the default thread pool process requests to the instance. In addition, custom thread pools can also be created and used to run custom NSAPI functions. By default, the web server creates one additional pool, named NativePool.

This test auto-discovers the native and custom thread pools used by a web server instance, and reports how well each pool is used.

Target of the test : An Oracle iPlanet Web Server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for each thread pool used by the web server instance being monitored.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port number at which the specified Host listens to.
User	Specify the name of the administrator of the administration server to which the target web server is registered.
PasswdFile	The eG agent connects to the administration server to which the target web server is registered to extract the required metrics. To enable the eG agent to communicate with this administration server, you first need to create a password file containing the administrator password for accessing the server; this password file should be created in the install directory of the web server. Specify the name of this file in the PasswdFile text box; by default, this is admin.passwd.
AdminServer	Specify the IP address of the administration server to which the target web server is registered.
AdminPort	Indicate the port at which the administration server listens.
Config	In Web Server 7.0, all configurable elements of a server instance like web applications, configuration files, and search collection indexes are logically grouped and termed as a Configuration. To enable the test to locate the web server instance to be monitored, you need to mention the Configuration that applies to the instance. In the Config text box therefore, specify the name of the Configuration which the target web server instance uses.
Node	Node is a network resource, such as a server or a host. Instance refers to the environment of a web server daemon on a given node, including its configuration, log files and other runtime artifacts such as lock databases, caches and temporary files. To enable the test to identify the exact web server instance to be monitored, you need to specify the name of the Node on which the instance executes. The test will thus monitor only that web server instance that operates on the given Node and which uses the specified Config.
SSL	Set this flag to Yes if the administration server is SSL-enabled; if not, set it to No.
WebServerDir	Here, specify the Oracle iPlanet web server installation directory.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
No of idle threads	Indicates the number of threads in this pool that are currently idle.	Number	A high value for this measure indicates that there are adequate free threads in the pool for servicing additional requests to the web server instance.
No of threads	Indicates the number of threads in this pool.	Number
No of requests queued	Indicates the number of requests currently waiting for a native thread from this pool.	Number	An abnormally high value for this measure could indicate the absence of free threads in the pool to service requests.
Peak requests queued	Indicates the highest number of requests that were ever queued up simultaneously for the use of a native thread from this pool since the server was started.	Number	This value can be viewed as the maximum concurrency for requests requiring a native thread.