Images Test

An image includes a desktop operating system (such as Windows 7 or Windows XP), a set of applications, and the VDI-in-a-Box Desktop Agent; without this agent, the vdimanager will not be able to receive updates on user sessions and desktop health. The vdimanager creates desktops from templates that consist of an image. A single image can be used by more than one template. Once an image is created, you can distribute that image to all the other servers in a grid. The Images test not only reports the distribution status (whether the image is successfully distributed or not) of an image, but also periodically checks the configuration of an image and reports whether the Desktop Agent is installed on the image or not. This way, the test promptly alerts you to distribution failures, points you to the reason why the vdimanager has not been receiving updates on user sessions and desktop health, and also leads you to the specific templates that have been affected by such incomplete (i.e., images without desktop agent) images.

Target of the test : A VDI-in-a-Box Manager

Agent deploying the test : A remote agent

Outputs of the test : One set of results for each user session

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.

Vdi in a box host

The IP address of the vdimanager being monitored

Vdi in a box Username, Vdi in a box Password, and Confirm Password

The test needs to log on to the VDI-in-a-Box appliance to pull out the metrics of interest. For this purpose, you need to configure the test with the credentials of a user with login rights to the appliance. By default, the appliance supports a root user named root (with the default password root) and a Read-only user named kvm (with the default password kaviza123). If you prefer not to expose the credentials of the root user, then you can configure the Vdi in a box Username and Vdi in a box Password parameters with the credentials of the user kvm. Confirm the password of this user by retyping it in the Confirm Password text box.

Note:

The default password of user kvm is kaviza123. If this is changed, then make sure you configure the Vdi in a box Password parameter with the new password.

SSH Port

Specify the SSH port number of the vdimanager. By default, this is 22.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise suite 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

Status

Indicates the current status of this image.

 

The values that this measure can take and their corresponding numeric values are discussed in the table below:

Measure Value Description Numeric Value
Green Image is distributed throughout the grid or fully distributed. 1
Yellow Image distribution is ongoing 2
Red Image distribution is complete. 3

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the distribution state of an image. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.

Image distribution

Indicates whether this image has been distributed or is being distributed to the servers in a grid.

 

The values that this measure can take and their corresponding numeric values are discussed in the table below:

Measure Value Description Numeric Value
Published The image is fully distributed throughout the grid 1
Distributing The image is being distributed throughout the grid 2

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the distribution state of an image. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.

Total templates using this image

Indicates the number of templates using this image.

Number

If the desktop agent is not installed on an image, then using this measure, you can easily assess the extent of the damage – this is because, this measure reports the total number of templates that will be affected by the non-availability of the desktop agent in the underlying image. To know which templates will be affected, use the detailed diagnosis of this measure.

Is HDX remote protocol enabled?

Indicates whether the HDX protocol is enabled for this image or not.

 

HDX is the default protocol that user devices use to communicate with virtual desktops provisioned by the VDI-in-a-Box appliance. HDX technology is a set of capabilities that deliver a “high definition” experience to end users of any application, on any device and over any network. This protocol provides multi-media support while using less bandwidth. It is suitable for remote access over a WAN.

The values that this measure can take and their corresponding numeric values are discussed in the table below:

Measure Value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the state of the HDX protocol. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.

Is desktop agent installed?

Indicates whether the Desktop Agent has been installed on this image or not.

 

If the value of this measure is No, it indicates that the desktop agent has not been installed on the image. This implies that the vdimanager will not be able to receive any communication related to user connections or desktop health from the desktops created using this image. If the value of this measure is Yes, it indicates that the desktop agent has been installed.

The numeric values that correspond to the measure values discussed above are as follows:

Measure Value Numeric Value
Yes 1
No 0

Note:

By default, this measure reports the above-mentioned Measure Values while indicating the state of the HDX protocol. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.

Image size

Indicates the current size of this image.

MB

 

Use the detailed diagnosis of the Total templates using the image measure to know which templates are using a particular image.

templatesusingtheimage

Figure 1 : The detailed diagnosis of the Total templates using the image measure

To know the current configuration of an image, use the detailed diagnosis of the Is desktop agent installed? measure.

deskagentinstalled

Figure 2 : The detailed diagnosis of the Is desktop agent installed? measure