Documentation #17978

Wrong diskcache parameter name for OpenStack Havana and Icehouse

Added by Michael Eischer over 7 years ago. Updated about 7 years ago.

Target version:
% Done:


Affected Versions:
Pull request ID:


I've been investigating some performance issues I've encountered on an OpenStack Icehouse deployment. The configuration closely resembles the one from
However, libvirt was using "none" as disk cache mode despite the configuration line in nova.conf:


A closer examination revealed that the correct configuration would have been:


Due to an unknown reason there is no deprecated_name with a libvirt prefix for the disk_cachemodes configuration option (see This holds for both OpenStack Havana and Icehouse. It is possible at least for Icehouse to use the configuration for Juno, which (implicitly) fixes the wrong parameter name.

Associated revisions

Revision 877245e6 (diff)
Added by Michael Eischer about 7 years ago

doc: Fixes parameter name in rbd configuration on openstack havana/icehouse

The documentation for using rbd together with openstack havana/icehouse
states that the parameter libvirt_disk_cachemodes should be added to
the nova.conf file. However, this is the only parameter that has no
legacy name with a 'libvirt_' prefix. (See
for the configuration option)
Thus the configured disk_cachemodes were not applied, defaulting to
no caching.

Fixes: #17978
Signed-off-by: Michael Eischer <>


#1 Updated by Michael Eischer about 7 years ago

Ping Any progress on this?

#2 Updated by Nathan Cutler about 7 years ago

@Michael: Can you open a PR at with your proposed fix? The documentation is under doc/

#3 Updated by Jason Dillaman about 7 years ago

@Michael: note that Icehouse and Havana are both EOLed by the upstream community. Does this issue apply to Grizzly+ releases of OpenStack as well?

#4 Updated by Michael Eischer about 7 years ago

I've opened a pull request:

@Jason: The documentation fix doesn't apply to OpenStack Juno or later which have their own documentation section(s). OpenStack Grizzly is not covered by the rbd documentation, but also doesn't seem to have the 'libvirt_' prefix for disk_cachemodes.

#5 Updated by Jason Dillaman about 7 years ago

  • Status changed from New to Resolved

Also available in: Atom PDF