Sun Java System Web Server 6.1 SP11 Administrator's Guide

The Sun Java System Web Server MIB

Sun Java System Web Server stores variables pertaining to network management. Variables that the master agent can access are called managed objects. These objects are defined in a tree-like structure called the MIB, which provides access to the web server’s network configuration, status, and statistics. Using SNMP, you can view this information from the network management workstation (NMS).

A server’s MIB contains variable definitions pertaining to network management for that particular server. The top level of the MIB tree is shown in The Sun Java System Web Server MIBthe figure below:

Figure 11–2 Top Level of the MIB Tree

The top level of the MIB tree shows that the internet object identifier has four subtrees: directory (1), mgmt (2), experimental (3), and private (4). The private (4) subtree contains the enterprises (1) node. Each subtree in the enterprises (1) node is assigned to an individual enterprise, which is an organization that has registered its own specific MIB extensions. An enterprise can then create product-specific subtrees under its subtree. MIBs created by companies are located under the enterprises (1) node. The Sun Java System MIBs are located under the enterprises (1) node.

Each Sun Java System Web Server subagent provides a MIB for use in SNMP communication. The server reports significant events to the NMS by sending messages or traps containing these variables. The NMS can also query the server’s MIB for data, or can remotely change variables in the MIB.

Each Sun Java System server has its own MIB. All Sun Java System MIBs are located at:

server_root/plugins/snmp

The Sun Java System Web Server’s MIB is a file called webserv61.mib. This MIB contains the definitions for various variables pertaining to network management for Sun Java System Web Server.

The Sun Java System Web Server 6.1 MIB has an object identifier of http 60 (iws60 OBJECT IDENTIFIER ::= {http 60 }) and is located in the server_root/plugins/snmp directory.

You can see administrative information about your web server and monitor the server in real time using the Sun Java System Web Server MIB. The Sun Java System Web Server MIB lists and describes the managed objects stored in the webserv61.mib.

Table 11–1 webserv61.mib managed objects and descriptions


