cinder/doc/source/configuration/block-storage/drivers/prophetstor-dpl-driver.rst
Brian Rosmaita 95c20b99c3 Revert "Remove ProphetStor Flexvisor Driver"
The driver removal policy was relaxed in January 2020 [0] to allow
unsupported drivers to remain in-tree at the discretion of the Cinder
project team.  Thus this driver, which was marked unsupported in
Train and removed early in Ussuri, is being restored.  It remains
deprecated and subject to removal should its presence affect the
gate adversely.

[0] https://docs.openstack.org/cinder/latest/drivers-all-about.html#driver-removal
git

This reverts commit cbda94022c.

Conflicts:
  cinder/volume/drivers/prophetstor/dplcommon.py
  - revised order of imports

Change-Id: I1af2b85f97ce64e4e667a844f7e2bac94b8ac7a8
Partially-implements: bp restore-unsupported-drivers
2020-04-06 08:52:14 -04:00

3.2 KiB

ProphetStor Fibre Channel and iSCSI drivers

ProhetStor Fibre Channel and iSCSI drivers add support for ProphetStor Flexvisor through the Block Storage service. ProphetStor Flexvisor enables commodity x86 hardware as software-defined storage leveraging well-proven ZFS for disk management to provide enterprise grade storage services such as snapshots, data protection with different RAID levels, replication, and deduplication.

The DPLFCDriver and DPLISCSIDriver drivers run volume operations by communicating with the ProphetStor storage system over HTTPS.

Supported operations

  • Create, delete, attach, and detach volumes.
  • Create, list, and delete volume snapshots.
  • Create a volume from a snapshot.
  • Copy an image to a volume.
  • Copy a volume to an image.
  • Clone a volume.
  • Extend a volume.

Enable the Fibre Channel or iSCSI drivers

The DPLFCDriver and DPLISCSIDriver are installed with the OpenStack software.

  1. Query storage pool id to configure dpl_pool of the cinder.conf file.

    1. Log on to the storage system with administrator access.

      $ ssh root@STORAGE_IP_ADDRESS
    2. View the current usable pool id.

      $ flvcli show pool list
      - d5bd40b58ea84e9da09dcf25a01fdc07 : default_pool_dc07
    3. Use d5bd40b58ea84e9da09dcf25a01fdc07 to configure the dpl_pool of /etc/cinder/cinder.conf file.

      Note

      Other management commands can be referenced with the help command flvcli -h.

  2. Make the following changes on the volume node /etc/cinder/cinder.conf file.

    # IP address of SAN controller (string value)
    san_ip=STORAGE IP ADDRESS
    
    # Username for SAN controller (string value)
    san_login=USERNAME
    
    # Password for SAN controller (string value)
    san_password=PASSWORD
    
    # Use thin provisioning for SAN volumes? (boolean value)
    san_thin_provision=true
    
    # The port that the iSCSI daemon is listening on. (integer value)
    iscsi_port=3260
    
    # DPL pool uuid in which DPL volumes are stored. (string value)
    dpl_pool=d5bd40b58ea84e9da09dcf25a01fdc07
    
    # DPL port number. (integer value)
    dpl_port=8357
    
    # Uncomment one of the next two option to enable Fibre channel or iSCSI
    # FIBRE CHANNEL(uncomment the next line to enable the FC driver)
    #volume_driver=cinder.volume.drivers.prophetstor.dpl_fc.DPLFCDriver
    # iSCSI (uncomment the next line to enable the iSCSI driver)
    #volume_driver=cinder.volume.drivers.prophetstor.dpl_iscsi.DPLISCSIDriver
  3. Save the changes to the /etc/cinder/cinder.conf file and restart the cinder-volume service.

The ProphetStor Fibre Channel or iSCSI drivers are now enabled on your OpenStack system. If you experience problems, review the Block Storage service log files for errors.

The following table contains the options supported by the ProphetStor storage driver.