The following sections describe the PlateSpin Orchestrate Server grid objects and facts that are required for provisioning of PlateSpin Orchestrate resource objects. This section highlights the facts that are expected to be set from a virtual machine discovery.
The following table explains the abbreviated codes used to define the PlateSpin Orchestrate grid objects and facts listed in the following sections:
Table 9-1 PlateSpin Orchestrate Grid Object Definitions
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. 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. datagrid: N/A virtual: N/A |
repository.description |
The description of the repository. |
String |
Local: o Default empty. SAN: o. nas: o. 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. 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. 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. 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 virtual: X |
repository.id |
The repository’s unique name. |
String |
Local: X SAN: X nas: X 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. 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. 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"] 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. 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. datagrid: N/A, empty. virtual: N/A, empty. |
repository.type |
The type of repository:
|
String (enum) |
Local: X. Local SAN: nas: 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). 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 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 datagrid: X virtual: X |
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
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
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)