Novell Doc: PlateSpin Orchestrate 2.0 Development Client Reference

5.4 The Resource Object

A Resource object in the Explorer Panel represents a physical or virtual machine that is managed by PlateSpin Orchestrate. If a resource is running the PlateSpin Orchestrate Agent, that resource can be scheduled for remote execution of a job.

This section includes information about a Resource object that is visible in the Explorer view and the accompanying Admin view of the Orchestrate Development Client:

5.4.1 Resource Groups

Any group object displayed in the Explorer panel represents a collection of similar object types. Groups can also be created automatically, as in the case when a provisioning adapter (PA) discovers a local repository on a VM host. For example, the xen30 PA, upon discovery of a VM host, automatically creates a local repository for that VM host and places the created repository in a xen30 repository group. You can also create groups manually in the Development Client, either by clicking the Actions menu and choosing Create Resource Group or by right clicking a Resource Group object (anywhere in the Resource hierarchy) and selecting New Resource Group.

5.4.2 The Resource Info/Groups Tab

The page that opens under the Info/Configuration tab of the Resource admin view includes several collapsible sections on the page where you can configure the general information and attributes of the job.

NOTE:Whenever you make changes to any Grid object, that object’s icon is overlaid with the write icon , signifying that the object has been altered. If you want to save the changes you have made, you need to click the Save icon on the Development Client toolbar.

Info
Groups

Info

The following fields on the Information panel provide facts for the Resource object:

Show Inherited Fact Values Check Box

Select this check box to show facts with overridden values supplied through attached and/or inherited polices. Such fact values are read only (non-editable).

Resource Information

The Job Control Settings panel on the Info/Groups page includes the following fields:

NOTE:Tool tip text is available when you mouse over any of these fields.

Resource Type: This drop-down list lets you choose the resource type. If you manually create a resource, you must select the appropriate type.

Fixed Physical: The node is a physical, hardware-based computer.
VM: The node is a virtual, software-based container that can run its own operating system and applications as if it were a physical computer.
VM Template: The node is an image of a server that can be used to create and provision new virtual servers. The template includes a virtual hardware components, a guest operating system, its configuration, and other software applications.

In the Fact Editor, the Resource Type fact is listed as resource.type:

<fact name="resource.type" value="Fixed Physical" type="String" />

Resource Enabled: This check box is selected by default. When it is selected (that is, its value is “true”), the resource is enabled (that is, it is allowed to accept work).

In the Fact Editor, this fact is listed as resource.enabled:

<fact name="resource.enabled" value="true" type="Boolean" />

Healthy: When this check box is selected (that is, its value is “true”), the resource is considered to be in good health. You can set the health of the object by selecting or deselecting the health check box. Changing the value in this way has an immediate effect unless the value is overriden by an attached policy (this follows the normal rules of policy inheritance). For more information, see Section A.0, Grid Object Health Monitoring.

In the Fact Editor, this is fact is listed as resource.health:

<fact name="resource.health" value="true" type="Boolean" />

Shutting Down: (Read Only) When this check box is selected (that is, its value is “true”), the node is attempting to shut down, pause, or suspend and does not want to accept new work.

In the Fact Editor, this fact is listed as resource.shuttingdown:

<fact name="resource.shuttingdown" value="false" type="Boolean" />

Host Name: The network hostname of the resource that is running the Orchestrate Agent. Often, the resource ID and the hostname are the same, but this is not always the case.

In the Fact Editor, this fact is listed as resource.hostname:

<fact name="resource.hostname" value="foonode" type="String" />

Host Fully Qualified Name: The full network hostname of the resource that is running the Orchestrate Agent.

In the Fact Editor, this fact is listed as resource.hostname.full:

<fact name="resource.hostname.full" value="foonode.division.company.com" type="String" />

Password: The password you want the PlateSpin Orchestrate Agent on this node to use for authentication to the PlateSpin Orchestrate Server.

In the Fact Editor, this fact is listed as resource.password.

<fact name="resource.password" value="xxx" type="String" />

Host IP Address: The network IP address of the resource running the Orchestrate Agent.

In the Fact Editor, this fact is listed as resource.ip:

<fact name="resource.ip" value="10.255.255.255" type="String" />

VNC IP Address: The IP address for a VNC session running on this resource.

In the Fact Editor, this fact is listed as resource.vnc.ip:

<fact name="resource.vnc.ip" value="" type="String" />

VNC Port: The port number for a VNC session running on this resource.

In the Fact Editor, this fact is listed as resource.vnc.port:

<fact name="resource.vnc.port" value="0" type="Integer" />

Billing Rate: The billing rate (in dollars per hour) that you want to charge for this resource running its assigned joblets.

In the Fact Editor, this fact is listed as resource.billingrate:

<fact name="resource.billingrate" value="1.0000" type="Real" />

Bill For: This drop-down list lets you choose the time scale you want to bill for.

walltime: The total time for the process to complete.
gcycles: The normalized average of compute cycles.

In the Fact Editor, this fact is listed as resource.billfor:

<fact name="resource.billfor" value="walltime" type="String" />

Power Factor: (Read Only) This value specifies the normalized power index of this machine relative to a 2.0 GHz Intel Pentium 4 machine.

In the Fact Editor, this fact is listed as resource.powerfactor:

<fact name="resource.powerfactor" value="1.0000" type="Real" />

Load Average: (Read Only) The load average on this resource as determined with the uptime command or other similar methods. The resource is polled every 30 seconds to determine the average.

In the Fact Editor, this fact is listed as resource.loadaverage:

