Package org.libvirt

Class Domain.DomainMigrateParameters

java.lang.Object
org.libvirt.Domain.DomainMigrateParameters
Enclosing class:
Domain
public static final class Domain.DomainMigrateParameters extends Object
Contains multiple constants that defines "virDomainMigrate* params" multiple field.
See Also:

  • Field Details

    • VIR_MIGRATE_PARAM_MIGRATE_DISKS

      public static final String VIR_MIGRATE_PARAM_MIGRATE_DISKS
      Lists the block devices to be migrated. At the moment this is only supported by the QEMU driver but not for the tunnelled migration.
      See Also:

    • VIR_MIGRATE_PARAM_DEST_XML

      public static final String VIR_MIGRATE_PARAM_DEST_XML
      The new configuration to be used for the domain on the destination host as TYPED_PARAM_STRING. The configuration must include an identical set of virtual devices, to ensure a stable guest ABI across migration.
      See Also:

    • VIR_MIGRATE_PARAM_PERSIST_XML

      public static final String VIR_MIGRATE_PARAM_PERSIST_XML
      The new persistent configuration to be used for the domain on the destination host as TYPED_PARAM_STRING. This field cannot be used to rename the domain during migration. Domain name in the destination XML must match the original domain name. Omitting this parameter keeps the original domain persistent configuration.
      See Also:

    • VIR_MIGRATE_PARAM_BANDWIDTH

      public static final String VIR_MIGRATE_PARAM_BANDWIDTH
      The maximum bandwidth (in MiB/s) that will be used for migration as TYPED_PARAM_ULLONG. 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.
      See Also:

    • VIR_MIGRATE_PARAM_BANDWIDTH_POSTCOPY

      public static final String VIR_MIGRATE_PARAM_BANDWIDTH_POSTCOPY
      The maximum bandwidth (in MiB/s) that will be used for post-copy phase of a migration as TYPED_PARAM_ULLONG. If set to 0 or omitted, post-copy migration speed will not be limited.
      See Also:

    • VIR_MIGRATE_PARAM_DEST_NAME

      public static final String VIR_MIGRATE_PARAM_DEST_NAME
      The name to be used for the domain on the destination host as TYPED_PARAM_STRING. 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.
      See Also:

    • VIR_MIGRATE_PARAM_GRAPHICS_URI

      public static final String VIR_MIGRATE_PARAM_GRAPHICS_URI
      URI to use for migrating client's connection to domain's graphical console, as TYPED_PARAM_STRING. If specified, the client will be asked to automatically reconnect using these parameters instead of the automatically computed ones.
      See Also:

    • VIR_MIGRATE_PARAM_LISTEN_ADDRESS

      public static final String VIR_MIGRATE_PARAM_LISTEN_ADDRESS
      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.
      See Also:

    • VIR_MIGRATE_PARAM_URI

      public static final String VIR_MIGRATE_PARAM_URI
      URI to use for initiating domain migration as TYPED_PARAM_STRING. 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 field may not be used when VIR_MIGRATE_TUNNELLED flag is set.
      See Also:

    • VIR_MIGRATE_PARAM_DISKS_PORT

      public static final String VIR_MIGRATE_PARAM_DISKS_PORT
      Port that destination server should use for incoming disks migration. Type is TYPED_PARAM_INT. If set to 0 or omitted, libvirt will choose a suitable default. At the moment this is only supported by the QEMU driver. For more details, please check Libvirt documentation:7
      See Also:

    • VIR_MIGRATE_PARAM_DISKS_URI

      public static final String VIR_MIGRATE_PARAM_DISKS_URI
      URI used for incoming disks migration. Type is TYPED_PARAM_STRING. Only schemes "tcp" and "unix" are accepted. TCP URI can currently only provide a server and port to listen on (and connect to), UNIX URI may only provide a path component for a UNIX socket. UNIX URI is only usable if the management application makes sure that socket created with this name on the destination will be reachable from the source under the same exact path.
      See Also:

    • VIR_MIGRATE_PARAM_COMPRESSION

      public static final String VIR_MIGRATE_PARAM_COMPRESSION
      The name of the method used to compress migration traffic as TYPED_PARAM_STRING. Supported compression methods: xbzrle, mt. The parameter may be specified multiple times if more than one method should be used.
      See Also:

    • VIR_MIGRATE_PARAM_COMPRESSION_MT_LEVEL

      public static final String VIR_MIGRATE_PARAM_COMPRESSION_MT_LEVEL
      The level of compression for multithread compression as TYPED_PARAM_INT. Accepted values are in range 0-9. 0 is no compression, 1 is maximum speed and 9 is maximum compression.
      See Also:

    • VIR_MIGRATE_PARAM_COMPRESSION_MT_THREADS

      public static final String VIR_MIGRATE_PARAM_COMPRESSION_MT_THREADS
      The number of compression threads for multithread compression as TYPED_PARAM_INT.
      See Also:

    • VIR_MIGRATE_PARAM_COMPRESSION_MT_DTHREADS

      public static final String VIR_MIGRATE_PARAM_COMPRESSION_MT_DTHREADS
      The number of decompression threads for multithread compression as TYPED_PARAM_INT.
      See Also:

    • VIR_MIGRATE_PARAM_COMPRESSION_XBZRLE_CACHE

      public static final String VIR_MIGRATE_PARAM_COMPRESSION_XBZRLE_CACHE
      The size of page cache for xbzrle compression as TYPED_PARAM_ULLONG.
      See Also:

    • VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL

      public static final String VIR_MIGRATE_PARAM_AUTO_CONVERGE_INITIAL
      The initial percentage guest CPUs are throttled to when auto-convergence decides migration is not converging as TYPED_PARAM_INT.
      See Also:

    • VIR_MIGRATE_PARAM_AUTO_CONVERGE_INCREMENT

      public static final String VIR_MIGRATE_PARAM_AUTO_CONVERGE_INCREMENT
      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. As TYPED_PARAM_INT.
      See Also:

    • VIR_MIGRATE_PARAM_PARALLEL_CONNECTIONS

      public static final String VIR_MIGRATE_PARAM_PARALLEL_CONNECTIONS
      The number of connections used during parallel migration as TYPED_PARAM_INT.
      See Also:

    • VIR_MIGRATE_PARAM_TLS_DESTINATION

      public static final String VIR_MIGRATE_PARAM_TLS_DESTINATION
      Override the destination host name used for TLS verification as TYPED_PARAM_STRING. Normally the TLS certificate from the destination host must match the host's name for TLS verification to succeed. When the certificate does not match the destination hostname and the expected certificate's hostname is known, this parameter can be used to pass this expected hostname when starting the migration.
      See Also:

  • Constructor Details

    • DomainMigrateParameters

      public DomainMigrateParameters()