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 DomainMXBean

All Superinterfaces:
  ManagedResourceMXBean

    public interface DomainMXBean

extends ManagedResourceMXBean

Management interface for a domain. A domain is a management unit consisting of subdomains and server pools. Domains are organized in a hierarchical fashion. Domains are named using a directory-like naming scheme. Each domain has a local name within its parent domain (e.g. "ParisDatacenter") and an absolute name (e.g. "/root/paris/ParisDatacenter").

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

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

Method Summary
`java.lang.String` | `getAttribute(java.lang.String key)` Returns an attribute of the domain
`java.lang.String` | `getName()` Return the symbolic name of the domain
`java.util.List<ServerPoolMXBean>` | `getServerPools()` Returns a list of the server pools belonging to this domain
`java.util.List<DomainMXBean>` | `getSubDomains()` Returns a list of the subdomains of this domain
`VirtualMachineMXBean` | `provisionVM(VMConfigSpec vmSpec, java.util.Map<java.lang.String,java.lang.String> constraints, boolean sync)` Provisions a new virtual machine.

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 domain

  Returns:

### getAttribute

    java.lang.String getAttribute(java.lang.String key)

  Returns an attribute of the domain

  Returns:
    the name of the attribute requested

### provisionVM

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

  Provisions a new virtual machine. The host, server pool (and possibly) subdomain on which the VM will be created will depend on the provisioning policy active for this domain (and its subdomains). 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` - contraints 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

### getServerPools

    java.util.List<ServerPoolMXBean> getServerPools()

  Returns a list of the server pools belonging to this domain

  Returns:

### getSubDomains

    java.util.List<DomainMXBean> getSubDomains()

  Returns a list of the subdomains of this domain

  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.