openstack-manuals/doc/common/tables/nova-libvirt.xml

<?xml version='1.0' encoding='UTF-8'?>
<para xmlns="http://docbook.org/ns/docbook" version="5.0">
  <!-- Warning: Do not edit this file. It is automatically
     generated and your changes will be overwritten.
     The tool to do so lives in openstack-doc-tools repository. -->
  <table rules="all" xml:id="config_table_nova_libvirt">
    <caption>Description of configuration options for libvirt</caption>
    <col width="50%"/>
    <col width="50%"/>
    <thead>
      <tr>
        <th>Configuration option = Default value</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <th colspan="2">[DEFAULT]</th>
      </tr>
      <tr>
        <td>remove_unused_base_images = True</td>
        <td>(BoolOpt) Should unused base images be removed?</td>
      </tr>
      <tr>
        <td>remove_unused_original_minimum_age_seconds = 86400</td>
        <td>(IntOpt) Unused unresized base images younger than this will not be removed</td>
      </tr>
      <tr>
        <th colspan="2">[libvirt]</th>
      </tr>
      <tr>
        <td>checksum_base_images = False</td>
        <td>(BoolOpt) Write a checksum for files in _base to disk</td>
      </tr>
      <tr>
        <td>checksum_interval_seconds = 3600</td>
        <td>(IntOpt) How frequently to checksum base images</td>
      </tr>
      <tr>
        <td>connection_uri = </td>
        <td>(StrOpt) Override the default libvirt URI (which is dependent on virt_type)</td>
      </tr>
      <tr>
        <td>cpu_mode = None</td>
        <td>(StrOpt) Set to "host-model" to clone the host CPU feature flags; to "host-passthrough" to use the host CPU model exactly; to "custom" to use a named CPU model; to "none" to not set any CPU model. If virt_type="kvm|qemu", it will default to "host-model", otherwise it will default to "none"</td>
      </tr>
      <tr>
        <td>cpu_model = None</td>
        <td>(StrOpt) Set to a named libvirt CPU model (see names listed in /usr/share/libvirt/cpu_map.xml). Only has effect if cpu_mode="custom" and virt_type="kvm|qemu"</td>
      </tr>
      <tr>
        <td>disk_prefix = None</td>
        <td>(StrOpt) Override the default disk prefix for the devices attached to a server, which is dependent on virt_type. (valid options are: sd, xvd, uvd, vd)</td>
      </tr>
      <tr>
        <td>image_info_filename_pattern = $instances_path/$image_cache_subdirectory_name/%(image)s.info</td>
        <td>(StrOpt) Allows image information files to be stored in non-standard locations</td>
      </tr>
      <tr>
        <td>remove_unused_kernels = False</td>
        <td>(BoolOpt) Should unused kernel images be removed? This is only safe to enable if all compute nodes have been updated to support this option. This will be enabled by default in future.</td>
      </tr>
      <tr>
        <td>remove_unused_resized_minimum_age_seconds = 3600</td>
        <td>(IntOpt) Unused resized base images younger than this will not be removed</td>
      </tr>
      <tr>
        <td>rng_dev_path = None</td>
        <td>(StrOpt) A path to a device that will be used as source of entropy on the host. Permitted options are: /dev/random or /dev/hwrng</td>
      </tr>
      <tr>
        <td>snapshots_directory = $instances_path/snapshots</td>
        <td>(StrOpt) Location where libvirt driver will store snapshots before uploading them to image service</td>
      </tr>
      <tr>
        <td>vif_driver = nova.virt.libvirt.vif.LibvirtGenericVIFDriver</td>
        <td>(StrOpt) DEPRECATED. The libvirt VIF driver to configure the VIFs.This option is deprecated and will be removed in the Juno release.</td>
      </tr>
      <tr>
        <td>virt_type = kvm</td>
        <td>(StrOpt) Libvirt domain type (valid options are: kvm, lxc, qemu, uml, xen)</td>
      </tr>
      <tr>
        <td>volume_clear = zero</td>
        <td>(StrOpt) Method used to wipe old volumes (valid options are: none, zero, shred)</td>
      </tr>
      <tr>
        <td>volume_clear_size = 0</td>
        <td>(IntOpt) Size in MiB to wipe at start of old volumes. 0 =&gt; all</td>
      </tr>
      <tr>
        <td>volume_drivers = iscsi=nova.virt.libvirt.volume.LibvirtISCSIVolumeDriver, iser=nova.virt.libvirt.volume.LibvirtISERVolumeDriver, local=nova.virt.libvirt.volume.LibvirtVolumeDriver, fake=nova.virt.libvirt.volume.LibvirtFakeVolumeDriver, rbd=nova.virt.libvirt.volume.LibvirtNetVolumeDriver, sheepdog=nova.virt.libvirt.volume.LibvirtNetVolumeDriver, nfs=nova.virt.libvirt.volume.LibvirtNFSVolumeDriver, aoe=nova.virt.libvirt.volume.LibvirtAOEVolumeDriver, glusterfs=nova.virt.libvirt.volume.LibvirtGlusterfsVolumeDriver, fibre_channel=nova.virt.libvirt.volume.LibvirtFibreChannelVolumeDriver, scality=nova.virt.libvirt.volume.LibvirtScalityVolumeDriver</td>
        <td>(ListOpt) Libvirt handlers for remote volumes.</td>
      </tr>
      <tr>
        <td>wait_soft_reboot_seconds = 120</td>
        <td>(IntOpt) Number of seconds to wait for instance to shut down after soft reboot request is made. We fall back to hard reboot if instance does not shutdown within this window.</td>
      </tr>
    </tbody>
  </table>
</para>