Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.ow2.jasmine.vmm.api
Interface ServerPoolMXBean

All Superinterfaces:
  ManagedResourceMXBean

    public interface ServerPoolMXBean

extends ManagedResourceMXBean

Management interface of a Server Pool. A Server Pool is a management unit acting as a container of physical hosts and virtual machines. A Server Pool is homogeneous with regard to the virtualization technology used by its member hosts. Live or cold migration of virtual machines between hosts is allowed only if the source and target host belong to the same server pool.

The `ObjectName` for identifying a ServerPoolMXBean follows the following template:

> org.ow2.jasmine.vmm.api:type=ServerPool,name=<pathname>

Method Summary
`java.util.List<HostMXBean>` | `getManagedHosts()` /** Returns the physical hosts belong to the server pool
`java.lang.String` | `getName()` Return the symbolic name of the server pool
`VirtualMachineImageStoreMXBean` | `getVMImageStore()` Returns the image stores belonging to this server pool
`VirtualMachineMXBean` | `provisionVM(VMConfigSpec vmSpec, java.util.Map<java.lang.String,java.lang.String> constraints, boolean sync)` Provisions a new virtual machine.
`void` | `setProvisioningPolicy(java.lang.String policyId)` Sets the provisioning policy of this domain

Methods inherited from interface org.ow2.jasmine.vmm.api.ManagedResourceMXBean
`getObjectName, getPath`

Method Detail

### getName

    java.lang.String getName()

  Return the symbolic name of the server pool

  Returns:

### provisionVM

    VirtualMachineMXBean provisionVM(VMConfigSpec vmSpec,
                                     java.util.Map<java.lang.String,java.lang.String> constraints,
                                     boolean sync)
                                     throws InsufficientResourcesException,
                                            InvalidVMConfigException,
                                            VMMException

  Provisions a new virtual machine. The host on which the VM will be created will depend on the provisioning policy active for Server Pool. Upon successful creation a notification of type NotificationTypes.VM_NEW will be emitted by the HostMXBean on which the VM has been created.

  Parameters:
    `vmSpec` - initial configuration of the virtual machine
    `constraints` - constraints on the placement of the VM
    `sync` - if true the call will return once the VM has been created
  Returns:
    the management interface of the created VM if `sync` is true, null otherwise
  Throws:
    `InsufficientResourcesException` - raised if not enough resources are available to create the VM
    `InvalidVMConfigException` - raised if the VM configuration is invalid
    `VMMException`

### setProvisioningPolicy

    void setProvisioningPolicy(java.lang.String policyId)

  Sets the provisioning policy of this domain

  Parameters:
    `policyId` -

### getManagedHosts

    java.util.List<HostMXBean> getManagedHosts()

  /** Returns the physical hosts belong to the server pool

  Returns:

### getVMImageStore

    VirtualMachineImageStoreMXBean getVMImageStore()

  Returns the image stores belonging to this server pool

  Returns:

Overview | Package | Class | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2009 OW2 Consortium. All Rights Reserved.