<fact name="resource.loadaverage" value="0.0000" type="Real" />

CPU Load: (Read Only) This value specifies the percentage of CPU utilization currently used by the resource.

In the Fact Editor, this fact is listed as resource.cpuload

<fact name="resource.cpuload" value="0" type="Integer" />

Joblet Slots: This value specifies the number of joblets that this resource can run simultaneously.

In the Fact Editor, this fact is listed as resource.joblets.slots:

<fact name="resource.joblets.slots" value="1" type="Integer" />

Extra System Joblet Slots: This value specifies the number of extra slots you want to be made available to privileged system joblets.

In the Fact Editor, this fact is listed as resource.joblets.systemslots:

<fact name="resource.joblets.systemslots" value="1" type="Integer" />

Joblets Active: (Read Only) This value specifies the number of joblets that are currently active on this resource.

In the Fact Editor, this fact is listed as resource.joblets.active:

<fact name="resource.joblets.active" value="0" type="Integer" />

Became Idle On: (Read Only) This field displays the date and time when the resource became idle. The field displays -1 if the resource is active.

In the Fact Editor, this fact is listed as resource.becameidle:

<fact name="resource.becameidle" value="7/23/09 5:02 PM" type="Date" />

Total Joblets Started: (Read Only) This field displays the total number of joblets that have run historically on this resource.

In the Fact Editor, this fact is listed as resource.history.jobletcount:

<fact name="resource.history.jobletcount" value="8" type="Integer" />

Total Completed Joblets: (Read Only) This field displays the total number of joblets that have completed historically on this resource.

In the Fact Editor, this fact is listed as resource.history.jobletcount.completed:

<fact name="resource.history.jobletcount.completed" value="8" type="Integer" />

Total Cancelled Joblets: (Read Only) This field displays the total number of joblets that have been cancelled historically on this resource.

In the Fact Editor, this fact is listed as resource.history.jobletcount.cancelled:

<fact name="resource.history.jobletcount.cancelled" value="0" type="Integer" />

Total Failed Joblets: (Read Only) This field displays the total number of joblets that have failed historically on this resource.

In the Fact Editor, this fact is listed as resource.history.jobletcount.failed:

<fact name="resource.history.jobletcount.failed" value="0" type="Integer" />

Total Charge: (Read Only) This field displays the cost (in dollars) of all of the joblets run on this resource.

In the Fact Editor, this fact is listed as resource.history.cost.total:

<fact name="resource.history.cost.total" value="0.0088" type="Real" />

Total Wall Time: (Read Only) This field displays the total wall time (measured in seconds) that this resource has spent running joblets.

In the Fact Editor, this fact is listed as resource.history.time.total:

<fact name="resource.history.time.total" value="31" type="Integer" />

Total Grid Time: (Read Only) This field displays the amount of time (measured in gcycles, which is the normalized average of compute cycles) of all work performed on this resource.

In the Fact Editor, this fact is listed as resource.history.gcycles.total:

<fact name="resource.history.gcycles.total" value="31" type="Integer" />

Sessions: (Read Only) This field displays the number of current active sessions (that is, the resource instances with an active agent). The value will be either 1 or 0, unless the object is actually a resource template, in which case it might be greater than 1.

In the Fact Editor, this fact is listed as resource.sessions:

<fact name="resource.sessions" value="0" type="Integer" />

Provisionable Resource: This check box is not selected by default. When it is selected (that is, its value is “true”), you specify that this resource is a provisionable type. Ona a VM resource and a VM template resource are currently provisionable.

In the Fact Editor, this fact is listed as resource.provisionable:

<fact name="resource.provisionable" value="false" type="Boolean" />

VM Host Info

VM Host Containers: This field displays a list of VM host containers that are supported by this resource. The list is aggregated from the VM host containers.

In the Fact Editor, this fact is listed as an array:

<fact name="resource.vmhosts">
  <array>
    <string>host1slesx_xen30</string>
  </array>
</fact>

You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove VM host containers to the array of element choices.

VM Host Repositories: This field displays a list of VM host repositories visible to this resource. The list is aggregated from the VM host repositories.

In the Fact Editor, this fact is listed as an array:

<fact name="resource.repositories">
  <array>
    <string>zos</string>
    <string>vmh3slesx</string>
  </array>
</fact>

You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove VM host repositories to the array of element choices.

Virtual Machine Configuration

The settings in this section of the Info/Groups page are available when the resource is a VM.

Under Construction: This check box is not selected by default. When it is selected (that is, its value is “true”), the VM is currently under construction (that is it is in the process of being created) and cannot be provisioned.

In the Fact Editor, this fact is listed as resource.vm.underconstruction:

<fact name="resource.vm.underconstruction" value="false" type="Boolean" />

VM Vendor: This value specifies the vendor name of the hypervisor that has provided the virtual machine.

In the Fact Editor, this fact is listed as resource.vm.vendor:

<fact name="resource.vm.vendor" value="xen" type="String" />

VM UUID: This value specifies the vendor and adapter-specific UUID of the resource. You should edit this value only if you are manually creating a Resource object.

In the Fact Editor, this fact is listed as resource.vm.uuid:

<fact name="resource.vm.uuid" value="237e9975-xxx15-yy1122-7c62-bf6d23d3a049" type="String" />

VM Version: This fact is no longer used.

In the Fact Editor, this fact is listed as resource.vm.version:

<fact name="resource.vm.version" value="0" type="Integer" />

