cinder/doc/source/configuration/block-storage/drivers/falconstor-fss-driver.rst
Jay S. Bryant 986a6a015f [DOC BLD FIX] Name files for inclusion properly
The Sphinx build was issuing hundreds of warning for
duplicate labels.  The reason for this was because
all of the tables we had were named as .rst files.
This would cause Sphinx to process them twice and it would
think there were duplicated sections.

There were two ways this could be handled:  1) Exclude the tables
directory from the docs build. 2) Name the files as they should
have always been so they weren't build twice.  Given that
option 1 just masked the problem, I am implementing this
patch using option 2.

So, all the tables we are including in our documentation
have been named from .rst to .inc and the .. include::
directives that use them have also been updated to use
the new file name.

Change-Id: If395eb652f7e3b789bcbd5e6d6d05954c23d8d8a
2017-08-04 15:33:52 -05:00

2.6 KiB

FalconStor FSS Storage Fibre Channel and iSCSI drivers

The FSSISCSIDriver and FSSFCDriver drivers run volume operations by communicating with the FalconStor FSS storage system over HTTP.

System requirements

To use the FalconStor FSS drivers, the following are required:

  • FalconStor FSS storage with:
    • iSCSI or FC host interfaces
    • FSS-8.00-8865 or later

Supported operations

The FalconStor volume driver provides the following Cinder volume operations:

  • Create, delete, attach, and detach volumes.
  • Create, list, and delete volume snapshots.
  • Create a volume from a snapshot.
  • Clone a volume.
  • Extend a volume.
  • Get volume statistics.
  • Create and delete consistency group.
  • Create and delete consistency group snapshots.
  • Modify consistency groups.
  • Manage and unmanage a volume.

iSCSI configuration

Use the following instructions to update the configuration file for iSCSI:

default_volume_type = FSS
enabled_backends = FSS

[FSS]

# IP address of FSS server
san_ip = 172.23.0.1
# FSS server user name
san_login = Admin
# FSS server password
san_password = secret
# FSS server storage pool id list
fss_pools=P:2,O:3
# Name to give this storage back-end
volume_backend_name = FSSISCSIDriver
# The iSCSI driver to load
volume_driver = cinder.volume.drivers.falconstor.iscsi.FSSISCSIDriver


# ==Optional settings==

# Enable FSS log message
fss_debug = true
# Enable FSS thin provision
san_thin_provision=true

Fibre Channel configuration

Use the following instructions to update the configuration file for fibre channel:

default_volume_type = FSSFC
enabled_backends = FSSFC

[FSSFC]
# IP address of FSS server
san_ip = 172.23.0.2
# FSS server user name
san_login = Admin
# FSS server password
san_password = secret
# FSS server storage pool id list
fss_pools=A:1
# Name to give this storage back-end
volume_backend_name = FSSFCDriver
# The FC driver to load
volume_driver = cinder.volume.drivers.falconstor.fc.FSSFCDriver


# ==Optional settings==

# Enable FSS log message
fss_debug = true
# Enable FSS thin provision
san_thin_provision=true

Driver options

The following table contains the configuration options specific to the FalconStor FSS storage volume driver.