9.7 Defining Values for Grid Objects

The following sections describe the ZENworks Orchestrator Server grid objects and facts that are required for provisioning of Orchestrator resource objects: This section highlights the facts that are expected to be set from a virtual machine discovery.

9.7.1 Orchestrator Grid Objects

The following table explains the abbreviated codes used to define the Orchestrator grid objects and facts listed in the following sections:

Table 9-1 Orchestrator Grid Object Definitions

Value

Description

Automatic

The fact should be automatically set after the successful discovery of virtual resources (VmHosts and VMs).

Boolean

The fact is a Boolean value.

Default

The specified default value of the fact is set.

Dictionary

The fact is selected from a specified dictionary listing.

Dynamic

The fact is dynamically generated.

Enumerate

The fact is a specified enumerated value.

Example

When available, provides an example how a fact might be applied to an object.

Integer

The fact is an integer value.

Real

The fact is a real number.

String

The fact is a string value.

Datagrid

Facts relate to datagrid object types.

Local

Facts relate to local object types.

NAS

Facts relate to Network Attached Storage (NAS) object types.

SAN

Facts relate to Storage Area Network (SAN) object types.

Virtual

Facts relate to virtual object types.

Warehouse

Facts relate to warehouse object types.

9.7.2 Repository Objects and Facts

Facts marked with an X designate that they should be automatically set after the successful discovery of virtual resources (VmHosts and VMs). Unless marked with the ° symbol, all of the following repository objects and facts must be set for the particular provisioning adapter to function. Facts marked with °° indicate the fact is required under certain conditions.

Table 9-2 Repository Objects and Facts

Fact Name

Description

Fact Type

Type:

X = automatically set

° = Not necessary to be set

°° = Required under certain conditions

repository.capacity

The maximum amount of storage space available to virtual machines (in megabytes). The value -1 means unlimited.

Integer

Local: Note: Not auto discovered, but set to a default value of -1 (unlimited size). The Administrator should alter this value.

This fact is not currently applicable to SAN because you cannot move file-based disks into a SAN.

SAN: Note: Not auto discovered, but set to a default value of -1 (unlimited size). The Administrator should alter this value.

nas: Note: Not auto discovered, but set to a default value of -1 (unlimited size). The Administrator should alter this value.

Warehouse: Note: Not autodiscovered, but set to a default value of -1' (unlimited size). The Administrator should alter this value.

datagrid: Note: Not auto discovered, but set to a default value of -1 (unlimited size). The Administrator should alter this value.

virtual: Note: Not auto discovered, but set to a default value of -1 (unlimited size). The Administrator should alter this value.

repository.searchpath

The relative path from the location to search for VM configuration files, which implicitly includes repository.image. preferredpath.

String []

Local: X. [etc/xen/vm, myimages]

NOTE:The path is relative to repository.location or the leading '/' is ignored.

SAN: o.

nas: X. [“my_vms”, “saved_vms”] or [""] Specifiesto search the whole mount.

NOTE:The path is either relative to repository.location; the leading '/' ignored.

Warehouse: N/A

datagrid: N/A

virtual: N/A

repository.description

The description of the repository.

String

Local: o Default empty.

SAN: o.

nas: o.

Warehouse: o Default empty.

datagrid: o Default empty.

virtual: o Default empty.

repository.efficency

The efficiency coefficient used to calculate the cost of moving VM disk images to and from the repository. This value is multiplied by the disk image size in Mb to determine a score. Thus, thus 0 means no cost and is very efficient).

Real

Local: Defaults to 1, which normalizes the transfer efficiency for moving VM disks.

SAN: oDefaults to 1, which normalizes the transfer efficiency for moving VM disks. Not currently applicable because file-based disks cannot be moved into a SAN.

nas: Defaults to 1, which normalizes the transfer efficiency for moving VM disks.

Warehouse: Defaults to 1, which normalizes the transfer efficiency for moving VM disks.

