Atom feed of this document
Icehouse -  Icehouse -  Icehouse -  Icehouse -  Icehouse -  Icehouse -  Icehouse -  Icehouse - 


XenAPINFS is a Block Storage (Cinder) driver that uses an NFS share through the XenAPI Storage Manager to store virtual disk images and expose those virtual disks as volumes.

This driver does not access the NFS share directly. It accesses the share only through XenAPI Storage Manager. Consider this driver as a reference implementation for use of the XenAPI Storage Manager in OpenStack (present in XenServer and XCP).


  • A XenServer/XCP installation that acts as Storage Controller. This hypervisor is known as the storage controller.

  • Use XenServer/XCP as your hypervisor for Compute nodes.

  • An NFS share that is configured for XenServer/XCP. For specific requirements and export options, see the administration guide for your specific XenServer version. The NFS share must be accessible by all XenServers components within your cloud.

  • To create volumes from XenServer type images (vhd tgz files), XenServer Nova plug-ins are also required on the storage controller.


You can use a XenServer as a storage controller and compute node at the same time. This minimal configuration consists of a XenServer/XCP box and an NFS share.

 Configuration patterns

  • Local configuration (Recommended): The driver runs in a virtual machine on top of the storage controller. With this configuration, you can create volumes from qemu-img-supported formats.


    Figure 1.3. Local configuration

  • Remote configuration: The driver is not a guest VM of the storage controller. With this configuration, you can only use XenServer vhd-type images to create volumes.


    Figure 1.4. Remote configuration

 Configuration options

Assuming the following setup:

  • XenServer box at

  • XenServer password is r00tme

  • NFS server is

  • NFS export is at /volumes

To use XenAPINFS as your cinder driver, set these configuration options in the cinder.conf file:

volume_driver =
xenapi_connection_url =
xenapi_connection_username = root
xenapi_connection_password = r00tme
xenapi_nfs_server =
xenapi_nfs_serverpath = /volumes

The following table shows the configuration options that the XenAPINFS driver supports:

Table 1.28. Description of configuration options for storage_xen
Configuration option = Default value Description
xenapi_connection_password = None (StrOpt) Password for XenAPI connection
xenapi_connection_url = None (StrOpt) URL for XenAPI connection
xenapi_connection_username = root (StrOpt) Username for XenAPI connection
xenapi_nfs_server = None (StrOpt) NFS server to be used by XenAPINFSDriver
xenapi_nfs_serverpath = None (StrOpt) Path of exported NFS, used by XenAPINFSDriver
xenapi_sr_base_path = /var/run/sr-mount (StrOpt) Base path to the storage repository

Questions? Discuss on
Found an error? Report a bug against this page

loading table of contents...