cinder/doc/source/configuration/block-storage/drivers/veritas-access-iscsi-driver.rst
Brian Rosmaita 207bead25f Revert "Remove the Veritas Access 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

This reverts commit 5649da137b.

Change-Id: I08a58ea6bb6340c5e09f4dbfa242f9b4a65ae05c
Partially-implements: bp restore-unsupported-drivers
2020-04-03 16:21:24 -04:00

2.7 KiB

Veritas ACCESS iSCSI driver

Veritas Access is a software-defined scale-out network-attached storage (NAS) solution for unstructured data that works on commodity hardware and takes advantage of placing data on premise or in the cloud based on intelligent policies. Through Veritas Access iSCSI Driver, OpenStack Block Storage can use Veritas Access backend as a block storage resource. The driver enables you to create iSCSI volumes that an OpenStack Block Storage server can allocate to any virtual machine running on a compute host.

Requirements

The Veritas ACCESS iSCSI Driver, version 1.0.0 and later, supports Veritas ACCESS release 7.4 and later.

Supported operations

  • Create and delete volumes.
  • Create and delete snapshots.
  • Create volume from snapshot.
  • Extend a volume.
  • Attach and detach volumes.
  • Clone volumes.

Configuration

  1. Enable RESTful service on the Veritas Access Backend.

  2. Create Veritas Access iSCSI target, add store and portal IP to it.

    You can create target and add portal IP, store to it as follows:

    Target> iscsi target create iqn.2018-02.com.veritas:target02
    Target> iscsi target store add target_fs iqn.2018-02.com.veritas:target02
    Target> iscsi target portal add iqn.2018-02.com.veritas:target02 10.10.10.1
    ...

    You can add authentication to target as follows:

    Target> iscsi target auth incominguser add iqn.2018-02.com.veritas:target02 user1
    ...
  3. Ensure that the Veritas Access iSCSI target service is online. If the Veritas Access iSCSI target service is not online, enable the service by using the CLI or REST API.

    Target> iscsi service start
    Target> iscsi service status
    ...

    Define the following required properties in the cinder.conf file:

    volume_driver = cinder.volume.drivers.veritas_access.veritas_iscsi.ACCESSIscsiDriver
    san_ip = va_console_ip
    san_api_port = 14161
    san_login = master
    san_password = password
    target_port = 3260
    vrts_lun_sparse = True
    vrts_target_config = /etc/cinder/vrts_target.xml
  4. Define Veritas Access Target details in /etc/cinder/vrts_target.xml:

    <?xml version="1.0" ?>
    <VRTS>
         <VrtsTargets>
              <Target>
                      <Name>iqn.2018-02.com.veritas:target02</Name>
                      <PortalIP>10.10.10.1</PortalIP>
                      <Authentication>0</Authentication>
              </Target>
         </VrtsTargets>
    </VRTS>
    ...