From 23660015de11973b36954fd192c48dc676570165 Mon Sep 17 00:00:00 2001 From: raghavendrat Date: Mon, 30 Sep 2024 07:08:20 +0000 Subject: [PATCH] HPE 3PAR: Add HPE Alletra MP related information 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 --- cinder/volume/drivers/hpe/hpe_3par_common.py | 30 +++---- .../block-storage/drivers/hpe-3par-driver.rst | 78 ++++++++++--------- ...-add-alletra-mp-info-3ed7f5160bf58dbe.yaml | 7 ++ 3 files changed, 65 insertions(+), 50 deletions(-) create mode 100644 releasenotes/notes/hpe-3par-add-alletra-mp-info-3ed7f5160bf58dbe.yaml diff --git a/cinder/volume/drivers/hpe/hpe_3par_common.py b/cinder/volume/drivers/hpe/hpe_3par_common.py index 799da394de6..14de0fd17a9 100644 --- a/cinder/volume/drivers/hpe/hpe_3par_common.py +++ b/cinder/volume/drivers/hpe/hpe_3par_common.py @@ -86,27 +86,30 @@ hpe3par_opts = [ cfg.StrOpt('hpe3par_api_url', default='', 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 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://:443/api/v1"), cfg.StrOpt('hpe3par_username', 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', default='', - help="3PAR/Primera/Alletra 9k password for the user specified " - "in hpe3par_username", + help="3PAR/Primera/Alletra 9k/Alletra MP password for the " + "user specified in hpe3par_username", secret=True), cfg.ListOpt('hpe3par_cpg', default=["OpenStack"], - help="List of the 3PAR/Primera/Alletra 9k CPG(s) to use for " - "volume creation"), + help="List of the 3PAR/Primera/Alletra 9k/Alletra MP CPG(s) " + "to use for volume creation"), cfg.StrOpt('hpe3par_cpg_snap', default="", - help="The 3PAR/Primera/Alletra 9k CPG to use for snapshots of " - "volumes. If empty the userCPG will be used."), + help="The 3PAR/Primera/Alletra 9k/Alletra MP CPG to use for " + "snapshots of volumes. If empty the userCPG will be used"), cfg.StrOpt('hpe3par_snapshot_retention', default="", help="The time in hours to retain a snapshot. " @@ -117,7 +120,8 @@ hpe3par_opts = [ " and is deleted. This must be larger than expiration"), cfg.BoolOpt('hpe3par_debug', 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', default=[], help="List of target iSCSI addresses to use."), @@ -126,9 +130,9 @@ hpe3par_opts = [ help="Enable CHAP authentication for iSCSI connections."), cfg.StrOpt('hpe3par_target_nsp', default="", - help="The nsp of 3PAR/Primera/Alletra 9k backend to be used " - "when: (1) multipath is not enabled in cinder.conf. " - "(2) Fiber Channel Zone Manager is not used. " + help="The nsp of 3PAR/Primera/Alletra 9k/Alletra MP backend to " + "be used when: (1) multipath is not enabled in cinder.conf" + ". (2) Fiber Channel Zone Manager is not used. " "(3) the backend is prezoned with this " "specific nsp only. For example if nsp is 2 1 2, the " "format of the option's value is 2:1:2"), diff --git a/doc/source/configuration/block-storage/drivers/hpe-3par-driver.rst b/doc/source/configuration/block-storage/drivers/hpe-3par-driver.rst index 06a9a97381e..c2ebf201b8c 100644 --- a/doc/source/configuration/block-storage/drivers/hpe-3par-driver.rst +++ b/doc/source/configuration/block-storage/drivers/hpe-3par-driver.rst @@ -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 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 use ``python-3parclient``, which is part of PyPi. -For information on HPE 3PAR, HPE Primera and HPE Alletra 9k Driver, refer to -`content kit page `_. +For information on HPE storage systems, +refer to `the Alletra Storage product page `_. System requirements ~~~~~~~~~~~~~~~~~~~ -To use the HPE 3PAR, HPE Primera and HPE Alletra 9k drivers, install the -following software and components on the HPE 3PAR storage system: +To use the HPE 3PAR, HPE Primera, HPE Alletra 9k and HPE Alletra MP drivers, +install the following software and components on the HPE 3PAR storage system: * 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 Storage service volume drivers. -To use the HPE Primera and HPE Alletra 9k backends, install the following -software and components on the HPE Primera storage system: +To use the HPE Primera, Alletra 9k and Alletra MP backends, install the +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 - combined as single option 'deco'. Due to this, only either 'thin' volume - or 'deco' volume can be created. + * HPE Primera: version 4.4.0 or higher. + * HPE Alletra 9k: version 9.4.0 or higher. + * HPE Alletra MP: version 10.4.2.23 or higher. - * Also, port number 443 is used instead of 8080. This only affects - cinder configuration. +* 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. -* Additionally, you must install the ``python-3parclient`` version 4.2.11 or +* Also, port number 443 is used instead of 8080. This only affects + cinder configuration. + +* Additionally, you must install the ``python-3parclient`` version 4.2.14 or newer from PyPi on the system with the enabled Block 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, 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 - not populated. + section of the cloned volume in the HPE 3PAR / Primera / Alletra 9k / + Alletra MP array is not populated. If volume types are not used or a particular key is not set for a volume type, 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 -The following keys require that the HPE 3PAR / Primera / Alletra 9k array -has a Priority Optimization enabled. +The following keys require that the HPE 3PAR/Primera/Alletra 9k/ +Alletra MP array has a Priority Optimization enabled. ``hpe3par:vvs`` 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 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 -an Adaptive Flash Cache enabled. +The following key requires that the HPE 3PAR/Primera/Alletra 9k/Alletra MP +array has an Adaptive Flash Cache enabled. * ``hpe3par:flash_cache`` - The flash-cache policy, which can be turned on and 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, the resulting volume defaults to thinly provisioned compressed volume. -* While creating volume on HPE Primera / Alletra 9k storage system, only below - two combinations are supported. If any other combination is used, then - volume is not created. +* While creating volume on HPE Primera/Alletra 9k/Alletra MP storage system, + only below two combinations are supported. If any other combination is used, + then volume is not created. * thin volume: provisioning = ``thin`` and compression = ``false`` * 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 - 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 - administrator access. + a. Log onto the HPE 3PAR / Primera / Alletra 9k / Alletra MP storage system + with administrator access. .. code-block:: console @@ -345,28 +349,28 @@ OpenStack software. other options run the :command:`setwsapi -h` command. #. 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 - volumes. + / Alletra 9k / Alletra MP storage system to be used as the default location + for creating volumes. #. Make the following changes in the ``/etc/cinder/cinder.conf`` file. .. code-block:: ini # 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: https://<3par ip>:8080/api/v1 - # Example 2: for Primera/Alletra 9k, URL is: - https://:443/api/v1 + # Example 2: for Primera/Alletra 9k/Alletra MP, URL is: + https://: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 - # 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 - # 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 # IP address of SAN controller for SSH access to the array @@ -397,7 +401,7 @@ OpenStack software. # Still available for single port iSCSI configuration #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 # Enable CHAP authentication for iSCSI connections. diff --git a/releasenotes/notes/hpe-3par-add-alletra-mp-info-3ed7f5160bf58dbe.yaml b/releasenotes/notes/hpe-3par-add-alletra-mp-info-3ed7f5160bf58dbe.yaml new file mode 100644 index 00000000000..a485e4b3cbd --- /dev/null +++ b/releasenotes/notes/hpe-3par-add-alletra-mp-info-3ed7f5160bf58dbe.yaml @@ -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. +