Add docs and update support matrix for Hitachi driver

Change-Id: Ib2f793e1d68ba2f3e613ee43c553f1d2a1d7f5a4

doc/source/configuration/block-storage/drivers/hitachi-vsp-driver.rst

@@ -0,0 +1,160 @@
+============================
+Hitachi block storage driver
+============================
+
+Hitachi block storage driver provides Fibre Channel and iSCSI support for
+Hitachi VSP storages.
+
+System requirements
+~~~~~~~~~~~~~~~~~~~
+
+Supported storages:
+
++-----------------+------------------------+
+| Storage model   | Firmware version       |
++=================+========================+
+| VSP E990,       | 93-01-01 or later      |
++-----------------+------------------------+
+| VSP F350,       | 88-01-04 or later      |
+| F370,           |                        |
+| F700,           |                        |
+| F900            |                        |
+|                 |                        |
+| VSP G350,       |                        |
+| G370,           |                        |
+| G700,           |                        |
+| G900            |                        |
++-----------------+------------------------+
+| VSP F400,       | 83-04-43 or later      |
+| F600,           |                        |
+| F800            |                        |
+|                 |                        |
+| VSP G200,       |                        |
+| G400,           |                        |
+| G600,           |                        |
+| G800            |                        |
++-----------------+------------------------+
+| VSP N400,       | 83-06-01 or later      |
+| N600,           |                        |
+| N800            |                        |
++-----------------+------------------------+
+| VSP 5100,       | 90-01-41 or later      |
+| 5500,           |                        |
+| 5100H,          |                        |
+| 5500H           |                        |
++-----------------+------------------------+
+| VSP F1500       | 80-05-43 or later      |
+|                 |                        |
+| VSP G1000,      |                        |
+| VSP G1500       |                        |
++-----------------+------------------------+
+
+Required storage licenses:
+
+* Hitachi Storage Virtualization Operating System (SVOS)
+
+  - Hitachi LUN Manager
+  - Hitachi Dynamic Provisioning
+* Hitachi Local Replication (Hitachi Thin Image)
+
+Supported operations
+~~~~~~~~~~~~~~~~~~~~
+
+* Create, delete, attach, and detach volumes.
+* Create, list, and delete volume snapshots.
+* Create a volume from a snapshot.
+* Copy a volume to an image.
+* Copy an image to a volume.
+* Clone a volume.
+* Extend a volume.
+* Migrate a volume.
+* Get volume statistics.
+* Efficient non-disruptive volume backup.
+* Manage and unmanage a volume.
+* Attach a volume to multiple instances at once (multi-attach).
+* Revert a volume to a snapshot.
+
+.. note::
+
+   The volume having snapshots cannot be extended in this driver.
+
+Configuration
+~~~~~~~~~~~~~
+
+Set up Hitachi storage
+----------------------
+
+You need to specify settings as described below for storage systems. For
+details about each setting, see the user's guide of the storage systems.
+
+#. User accounts
+
+   Create a storage device account belonging to the Administrator User Group.
+
+#. DP Pool
+
+   Create a DP pool that is used by the driver.
+
+#. Ports
+
+   Enable Port Security for the ports used by the driver.
+
+Set up Hitachi storage volume driver
+------------------------------------
+
+Set the volume driver to Hitachi block storage driver by setting the
+volume_driver option in the cinder.conf file as follows:
+
+If you use Fibre Channel:
+
+.. code-block:: ini
+
+   [hitachi_vsp]
+   volume_driver = cinder.volume.drivers.hitachi.hbsd_fc.HBSDFCDriver
+   volume_backend_name = hitachi_vsp
+   san_ip = 1.2.3.4
+   san_login = hitachiuser
+   san_password = password
+   hitachi_storage_id = 123456789012
+   hitachi_pool = pool0
+
+If you use iSCSI:
+
+.. code-block:: ini
+
+   [hitachi_vsp]
+   volume_driver = cinder.volume.drivers.hitachi.hbsd_iscsi.HBSDISCSIDriver
+   volume_backend_name = hitachi_vsp
+   san_ip = 1.2.3.4
+   san_login = hitachiuser
+   san_password = password
+   hitachi_storage_id = 123456789012
+   hitachi_pool = pool0
+
+This table shows configuration options for Hitachi block storage driver.
+
+.. config-table::
+   :config-target: Hitachi block storage driver
+
+   cinder.volume.drivers.hitachi.hbsd_common
+   cinder.volume.drivers.hitachi.hbsd_rest
+   cinder.volume.drivers.hitachi.hbsd_fc
+
+Required options
+----------------
+
+- ``san_ip``
+    IP address of SAN controller
+
+- ``san_login``
+    Username for SAN controller
+
+- ``san_password``
+    Password for SAN controller
+
+- ``hitachi_storage_id``
+    Product number of the storage system.
+
+- ``hitachi_pool``
+    Pool number or pool name of the DP pool.
+

doc/source/reference/support-matrix.ini

@@ -48,6 +48,9 @@ title=Dell EMC VNX Storage Driver (FC, iSCSI)
 [driver.fujitsu_eternus]
 title=Fujitsu ETERNUS Driver (FC, iSCSI)
 
+[driver.hitachi_vsp]
+title=Hitachi VSP Storage Driver (FC, iSCSI)
+
 [driver.hpe_3par]
 title=HPE 3PAR Storage Driver (FC, iSCSI)
 
@@ -210,6 +213,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=complete
 driver.fujitsu_eternus=complete
+driver.hitachi_vsp=complete
 driver.hpe_3par=complete
 driver.hpe_msa=complete
 driver.huawei_t_v1=complete
@@ -274,6 +278,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=complete
 driver.fujitsu_eternus=complete
+driver.hitachi_vsp=complete
 driver.hpe_3par=complete
 driver.hpe_msa=complete
 driver.huawei_t_v1=complete
@@ -338,6 +343,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=complete
 driver.hpe_3par=missing
 driver.hpe_msa=missing
 driver.huawei_t_v1=complete
@@ -405,6 +411,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=missing
 driver.hpe_3par=complete
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -471,6 +478,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=missing
 driver.hpe_3par=complete
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -538,6 +546,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=complete
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=missing
 driver.hpe_3par=complete
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -604,6 +613,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=complete
 driver.fujitsu_eternus=complete
+driver.hitachi_vsp=complete
 driver.hpe_3par=complete
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -671,6 +681,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=missing
 driver.hpe_3par=missing
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -738,6 +749,7 @@ driver.dell_emc_vnx=missing
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=complete
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=complete
 driver.hpe_3par=complete
 driver.hpe_msa=complete
 driver.huawei_t_v1=missing
@@ -802,6 +814,7 @@ driver.dell_emc_vnx=complete
 driver.dell_emc_powerflex=complete
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=complete
 driver.hpe_3par=complete
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing
@@ -870,6 +883,7 @@ driver.dell_emc_vnx=missing
 driver.dell_emc_powerflex=missing
 driver.dell_emc_xtremio=missing
 driver.fujitsu_eternus=missing
+driver.hitachi_vsp=missing
 driver.hpe_3par=missing
 driver.hpe_msa=missing
 driver.huawei_t_v1=missing