diff --git a/doc/source/configuration/block-storage/drivers/hitachi-vsp-driver.rst b/doc/source/configuration/block-storage/drivers/hitachi-vsp-driver.rst new file mode 100644 index 00000000000..2b3c400892c --- /dev/null +++ b/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. + diff --git a/doc/source/reference/support-matrix.ini b/doc/source/reference/support-matrix.ini index 9d27d399cac..51bd98580da 100644 --- a/doc/source/reference/support-matrix.ini +++ b/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