openstack/cinder
Code Issues Proposed changes

HPE 3PAR: Add HPE Alletra MP related information

Browse Source 
In documentation, added information for using HPE Alletra MP
storage system. HPE Alletra MP is newer version of existing
HPE Alletra 9k storage system.

Change-Id: I136506634c62525c89d0b80f0fcdcb63bf4c5302
This commit is contained in:
raghavendrat 2024-09-30 07:08:20 +00:00
parent b07e4147f9
commit 23660015de
3 changed files with 65 additions and 50 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
cinder/volume/drivers/hpe/hpe_3par_common.py
View File

@ -86,27 +86,30 @@ hpe3par_opts = [
cfg.StrOpt('hpe3par_api_url', cfg.StrOpt('hpe3par_api_url',
default='', default='',
help="WSAPI Server URL. " help="WSAPI Server URL. "
"This setting applies to: 3PAR, Primera and Alletra 9k " "This setting applies to: 3PAR, Primera, Alletra 9k and "
"Alletra MP"
"\n Example 1: for 3PAR, URL is: " "\n Example 1: for 3PAR, URL is: "
"\n https://<3par ip>:8080/api/v1 " "\n https://<3par ip>:8080/api/v1 "
"\n Example 2: for Primera/Alletra 9k, URL is: " "\n Example 2: for Primera/Alletra 9k/Alletra MP, "
"URL is: "
"\n https://<primera ip>:443/api/v1"), "\n https://<primera ip>:443/api/v1"),
cfg.StrOpt('hpe3par_username', cfg.StrOpt('hpe3par_username',
default='', default='',
help="3PAR/Primera/Alletra 9k username with the 'edit' role"), help="3PAR/Primera/Alletra 9k/Alletra MP username with the "
"'edit' role"),
cfg.StrOpt('hpe3par_password', cfg.StrOpt('hpe3par_password',
default='', default='',
help="3PAR/Primera/Alletra 9k password for the user specified " help="3PAR/Primera/Alletra 9k/Alletra MP password for the "
"in hpe3par_username", "user specified in hpe3par_username",
secret=True), secret=True),
cfg.ListOpt('hpe3par_cpg', cfg.ListOpt('hpe3par_cpg',
default=["OpenStack"], default=["OpenStack"],
help="List of the 3PAR/Primera/Alletra 9k CPG(s) to use for " help="List of the 3PAR/Primera/Alletra 9k/Alletra MP CPG(s) "
"volume creation"), "to use for volume creation"),
cfg.StrOpt('hpe3par_cpg_snap', cfg.StrOpt('hpe3par_cpg_snap',
default="", default="",
help="The 3PAR/Primera/Alletra 9k CPG to use for snapshots of " help="The 3PAR/Primera/Alletra 9k/Alletra MP CPG to use for "
"volumes. If empty the userCPG will be used."), "snapshots of volumes. If empty the userCPG will be used"),
cfg.StrOpt('hpe3par_snapshot_retention', cfg.StrOpt('hpe3par_snapshot_retention',
default="", default="",
help="The time in hours to retain a snapshot. " help="The time in hours to retain a snapshot. "
@ -117,7 +120,8 @@ hpe3par_opts = [
" and is deleted. This must be larger than expiration"), " and is deleted. This must be larger than expiration"),
cfg.BoolOpt('hpe3par_debug', cfg.BoolOpt('hpe3par_debug',
default=False, default=False,
help="Enable HTTP debugging to 3PAR/Primera/Alletra 9k"), help="Enable HTTP debugging to 3PAR/Primera/Alletra 9k/"
"Alletra MP"),
cfg.ListOpt('hpe3par_iscsi_ips', cfg.ListOpt('hpe3par_iscsi_ips',
default=[], default=[],
help="List of target iSCSI addresses to use."), help="List of target iSCSI addresses to use."),
@ -126,9 +130,9 @@ hpe3par_opts = [
help="Enable CHAP authentication for iSCSI connections."), help="Enable CHAP authentication for iSCSI connections."),
cfg.StrOpt('hpe3par_target_nsp', cfg.StrOpt('hpe3par_target_nsp',
default="", default="",
help="The nsp of 3PAR/Primera/Alletra 9k backend to be used " help="The nsp of 3PAR/Primera/Alletra 9k/Alletra MP backend to "
"when: (1) multipath is not enabled in cinder.conf. " "be used when: (1) multipath is not enabled in cinder.conf"
"(2) Fiber Channel Zone Manager is not used. " ". (2) Fiber Channel Zone Manager is not used. "
"(3) the backend is prezoned with this " "(3) the backend is prezoned with this "
"specific nsp only. For example if nsp is 2 1 2, the " "specific nsp only. For example if nsp is 2 1 2, the "
"format of the option's value is 2:1:2"), "format of the option's value is 2:1:2"),

76
doc/source/configuration/block-storage/drivers/hpe-3par-driver.rst
View File

@ -1,6 +1,6 @@
=============================================== ===============================================================
HPE 3PAR, HPE Primera and HPE Alletra 9k Driver HPE 3PAR, HPE Primera, HPE Alletra 9k and HPE Alletra MP Driver
=============================================== ===============================================================
The ``HPE3PARFCDriver`` and ``HPE3PARISCSIDriver`` drivers, which are based on The ``HPE3PARFCDriver`` and ``HPE3PARISCSIDriver`` drivers, which are based on
the Block Storage service (Cinder) plug-in architecture, run volume operations the Block Storage service (Cinder) plug-in architecture, run volume operations
@ -8,14 +8,14 @@ by communicating with the HPE 3PAR, HPE Primera and HPE Alletra 9k storage
systems over HTTP, HTTPS, and SSH connections. The HTTP & HTTPS communications systems over HTTP, HTTPS, and SSH connections. The HTTP & HTTPS communications
use ``python-3parclient``, which is part of PyPi. use ``python-3parclient``, which is part of PyPi.
For information on HPE 3PAR, HPE Primera and HPE Alletra 9k Driver, refer to For information on HPE storage systems,
`content kit page <https://www.hpe.com/us/en/product-catalog/storage/storage-software/pip.openstack-device-management-software.1008537377.html>`_. refer to `the Alletra Storage product page <https://buy.hpe.com/us/en/storage/disk-storage-systems/alletra-storage-arrays/c/1013540066>`_.
System requirements System requirements
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
To use the HPE 3PAR, HPE Primera and HPE Alletra 9k drivers, install the To use the HPE 3PAR, HPE Primera, HPE Alletra 9k and HPE Alletra MP drivers,
following software and components on the HPE 3PAR storage system: install the following software and components on the HPE 3PAR storage system:
* HPE 3PAR Operating System software version 3.1.3 MU1 or higher. * HPE 3PAR Operating System software version 3.1.3 MU1 or higher.
@ -60,19 +60,23 @@ following software and components on the HPE 3PAR storage system:
newer from PyPi on the system with the enabled Block newer from PyPi on the system with the enabled Block
Storage service volume drivers. Storage service volume drivers.
To use the HPE Primera and HPE Alletra 9k backends, install the following To use the HPE Primera, Alletra 9k and Alletra MP backends, install the
software and components on the HPE Primera storage system: following software and components on the HPE storage system:
* HPE Primera Operating System software version 4.0.0 or higher. * Operating System software:
* On HPE Primera/Alletra 9k storage system, Dedup & Compression is * HPE Primera: version 4.4.0 or higher.
combined as single option 'deco'. Due to this, only either 'thin' volume * HPE Alletra 9k: version 9.4.0 or higher.
or 'deco' volume can be created. * HPE Alletra MP: version 10.4.2.23 or higher.
* Also, port number 443 is used instead of 8080. This only affects * On HPE Primera/Alletra 9k/Alletra MP storage system, Dedup & Compression
is combined as single option 'deco'. Due to this, only either 'thin'
volume or 'deco' volume can be created.
* Also, port number 443 is used instead of 8080. This only affects
cinder configuration. cinder configuration.
* Additionally, you must install the ``python-3parclient`` version 4.2.11 or * Additionally, you must install the ``python-3parclient`` version 4.2.14 or
newer from PyPi on the system with the enabled Block newer from PyPi on the system with the enabled Block
Storage service volume drivers. Storage service volume drivers.
@ -158,8 +162,8 @@ pairs and associate them with a volume type, run the following command:
Volumes that are cloned only support the extra specs keys cpg, snap_cpg, Volumes that are cloned only support the extra specs keys cpg, snap_cpg,
provisioning and vvs. The others are ignored. In addition the comments provisioning and vvs. The others are ignored. In addition the comments
section of the cloned volume in the HPE 3PAR / Primera / Alletra 9k array is section of the cloned volume in the HPE 3PAR / Primera / Alletra 9k /
not populated. Alletra MP array is not populated.
If volume types are not used or a particular key is not set for a volume type, If volume types are not used or a particular key is not set for a volume type,
the following defaults are used: the following defaults are used:
@ -216,8 +220,8 @@ pairs and associate them with a volume type, run the following commands:
$ openstack help volume qos $ openstack help volume qos
The following keys require that the HPE 3PAR / Primera / Alletra 9k array The following keys require that the HPE 3PAR/Primera/Alletra 9k/
has a Priority Optimization enabled. Alletra MP array has a Priority Optimization enabled.
``hpe3par:vvs`` ``hpe3par:vvs``
The virtual volume set name that has been predefined by the Administrator The virtual volume set name that has been predefined by the Administrator
@ -254,8 +258,8 @@ has a Priority Optimization enabled.
set I/O limits. Similarly, minBWS and maxBWS must be used together. If only set I/O limits. Similarly, minBWS and maxBWS must be used together. If only
one is set the other will be set to the same value. one is set the other will be set to the same value.
The following key requires that the HPE 3PAR / Primera / Alletra 9k array has The following key requires that the HPE 3PAR/Primera/Alletra 9k/Alletra MP
an Adaptive Flash Cache enabled. array has an Adaptive Flash Cache enabled.
* ``hpe3par:flash_cache`` - The flash-cache policy, which can be turned on and * ``hpe3par:flash_cache`` - The flash-cache policy, which can be turned on and
off by setting the value to ``true`` or ``false``. off by setting the value to ``true`` or ``false``.
@ -273,9 +277,9 @@ Other restrictions and considerations for ``hpe3par:compression``:
if a compression is enabled and provisioning type requested is full, if a compression is enabled and provisioning type requested is full,
the resulting volume defaults to thinly provisioned compressed volume. the resulting volume defaults to thinly provisioned compressed volume.
* While creating volume on HPE Primera / Alletra 9k storage system, only below * While creating volume on HPE Primera/Alletra 9k/Alletra MP storage system,
two combinations are supported. If any other combination is used, then only below two combinations are supported. If any other combination is used,
volume is not created. then volume is not created.
* thin volume: provisioning = ``thin`` and compression = ``false`` * thin volume: provisioning = ``thin`` and compression = ``false``
* deco volume: provisioning = ``dedup`` and compression = ``true`` * deco volume: provisioning = ``dedup`` and compression = ``true``
@ -304,10 +308,10 @@ OpenStack software.
#. Verify that the HPE 3PAR Web Services API server is enabled and running on #. Verify that the HPE 3PAR Web Services API server is enabled and running on
the HPE 3PAR / Primera / Alletra 9k storage system. the HPE 3PAR / Primera / Alletra 9k / Alletra MP storage system.
a. Log onto the HPE 3PAR / Primera / Alletra 9k storage system with a. Log onto the HPE 3PAR / Primera / Alletra 9k / Alletra MP storage system
administrator access. with administrator access.
.. code-block:: console .. code-block:: console
@ -345,28 +349,28 @@ OpenStack software.
other options run the :command:`setwsapi -h` command. other options run the :command:`setwsapi -h` command.
#. If you are not using an existing CPG, create a CPG on the HPE 3PAR / Primera #. If you are not using an existing CPG, create a CPG on the HPE 3PAR / Primera
/ Alletra 9k storage system to be used as the default location for creating / Alletra 9k / Alletra MP storage system to be used as the default location
volumes. for creating volumes.
#. Make the following changes in the ``/etc/cinder/cinder.conf`` file. #. Make the following changes in the ``/etc/cinder/cinder.conf`` file.
.. code-block:: ini .. code-block:: ini
# WSAPI Server URL. # WSAPI Server URL.
# This setting applies to all: 3PAR, Primera and Alletra 9k. # This setting applies to all: 3PAR, Primera, Alletra 9k and Alletra MP.
# Example 1: for 3PAR, URL is: # Example 1: for 3PAR, URL is:
https://<3par ip>:8080/api/v1 https://<3par ip>:8080/api/v1
# Example 2: for Primera/Alletra 9k, URL is: # Example 2: for Primera/Alletra 9k/Alletra MP, URL is:
https://<primera/alletra_9k ip>:443/api/v1 https://<primera/alletra_9k/alletra_mp ip>:443/api/v1
# 3PAR / Primera / Alletra 9k username with the 'edit' role # 3PAR / Primera / Alletra 9k / Alletra MP username with the 'edit' role
hpe3par_username=edit3par hpe3par_username=edit3par
# 3PAR / Primera / Alletra 9k password for the user specified in hpe3par_username # 3PAR / Primera / Alletra 9k / Alletra MP password for the user specified in hpe3par_username
hpe3par_password=3parpass hpe3par_password=3parpass
# 3PAR / Primera / Alletra 9k CPG to use for volume creation # 3PAR / Primera / Alletra 9k / Alletra MP CPG to use for volume creation
hpe3par_cpg=OpenStackCPG_RAID5_NL hpe3par_cpg=OpenStackCPG_RAID5_NL
# IP address of SAN controller for SSH access to the array # IP address of SAN controller for SSH access to the array
@ -397,7 +401,7 @@ OpenStack software.
# Still available for single port iSCSI configuration # Still available for single port iSCSI configuration
#iscsi_ip_address=10.10.220.253 #iscsi_ip_address=10.10.220.253
# Enable HTTP debugging to 3PAR / Primera / Alletra 9k # Enable HTTP debugging to 3PAR / Primera / Alletra 9k / Alletra MP
hpe3par_debug=False hpe3par_debug=False
# Enable CHAP authentication for iSCSI connections. # Enable CHAP authentication for iSCSI connections.

7
releasenotes/notes/hpe-3par-add-alletra-mp-info-3ed7f5160bf58dbe.yaml Normal file
View File

@ -0,0 +1,7 @@
---
other:
- |
HPE 3PAR: Documented that existing driver supports the new Alletra MP
backend. HPE Alletra MP is newer version of existing HPE Alletra 9k
backend.