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

  1. User accounts

    Create a storage device account belonging to the Administrator User Group.

  2. DP Pool

    Create a DP pool that is used by the driver.

  3. 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:

[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:

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

Description of Hitachi block storage driver configuration options

Configuration option = Default value

Description

hitachi_compute_target_ports = []

(List of String) IDs of the storage ports used to attach volumes to compute nodes. To specify multiple ports, connect them by commas (e.g. CL1-A,CL2-A).

hitachi_discard_zero_page = True

(Boolean) Enable or disable zero page reclamation in a DP-VOL.

hitachi_group_create = False

(Boolean) If True, the driver will create host groups or iSCSI targets on storage ports as needed.

hitachi_group_delete = False

(Boolean) If True, the driver will delete host groups or iSCSI targets on storage ports as needed.

hitachi_ldev_range = None

(String) Range of the LDEV numbers in the format of ‘xxxx-yyyy’ that can be used by the driver. Values can be in decimal format (e.g. 1000) or in colon-separated hexadecimal format (e.g. 00:03:E8).

hitachi_pool = None

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

hitachi_rest_tcp_keepalive = True

(Boolean) Enables or disables use of REST API tcp keepalive

hitachi_snap_pool = None

(String) Pool number or pool name of the snapshot pool.

hitachi_storage_id = None

(String) Product number of the storage system.

hitachi_target_ports = []

(List of String) IDs of the storage ports used to attach volumes to the controller node. To specify multiple ports, connect them by commas (e.g. CL1-A,CL2-A).

hitachi_zoning_request = False

(Boolean) If True, the driver will configure FC zoning between the server and the storage system provided that FC zoning manager is enabled.

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.