Managed object	Description
iwsInstanceTable	Sun Java System Web Server instances.
iwsInstanceEntry	Sun Java System Web Server instance.
iwsInstanceIndex	Server instance index.
iwsInstanceId	Server instance identifier
iwsInstanceVersion	String, such as `SunJava System-WebServer/6.1 BB1-01/24/2001 17:15 (SunOS DOMESTIC)`
iwsInstanceDescription	Description of the server instance.
iwsInstanceOrganization	Organization responsible for the server instance.
iwsInstanceContact	Contact information for person(s) responsible for server instance.
iwsInstanceLocation	The location of the server.
iwsInstanceStatus	Status of the server instance.
iwsInstanceUptime	The time for which the server has been running.
iwsInstanceDeathCount	Number of times server instance processes have gone down.
iwsInstanceRequests	Number of requests processed by the server instance.
iwsInstanceInOctets	Number of octets received by the server instance. Will show 0 if information is not available.
iwsInstanceOutOctets	Number of octets transmitted by the server instance. Will show 0 if information is not available.
iwsInstanceCount2xx	Number of 200-level (Successful) responses issued by the server instance.
iwsInstanceCount3xx	Number of 300-level (Redirection) responses issued by the server instance.
iwsInstanceCount4xx	Number of 400-level (Client Error) responses issued by the server instance.
iwsInstanceCount5xx	Number of 500-level (Server Error) responses issued by the server instance.
iwsInstanceCountOther	Number of other (neither 2xx, 3xx, 4xx, nor 5xx) responses issued by the server instance.
iwsInstanceCount200	Number of 200 (Request Fulfilled) responses issued by the server instance.
iwsInstanceCount302	Number of 302 (Moved Temporarily) responses issued by the server instance.
iwsInstanceCount304	Number of 304 (Not Modified) responses issued by the server instance.
iwsInstanceCount400	Number of 400 (Bad Request) responses issued by the server instance.
iwsInstanceCount401	Number of 401 (Unauthorized) responses issued by the server instance.
iwsInstanceCount403	Number of 403 (Forbidden) responses issued by the server instance.
iwsInstanceCount404	Number of 404 (Not Found) responses issued by the server instance.
iwsInstanceCount503	Number of 503 (Unavailable) responses issued.
iwsVsTable	Sun Java System Web Server virtual servers.
iwsVsEntry	Sun Java System Web Server virtual server.
iwsVsIndex	Virtual server index.
iwsVsId	Virtual server identifier.
iwsVsRequests	Number of requests processed by the virtual server.
iwsVsInOctets	Number of octets received by the virtual server.
iwsVsOutOctets	Number of octets transmitted by the virtual server.
iwsVsCount2xx	Number of 200-level (Successful) responses issued by the virtual server.
iwsVsCount3xx	Number of 300-level (Redirection) responses issued by the virtual server.
iwsVsCount4xx	Number of 400-level (Client Error) responses issued by the virtual server.
iwsVsCount5xx	Number of 500-level (Server Error) responses issued by the virtual server.
iwsVsCountOther	Number of other (neither 2xx, 3xx, 4xx, nor 5xx) responses issued by the virtual server.
iwsVsCount200	Number of 200 (Request Fulfilled) responses issued by the virtual server.
iwsVsCount302	Number of 302 (Moved Temporarily) responses issued by the virtual server.
iwsVsCount304	Number of 304 (Not Modified) responses issued by the virtual server.
iwsVsCount400	Number of 400 (Bad Request) responses issued by the virtual server.
iwsVsCount401	Number of 401 (Unauthorized) responses issued by the virtual server.
iwsVsCount403	Number of 403 (Forbidden) responses issued by the virtual server.
iwsVsCount404	Number of 404 (Not Found) responses issued by the virtual server.
iwsVsCount503	Number of 503 (Unavailable) responses issued.
iwsProcessTable	Sun Java System Web Server processes.
iwsProcessEntry	Sun Java System Web Server process.
iwsProcessIndex	Process index.
iwsProcessId	Operating system process identifier.
iwsProcessThreadCount	Number of request processing threads.
iwsProcessThreadIdle	Number of request processing threads currently idle.
iwsProcessConnectionQueueCount	Number of connections currently in connection queue.
iwsProcessConnectionQueuePeak	Largest number of connections that have been queued simultaneously.
iwsProcessConnectionQueueMax	Maximum number of connections allowed in connection queue.
iwsProcessConnectionQueueTotal	Number of connections that have been accepted.
iwsProcessConnectionQueueOverflows	Number of connections rejected due to connection queue overflow.
iwsProcessKeepaliveCount	Number of connections currently in keepalive queue.
iwsProcessKeepaliveMax	Maximum number of connections allowed in keepalive queue.
iwsProcessSizeResident	Process resident size in kbytes.
iwsProcessSizeVirtual	Process size in kbytes.
iwsProcessFractionSystemMemoryUsage	Fraction of process memory in system memory.
iwsListenTable	Sun Java System Web Server listen sockets.
iwsListenEntry	Sun Java System Web Server listen socket.
iwsListenIndex	Listen socket index.
iwsListenId	Listen socket identifier.
iwsListenAddress	Address where socket listens.
iwsListenPort	Port where socket listens.
iwsListenSecurity	Encryption support.
iwsThreadPoolTable	Sun Java System Web Server thread pools.
iwsThreadPoolEntry	Sun Java System Web Server thread pool.
iwsThreadPoolIndex	Thread pool index.
iwsThreadPoolID	Thread pool identifier.
iwsThreadPoolCount	Number of requests queued.
iwsThreadPoolPeak	Largest number of requests that have been queued simultaneously.
iwsThreadPoolMax	Maximum number of requests allowed in queue.
iwsInstanceStatusChange	An `iwsInstanceStatusChange` trap signifies that `iwsInstanceStatus` has changed.
iwsInstanceLoad1MinuteAverage	System load average for one minute.
iwsInstanceLoad5MinuteAverage	System load average for five minutes.
iwsInstanceLoad15MinuteAverage	System load average for fifteen minutes.
iwsInstanceNetworkInOctets	Number of octets transmitted on the network per second.
iwsInstanceNetworkOutOctets	Number of octets received on the network per second.
iwsCpuIndex	The CPU index.
iwsCpuId	The CPU id.
iwsCpuIdleTime	The CPU idle time.
iwsCpuUserTime	The CPU user time.
iwsCpuKernelTime	The CPU kernel time.