Default Storage Repository: This drop-down list lets you choose the repository where the images of this VM disk and other configuration files are currently stored or where they will be stored.

In the Fact Editor, this fact is listed as resource.vm.repository:

<fact name="resource.vm.repository" value="vmh1slesx" type="String" />

Storage Location in Repository: This value specifies the file system location (either absolute or relative to repository.location) where the VM files are located.

In the Fact Editor, this fact is listed as resource.vm.basepath:

<fact name="resource.vm.basepath" value="/var/lib/xen/images/win2kbuild" type="String" />

Virtual Disks Layout: This visual map specifies the virtual disks that make up this VM.

In the Fact Editor, this fact is listed as a dictionary:

<fact name="resource.vm.vdisks">
  <list>
    <listelement>
      <dictionary>
        <dictelement key="moveableprefix">
          <string>file:</string>
        </dictelement>
        <dictelement key="vdev">
          <string>hda</string>
        </dictelement>
        <dictelement key="mode">
          <string>w</string>
        </dictelement>
        <dictelement key="moveable">
          <boolean>true</boolean>
        </dictelement>
        <dictelement key="size">
          <integer>4096</integer>
        </dictelement>
        <dictelement key="location">
          <string>file:/var/lib/xen/images/win2kbuild/disk0</string>
        </dictelement>
        <dictelement key="repository">
          <string>vmh1slesx</string>
        </dictelement>
      </dictionary>
    </listelement>
  </list>
</fact>

You can edit these dictionary keys by clicking the button to open the Virtual Disk Editor dialog box and then expanding the map to open the details of the dictionary.

Figure 5-5 The Virtual Disk Editor

The editable dictionary keys (String values) include the following:

repository: The optional repository housing disk.
location: The URL referencing disk image.
size: The optional size (measured in Megabytes) of the virtual disk.
moveable: The true or false value showing whether the disk can be moved by PlateSpin Orchestrate.

VM Files: This list includes the files (described by file types and file paths) that make up this VM.

In the Fact Editor, this fact is listed as a dictionary:

<fact name="resource.vm.files">
  <dictionary>
    <dictelement key="config">
      <string>/var/lib/xen/images/win2kbuild/config.xen</string>
    </dictelement>
  </dictionary>
</fact>

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.

You can edit this dictionary by clicking the button to open an array editor. In this dialog box you can add or remove file types and paths to the array of element choices.

Required Virtual Memory: This value specifies the amount (measured in Mb) of virtual memory required for this VM image.

In the Fact Editor, this fact is listed as resource.vm.memory:

<fact name="resource.vm.memory" value="1024" type="Integer" />

Host CPU Architecture: This value specifies the type of CPU architecture required by this VM. You should edit these values only when you are manually creating a Resource object.

Possible types include:

x86
x86_64
sparc
ppc
mips
alpha

In the Fact Editor, this fact is listed as resource.vm.cpu.architecture:

<fact name="resource.vm.cpu.architecture" value="x86" type="String" />

Requires Host HVM Support: This check box is selected by default. When it is selected (that is, its value is “true”), this VM requires host HVM support. The setting is required when you want to perform paravirtualization, otherwise only full virtualization is possible.

In the Fact Editor, this fact is listed as resource.vm.cpu.hvm:

<fact name="resource.vm.cpu.hvm" value="true" type="Boolean" />

Host CPU % Weight: This value specifies the CPU weight (as a percentage of the virtual processor runtime) that you can assign to the virtual processor associated with this VM.

A value of 1.0 represents normal weighting. Setting another VM to a weight of 2.0 means that it would get twice as much CPU runtime as this VM.

In the Fact Editor, this fact is listed as resource.vm.cpu.weight:

<fact name="resource.vm.cpu.weight" value="1.0000" type="Real" />

Host CPU Number: This value specifies the number of virtual CPUs assigned to this VM.

In the Fact Editor, this fact is listed as resource.vm.vcpu.number:

<fact name="resource.vm.vcpu.number" value="1" type="Integer" />

Moveable Disk Size: This value specifies the total size (measured in Mb) of all the virtual moveable disks for this VM image.

In the Fact Editor, this fact is listed as resourc.vm.vdisksize:

<fact name="resource.vm.vdisksize" value="4096" type="Integer" />

Prevent Disk Relocation: This check box is not selected by default. When it is selected (that is, its value is “true”), PlateSpin Orchestrate cannot move VM disks and thus consideration of other potential VM hosts.

In the Fact Editor, this fact is listed as resource.vm.preventmove:

<fact name="resource.vm.preventmove" value="false" type="Boolean" />

Max VMs Per Host: This value specifies the number of instances of this VM image that are allowed on a VM host, configureable based on the known capacity of the VM host/hypervisor.

In the Fact Editor, this fact is listed as resource.vm.maxinstancespervmhost:

<fact name="resource.vm.maxinstancespervmhost" value="1" type="Integer" />

VM Host Ranking: This list box includes the ranking specifications used to select suitable VM hosts. The element syntax is fact/order where order is either ascending or descending.

In the Fact Editor, this fact is listed as an array:

<fact name="resource.vm.vmhost.rankby">
  <array>
    <string>vmhost.vm.placement.score/a</string>
    <string>vmhost.loadindex.slots/a</string>
  </array>
</fact>

You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove ranking specifications to the array of element choices. A trailing /a indicates an ascending sort order. A trailing /d indicates a descending sort order.

Construction Specification: The VM Builder Specifications field in this section displays a list of specifications that were used to build this VM. These specifications are interpreted by the provisioning adapter. You should edit these values using the PlateSpin Orchestrate VM Client.