datagrid: Defaults to 1, which normalizes the transfer efficiency for moving VM disks.

virtual: Defaults to 1, which normalizes the transfer efficiency for moving VM disks.

repository.enabled

True if the Repository is enabled, meaning that new VM instances can be provisioned.

Boolean

Local: Defaults to true.

SAN: Defaults to true.

nas: Defaults to true.

Warehouse: Defaults to true.

datagrid: Defaults to true.

virtual: Defaults to true.

repository.freespace

The amount of storage space available to new virtual machines (in megabytes). The value -1 means unlimited.

Integer

Local: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

SAN: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

nas: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

Warehouse: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

datagrid: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

virtual: Dynamic: (capacity—used space) or -1 if capacity is unlimited.

repository.groups

The groups this Repository is a member of.

String[]

Local: X

SAN: X

nas: X

Warehouse: X

virtual: X

repository.id

The repository’s unique name.

String

Local: X

SAN: X

nas: X

Warehouse: X. This fact is autocreated as warehouse, but could add others manually.

datagrid: X. Currently one datagrid repository is supported.

virtual: X

repository.preferredpath

The relative path from the location to search and place VM files for movement and cloning.

String

Local: X. "var/lib/xen/images"

NOTE:The path is relative to repository.location; the leading '/' is ignored.

SAN:

nas: X. "my_vms"

NOTE:The path is relative to repository.location; the leading '/' is ignored.

Warehouse: N/A

datagrid: N/A

virtual: N/A

repository.location

The Repository's physical location.

String

Local: X. "/" or /var/xen/images.

SAN: o.

nas: X. /u or /mnt/myshareddisk.

NOTE:This is the “mount point,” which is assumed to be the same mount point on every host that has a connection to this NAS.

Warehouse: X. grid:///warehouse

datagrid: oX. grid:///vms

virtual: N/A

repository.provisioner.jobs

The names of the provisioning adapter jobs that can manage VMs on this repository.

String []

Local: X. ["xen30"]

SAN:

nas: X. ["xen30"]

Warehouse: X. ["xen30"]

datagrid: X. ["xen30"]

virtual: X. ["vcenter"]

repository.san.type

