Quobyte Driver

Quobyte Driver

Quobyte can be used as a storage back end for the OpenStack Shared File System service. Shares in the Shared File System service are mapped 1:1 to Quobyte volumes. Access is provided via NFS protocol and IP-based authentication. The Quobyte driver uses the Quobyte API service.

Supported shared filesystems and operations

The drivers supports NFS shares.

The following operations are supported:

  • Create a share.

  • Delete a share.

  • Allow share access.

    Note the following limitations:

    • Only IP access type is supported.
  • Deny share access.

Driver options

The following table contains the configuration options specific to the share driver.

Description of Quobyte share driver configuration options
Configuration option = Default value Description
[DEFAULT]  
quobyte_api_ca = None (String) The X.509 CA file to verify the server cert.
quobyte_api_password = quobyte (String) Password for Quobyte API server
quobyte_api_url = None (String) URL of the Quobyte API server (http or https)
quobyte_api_username = admin (String) Username for Quobyte API server.
quobyte_default_volume_group = root (String) Default owning group for new volumes.
quobyte_default_volume_user = root (String) Default owning user for new volumes.
quobyte_delete_shares = False (Boolean) Actually deletes shares (vs. unexport)
quobyte_volume_configuration = BASE (String) Name of volume configuration used for new shares.

Configuration

To configure Quobyte access for the Shared File System service, a back end configuration section has to be added in the manila.conf file. Add the name of the configuration section to enabled_share_backends in the manila.conf file. For example, if the section is named Quobyte:

enabled_share_backends = Quobyte

Create the new back end configuration section, in this case named Quobyte:

[Quobyte]

share_driver = manila.share.drivers.quobyte.quobyte.QuobyteShareDriver
share_backend_name = QUOBYTE
quobyte_api_url = http://api.myserver.com:1234/
quobyte_delete_shares = False
quobyte_volume_configuration = BASE
quobyte_default_volume_user = myuser
quobyte_default_volume_group = mygroup

The section name must match the name used in the enabled_share_backends option described above. The share_driver setting is required as shown, the other options should be set according to your local Quobyte setup.

Other security-related options are:

quobyte_api_ca = /path/to/API/server/verification/certificate
quobyte_api_username = api_user
quobyte_api_password = api_user_pwd

Quobyte support can be found at the Quobyte support webpage.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.