Control Domain Test

When Oracle VM Server for SPARC software is installed, a domain called the control domain is created. From this control domain, you can create virtual machines called logical domains that each run an independent OS. The control domain manages the logical domains and in the process consumes the physical CPU and memory resources of the Oracle VM server. In the event of a resource contention, administrators must figure out what is draining resources from the server – is it the control domain? Or is it one/more of the logical domains on the server? Using this test, administrators can accurately tell whether/not the control domain is contributing to the resource crunch experienced by the Oracle VM server.

Target of the test: Oracle VM Server

Agent deploying the test: A remote agent

Outputs of the test: One set of results for the Oracle VM Server being monitored.

Configurable parameters for the test
Parameters	Description
Test Period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port at which the specified Host listens. By default, this is NULL.
Oracle VM Manager, Oracle VM Manager User, Oracle VM Manager Password, and Confirm Password	This test remotely connects to the Oracle VM Manager that manages the monitored Oracle VM Server and uses the web services API of the Oracle VM Manager to pull out metrics of interest. To enable this test to communicate with the web services API, you first need to configure the test with the IP address or host name of the Oracle VM Manager. This can be done using the Oracle VM Manager text box. Then, you need to configure the test with the credentials of a user with Admin rights to the Oracle VM Manager. Use the Oracle VM Manager User and Oracle VM Manager Password parameters to configure these credentials. Finally, confirm the password by retyping it in the Confirm Password text box.
SSL	By default, the Oracle VM Manager is SSL-enabled. Accordingly, the SSL flag is set to Yes by default. This indicates that the eG agent will communicate with the Oracle VM Manager via HTTPS by default.
WebPort	By default,, the Oracle VM Manager listens on 7002. This implies that while monitoring an Oracle VM server via an SSL-enabled Oracle VM Manager, the eG agent, by default, connects to port 7002 of the Oracle VM Manager to pull out metrics. In some environments however, this default port may not apply. In such a case, against the WebPort parameter, you can specify the exact port at which the Oracle VM Manager in your environment listens so that the eG agent communicates with that port.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Processors assigned	Indicates the number of processors assigned to the control domain.	Number
CPU utilization	Indicates the percentage of physical CPU resources utilized by the control domain.	Percent	If the value of this measure consistently grows closer to 100%, it is indicative of excessive CPU usage by the control domain.
Memory used	Indicates the amount of memory used by the control domain.	MB	Ideally, the value of this measure should be low.