In the Fact Editor, this fact is listed as a dictionary:

<fact name="resource.vm.spec">
  <dictionary>
    <dictelement key="ssd">
      <string>ddd</string>
    </dictelement>
  </dictionary>
</fact>

You can edit the dictionary by clicking the button to open an attribute editor where you can add or remove dialog box and then expanding the map to open the details of the dictionary.

Provisioning Information

The settings on this section of the Info/Groups panel are not available unless the resource you select is a VM.

Provisioning Job: This drop-down list lets you select the name of the provisioning job that manages the life cycle of this resource.

In the Fact Editor, this fact is listed as resource.provisioner.job:

<fact name="resource.provisioner.job" value="xen30" type="String" />

VM Warehouse Version: This value specifies the warehouse version number for this VM. This fact is no longer used.

In the Fact Editor, this fact is listed as resource.provisioner.warehouse.version:

<fact name="resource.provisioner.warehouse.version" value="0" type="Integer" />

VM Warehouse GUID: This value specifies the warehouse ID for this VM. This fact is no longer used.

In the Fact Editor, this fact is listed as resource.provisioner.warehouse.guid:

<fact name="resource.provisioner.warehouse.guid" value="" type="String" />

Provisioned Instances: This value specifies the total count of operational instances and provisions in progress.

In the Fact Editor, this fact is listed as resource.provisioner.count:

<fact name="resource.provisioner.count" value="0" type="Integer" />

Cloned Instances: This value specifies the total count of cloned instances of the template.

In the Fact Editor, this fact is listed as resource.provisioner.instancecount:

<fact name="resource.provisioner.instancecount" value="0" type="Integer" />

Instances: This list includes the IDs of the instances of this template resource (if applicable).

In the Fact Editor, this fact is listed as an array:

<fact name="resource.provisioner.instances">
  <array type="String">
  </array>
</fact>

You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove instance IDs to the array of choices.

Max Provisioned Instances: (For VM templates only) This value specifies the maximum allowed number of instances of this provisionable resource.

In the Fact Editor, this fact is listed as resource.provisioner.maxinstances:

<fact name="resource.provisioner.maxinstances" value="1" type="Integer" />

Agent Shutdown Timeout: This value specifies the maximum amount of time (measured in seconds) allowed for this VM to shut down and for the Orchestrate Agent to disconnect from the Orchestrate Server.

In the Fact Editor, this fact is listed as resource.provisioner.timeout.shutdown:

<fact name="resource.provisioner.timeout.shutdown" value="" type="Integer" />

Default Agent Idle Timeout: This value specifies the maximum amount of time (measured in seconds) allowed for a VM instance to be idle before relaxing reservation policy or shutting down. Behavior depends on mode, and can be overridden by the provision request.

In the Fact Editor, this fact is listed as resource.provisioner.timeout.idle:

<fact name="resource.provisioner.timeout.idle" value="" type="Integer" />

Host Wait Timeout: This value specifies the maximum amount of time (measured in seconds) to wait for a suitable host before timing out. A value of less than zero (<0), means that the VM waits indefinitely.

In the Fact Editor, this fact is listed as resource.provisioner.host.maxwait:

<fact name="resource.provisioner.host.maxwait" value="-1" type="Integer" />

Preferred Host Wait: This value specifies the amount of time (measured in seconds) after which some VM Host constraints (for example, whether to move the disk image) are lifted to increase the available pool of hosts. A value of less than zero (<0), means that the VM resource waits indefinitely.

In the Fact Editor, this fact is listed as resource.provisioner.host.preferredwait:

<<fact name="resource.provisioner.host.preferredwait" value="0" type="Integer" />

Recommended Host: This drop-down list includes the names of VM hosts that you can choose from to associate with this VM resource image. You might specify this host when you want a quick VM startup or if you want to change hosts because the original host was suspended. When combined with the resource.provisioner.host.preferredwait fact, this fact can lock a VM to one host.

In the Fact Editor, this fact is listed as resource.provisioner.recommendedhost:

<fact name="resource.provisioner.recommendedhost" value="" type="String" />

Debug Provision Log: This check box is not selected by default. When it is selected (that is, its value is “true”), the debug log level in the provisioner is enabled.

In the Fact Editor, this fact is listed as resource.provisioner.debug:

<fact name="resource.provisioner.debug" value="false" type="Boolean" />

Parent Template: This value specifies the ID of the template resource from which this instance was created. (This is only applicable if the template was copied from another template.)

In the Fact Editor, this fact is listed as resource.provision.template:

<fact name="resource.provision.template" value="" type="String" />

Current State: This value specifies the current state of this provisioned instance. The different states include:

down
suspended
up
paused
unknown (when an administrative action is in process)

In the Fact Editor, this fact is listed as resource.provision.state:

<fact name="resource.provision.state" value="down" type="String" />

Current Host: This value specifies the ID of the VM host that is currently housing this provisioned resource.

In the Fact Editor, this fact is listed as resource.provision.vmhost:

<fact name="resource.provision.vmhost" value="vmh6sles_xen30" type="String" />

Current Status: (Read Only) This value specifies the current descriptive status of the provisioned resource.

In the Fact Editor, this fact is listed as resource.provision.status:

<fact name="resource.provision.status" value="Undefined" type="String" />

Current Action: (Read Only) This value specifies the management action currently in progress on this provisioned resource.

In the Fact Editor, this fact is listed as resource.provision.currentaction:

<fact name="resource.provision.currentaction" value="" type="String" />

