public class Domain
extends java.lang.Object
Modifier and Type | Field and Description |
---|---|
protected Libvirt |
libvirt
The libvirt connection from the hypervisor
|
Modifier and Type | Method and Description |
---|---|
int |
abortJob()
Requests that the current background job be aborted at the soonest
opportunity.
|
void |
attachDevice(java.lang.String xmlDesc)
Creates a virtual device attachment to backend.
|
void |
attachDeviceFlags(java.lang.String xmlDesc,
int flags)
Creates a virtual device attachment to backend.
|
DomainBlockInfo |
blockInfo(java.lang.String path)
This function returns block device (disk) stats for block devices
attached to the domain.
|
DomainBlockStats |
blockStats(java.lang.String path)
Returns block device (disk) stats for block devices attached to this
domain.
|
void |
coreDump(java.lang.String to,
int flags)
Dumps the core of this domain on a given file for analysis.
|
int |
cpuMapLength(int maxCpus)
It returns the length (in bytes) required to store the complete CPU map
between a single virtual & all physical CPUs of a domain.
|
int |
create()
Launches this defined domain.
|
int |
create(int flags)
Launches this defined domain with the provide flags.
|
void |
destroy()
Destroys this domain object.
|
void |
detachDevice(java.lang.String xmlDesc)
Destroys a virtual device attachment to backend.
|
void |
detachDeviceFlags(java.lang.String xmlDesc,
int flags)
Destroys a virtual device attachment to backend.
|
void |
finalize() |
int |
free()
Frees this domain object.
|
boolean |
getAutostart()
Provides a boolean value indicating whether the network is configured to
be automatically started when the host machine boots.
|
Connect |
getConnect()
Provides the connection object associated with a domain.
|
int |
getID()
Gets the hypervisor ID number for the domain
|
DomainInfo |
getInfo()
Extract information about a domain.
|
DomainJobInfo |
getJobInfo()
Extract information about progress of a background job on a domain.
|
long |
getMaxMemory()
Retrieve the maximum amount of physical memory allocated to a domain.
|
int |
getMaxVcpus()
Provides the maximum number of virtual CPUs supported for the guest VM.
|
java.lang.String |
getName()
Gets the public name for this domain
|
java.lang.String |
getOSType()
Gets the type of domain operation system.
|
SchedParameter[] |
getSchedulerParameters()
Gets the scheduler parameters.
|
java.lang.String[] |
getSchedulerType()
Gets the scheduler type.
|
int[] |
getUUID()
Get the UUID for this domain.
|
java.lang.String |
getUUIDString()
Gets the UUID for this domain as string.
|
int[] |
getVcpusCpuMaps()
Returns the cpumaps for this domain Only the lower 8 bits of each int in
the array contain information.
|
VcpuInfo[] |
getVcpusInfo()
Extracts information about virtual CPUs of this domain
|
java.lang.String |
getXMLDesc(int flags)
Provides an XML description of the domain.
|
int |
hasCurrentSnapshot()
Determine if the domain has a snapshot
|
int |
hasManagedSaveImage()
Determine if the domain has a managed save image
|
DomainInterfaceStats |
interfaceStats(java.lang.String path)
Returns network interface stats for interfaces attached to this domain.
|
int |
isActive()
Determine if the domain is currently running
|
int |
isPersistent()
Determine if the domain has a persistent configuration which means it
will still exist after shutting down
|
int |
managedSave()
suspend a domain and save its memory contents to a file on disk.
|
int |
managedSaveRemove()
Remove any managed save images from the domain
|
MemoryStatistic[] |
memoryStats(int number)
This function provides memory statistics for the domain.
|
Domain |
migrate(Connect dconn,
long flags,
java.lang.String dname,
java.lang.String uri,
long bandwidth)
Migrate this domain object from its current host to the destination host
given by dconn (a connection to the destination host).
|
int |
migrateSetMaxDowntime(long downtime)
Sets maximum tolerable time for which the domain is allowed to be paused
at the end of live migration.
|
int |
migrateToURI(java.lang.String uri,
long flags,
java.lang.String dname,
long bandwidth)
Migrate the domain object from its current host to the destination host
given by duri.
|
void |
pinVcpu(int vcpu,
int[] cpumap)
Dynamically changes the real CPUs which can be allocated to a virtual
CPU.
|
protected void |
processError()
Error handling logic to throw errors.
|
void |
reboot(int flags)
Reboot this domain, the domain object is still usable there after but the
domain OS is being stopped for a restart.
|
void |
resume()
Resume this suspended domain, the process is restarted from the state
where it was frozen by calling virSuspendDomain().
|
int |
revertToSnapshot(DomainSnapshot snapshot)
Revert the domain to a given snapshot.
|
void |
save(java.lang.String to)
Suspends this domain and saves its memory contents to a file on disk.
|
void |
setAutostart(boolean autostart)
Configures the network to be automatically started when the host machine
boots.
|
void |
setMaxMemory(long memory)
* Dynamically change the maximum amount of physical memory allocated to a
domain.
|
void |
setMemory(long memory)
Dynamically changes the target amount of physical memory allocated to
this domain.
|
void |
setSchedulerParameters(SchedParameter[] params)
Changes the scheduler parameters
|
void |
setVcpus(int nvcpus)
Dynamically changes the number of virtual CPUs used by this domain.
|
void |
shutdown()
Shuts down this domain, the domain object is still usable there after but
the domain OS is being stopped.
|
DomainSnapshot |
snapshotCreateXML(java.lang.String xmlDesc)
Creates a new snapshot of a domain based on the snapshot xml contained in
xmlDesc.
|
DomainSnapshot |
snapshotCurrent()
Get the current snapshot for a domain, if any.
|
java.lang.String[] |
snapshotListNames()
Collect the list of domain snapshots for the given domain.
|
DomainSnapshot |
snapshotLookupByName(java.lang.String name)
Retrieve a snapshot by name
|
int |
snapshotNum()
Provides the number of domain snapshots for this domain..
|
void |
suspend()
Suspends this active domain, the process is frozen without further access
to CPU resources and I/O but the memory used by the domain at the
hypervisor level will stay allocated.
|
void |
undefine()
undefines this domain but does not stop it if it is running
|
int |
updateDeviceFlags(java.lang.String xml,
int flags)
Change a virtual device on a domain
|
protected Libvirt libvirt
public int abortJob() throws LibvirtException
LibvirtException
public void attachDevice(java.lang.String xmlDesc) throws LibvirtException
xmlDesc
- XML description of one deviceLibvirtException
public void attachDeviceFlags(java.lang.String xmlDesc, int flags) throws LibvirtException
xmlDesc
- XML description of one deviceflags
- the an OR'ed set of virDomainDeviceModifyFlagsLibvirtException
public DomainBlockInfo blockInfo(java.lang.String path) throws LibvirtException
path
- the path to the block deviceLibvirtException
public DomainBlockStats blockStats(java.lang.String path) throws LibvirtException
path
- path to the block deviceLibvirtException
public void coreDump(java.lang.String to, int flags) throws LibvirtException
to
- path for the core fileflags
- extra flags, currently unusedLibvirtException
public int cpuMapLength(int maxCpus)
public int create() throws LibvirtException
LibvirtException
public int create(int flags) throws LibvirtException
LibvirtException
public void destroy() throws LibvirtException
LibvirtException
public void detachDevice(java.lang.String xmlDesc) throws LibvirtException
xmlDesc
- XML description of one deviceLibvirtException
public void detachDeviceFlags(java.lang.String xmlDesc, int flags) throws LibvirtException
xmlDesc
- XML description of one deviceLibvirtException
public void finalize() throws LibvirtException
finalize
in class java.lang.Object
LibvirtException
public int free() throws LibvirtException
LibvirtException
public boolean getAutostart() throws LibvirtException
LibvirtException
public Connect getConnect()
public int getID() throws LibvirtException
LibvirtException
public DomainInfo getInfo() throws LibvirtException
LibvirtException
public DomainJobInfo getJobInfo() throws LibvirtException
LibvirtException
public long getMaxMemory() throws LibvirtException
LibvirtException
public int getMaxVcpus() throws LibvirtException
LibvirtException
public java.lang.String getName() throws LibvirtException
LibvirtException
public java.lang.String getOSType() throws LibvirtException
LibvirtException
public SchedParameter[] getSchedulerParameters() throws LibvirtException
LibvirtException
public java.lang.String[] getSchedulerType() throws LibvirtException
LibvirtException
public int[] getUUID() throws LibvirtException
LibvirtException
public java.lang.String getUUIDString() throws LibvirtException
LibvirtException
public int[] getVcpusCpuMaps() throws LibvirtException
LibvirtException
public VcpuInfo[] getVcpusInfo() throws LibvirtException
LibvirtException
public java.lang.String getXMLDesc(int flags) throws LibvirtException
flags
- not usedLibvirtException
public int hasCurrentSnapshot() throws LibvirtException
LibvirtException
public int hasManagedSaveImage() throws LibvirtException
LibvirtException
public DomainInterfaceStats interfaceStats(java.lang.String path) throws LibvirtException
path
- path to the interfaceLibvirtException
public int isActive() throws LibvirtException
LibvirtException
public int isPersistent() throws LibvirtException
LibvirtException
public int managedSave() throws LibvirtException
LibvirtException
public int managedSaveRemove() throws LibvirtException
LibvirtException
public MemoryStatistic[] memoryStats(int number) throws LibvirtException
number
- the number of stats to retrieveLibvirtException
public Domain migrate(Connect dconn, long flags, java.lang.String dname, java.lang.String uri, long bandwidth) throws LibvirtException
dconn
- destination host (a Connect object)flags
- flagsdname
- (optional) rename domain to this at destinationuri
- (optional) dest hostname/URI as seen from the source hostbandwidth
- optional) specify migration bandwidth limit in MbpsLibvirtException
public int migrateSetMaxDowntime(long downtime) throws LibvirtException
downtime
- the time to be downLibvirtException
public int migrateToURI(java.lang.String uri, long flags, java.lang.String dname, long bandwidth) throws LibvirtException
uri
- The destination URIflags
- Controls the migratedname
- The name at the destnationbandwidth
- Specify the migration bandwidthLibvirtException
public void pinVcpu(int vcpu, int[] cpumap) throws LibvirtException
vcpu
- virtual cpu numbercpumap
- bit map of real CPUs represented by the the lower 8 bits of
each int in the array. Each bit set to 1 means that
corresponding CPU is usable. Bytes are stored in little-endian
order: CPU0-7, 8-15... In each byte, lowest CPU number is
least significant bit.LibvirtException
protected void processError() throws LibvirtException
LibvirtException
public void reboot(int flags) throws LibvirtException
flags
- extra flags for the reboot operation, not used yetLibvirtException
public void resume() throws LibvirtException
LibvirtException
public int revertToSnapshot(DomainSnapshot snapshot) throws LibvirtException
snapshot
- the snapshot to revert toLibvirtException
public void save(java.lang.String to) throws LibvirtException
to
- path for the output fileLibvirtException
public void setAutostart(boolean autostart) throws LibvirtException
autostart
- LibvirtException
public void setMaxMemory(long memory) throws LibvirtException
memory
- the amount memory in kilobytesLibvirtException
public void setMemory(long memory) throws LibvirtException
memory
- in kilobytesLibvirtException
public void setSchedulerParameters(SchedParameter[] params) throws LibvirtException
params
- an array of SchedParameter objects to be changedLibvirtException
public void setVcpus(int nvcpus) throws LibvirtException
nvcpus
- the new number of virtual CPUs for this domainLibvirtException
public void shutdown() throws LibvirtException
LibvirtException
public DomainSnapshot snapshotCreateXML(java.lang.String xmlDesc) throws LibvirtException
xmlDesc
- string containing an XML description of the domainLibvirtException
public DomainSnapshot snapshotCurrent() throws LibvirtException
LibvirtException
public java.lang.String[] snapshotListNames() throws LibvirtException
LibvirtException
public DomainSnapshot snapshotLookupByName(java.lang.String name) throws LibvirtException
name
- the nameLibvirtException
public int snapshotNum() throws LibvirtException
LibvirtException
public void suspend() throws LibvirtException
LibvirtException
public void undefine() throws LibvirtException
LibvirtException
public int updateDeviceFlags(java.lang.String xml, int flags) throws LibvirtException
xml
- the xml to update withflags
- controls the updateLibvirtException