openstack/cinder
Code Issues Proposed changes

Merge "HPE 3PAR: Add HPE Alletra 9k related information"

Browse Source
This commit is contained in:
Zuul 2021-09-07 18:06:16 +00:00 committed by Gerrit Code Review
commit d81a838639
3 changed files with 50 additions and 45 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -86,27 +86,27 @@ 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 both 3PAR and Primera. " "This setting applies to: 3PAR, Primera and Alletra 9k "
"\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, URL is: " "\n Example 2: for Primera/Alletra 9k, 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 username with the 'edit' role"), help="3PAR/Primera/Alletra 9k username with the 'edit' role"),
cfg.StrOpt('hpe3par_password', cfg.StrOpt('hpe3par_password',
default='', default='',
help="3PAR / Primera password for the user specified " help="3PAR/Primera/Alletra 9k password for the user specified "
"in hpe3par_username", "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 CPG(s) to use for " help="List of the 3PAR/Primera/Alletra 9k CPG(s) to use for "
"volume creation"), "volume creation"),
cfg.StrOpt('hpe3par_cpg_snap', cfg.StrOpt('hpe3par_cpg_snap',
default="", default="",
help="The 3PAR / Primera CPG to use for snapshots of volumes. " help="The 3PAR/Primera/Alletra 9k CPG to use for snapshots of "
"If empty the userCPG will be used."), "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 +117,7 @@ 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"), help="Enable HTTP debugging to 3PAR/Primera/Alletra 9k"),
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,10 +126,10 @@ 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 backend to be used when: " help="The nsp of 3PAR/Primera/Alletra 9k backend to be used "
"(1) multipath is not enabled in cinder.conf. " "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 3PAR 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"),
] ]

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

@ -1,21 +1,21 @@
==================================================== ===============================================
HPE 3PAR and HPE Primera Driver for OpenStack Cinder HPE 3PAR, HPE Primera and HPE Alletra 9k 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
by communicating with the HPE 3PAR and HPE Primera storage system over HTTP, by communicating with the HPE 3PAR, HPE Primera and HPE Alletra 9k storage
HTTPS, and SSH connections. The HTTP and HTTPS communications use systems over HTTP, HTTPS, and SSH connections. The HTTP & HTTPS communications
``python-3parclient``, which is part of PyPi. use ``python-3parclient``, which is part of PyPi.
For information on HPE 3PAR and HPE Primera Driver for OpenStack Cinder, refer to For information on HPE 3PAR, HPE Primera and HPE Alletra 9k Driver, refer to
`content kit page <https://www.hpe.com/us/en/product-catalog/storage/storage-software/pip.openstack-device-management-software.1008537377.html>`_. `content kit page <https://www.hpe.com/us/en/product-catalog/storage/storage-software/pip.openstack-device-management-software.1008537377.html>`_.
System requirements System requirements
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~
To use the HPE 3PAR and HPE Primera drivers, install the following software To use the HPE 3PAR, HPE Primera and HPE Alletra 9k drivers, install the
and components on the HPE 3PAR storage system: 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,14 +60,14 @@ 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 backend, install the following software and components To use the HPE Primera and HPE Alletra 9k backends, install the following
on the HPE Primera storage system: software and components on the HPE Primera storage system:
* HPE Primera Operating System software version 4.0.0. * HPE Primera Operating System software version 4.0.0 or higher.
* On HPE Primera storage system, Dedup & Compression is combined as single * On HPE Primera/Alletra 9k storage system, Dedup & Compression is
option 'deco'. Due to this, only either 'thin' volume or 'deco' volume combined as single option 'deco'. Due to this, only either 'thin' volume
can be created. or 'deco' volume can be created.
* Also, port number 443 is used instead of 8080. This only affects * Also, port number 443 is used instead of 8080. This only affects
cinder configuration. cinder configuration.
@ -158,7 +158,7 @@ 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 / HPE Primera array is section of the cloned volume in the HPE 3PAR / Primera / Alletra 9k array is
not populated. 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,
@ -216,8 +216,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 / HPE Primera array has a The following keys require that the HPE 3PAR / Primera / Alletra 9k array
Priority Optimization enabled. 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 +254,8 @@ 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 / HPE Primera array has an The following key requires that the HPE 3PAR / Primera / Alletra 9k array has
Adaptive Flash Cache enabled. 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,8 +273,8 @@ 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 storage system, only below two * While creating volume on HPE Primera / Alletra 9k storage system, only below
combinations are supported. If any other combination is used, then two combinations are supported. If any other combination is used, then
volume is not created. volume is not created.
* thin volume: provisioning = ``thin`` and compression = ``false`` * thin volume: provisioning = ``thin`` and compression = ``false``
@ -304,10 +304,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 / HPE Primera storage system. the HPE 3PAR / Primera / Alletra 9k storage system.
a. Log onto the HPE 3PAR / HPE Primera storage system with administrator a. Log onto the HPE 3PAR / Primera / Alletra 9k storage system with
access. administrator access.
.. code-block:: console .. code-block:: console
@ -344,28 +344,28 @@ OpenStack software.
To stop the Web Services API Server, use the :command:`stopwsapi` command. For To stop the Web Services API Server, use the :command:`stopwsapi` command. For
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 / HPE #. If you are not using an existing CPG, create a CPG on the HPE 3PAR / Primera
Primera storage system to be used as the default location for creating volumes. / Alletra 9k storage system to be used as the default location 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 both 3PAR and Primera. # This setting applies to all: 3PAR, Primera and Alletra 9k.
# 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, URL is: # Example 2: for Primera/Alletra 9k, URL is:
https://<primera ip>:443/api/v1 https://<primera/alletra_9k ip>:443/api/v1
# 3PAR / Primera username with the 'edit' role # 3PAR / Primera / Alletra 9k username with the 'edit' role
hpe3par_username=edit3par hpe3par_username=edit3par
# 3PAR / Primera password for the user specified in hpe3par_username # 3PAR / Primera / Alletra 9k password for the user specified in hpe3par_username
hpe3par_password=3parpass hpe3par_password=3parpass
# 3PAR / Primera CPG to use for volume creation # 3PAR / Primera / Alletra 9k 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
@ -396,7 +396,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 # Enable HTTP debugging to 3PAR / Primera / Alletra 9k
hpe3par_debug=False hpe3par_debug=False
# Enable CHAP authentication for iSCSI connections. # Enable CHAP authentication for iSCSI connections.

5
releasenotes/notes/hpe-3par-add-alletra-9k-info-5e1d09e083d3faa9.yaml Normal file
View File

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