Request Time: (Read Only) This value specifies the time when the last provision (or other administrative action) was requested.

In the Fact Editor, this fact is listed as resource.provision.time.request:

<fact name="resource.provision.time.request" value="8/24/09 4:36 PM" type="Date" />

Start Time: (Read Only) This value specifies the time when the resource was last successfully provisioned.

In the Fact Editor, this fact is listed as resource.provision.time.start:

<fact name="resource.provision.time.start" value="12/31/69 4:59 PM" type="Date" />

Shutdown Time: (Read Only) This value specifies the time when the resource was last shut down.

In the Fact Editor, this fact is listed as resource.provision.time.shutdown:

<fact name="resource.provision.time.shutdown" value="12/31/69 4:59 PM" type="Date" />

Host Wait Time: (Read Only) This value specifies the amount of time (measured in seconds) that this resource has been waiting for or did wait for a suitable host.

In the Fact Editor, this fact is listed as resource.provision.time.hostwait:

<fact name="resource.provision.time.hostwait" value="0" type="Integer" />

Managing Job ID: (Read Only) This value specifies the current or last Job ID that performed a provisioning action on this resource. This is useful when viewing the job log to monitor specific provisioning actions.

In the Fact Editor, this fact is listed as resource.provision.jobid:

<fact name="resource.provision.jobid" value="system.xen30.74239" type="String" />

Automatic Provision: (Read Only) This check box is not selected by default. When it is checked (that is, its value is “true”), the resource was cloned or provisioned automatically and so will be shut down or destroyed automatically.

In the Fact Editor, this fact is listed as resource.provision.automatic:

<fact name="resource.provision.automatic" value="false" type="Boolean" />

Needs Resync: This check box is not selected by default. When it is selected (that is, its value is “true”), you specify that the provisioned resource’s state needs to be resynchronized using the associated provisioning technology at the next opportunity.

In the Fact Editor, this fact is listed as resource.provision.resync:

<fact name="resource.provision.resync" value="false" type="Boolean" />

Linux Autoprep Config: If any of the fields in this section are blank (that is, undefined), click Define to install a fact editor that you can use to define the value.

This section includes the following settings:

Linux Computer Name: This value specifies the host name of a new VM. Enter “*” to indicate that the VM ID is to be used rather than the host name you specify.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.linuxglobal.ComputerName
```
<fact name="resource.provisioner.autoprep.linuxglobal.ComputerName" value="afd" type="String" />
```
Linux Domain: This value specifies the domain to which the new VM belongs.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.linuxglobal.Domain
```
<fact name="resource.provisioner.autoprep.linuxglobal.Domain" value="" type="String" />
```

Windows Sysprep Config: Although the fields in this section can be defined with a Fact Editor, the entire section of facts is non-functional and is not currently supported.

Autoprep Network Adapter 0: This section of the Info/Groups page displays the configuration information for a network adapter (0)you can prepare for autoprep work. A new VM resource or VM template resource does not have these facts defined. When you click Define, a Fact Editor is enabled where you can define the facts for the adapter.

The section includes the following settings/facts:

MAC Address: The value you specify in this field is the name for each NIC that represents the MAC address of the interface. Specify an asterisk (*) to generate a new MAC address. If the value is not set, the current configuration is used.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].MACAddress:
```
<fact name="resource.provisioner.autoprep.adapters[0].MACAddress" value="dadf" type="String" />
```
Use DHCP: When this check box is selected (that is, its value is “true”), the new VM retrieves its network settings from a DHCP server and any adapter settings are ignored. If the check box is not selected (that is, its value is “false”), any required adapter settings must be defined.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].UseDHCP:
```
<fact name="resource.provisioner.autoprep.adapters[0].UseDHCP" value="true" type="Boolean" />
```
IP Address: This field displays the IP address for the adapter.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].IPAddress:
```
<fact name="resource.provisioner.autoprep.adapters[0].IPAddress" value="fddfasdf" type="String" />
```
Subnet Mask: This field displays the subnet mask for the adapter.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].subnetMask:
```
<fact name="resource.provisioner.autoprep.adapters[0].subnetMask" value="fadsafdasdf" type="String" />
```
Gateway IP Address: This field displays a list of the internet gateway IP addresses available to the interface.

In the Fact Editor, this fact is listed as an array:
```
<fact name="resource.provisioner.autoprep.adapters[0].Gateways">
  <array>
    <string>afdasadfs</string>
  </array>
</fact>
```
You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove the IP address or change its order in the array of element choices.
DNS from DHCP: (Optional. SUSE VM only) When this check box is selected (that is, its value is “true”), the SUSE VM is configured to retrieve its DNS server settings from DHCP.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].DNSFromDHCP:
```
<fact name="resource.provisioner.autoprep.adapters[0].DNSFromDHCP" value="true" type="Boolean" />
```
DNS Server IP Addresses: This field displays a list of DNS servers for name lookup.

In the Fact Editor, this fact is listed as an array:
```
<fact name="resource.provisioner.autoprep.adapters[0].DNSServers">
  <array>
    <string>adfadsasdf</string>
  </array>
</fact>
```
You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove a server IP address or change its order in the array of element choices.
DNS Domain: (Windows only) This field displays the name of the adapter’s domain.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].DNSDomain:
```
<fact name="resource.provisioner.autoprep.adapters[0].DNSDomain" value="afds" type="String" />
```
Primary WINS Server: This field displays the name of the adapter’s primary WINS server.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].primaryWINS:
```
<fact name="resource.provisioner.autoprep.adapters[0].primaryWINS" value="dfasfasddasf" type="String" />
```
Secondary WINS Server: This field displays the name of the adapter’s secondary WINS server.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].secondaryWINS:
```
<fact name="resource.provisioner.autoprep.adapters[0].secondaryWINS" value="fdasadsfasd" type="String" />
```
DNS Suffixes: This field displays a list of the suffixes associated with this adapter that are appended to the name for lookup.

