Enum libvirt_rpc::request::MigrationParam

pub enum MigrationParam {
    Uri(String),
    DestinationName(String),
    DestinationXml(String),
    PersistentXml(String),
    Bandwidth(u64),
    GraphicsUri(String),
    ListenAddress(String),
    MigrateDisks(String),
    DisksPort(i32),
    Compression(String),
    CompressionLevel(i32),
    CompressionThreads(i32),
    DecompressionThreads(i32),
    CompressionXbzrleCache(u64),
    AutoConvergeInitial(i32),
    AutoConvergeIncrement(i32),
}

Variants

Uri(String)

URI to use for initiating domain migration. It takes a hypervisor specific format. The uri_transports element of the hypervisor capabilities XML includes details of the supported URI schemes. When omitted libvirt will auto-generate suitable default URI. It is typically only necessary to specify this URI if the destination host has multiple interfaces and a specific interface is required to transmit migration data.

This filed may not be used when VIR_MIGRATE_TUNNELLED flag is set.

DestinationName(String)

the name to be used for the domain on the destination host. Omitting this parameter keeps the domain name the same. This field is only allowed to be used with hypervisors that support domain renaming during migration.

DestinationXml(String)

the new configuration to be used for the domain on the destination host. The configuration must include an identical set of virtual devices, to ensure a stable guest ABI across migration. Only parameters related to host side configuration can be changed in the XML. Hypervisors which support this field will forbid migration if the provided XML would cause a change in the guest ABI. This field cannot be used to rename the domain during migration (use VIR_MIGRATE_PARAM_DEST_NAME field for that purpose). Domain name in the destination XML must match the original domain name.

Omitting this parameter keeps the original domain configuration. Using this field with hypervisors that do not support changing domain configuration during migration will result in a failure.

PersistentXml(String)

the new persistent configuration to be used for the domain on the destination host. This field cannot be used to rename the domain during migration (use VIR_MIGRATE_PARAM_DEST_NAME field for that purpose). Domain name in the destination XML must match the original domain name.

Omitting this parameter keeps the original domain persistent configuration. Using this field with hypervisors that do not support changing domain configuration during migration will result in a failure.

Bandwidth(u64)

the maximum bandwidth (in MiB/s) that will be used for migration. If set to 0 or omitted, libvirt will choose a suitable default. Some hypervisors do not support this feature and will return an error if this field is used and is not 0.

GraphicsUri(String)

URI to use for migrating client's connection to domain's graphical console. If specified, the client will be asked to automatically reconnect using these parameters instead of the automatically computed ones. This can be useful if, e.g., the client does not have a direct access to the network virtualization hosts are connected to and needs to connect through a proxy. The URI is formed as follows: protocol://hostname[:port]/[?parameters] where protocol is either "spice" or "vnc" and parameters is a list of protocol specific parameters separated by '&'. Currently recognized parameters are "tlsPort" and "tlsSubject". For example, spice://target.host.com:1234/?tlsPort=4567

ListenAddress(String)

The listen address that hypervisor on the destination side should bind to for incoming migration. Both IPv4 and IPv6 addresses are accepted as well as hostnames (the resolving is done on destination). Some hypervisors do not support this feature and will return an error if this field is used.

MigrateDisks(String)

The multiple values that list the block devices to be migrated. At the moment this is only supported by the QEMU driver but not for the tunnelled migration.

DisksPort(i32)

virDomainMigrate* params field: port that destination server should use for incoming disks migration. If set to 0 or omitted, libvirt will choose a suitable default. At the moment this is only supported by the QEMU driver.

Compression(String)

virDomainMigrate* params multiple field: name of the method used to compress migration traffic. Supported compression methods: xbzrle, mt. The parameter may be specified multiple times if more than one method should be used.

CompressionLevel(i32)

the level of compression for multithread compression. Accepted values are in range 0-9. 0 is no compression, 1 is maximum speed and 9 is maximum compression.

CompressionThreads(i32)

the number of compression threads for multithread compression

DecompressionThreads(i32)

the number of decompression threads for multithread compression

CompressionXbzrleCache(u64)

the size of page cache for xbzrle compression

AutoConvergeInitial(i32)

the initial percentage guest CPUs are throttled to when auto-convergence decides migration is not converging.

AutoConvergeIncrement(i32)

the increment added to VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL whenever the hypervisor decides the current rate is not enough to ensure convergence of the migration.

Trait Implementations

impl Debug for MigrationParam

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Into<TypedParam> for MigrationParam

fn into(self) -> TypedParam

Performs the conversion.