SWS Instances Test

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.

This test reports useful performance statistics related to a web server instance, which indicate the following:

  • How long has the instance been up and running?
  • How quickly does the instance respond to requests? Is there a processing bottlneck on the server instance?
  • Have any been errors been captured on the instance?
  • How is the data traffic to and from the instance?

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 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.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

Instance running time

Indicates the total time for which the instance has been up and running.

Secs

By observing the variations in this measure over time, you can determine whether there were frequent breaks in the availability of the instance.

The detailed diagnosis of this measure (if enabled) displays starting time of the instance.

Requests

Indicates the rate of requests to all the virtual servers in the instance.

Reqs/Sec

 

No. of errors

Indicates the number of errors logged on all the virtual servers in the instance during the last measurement period.

Number

Ideally, this value should be 0.

Maximum response time

Indicates the maximum response time of all virtual servers since the instance was up.

Secs

A low response time is typically desired. A high value of this measure could indicate a processing bottleneck on the web server instance or a network congestion. 

Avg res time in Last5min

Average response time of all virtual servers in the instance during last 5 minutes.

Secs

 

Data transmitted

Indicates the rate of data transmitted by this instance.

KB/Sec

 

Data received

Indicates the rate of data received by this instance.

KB/Sec