In the Fact Editor, this fact is listed as an array:
```
<fact name="resource.provisioner.autoprep.adapters[0].DNSSuffixes">
  <array>
    <string>afjkdl</string>
  </array>
</fact>
```
You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove a suffix or change its order in the array of element choices.
NetBIOS: This drop-down list box includes the NetBIOS options for this VM. Options include EnableNetBIOSviaDhcp, EnableNetBIOS, and DisableNetBIOS.

In the Fact Editor, this fact is listed as resource.provisioner.autoprep.adapters[0].netBIOS:
```
<fact name="resource.provisioner.autoprep.adapters[0].netBIOS" value="EnableNetBIOS" type="String" />
```

Autoprep Network Adapter 1: This section of the Info/Groups page displays the configuration information for a network adapter (1) you can prepare for autoprep work. Definitions of its facts are similar to Autoprep Network Adapter (0), except for its identification in the as Adapter [1] rather than Adapter [0].

OS Information

OS Name: (Read Only) This field displays the name of the resource operating system.

In the Fact Editor, this fact is listed as resource.os.name:

<fact name="resource.os.name" value="Linux" type="String" />

OS Version: (Read Only) This field displays the version number of the resource operating system. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.os.version:

<fact name="resource.os.version" value="2.6.16.46-0.12-smp" type="String" />

OS Version String: (Read Only) This field displays the full identification string of the operating system as supplied by the vendor of the operating system. The information is not available until the osinfo system job runs. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.os.version.string:

<fact name="resource.os.version.string" value="Linux version 2.6.16.46-0.12-smp (geeko@buildhost) (gcc version 4.1.2 20070115 (prerelease) (SUSE Linux)) #1 SMP Thu May 17 14:00:09 UTC 2007" type="String" />

OS Architecture: This field displays the name of the operating system architecture (for example, x86, amd64, i386, or sparc).

In the Fact Editor, this fact is listed as resource.os.arch:

<fact name="resource.os.arch" value="i386" type="String" />

OS Family: This value indicates the operating system family name (for example, windows, linux, solaris, unix, aix, mac) of the resource, if known.

In the Fact Editor, this fact is listed as resource.os.family:

<fact name="resource.os.family" value="linux" type="String" />

OS Type: This drop-down list lets you select the unique string identifier for each OS release, for example, sles11.

In the Fact Editor, this fact is listed as resource.os.type:

<fact name="resource.os.type" value="sles10" type="String" />

OS Vendor: (Read Only) This field displays the unique string identifier for each OS release.

In the Fact Editor, this fact is listed as resource.os.vendor:

<fact name="resource.os.vendor" value="Novell" type="String" />

OS Vendor Version: (Read Only) This field displays the vendor-defined version for the operating system (for example, 10 for SUSE Linux Enterprise Server 10).

In the Fact Editor, this fact is listed as resource.os.vendor.version:

<fact name="resource.os.vendor.version" value="10" type="String" />

OS Vendor String: (Read Only) This field displays the full identification for the operating system that is supplied by the vendor. The osinfo system job must run for this value to be displayed.

In the Fact Editor, this fact is listed as resource.os.vendor.string:

<fact name="resource.os.vendor.string" value="SUSE Linux Enterprise Server 10 (i586)" type="String" />

OS File Path Separator: (Read Only) This field displays the character used by the resource operating system for file path separation.

In the Fact Editor, this fact is listed as resource.os.file.separator:

<fact name="resource.os.file.separator" value="/" type="String" />

CPU Information

Number of CPUs: (Read only) This field displays the number CPUs available for this resource to use. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.cpu.number:

<fact name="resource.cpu.number" value="2" type="Integer" />

CPU Speed: (Read only) This field displays the processor speed (measured in Mhz). The cpuinfo job must run for this value to be displayed. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.cpu.mhz:

<fact name="resource.cpu.mhz" value="2594" type="Integer" />

CPU Vendor: (Read only) This field displays the name of the CPU vendor. The cpuinfo system job must run for this value to be displayed. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.cpu.vendor:

<fact name="resource.cpu.vendor" value="GenuineIntel" type="String" />

CPU Model Number: (Read only) This field displays the full vendor model number of the CPU. The cpuinfo system job must run for this value to be displayed. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.cpu.model:

<fact name="resource.cpu.model" value="Intel(R) Pentium(R) 4 CPU 2.60GHz" type="String" />

CPU Architecture: This field displays the CPU architecture (for example, x86, x86_64, sparc) of this resource. For a VM resource, this fact remains undefined.

In the Fact Editor, this fact is listed as resource.cpu.architecture:

<fact name="resource.cpu.architecture" value="x86" type="String" />

CPU HVM Support: This field is marked true if the CPU has hardware virtualization support.

In the Fact Editor, this fact is listed as resource.cpu.hvm:

<fact name="resource.cpu.hvm" value="false" type="Boolean" />

Memory Information

