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

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 E590, E790	93-03-22 or later
VSP E990	93-01-01 or later
VSP E1090, E1090H	93-06-2x or later
VSP F350, F370, F700, F900 VSP G350, G370, G700, G900	88-01-04 or later
VSP F400, F600, F800 VSP G200, G400, G600, G800	83-04-43 or later
VSP N400, N600, N800	83-06-01 or later
VSP 5100, 5500, 5100H, 5500H	90-01-41 or later
VSP 5200, 5600, 5200H, 5600H	90-08-0x or later
VSP F1500 VSP G1000, VSP G1500	80-05-43 or later

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.
• Create, list, update, and delete consistency groups.
• Create, list, and delete consistency group snapshots.
• 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.

Common resources:

• All resources

  The name of any storage resource, such as a DP pool or a host group, cannot contain any whitespace characters or else it will be unusable by the driver.

• 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.

• Resource group

  If using a new resource group for exclusive use by an OpenStack system, create a new resource group, and assign the necessary resources, such as LDEVs, port, and host group (iSCSI target) to the created resource.

• Ports

  Enable Port Security for the ports used by the driver.

If you use iSCSI:

• Ports

  Assign an IP address and a TCP port number to the port.

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:

[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_pools = pool0

If you use iSCSI:

[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_pools = pool0

This table shows configuration options for Hitachi block storage driver.

cinder.volume.drivers.hitachi.hbsd_common cinder.volume.drivers.hitachi.hbsd_rest cinder.volume.drivers.hitachi.hbsd_rest_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_pools

  Pool number(s) or pool name(s) of the DP pool.