The type of SAN (Adapter specific, “iscsi”, or “fibrechannel” or '' if not applicable.

String (enum)

Local: N/A, empty.

SAN: Administrator must set to “iqn”, “npiv“, or “emc.”

nas: N/A, empty.

Warehouse: N/A, empty.

datagrid: N/A, empty.

virtual: N/A, empty.

repository.san.vendor

The vendor of the SAN. Controls which storage bind logic to run (e.g. LUN masking, etc.).

String

Local: N/A, empty.

SAN: Administrator must set to “iscsi” or “fibrechannel.”

nas: N/A, empty.

Warehouse: N/A, empty.

datagrid: N/A, empty.

virtual: N/A, empty.

repository.type

The type of repository:

  • Local; e.g. a local disk.

  • nas; e.g. a NFS mount.

  • san , datagrid: A Orchestrator built in datagrid backed store.

  • warehouse: A ZENworks managed storage.

  • virtual: An externally managed VM; e.g. VMWare Virtual Center.

String (enum)

Local: X. Local

SAN:

nas:

Warehouse: X. Warehouse

datagrid: X. Datagrid

virtual: X. Virtual

repository.usedspace

The amount of storage space used for virtual machines.

Integer

Local: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

SAN: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

Not currently applicable to SAN because you cannot move file-based disks into SAN.

nas: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

Warehouse: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

datagrid: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

virtual: Dynamic: Sum of disk space used by contained VMs. Only includes disks that are stored as local files (not partitions).

repository.vmhosts

The list of VM hosts capable of using this repository (aggregated from the individual VM host fact).

String []

Local: X

SAN:

nas: X

Warehouse: X

datagrid: X

virtual: X

repository.vmimages

The list of VM images stored in this repository (aggregated from individual VM fact).

String []

Local: X

SAN:

nas: X

Warehouse: X

datagrid: X

virtual: X

9.7.3 VmHost Objects and Facts

Unless marked with a “°” symbol, all of the following VmHost objects and facts must be set for the particular provisioning adapter to function.The “X”mark designates that the fact should be automatically set after the successful discovery of virtual resources (VmHosts and VMs).

Table 9-3 VmHost Objects and Facts

Fact Name

Description

Fact Type

Provision Adapter

X = automatically set

° = Not necessary to be set

°° = Required under certain conditions

vmhost.accountinggroup

The default vmhost (resource) group which is adjusted for VM statistics.

String

xen30: X. All.

vmserver: X. All.

vcenter: X. All.

vmhost.enabled

True if the VM host is enabled, which enables new VM instances to be provisioned.

Boolean

xen30: X. True.

vmserver: X. True.

vcenter: X. True.

vmhost.groups

The groups this VM host is a member of. Alias for 'vmhost.resource.group.

String []

xen30: X.

vmserver: X.

vcenter: X.

vmhost.id

The VM host's unique name.

String

xen30: X. <physical host id>_xen30

vmserver: X. <physical host id>_vmserver

vcenter: X. <physical host id>_vcenter

vmhost.loadindex.slots

The loading index; the ratio of active hosted VMs to the specified maximum.

Dynamic Real

xen30: X.

vmserver: X.

vcenter: X.

vmhost.loadindex.virtualmemory

The loading index; the ratio of consumed memory to the specifed maximum.

Dynamic Real

xen30: X.

vmserver: X.

vcenter: X.

vmhost.location

The VM host's physical location.

String

xen30: oDefaults to empty string.

vmserver: oDefaults to empty string.

vcenter: X. Virtual center's 'locator' to the Vmhost; e.g., "/vcenter/eng/esx1".

vmhost.maxvmslots

The maximum number of hosted VM instances.

Integer

xen30: Defaults to 3. Should be reset by Administrator.

vmserver: Defaults to 3. Should be reset by Administrator.

vcenter: Defaults to 3. Should be reset by Adminstrator.

vmhost.memory.available

The amount of memory available to new virtual machines.

Dynamic Integer

xen30: X. Calculated to be 'vmhost.memory.max; the memory consumed by running VMs.

vmserver: X. Calculated to be 'vmhost.memory.max; the memory consumed by running VMs.

vcenter: X. Calculated to be 'vmhost.memory.max; the memory consumed by running VMs.

vmhost.memory.max

The maximum amount of memory available to virtual machines (in megabytes).

Integer

xen30: X. Discovered.

vmserver: X. Discovered.

vcenter: X. Discovered.

vmhost.migration

True if the VM host can support VM migration; also subject to provision adapter capabilities.

Boolean

xen30: X. Defaults to false. Not discovered. Administrator should enable as appropriate to indicate that the VmHost supports migration.

vmserver: X. Defaults to false. Not discovered. Should not be set to true since vmserver/gsx does not support migration.

vcenter: X. Discovered.

vmhost.provisioner.job

The name of the provisioning adapter job that manages VM discovery on this host.

String

xen30: X. xen30.

vmserver: X. vmserver.

vcenter: X. vcenter.

vmhost.provisioner.password

The password required for provisioning on the VM host. This fact is used by the provisioning adapter.

String

xen30: o.

vmserver: o. If set, this fact is passed to the vmserver CLI tools to authenticate. Not necessary if Orchestrator agent is run as root.

vcenter: o.

vmhost.provisioner.username

The username required for provisioning on the VM host. This fact is used by the provisioning adapter.

String

xen30: o.

vmserver: If set, is passed to vmserver CLI tools to authenticate. Not necessary if Orchestrator agent is run as root.

vcenter: o.

vmhost.repositories

This list of repositories (VM disk stores) is visible to this VM host.

String []

xen30: X. Discovery only adds the local repository, the datagrid and the warehouse on the first creation of the vmhost. Administrator is required to add SAN/NAS repositories or remove local if desired.

vmserver: X. Discovery only adds the local repository, the datagrid and the warehouse on the first creation of the vmhost. Administrator is required to add SAN/NAS repositories or remove local if desired.

vcenter: X. Automatically set to VirtualCenter.

NOTE:This is the only sensible setting.

vmhost.resource

The name of the resource that houses this VM host container.

xen30: o.

vmserver: X.

vcenter: X.

vmhost.shuttingdown

True if the VM host is attempting to shut down and does not need to be provisioned.

Dynamic Boolean

xen30: Initially False, then set to True when the administrator specifies to shut down a host.

vmserver: Initially False, then set to True when the administrator specifies to shut down a host.

vcenter: Initially False, then set to True when the administrator specifies to shut down a host.

vmhost.vm.available.groups

The list of resource groups containing VMs that are allowed to run on this host.

String []

xen30: X. Automatically set to VMs_<provisioning_adapter>; e.g., any VM of compatible type can be provisioned. The VMs_<provisioning_adapter> group is automatically created by discovery. The administrator can refine this by creating new groups and editing if further restrictions are required.

vmserver: X. Automatically set to VMs_<provisioning_adapter>; e.g., any VM of compatible type can be provisioned. The VMs_<provisioning_adapter> group is automatically created by discovery. The administrator can refine this by creating new groups and editing if further restrictions are required.

vcenter: X. Discovery attempts to map Virtual Center grouping to Orchestrator resources groups and sets this fact accordingly. This also includes a special "template_vcenter" group to map to Virtual Center 1.3.x "templates".

vmhost.vm.count

The current number of active VM instances.

Dynamic Integer

xen30: X.

vmserver: X.

vcenter: X.

vmhost.vm.instanceids

The list of active VM instances.

Dynamic String[]

xen30: X.

vmserver: X.

vcenter: X.

vmhost.vm.templatecounts

A dictionary of running instance counts for each running VM template.

Dynamic Dictionary

xen30: X.

vmserver: X.

vcenter: X.

vmhost.xen.bits

xen30 only. Legal values are 32 and 64.

Integer

xen30: X. 64.

vmserver: oNot defined.

vcenter: oNot defined.

vmhost.xen.hvm

xen30 only.

Boolean

xen30: X. True.

vmserver: oNot defined.

vcenter: oNot defined.

vmhost.xen.version

xen30 only: Major.Minor version of the Xen hypervisor.

Real

xen30: X. 3.00

vmserver: oNot defined.

vcenter: oNot defined.

vmhost.vcenter.hostname

vcenter only. The hostname of the resource containing this VM container.

NOTE:Deprecated. Use 'vmhost.resource.hostname instead.

String

xen30: oNot defined.

vmserver: oNot defined.

vcenter: X. esx1.

vmhost.vcenter.networks

vcenter only. List of network interfaces on the physical host.

List

xen30: oNot defined.

vmserver: oNot defined.

vcenter: VM network.

vmhost.vcenter.grouppath

vcenter only: Part of the Virtual Center “locator” URL.

List

xen30: oNot defined.

vmserver: oNot defined.

vcenter: X. /vcenter/eng1.

9.7.4 VM Resource Objects and Other Base Resource Facts

The following virtual machine resource objects and additional base resource facts marked with the “•” symbol must be set for the particular provisioning adapter to function. Facts marked with “••” indicate the fact is required under certain conditions. The “X” character designates that the fact should be automatically set after the successful discovery of virtual resources (VmHosts and VMs).

Table 9-4 Resource Objects (VM only) and Additional Facts to Base Resource Facts resource.provisioner.warehouse.guidresource.provisioner.warehouse.guid

Fact Name

Description

Type

Provision Adapter

X = automatically set

° = Not necessary to be set

°° = Required under certain conditions

resource.provision.automatic

Signifies that this resource was cloned/provisioned automatically and thus is shut down/destroyed automatically as well.

Dynamic Boolean

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.autoprep.*

Fact namespace used to convey configuration information actually used to "personalize" this VM instance.

<various>

xen30: o X. Can be set when rediscovering the state or as a result of a migration or provision action.

vmserver: o X. Can be set when rediscovering the state or as a result of a migration or provision action.

vcenter: o X. Can be set when rediscovering the state or as a result of a migration or provision action.

resource.provision.currentaction

The current management action in progress on this provisionable resource.c.

Dynamic String

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.hostwait

The time (seconds) this resource has been waiting / waited for a suitable host.

Dynamic Integer

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.jobid

The current or last job ID that performed a provisioning action on this resource. Useful for viewing the job log.

Dynamic String

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.resync

Specifies that the provisioned resource's state needs to be re-synced with the underlying provisioning technology at the next opportunity.

Dynamic Boolean

xen30: oX. Can be set on discovery when the Orchestrator state machine mismatches the VM state. This initiates a future VM state recovery action ("Check Status"). May be set for delayed re-discovery by administrator or JDL logic.

vmserver: oX. Can be set on discovery when the Orchestrator state machine mismatches the VM state. This initiates a future VM state recovery action ("Check Status"). May be set for delayed re-discovery by administrator or JDL logic.

vcenter: oX. Can be set on discovery when the Orchestrator state machine mismatches the VM state. This initiates a future VM state recovery action ("Check Status"). May be set for delayed re-discovery by administrator or JDL logic.

resource.provision.state

The current state of this provisioned instance (down, suspended, up, paused) or unknown if an admin action is currently being performed.

Dynamic String (enum)

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.status

The current descriptive status of the provisioned resource.

Dynamic String

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.template

The ID of the template resource that this instance was created from (if applicable).

Dynamic String

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.time.request

The time when the last provision (or other administrative action) request was made.

Dynamic Date

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.time.shutdown

The time when the resource was last shut down.

Dynamic Date

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.time.start

The time when the resource was last successfully provisioned.

Dynamic Date

xen30: o .

vmserver: o .

vcenter: o .

resource.provision.vmhost

The ID of the host currently housing this provisioned resource.

Dynamic String

xen30: o .

vmserver: o .

vcenter: o .

resource.provisionable

True if the resources is a provisionable type.

Dynamic Boolean

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.autoprep.*

Fact namespace used to convey configuration information actually used to "personalize" this VM instance.

<various>

xen30: o X (only if set in warehouse).

vmserver: o .

vcenter: o .

resource.provisioner.count

The total count of operational instances and provisions in progress"

Dynamic Integer

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.debug

Controls the debug log level in the provisioner.

Boolean

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.host.maxwait

The maximum time to wait for a suitable host before timing out (in seconds, '<0' to wait indefinitely).

Integer

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.host.preferredwait

The time after which some VMhost constraints is lifted to increase the available pool by, for example, considering moving the disk image (in seconds, <0 to wait indefinitely).

Integer

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.instances

The list of id's of the instances of this template resource (if applicable).

String[]

xen30: o .

vmserver: o .

vcenter: o .

resource.provisioner.job

The name of the provisioning job that manages the life cycle of this resource.

String

xen30: X. xen30

vmserver: X. vmserver

vcenter: X. vcenter

resource.provisioner.maxinstances

The maximum allowed number of instances of this provisionable resource (applicable only to templates).

Integer

xen30: X. Defaults to 1. Administrator should reset for VM templates to allow multiple clones.

vmserver: X. Defaults to 1. Administrator should reset for VM templates to allow multiple clones.

vcenter: X. Defaults to 1. Administrator should reset for VM templates to allow multiple clones.

resource.provisioner.recommendedhost

The host on which the image for this resource is associated; e.g., was suspended or is the preferred host for quick startup.

String

xen30: o X.

vmserver: o X.

vcenter: o X.

resource.provisioner.warehouse.guid

The warehouse ID of this VM.

String

xen30: oo X. Required only if resource.provisioner.repository is 'warehouse' (guid from warehouse).

vmserver: N/A

vcenter: N/A.

resource.provisioner.warehouse.version

The warehouse version number of this VM.

Integer

xen30: oo X. Required only if resource.provisioner.repository is 'warehouse' {version from warehouse}.

vmserver: N/A.

vcenter: N/A.

resource.vcenter.grouppath

Locator for the Virtual Center group that the VM resides in.

String

xen30: o Not defined.

vmserver: o Not defined.

vcenter: X. /vcenter/eng

resource.vcenter.guestOS

VMWare's name for the guest OS.

String

xen30: o Not defined.

vmserver: o Not defined.

vcenter: X. winNetEnterprise.

resource.vcenter.imagepath

Locator for the VM in Virtual Center.

String

xen30: o Not defined.

vmserver: o Not defined.

vcenter: X. /vcenter/eng/windows2003ent.

resource.vm.basepath

The file system location of the VM files either absolute or relative to the 'repository.location' fact.

String

xen30: X. Example: "var/lib/xen/images/sles10".

vmserver: X. For example, "/var/lib/vmware/Virtual-Machines/sles9".

Location in the repository of the directory containing VM disks, configuration file and other related files.

vcenter: o N/A.

resource.vm.configfile

The location of the VM's configuration file inside of the default repository (resource.provisioner.repository).

String

xen30: X. /etc/xen/vm/sles10.

vmserver: o Not currently used.

vcenter: o N/A.

resource.vm.cpu.architecture

The required cpu architecture e.g. x86, x86_64, sparc.

String

xen30: o X (only if set in warehouse).

vmserver: o .

vcenter: o .

resource.vm.cpu.weight

The CPU weight for this VM. A value of '1.0' represents normal weighting; setting another VM to a weight of '2.0' would mean it would get twice as much cpu as this VM.

Real

xen30: o .

vmserver: o .

vcenter: o .

resource.vm.files

Files that make up this VM. The dictionary key (String) represents the file type (adapter specific), the value is the file path either absolute or relative to 'repository.location' of the 'resource.vm.repository'.

Dictionary

xen30: X. { "mof": /var/lib/xen/images/sles10/mof" , "suspendcheckpoint": "/var/lib/xend/domain/checkpoint", "config": "/var/lib/xen/images/sles10/config.xen' }.

vmserver: o X { "config": "/var/lib/vmware/Virtual Machines/sles10/sles10.vmx' }.

vcenter: o N/A.

resource.vm.maxinstancespervmhost

The maximum allowed number of instances of this VM image per vmhost.

Integer

xen30: Defaults to 1. Administrator should increase if more than one instance of the same VM template is allowed to be run on one host.

resource.vm.memory

The configured virtual memory requirement of this VM image (megabytes).

Integer

xen30: X.

vmserver: X.

vcenter: X.

resource.vm.preventmove

Set by the administrator to prevent relocation of a VM (disk moves) even if possible.

Boolean Default: False

 

resource.vm.type

The required system type of a virtual machine ( 'full' or 'para' ).

String

xen30: X.

vmserver: X.

vcenter: X.

resource.vm.uuid

The UUID of a virtual machine (vendor/adapter specific).

String

xen30: X. {vm uuid}

vmserver: Not currently used.

vcenter: Not currently used.

resource.vm.vcpu.number

The number of virtual CPUs for this VM.

Integer

xen30: o X.

vmserver: o .

vcenter: o .

resource.vm.vdisks

The specification of virtual disks that make up this VM. The dictionary keys are name (String), repository (String), location (String), size (Integer), fixed (Boolean).

List of Diction-aries

xen30: X. [ { "location":"/var/lib/xen/images/sles10/disk1", "moveable":True,"repository":"vmhost1" ... } ].

vmserver: o Not currently used.

vcenter: o N/A.

resource.vm.vdisksize

The total size of all the moveable virtual desks for this VM image (megabytes).

Integer

xen30: X.

vmserver: X.

vcenter: X.

resource.vm.vendor

The vendor of a virtual machine.

String

xen30: o X.

vmserver: o X.

vcenter: o X.

resource.vm.version

The version number for this VM.

Integer

xen30: X (only if set in warehouse). Required only if resource.provisioner.repository is 'warehouse.

vmserver: o N/A.

vcenter: o N/A.

resource.vm.vmhost.rankby

The ranking specification used to select suitable vm hosts. Element syntax is <fact>/<order> where order is either a (ascending) or d (descending).

String[]

xen30: Defaults to vmhost.vm.placement.score/a, vmhost.loadindex.slots/a.

vmserver: Defaults to vmhost.vm.placement.score/a, vmhost.loadindex.slots/a.

vcenter: Defaults to vmhost.vm.placement.score/a, vmhost.loadindex.slots/a.

resource.vnc.ip

The host IP address for a VNC session running on the resource.

NOTE:Technically, this fact is available on all resources both VMs and physical.

String

xen30: o X. 192.168.0.4

vmserver: Not used.

vcenter: o .

resource.vnc.port

The port number for a VNC session running on the resource.

NOTE:Technically, this fact is available on all resources both VMs and physical.

Integer

xen30: o X. 5900

vmserver: Not used.

vcenter: o .

9.7.5 Physical Resource Objects and Additional Facts

The following physical resource objects and additional base resource facts marked with the “•” symbol must be set for the particular provisioning adapter to function. The physical resources have the potential of creating VmHost containers.

Facts marked with “••” indicate the fact is required under certain conditions. The “X” character designates that the fact should be automatically set after the successful discovery of virtual resources (VmHosts and VMs).

Table 9-5 Resource Object (Physical that have the potential for VmHost containers) / Additional Facts (additional to base resource set) resource.provisioner.warehouse.guid

Fact Name

Description

Type

Provision Adapter

X = automatically set

° = Not necessary to be set

°° = Required under certain conditions

resource.vcenter.client

vcenter only: Marks resources and Virtual Center web services client capable.

.

Boolean

xen30: o Not defined.

vmserver: o Not defined.

vcenter: Administrator must set through association of 'vcenter_client.policy' with approriate resources.

resource.vmserver.cmdpath

vmserver only: Path to VMWare CLI tools.

String

xen30: o Not defined.

vmserver: X. For example, "/usr/bin/vmware-cmd"

vcenter: o Not defined.

resource.vmserver.localrepositories

vmserver only: Paths to VM storage directories.

List

xen30: o Not defined.

vmserver: For example, "/var/lib/vmware/virtual machines"

vcenter: o Not defined.

resource.vmserver.vmrunpath

vmserver only: Full path to vmrun CLI tool.

String

xen30: o Not defined.

vmserver: X. For example, "/usr/bin/vmrun".

vcenter: o Not defined.

resource.xen

xen30 only: Xen enabled.

Boolean

xen30: X. True.

vmserver: o Not defined.

vcenter: o Not defined.

resource.xen.bits

xen30 only: (legal values are 32 and 64)

String

xen30: X. 64 bit.

vmserver: o Not defined.

vcenter: o Not defined.

resource.xen.hvm

xen30 only:

Boolean

xen30: X. True.

vmserver: o Not defined.

vcenter: o Not defined.

resource.xen.version

xen30 only: Major.Minor version of the Xen hypervisor.

.

Real

xen30: X. 3.00.

vmserver: o Not defined.

vcenter: o Not defined.