Virtual Memory: (Read only) This field displays the total amount of virtual memory (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed

In the Fact Editor, this fact is listed as resource.memory.virtual.total:

<fact name="resource.memory.virtual.total" value="4060" type="Integer" />

Virtual Available: (Read only) This field displays the amount of available virtual memory (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed.

In the Fact Editor, this fact is listed as resource.memory.virtual.available:

<fact name="resource.memory.virtual.available" value="19951" type="Integer" />

Physical Memory: (Read only) This field displays the total amount of physical memory (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed

In the Fact Editor, this fact is listed as resource.memory.physical.total:

<fact name="resource.memory.physical.total" value="3889" type="Integer" />

Physical Available: (Read only) This field displays the amount of available physicall memory (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed.

In the Fact Editor, this fact is listed as resource.memory.physical.available:

<fact name="resource.memory.physical.available" value="3565" type="Integer" />

Swap Memory: (Read only) This field displays the total amount of configured swap space (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed

In the Fact Editor, this fact is listed as resource.memory.swap.total:

<fact name="resource.memory.swap.total" value="16386" type="Integer" />

Swap Available: (Read only) This field displays the total amount of free swap space (measured in Mb) on the resource. The memInfo system job must run for this value to be displayed

In the Fact Editor, this fact is listed as resource.memory.swap.available:

<fact name="resource.memory.swap.available" value="16386" type="Integer" />

Disk/Network Information

The facts in the Disk/Network Information section of the Info/Groups page are not currently functional and are not supported.

Agent Information

Agent Version: (Read only) This field displays the PlateSpin Orchestrate Agent version and build number that is installed on this resource. The string uses the following syntax:

major.minor.point_build

In the Fact Editor, this fact is listed as resource.agent.version:

<fact name="resource.agent.version" value="2.0.2_70917" type="String" />

Agent Install Dir: (Read only) This field displays the name of the home directory of the PlateSpin Orchestrate Agent installation files.

In the Fact Editor, this fact is listed as resource.agent.home:

<fact name="resource.agent.home" value="/opt/novell/zenworks/zos/agent" type="String" />

Agent Java Version: (Read only) This field displays the version of the Java JVM currently in use by the PlateSpin Orchestrate Agent installed on this resource.

In the Fact Editor, this fact is listed as resource.agent.jvm.version:

<fact name="resource.agent.jvm.version" value="1.5.0_17" type="String" />

Agent Java Runtime: (Read only) This field displays the version of the Java JVM runtime currently in use by the PlateSpin Orchestrate Agent installed on this resource.

In the Fact Editor, this fact is listed as resource.agent.jvm.runtime:

<fact name="resource.agent.jvm.runtime" value="1.5.0_17-b04" type="String" />

Agent Java Vendor: (Read only) This field displays the name of the vendor of the Java JVM currently in use by the PlateSpin Orchestrate Agent installed on this resource.

In the Fact Editor, this fact is listed as resource.agent.jvm.vendor:

<fact name="resource.agent.jvm.vendor" value="Sun Microsystems Inc." type="String" />

Agent Java Home Dir: (Read only) This field displays the path to the home directory of the Java JVM currently in use by the PlateSpin Orchestrate Agent installed on this resource.

In the Fact Editor, this fact is listed as resource.agent.jvm.home:

<fact name="resource.agent.jvm.home" value="/opt/novell/zenworks/zos/agent/jre" type="String" />

Available Agent Memory: (Read only) This field displays the amount of memory (measured in Mb) available to the PlateSpin Orchestrate Agent installed on this resource.

In the Fact Editor, this fact is listed as resource.agent.jvm.memory:

<fact name="resource.agent.jvm.memory" value="127" type="Integer" />

Enhanced Exec Available: This check box is selected by default. When it is selected (that is, its value is “true”), it indicates that the PlateSpin Orchestrate Agent installed on this resource is able to use enhanced exec features (as opposed to unsupported agent installs, for example, AIX).

In the Fact Editor, this fact is listed as resource.agent.exec.installed:

<fact name="resource.agent.exec.installed" value="true" type="Boolean" />

Clustered Agent: This check box is not selected by default. When you select it (that is, its value is “true”), you specify that the agent is “clustered” on this VM resource; that is, it converts duplicate logins to failover logins.

In the Fact Editor, this fact is listed as resource.agent.clustered:

<fact name="resource.agent.clustered" value="false" type="Boolean" />

Agent Configuration

Gmond Port: This field specifies the port that the agent uses for gmond. Port 8649 is the default port. A setting of zero 90) or less means that the values is not read.

In the Fact Editor, this fact is listed as esource.agent.config.gmond.port:

<fact name="resource.agent.config.gmond.port" value="8649" type="Integer" />

Datagrid Cache TTL: This field specifies the amount of time (measured in minutes) that inactive files should remain in the agent’s datagrid cache. A setting of zero (0) turns off the cache.

In the Fact Editor, this fact is listed as jresource.agent.config.datagrid.cache.lifetime:

<fact name="resource.agent.config.datagrid.cache.lifetime" value="1440" type="Integer" />

Datagrid Cleanup Interval: This field specifies the amount of time (measured in minutes) that the Orchestrate Server should wait between cleanup sweeps of the agent’s datagrid cache.

In the Fact Editor, this fact is listed as resource.agent.config.datagrid.cache.cleanupinterval:

<fact name="resource.agent.config.datagrid.cache.cleanupinterval" value="60" type="Integer" />

Exec Daemon Timeout: This field specifies the amount of time (measured in seconds) that the enhanced exec daemon is to remain running. A setting of zero (0) specifies that the daemon is to remain running. The exec daemon is the non-Java component of the agent that is responsible for executing commands remotely.

In the Fact Editor, this fact is listed as resource.agent.config.exec.daemon.timeout:

<fact name="resource.agent.config.exec.daemon.timeout" value="300" type="Integer" />

Exec As Agent User Only: This check box is selected by default. When you select it (that is, its value is “true”), you specify that the agent is to always run executables as the Agent User only. Selecting this check box overrides any job fact settings (that is, the job.joblet.runtype fact).

In the Fact Editor, this fact is listed as resource.agent.config.exec.asagentuseronly:

<fact name="resource.agent.config.exec.asagentuseronly" value="true" type="Boolean" />

Cleanup After Joblets: This check box is not selected by default. When you select it (that is, its value is “true”), you specify that the agent on this resource is to clean up temporary directories created for each joblet. You can deselect this check box for debugging purposes; when you select it again, the cleanup process starts again, deleting temporary directories that were created while the setting was deactivated.

In the Fact Editor, this fact is listed as resource.agent.config.joblet.cleanup:

<fact name="resource.agent.config.joblet.cleanup" value="true" type="Boolean" />

Use Enhanced Exec: This check box is not selected by default. When you select it (that is, its value is “true”), you specify that the agent on this resource is to use the enhanced exec feature of the agent, which is available for supported agent installations. Marking this fact as “false” causes the enhanced exec feature not to be used.

In the Fact Editor, this fact is listed as resource.agent.config.exec.enhancedused:

<fact name="resource.agent.config.exec.enhancedused" value="true" type="Boolean" />

Log Level: This drop-down list lets you choose the level of agent logging in terms of the amount of detail (that is, the “verbosity”) you want to include in the agent log. The choices include:

quiet
normal
verbose

In the Fact Editor, this fact is listed as resource.agent.config.loglevel:

<fact name="resource.agent.config.loglevel" value="normal" type="String" />

Debug Logging: This check box is not selected by default. When you select it (that is, its value is “true”), you activate the debug function in the agent log, which is additive to the log level.

In the Fact Editor, this fact is listed as resource.agent.config.logdebug:

<fact name="resource.agent.config.logdebug" value="false" type="Boolean" />

Installed Components

Applications: This field displays a list of the names of applications (including the full version name) that are installed on this resource. This is useful for constraining joblets to run only on a resource with a particular application installed.

In the Fact Editor, this fact is listed as an array:

<fact name="resource.installed.apps">
  <array>
    <string>man-pages-2.39-0.9</string>
    <string>xorg-x11-fonts-scalable-6.9.0-50.45</string>
    <string>cifs-mount-3.0.24-2.23</string>
    <string>gdbm-1.8.3-243.2</string>
    <string>libaio-0.3.104-14.2</string>
    <string>libnl-1.0-18.4</string>
...
  </array>
</fact>

You can edit this array by clicking the button to open an array editor. In this dialog box you can add or remove the application name or change its order in the array of element choices.

Groups

This section of the Info/Groups page lists the groups of Resource objects in the grid. Click Choose to open the Resource Group Selection dialog box. In this dialog box, you can choose which Resource Groups to display in the Explorer Panel by selecting a group and then clicking Add or Remove to move it to or from the Source Resource Groups list.

5.4.3 The Provision Info Tab

The Provision Info tab is displayed only for VM resource objects selected in the Explorer tree. The read-only fields displayed at the top of the Provision Info page summarize information related to the provisioning of the resource, whether that resource is a VM or VM template.

The page has several subtabs that open other pages that display further information about the VM:

Show Log: This page displays the log that includes historical details about the history of the provisioning of the VM.
Host Assignment Log: This page displays the log of VM host assignment constraint errors of the last migration or provision action.
Autoprep Data: You can use this page to help you debug the policy (and its resulting constraints and facts) associated with this VM.
Policy Debugger: You can use this page to help you debug the policy (and its resulting constraints and facts) associated with this VM. For more information, see Section 4.0, The Policy Debugger.
Action History: This page displays the log that includes historical details about the history of the provisioning of the VM. For more information, see Section D.0, Provisioning Actions and History.

5.4.4 The Resource Log Tab

Open the Resource Log tab to view the contents of the log file for this resource. You can click Refresh to update the content. You can also select Debug Logging to activate the debug feature as part of the logging or change the Log Level to the level of detail that you want.

5.4.5 The Resource Policies Tab

The Polices tab of the Resource admin view opens a page that contains a policy viewer for each of the policies associated with a Resource Grid object.

You can modify a policy using the Policy Grid object. For more information see Section 5.8.1, The Policy Object.

Click Choose in the admin view of the Policy viewer to launch a Policy Selection dialog box where you can add or remove individual policies to be applied to the selected Resource Grid object.

Figure 5-6 The Policy Selection Dialog Box

5.4.6 The Resource Health Debugger Tab

The Health Debugger is a common Admin view in the Development Client for most Grid objects. For information about this tool, see Section 6.0, The Health Debugger.

5.4.7 The Resource Constraints/Facts Tab

The Constraints/Facts tab opens a page that shows all of the effective constraints and facts for a Grid object. Each Grid object has an associated set of facts and constraints that define its properties. In essence, by changing the policy constraints and fact values for a job, you can change the behavior of the job and how the PlateSpin Orchestrate Server allocates available system resources to it. The Orchestrate Server assigns default values to each of the component facts, although they can be changed at any time by the administrator, unless they are read-only. Facts with mode r/o have read-only values, which can be viewed (that is, using the edit “pencil” icon) but changes cannot be made.