Information about settings in the RHEV XML files (Bare Metal and Template Based)

This topic contains the following sections:

Descriptions of sections and settings
To get the server ID - RHEVManager
To get the RHEV SourceTemplateId
To get the RHEV storage name
To get the RHEV network name
RHEV platform-specific properties

Descriptions of sections and settings

Section	Optional (O) or Mandatory (M)	Default/possible values	Notes
<GeneralInfo>	M		<PackageName> and <PackageDescription> — Name and description of the VGP. <DepotGroupId> — You store VGPs in the Depot. You can get the ID of a depot group by using the command DepotGroup : groupNameToId. <VirtualGuestPackageType> — Specify one of the following integers: 12 - RHEV Template Based 13 - RHEV Bare Metal <VirtualGuestName> — Name of the virtual guest you are using this package to create.
<PlatformInfo>			The following sections are part of the PlatformInfo section.
<VirtualGuestInfo>			The following sections are part of the VirtualGuestInfo section.
<Description>	O		Optional description of the virtual guest.
<GuestOS>	M – For bare metal VGP. Not used for template based VGP, since template already has Guest OS associated with it.	rhel_6 rhel_6x64 rhel_5 rhel_5x64 rhel_4 rhel_4x64 rhel_3 rhel_3x64 windows_xp windows_2003 windows_2003x64 windows_7 windows_7x64 windows_2008 windows_2008x64 windows_2008r2 other_linux other
<SourceTemplateId>	M - for template based VGP. Not used with bare metal VGP.		The RHEV template on which you are basing this VGP. For information on how to get this value, see To get the RHEV SourceTemplateId.
<CoresPerSocket>	O	In the case of a bare metal VGP, default value = 1.	Integer value indicating number of cores per socket.
<NumOfSockets>	O	In the case of a bare metal VGP, default value = 1.	Integer value indicating number of sockets you are assigning to the virtual guest. Total cores assigned to the virtual guest = coresPerSocket * numOfSockets
<MemoryInMB>	O	In the case of a bare metal VGP, default value = 256.	Integer value indicating size of memory, expressed in MB.
<PowerOnVMAfterCreation>	O	Default = true.	True to power on the virtual machine after it is created, false otherwise.
<VirtualDisks>	O		Group tag for virtual disks
<VirtualDisk>	M
<DiskSizeInGB>	M		Integer indicating disk size, expressed in GB.
<Storage>	M		Storage name where virtual disk will be created. For information on how to get this value, see To get the RHEV storage name.
<ThinProvisioning>	O	Default = false.	Set this to true or false: True: Allows virtual disks to use only the amount of storage space they currently need. False: For a disk, the given disk size is pre-allocated to that on storage.
<VirtualNetworks>	O		Group tag for virtual networks.
<VirtualNetwork>	M		Group tag for network interface.
<NetworkName>	M		Name of the network to use. For information on how to get this name, see To get the RHEV Network Name.
<MACAddress>	O		If you do not specify this value, the hypervisor will generate the MAC address.
<PlatformSpecificProperties>			RHEV supports the following platform-specific properties: HAPriority diskInterfaceType networkAdapterType For information about the values you can specify for these properties, see RHEV platform-specific properties.

To get the server ID - RHEVManager

Some of the commands you use to get VGP values require you to pass in the server ID of the RHEVManager.
To do this, use the listVirtualEntityManagers command, and pass in an EntityType argument that specifies RHEVManagers:

Command	Virtualization listVirtualEntityManagers RHEVManager
Output format	ServerId::ServerName
Output example	1::MyRHEVManager

In this example, the server ID is 1.

To get the RHEV SourceTemplateId

Use the listVirtualEntitiesByEntityManagerServerNameAndEntityType command to get the SourceTemplateId. This command takes 3 arguments — server name of the RHEV manager, EntityType, and true|false to indicate whether or not you want to print a header in the output.

Because you want a <SourceTemplateId>, you specify Template as EntityType:

Command	Virtualization listVirtualEntitiesByEntityManagerServerNameAndEntityType rhev-manager Template true
Output format	Name::OS::Entity Key
Output example	rhev-5_7_32bit::rhel_5::1 Template rhev-5_7_32bit

The <SourceTemplateId> element in the VGP file uses the EntityKey as the ID, so in this example you would specify:

<SourceTemplateId>1 Template rhev-5_7_32bit</SourceTemplateId>

To get the RHEV storage name

Get the server ID of the RHEVManager, as described in To get the server ID - RHEVManager. For the purpose of this example, assume the server ID is 1.
Now you can use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the storage name. This command takes 3 arguments — ServerId, EntityType, and true|false to indicate whether or not you want to print a header with the output.

You already have the ServerId (1).
Because you want a storage name, you specify Storage as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 Storage true
Output format
Storage::Capacity (GB)::Free Space (GB)
Output example
data::799.0::180.0
The <Storage> element in the VGP file uses the Storagevalue, so in this example you would specify:
<Storage>data</Storage>

To get the RHEV network name

Get the server ID of the RHEVManager, as described in To get the server ID - RHEVManager. For the purpose of this example, assume the server ID is 1.
Now you can use the listVirtualEntitiesByEntityManagerServerIdAndEntityType command to get the network name. This command takes 2 arguments — ServerId and EntityType. You already have the ServerId (1).

Because you want a network name, you specify Network as EntityType:
Command
Virtualization listVirtualEntitiesByEntityManagerServerIdAndEntityType 1 Network
Output Format
Name::network_attributes
Output Example
network2::... attributes omitted ...
For example, in the VGP file you might specify the following:
<NetworkName>network2</NetworkName>

RHEV platform-specific properties

Property	Legal values
HAPriority (Describes high availability for the virtual machine you are creating.)	No_HA Low Medium High
diskInterfaceType	ide virtio default (Note that default assumes ide for Windows, and virtio for Linux.)
networkAdapterType	e1000 virtio rtl8139 rtl8139_virtio default (Note that default asso for Linux.)