HPE XP block storage driver

HPE XP block storage driver provides Fibre Channel and iSCSI support for HPE XP storages.

System requirements

Supported storages:

Storage model

Firmware version

XP8

90-01-41 or later

XP7

80-05-43 or later

Required storage licenses:

  • Thin Provisioning

  • Fast Snap

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 HPE XP 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. THP pool

    Create a THP pool that is used by the driver.

  3. Ports

    Enable Port Security for the ports used by the driver.

Set up HPE XP storage volume driver

Set the volume driver to HPE XP block storage driver by setting the volume_driver option in the cinder.conf file as follows:

If you use Fibre Channel:

[hpe_xp]
volume_driver = cinder.volume.drivers.hpe.xp.hpe_xp_fc.HPEXPFCDriver
volume_backend_name = hpexp_fc
san_ip = 1.2.3.4
san_login = hpexpuser
san_password = password
hpexp_storage_id = 123456789012
hpexp_pools = pool0

If you use iSCSI:

[hpe_xp]
volume_driver = cinder.volume.drivers.hpe.xp.hpe_xp_iscsi.HPEXPISCSIDriver
volume_backend_name = hpexp_iscsi
san_ip = 1.2.3.4
san_login = hpexpuser
san_password = password
hpexp_storage_id = 123456789012
hpexp_pools = pool0

This table shows configuration options for HPE XP block storage driver.

Description of HPE XP block storage driver configuration options

Configuration option = Default value

Description

hpexp_async_copy_check_interval = 10

(Integer(min=1, max=600)) Interval in seconds to check copy asynchronously

hpexp_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).

hpexp_copy_check_interval = 3

(Integer(min=1, max=600)) Interval in seconds to check copy

hpexp_copy_speed = 3

(Integer(min=1, max=15)) Copy speed of storage system. 1 or 2 indicates low speed, 3 indicates middle speed, and a value between 4 and 15 indicates high speed.

hpexp_discard_zero_page = True

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

hpexp_exec_retry_interval = 5

(Integer) Retry interval in seconds for REST API execution.

hpexp_extend_timeout = 600

(Integer) Maximum wait time in seconds for a volume extention to complete.

hpexp_group_create = False

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

hpexp_group_delete = False

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

hpexp_host_mode_options = []

(List of String) Host mode option for host group or iSCSI target.

hpexp_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).

hpexp_lock_timeout = 7200

(Integer) Maximum wait time in seconds for storage to be unlocked.

hpexp_lun_retry_interval = 1

(Integer) Retry interval in seconds for REST API adding a LUN.

hpexp_lun_timeout = 50

(Integer) Maximum wait time in seconds for adding a LUN to complete.

hpexp_pools = []

(List of String) Pool number[s] or pool name[s] of the THP pool.

hpexp_rest_another_ldev_mapped_retry_timeout = 600

(Integer) Retry time in seconds when new LUN allocation request fails.

hpexp_rest_connect_timeout = 30

(Integer) Maximum wait time in seconds for REST API connection to complete.

hpexp_rest_disable_io_wait = True

(Boolean) It may take some time to detach volume after I/O. This option will allow detaching volume to complete immediately.

hpexp_rest_get_api_response_timeout = 1800

(Integer) Maximum wait time in seconds for a response against GET method of REST API.

hpexp_rest_job_api_response_timeout = 1800

(Integer) Maximum wait time in seconds for a response from REST API.

hpexp_rest_keep_session_loop_interval = 180

(Integer) Loop interval in seconds for keeping REST API session.

hpexp_rest_server_busy_timeout = 7200

(Integer) Maximum wait time in seconds when REST API returns busy.

hpexp_rest_tcp_keepalive = True

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

hpexp_rest_tcp_keepcnt = 4

(Integer) Maximum number of transmissions for TCP keepalive packet.

hpexp_rest_tcp_keepidle = 60

(Integer) Wait time in seconds for sending a first TCP keepalive packet.

hpexp_rest_tcp_keepintvl = 15

(Integer) Interval of transmissions in seconds for TCP keepalive packet.

hpexp_rest_timeout = 30

(Integer) Maximum wait time in seconds for REST API execution to complete.

hpexp_restore_timeout = 86400

(Integer) Maximum wait time in seconds for the restore operation to complete.

hpexp_snap_pool = None

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

hpexp_state_transition_timeout = 900

(Integer) Maximum wait time in seconds for a volume transition to complete.

hpexp_storage_id = None

(String) Product number of the storage system.

hpexp_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).

hpexp_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

  • hpexp_storage_id

    Product number of the storage system.

  • hpexp_pools

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