summaryrefslogtreecommitdiffstats
path: root/ansible_collections/dellemc/powerflex/docs
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-26 06:22:20 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-26 06:22:20 +0000
commit18bd2207b6c1977e99a93673a7be099e23f0f547 (patch)
tree40fd9e5913462a88be6ba24be6953383c5b39874 /ansible_collections/dellemc/powerflex/docs
parentReleasing progress-linux version 10.0.1+dfsg-1~progress7.99u1. (diff)
downloadansible-18bd2207b6c1977e99a93673a7be099e23f0f547.tar.xz
ansible-18bd2207b6c1977e99a93673a7be099e23f0f547.zip
Merging upstream version 10.1.0+dfsg.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'ansible_collections/dellemc/powerflex/docs')
-rw-r--r--ansible_collections/dellemc/powerflex/docs/CONTRIBUTING.md8
-rw-r--r--ansible_collections/dellemc/powerflex/docs/INSTALLATION.md4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/ISSUE_TRIAGE.md6
-rw-r--r--ansible_collections/dellemc/powerflex/docs/MAINTAINERS.md3
-rw-r--r--ansible_collections/dellemc/powerflex/docs/MAINTAINER_GUIDE.md2
-rw-r--r--ansible_collections/dellemc/powerflex/docs/Release Notes.md14
-rw-r--r--ansible_collections/dellemc/powerflex/docs/SECURITY.md2
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/device.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/fault_set.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/info.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/mdm_cluster.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/protection_domain.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/replication_consistency_group.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/replication_pair.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/resource_group.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/sdc.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/sds.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/snapshot.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/snapshot_policy.rst4
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/storagepool.rst252
-rw-r--r--ansible_collections/dellemc/powerflex/docs/modules/volume.rst4
21 files changed, 253 insertions, 90 deletions
diff --git a/ansible_collections/dellemc/powerflex/docs/CONTRIBUTING.md b/ansible_collections/dellemc/powerflex/docs/CONTRIBUTING.md
index 84531753a..12ce41fec 100644
--- a/ansible_collections/dellemc/powerflex/docs/CONTRIBUTING.md
+++ b/ansible_collections/dellemc/powerflex/docs/CONTRIBUTING.md
@@ -10,7 +10,7 @@ You may obtain a copy of the License at
# How to contribute
-Become one of the contributors to this project! We thrive to build a welcoming and open community for anyone who wants to use the project or contribute to it. There are just a few small guidelines you need to follow. To help us create a safe and positive community experience for all, we require all participants to adhere to the [Code of Conduct](https://github.com/dell/ansible-powerflex/blob/2.4.0/CODE_OF_CONDUCT.md).
+Become one of the contributors to this project! We thrive to build a welcoming and open community for anyone who wants to use the project or contribute to it. There are just a few small guidelines you need to follow. To help us create a safe and positive community experience for all, we require all participants to adhere to the [Code of Conduct](https://github.com/dell/ansible-powerflex/blob/main/CODE_OF_CONDUCT.md).
## Table of contents
@@ -76,7 +76,7 @@ Triage helps ensure that issues resolve quickly by:
If you don't have the knowledge or time to code, consider helping with _issue triage_. The Ansible modules for Dell PowerFlex community will thank you for saving them time by spending some of yours.
-Read more about the ways you can [Triage issues](https://github.com/dell/ansible-powerflex/blob/2.4.0/ISSUE_TRIAGE.md).
+Read more about the ways you can [Triage issues](https://github.com/dell/ansible-powerflex/blob/main/ISSUE_TRIAGE.md).
## Your first contribution
@@ -89,7 +89,7 @@ When you're ready to contribute, it's time to create a pull request.
## Branching
-* [Branching Strategy for Ansible modules for Dell PowerFlex](https://github.com/dell/ansible-powerflex/blob/2.4.0/BRANCHING.md)
+* [Branching Strategy for Ansible modules for Dell PowerFlex](https://github.com/dell/ansible-powerflex/blob/main/BRANCHING.md)
## Signing your commits
@@ -144,7 +144,7 @@ Make sure that the title for your pull request uses the same format as the subje
### Quality gates for pull requests
-GitHub Actions are used to enforce quality gates when a pull request is created or when any commit is made to the pull request. These GitHub Actions enforce our minimum code quality requirement for any code that get checked into the repository. If any of the quality gates fail, it is expected that the contributor will look into the check log, understand the problem and resolve the issue. If help is needed, please feel free to reach out the maintainers of the project for [support](https://github.com/dell/ansible-powerflex/blob/2.4.0/SUPPORT.md).
+GitHub Actions are used to enforce quality gates when a pull request is created or when any commit is made to the pull request. These GitHub Actions enforce our minimum code quality requirement for any code that get checked into the repository. If any of the quality gates fail, it is expected that the contributor will look into the check log, understand the problem and resolve the issue. If help is needed, please feel free to reach out the maintainers of the project for [support](https://github.com/dell/ansible-powerflex/blob/main/SUPPORT.md).
#### Code sanitization
diff --git a/ansible_collections/dellemc/powerflex/docs/INSTALLATION.md b/ansible_collections/dellemc/powerflex/docs/INSTALLATION.md
index c2b8df3ba..f3e0e1c01 100644
--- a/ansible_collections/dellemc/powerflex/docs/INSTALLATION.md
+++ b/ansible_collections/dellemc/powerflex/docs/INSTALLATION.md
@@ -41,7 +41,7 @@ You may obtain a copy of the License at
* Download the latest tar build from any of the available distribution channel [Ansible Galaxy](https://galaxy.ansible.com/dellemc/powerflex) /[Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/dellemc/powerflex) and use this command to install the collection anywhere in your system:
- ansible-galaxy collection install dellemc-powerflex-2.4.0.tar.gz -p <install_path>
+ ansible-galaxy collection install dellemc-powerflex-2.5.0.tar.gz -p <install_path>
* Set the environment variable:
@@ -68,7 +68,7 @@ You may obtain a copy of the License at
## Ansible modules execution
-The Ansible server must be configured with Python library for PowerFlex to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powerflex/blob/2.4.0/docs/) provide information on different Ansible modules along with their functions and syntax. The parameters table in the Product Guide provides information on various parameters which needs to be configured before running the modules.
+The Ansible server must be configured with Python library for PowerFlex to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powerflex/blob/main/docs/) provide information on different Ansible modules along with their functions and syntax. The parameters table in the Product Guide provides information on various parameters which needs to be configured before running the modules.
## SSL certificate validation
diff --git a/ansible_collections/dellemc/powerflex/docs/ISSUE_TRIAGE.md b/ansible_collections/dellemc/powerflex/docs/ISSUE_TRIAGE.md
index 50d4665ef..317216157 100644
--- a/ansible_collections/dellemc/powerflex/docs/ISSUE_TRIAGE.md
+++ b/ansible_collections/dellemc/powerflex/docs/ISSUE_TRIAGE.md
@@ -41,10 +41,10 @@ This section describes the various issue templates and the expected content.
Should explain what happened, what was expected and how to reproduce it together with any additional information that may help giving a complete picture of what happened such as screenshots, output and any environment related information that's applicable and/or maybe related to the reported problem:
- - Ansible Version: [e.g. 2.14]
+ - Ansible Version: [e.g. 2.15]
- Python Version [e.g. 3.11]
- - Ansible modules for Dell PowerFlex Version: [e.g. 2.4.0]
- - PowerFlex SDK version: [e.g. PyPowerFlex 1.11.0]
+ - Ansible modules for Dell PowerFlex Version: [e.g. 2.5.0]
+ - PowerFlex SDK version: [e.g. PyPowerFlex 1.12.0]
- Any other additional information...
#### Feature requests
diff --git a/ansible_collections/dellemc/powerflex/docs/MAINTAINERS.md b/ansible_collections/dellemc/powerflex/docs/MAINTAINERS.md
index 4679f6d73..6f0c6100e 100644
--- a/ansible_collections/dellemc/powerflex/docs/MAINTAINERS.md
+++ b/ansible_collections/dellemc/powerflex/docs/MAINTAINERS.md
@@ -9,10 +9,7 @@ You may obtain a copy of the License at
-->
# Maintainers
-
-* Ananthu Kuttattu (kuttattz)
* Bhavneet Sharma (Bhavneet-Sharma)
* Jennifer John (Jennifer-John)
* Meenakshi Dembi (meenakshidembi691)
-* Pavan Mudunuri (Pavan-Mudunuri)
* Trisha Datta (trisha-dell)
diff --git a/ansible_collections/dellemc/powerflex/docs/MAINTAINER_GUIDE.md b/ansible_collections/dellemc/powerflex/docs/MAINTAINER_GUIDE.md
index 5f982c2f9..2832c9791 100644
--- a/ansible_collections/dellemc/powerflex/docs/MAINTAINER_GUIDE.md
+++ b/ansible_collections/dellemc/powerflex/docs/MAINTAINER_GUIDE.md
@@ -27,7 +27,7 @@ If a candidate is approved, a Maintainer contacts the candidate to invite them t
## Maintainer policies
* Lead by example
-* Follow the [Code of Conduct](https://github.com/dell/ansible-powerflex/blob/2.4.0/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powerflex/blob/2.4.0/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powerflex/blob/2.4.0/COMMITTER_GUIDE.md) guides
+* Follow the [Code of Conduct](https://github.com/dell/ansible-powerflex/blob/main/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powerflex/blob/main/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powerflex/blob/main/COMMITTER_GUIDE.md) guides
* Promote a friendly and collaborative environment within our community
* Be actively engaged in discussions, answering questions, updating defects, and reviewing pull requests
* Criticize code, not people. Ideally, tell the contributor a better way to do what they need.
diff --git a/ansible_collections/dellemc/powerflex/docs/Release Notes.md b/ansible_collections/dellemc/powerflex/docs/Release Notes.md
index 1a2552326..36cf06f97 100644
--- a/ansible_collections/dellemc/powerflex/docs/Release Notes.md
+++ b/ansible_collections/dellemc/powerflex/docs/Release Notes.md
@@ -1,6 +1,6 @@
**Ansible Modules for Dell Technologies PowerFlex**
=========================================
-### Release notes 2.4.0
+### Release notes 2.5.0
> © 2024 Dell Inc. or its subsidiaries. All rights reserved. Dell
> and other trademarks are trademarks of Dell Inc. or its
@@ -28,7 +28,7 @@ Table 1. Revision history
| Revision | Date | Description |
|----------|-----------------|-------------------------------------------------------------|
-| 01 | April 2024 | Current release of Ansible Modules for Dell PowerFlex 2.4.0 |
+| 01 | May 2024 | Current release of Ansible Modules for Dell PowerFlex 2.5.0 |
Product description
-------------------
@@ -44,10 +44,8 @@ each of the entities.
New features and enhancements
-----------------------------
Along with the previous release deliverables, this release supports following features -
-- Added support for executing Ansible PowerFlex modules and roles on AWS environment.
-- Added support for resource group provisioning to validate, deploy, edit, add nodes and delete a resource group.
-- The Info module is enhanced to list out all the firmware repository.
-- Added support for PowerFlex ansible modules and roles on Azure.
+ - The storage pool module has been enhanced to support more features.
+ - Fixed the roles to support attaching the MDM cluster to the gateway.
Known issues
------------
@@ -63,11 +61,11 @@ Limitations
Distribution
------------
The software package is available for download from the [Ansible Modules
-for PowerFlex GitHub](https://github.com/dell/ansible-powerflex/tree/2.4.0) page.
+for PowerFlex GitHub](https://github.com/dell/ansible-powerflex/tree/main) page.
Documentation
-------------
-The documentation is available on [Ansible Modules for PowerFlex GitHub](https://github.com/dell/ansible-powerflex/tree/2.4.0/docs)
+The documentation is available on [Ansible Modules for PowerFlex GitHub](https://github.com/dell/ansible-powerflex/tree/main/docs)
page. It includes the following:
- README
diff --git a/ansible_collections/dellemc/powerflex/docs/SECURITY.md b/ansible_collections/dellemc/powerflex/docs/SECURITY.md
index a7eab1ba4..b2de265bb 100644
--- a/ansible_collections/dellemc/powerflex/docs/SECURITY.md
+++ b/ansible_collections/dellemc/powerflex/docs/SECURITY.md
@@ -12,7 +12,7 @@ You may obtain a copy of the License at
The Ansible modules for Dell PowerFlex repository are inspected for security vulnerabilities via blackduck scans and static code analysis.
-In addition to this, there are various security checks that get executed against a branch when a pull request is created/updated. Please refer to [pull request](https://github.com/dell/ansible-powerflex/blob/2.4.0/docs/CONTRIBUTING.md#Pull-requests) for more information.
+In addition to this, there are various security checks that get executed against a branch when a pull request is created/updated. Please refer to [pull request](https://github.com/dell/ansible-powerflex/blob/main/docs/CONTRIBUTING.md#Pull-requests) for more information.
## Reporting a vulnerability
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/device.rst b/ansible_collections/dellemc/powerflex/docs/modules/device.rst
index cbeb0f813..9eccc2627 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/device.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/device.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/fault_set.rst b/ansible_collections/dellemc/powerflex/docs/modules/fault_set.rst
index 191ab73ca..d1d5fb321 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/fault_set.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/fault_set.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/info.rst b/ansible_collections/dellemc/powerflex/docs/modules/info.rst
index fd674804f..49c1f0f77 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/info.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/info.rst
@@ -23,9 +23,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/mdm_cluster.rst b/ansible_collections/dellemc/powerflex/docs/modules/mdm_cluster.rst
index fa73ae5d6..4c64170f3 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/mdm_cluster.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/mdm_cluster.rst
@@ -23,9 +23,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/protection_domain.rst b/ansible_collections/dellemc/powerflex/docs/modules/protection_domain.rst
index 0bd532b9a..10acf4b23 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/protection_domain.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/protection_domain.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/replication_consistency_group.rst b/ansible_collections/dellemc/powerflex/docs/modules/replication_consistency_group.rst
index d8d144077..f60ce5bdb 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/replication_consistency_group.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/replication_consistency_group.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/replication_pair.rst b/ansible_collections/dellemc/powerflex/docs/modules/replication_pair.rst
index 7c883c6fd..9da3699fc 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/replication_pair.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/replication_pair.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/resource_group.rst b/ansible_collections/dellemc/powerflex/docs/modules/resource_group.rst
index a72918d83..3a0d9cd34 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/resource_group.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/resource_group.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/sdc.rst b/ansible_collections/dellemc/powerflex/docs/modules/sdc.rst
index 7b0871b30..6d4003f69 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/sdc.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/sdc.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/sds.rst b/ansible_collections/dellemc/powerflex/docs/modules/sds.rst
index 188fe9f9a..cd2730ceb 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/sds.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/sds.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/snapshot.rst b/ansible_collections/dellemc/powerflex/docs/modules/snapshot.rst
index e09e80069..f44b3272f 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/snapshot.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/snapshot.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/snapshot_policy.rst b/ansible_collections/dellemc/powerflex/docs/modules/snapshot_policy.rst
index dd683c921..21823e96d 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/snapshot_policy.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/snapshot_policy.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/storagepool.rst b/ansible_collections/dellemc/powerflex/docs/modules/storagepool.rst
index f9f3f271f..1cc9717bc 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/storagepool.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/storagepool.rst
@@ -21,9 +21,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.
@@ -80,6 +78,163 @@ Parameters
Enable/Disable RMcache on a specific storage pool.
+ enable_zero_padding (optional, bool, None)
+ Enable/Disable zero padding on a specific storage pool.
+
+
+ rep_cap_max_ratio (optional, int, None)
+ Set replication journal capacity of a storage pool.
+
+
+ enable_rebalance (optional, bool, None)
+ Enable/Disable rebalance on a specific storage pool.
+
+
+ spare_percentage (optional, int, None)
+ Set the spare percentage of a specific storage pool.
+
+
+ rmcache_write_handling_mode (optional, str, Cached)
+ Set RM cache write handling mode of a storage pool.
+
+ *Passthrough* Writes skip the cache and are stored in storage only.
+
+ *Cached* Writes are stored in both cache and storage (the default).
+
+ Caching is only performed for IOs whose size is a multiple of 4k bytes.
+
+
+ enable_rebuild (optional, bool, None)
+ Enable/Disable rebuild of a specific storage pool.
+
+
+ enable_fragmentation (optional, bool, None)
+ Enable/Disable fragmentation of a specific storage pool.
+
+
+ parallel_rebuild_rebalance_limit (optional, int, None)
+ Set rebuild/rebalance parallelism limit of a storage pool.
+
+
+ persistent_checksum (optional, dict, None)
+ Enable/Disable persistent checksum of a specific storage pool.
+
+
+ enable (optional, bool, None)
+ Enable / disable persistent checksum.
+
+
+ validate_on_read (optional, bool, None)
+ Validate checksum upon reading data.
+
+
+ builder_limit (optional, int, 3072)
+ Bandwidth limit in KB/s for the checksum building process.
+
+ Valid range is 1024 to 10240.
+
+
+
+ protected_maintenance_mode_io_priority_policy (optional, dict, None)
+ Set protected maintenance mode I/O priority policy of a storage pool.
+
+
+ policy (optional, str, limitNumOfConcurrentIos)
+ The I/O priority policy for protected maintenance mode.
+
+ ``unlimited`` Protected maintenance mode IOPS are not limited
+
+ ``limitNumOfConcurrentIos``Limit the number of allowed concurrent protected maintenance mode migration I/Os to the value defined for *concurrent_ios_per_device*.
+
+ ``favorAppIos`` Always limit the number of allowed concurrent protected maintenance mode migration I/Os to value defined for *concurrent_ios_per_device*.
+
+ If application I/Os are in progress, should also limit the bandwidth of protected maintenance mode migration I/Os to the limit defined for the *bw_limit_per_device*.
+
+
+ concurrent_ios_per_device (optional, int, None)
+ The maximum number of concurrent protected maintenance mode migration I/Os per device.
+
+ Valid range is 1 to 20.
+
+
+ bw_limit_per_device (optional, int, None)
+ The maximum bandwidth of protected maintenance mode migration I/Os, in KB per second, per device.
+
+ Valid range is 1024 to 1048576.
+
+
+
+ vtree_migration_io_priority_policy (optional, dict, None)
+ Set the I/O priority policy for V-Tree migration for a specific Storage Pool.
+
+
+ policy (optional, str, None)
+ The I/O priority policy for protected maintenance mode.
+
+ ``limitNumOfConcurrentIos`` Limit the number of allowed concurrent V-Tree migration I/Os (default) to the *concurrent_ios_per_device*.
+
+ ``favorAppIos`` Always limit the number of allowed concurrent V-Tree migration I/Os to defined for *concurrent_ios_per_device*.
+
+ If application I/Os are in progress, should also limit the bandwidth of V-Tree migration I/Os to the limit defined for the *bw_limit_per_device*.
+
+
+ concurrent_ios_per_device (optional, int, None)
+ The maximum number of concurrent V-Tree migration I/Os per device.
+
+ Valid range is 1 to 20
+
+
+ bw_limit_per_device (optional, int, None)
+ The maximum bandwidth of V-Tree migration I/Os, in KB per second, per device.
+
+ Valid range is 1024 to 25600.
+
+
+
+ rebalance_io_priority_policy (optional, dict, None)
+ Set the rebalance I/O priority policy for a Storage Pool.
+
+
+ policy (optional, str, favorAppIos)
+ Policy to use for rebalance I/O priority.
+
+ ``unlimited`` Rebalance I/Os are not limited.
+
+ ``limitNumOfConcurrentIos`` Limit the number of allowed concurrent rebalance I/Os.
+
+ ``favorAppIos`` Limit the number and bandwidth of rebalance I/Os when application I/Os are in progress.
+
+
+ concurrent_ios_per_device (optional, int, None)
+ The maximum number of concurrent rebalance I/Os per device.
+
+ Valid range is 1 to 20.
+
+
+ bw_limit_per_device (optional, int, None)
+ The maximum bandwidth of rebalance I/Os, in KB/s, per device.
+
+ Valid range is 1024 to 1048576.
+
+
+
+ cap_alert_thresholds (optional, dict, None)
+ Set the threshold for triggering capacity usage alerts.
+
+ Alerts thresholds are calculated from each Storage Pool capacity after deducting the defined amount of spare capacity.
+
+
+ high_threshold (optional, int, None)
+ Threshold of the non-spare capacity of the Storage Pool that will trigger a high-priority alert, expressed as a percentage.
+
+ This value must be lower than the *critical_threshold*.
+
+
+ critical_threshold (optional, int, None)
+ Threshold of the non-spare capacity of the Storage Pool that will trigger a critical-priority alert, expressed as a percentage.
+
+
+
state (True, str, None)
State of the storage pool.
@@ -122,7 +277,7 @@ Notes
.. note::
- TRANSITIONAL media type is supported only during modification.
- - The *check_mode* is not supported.
+ - The *check_mode* is supported.
- The modules present in the collection named as 'dellemc.powerflex' are built to support the Dell PowerFlex storage platform.
@@ -153,37 +308,75 @@ Examples
storage_pool_id: "abcd1234ab12r"
state: "present"
- - name: Create a new storage pool by name
- dellemc.powerflex.storagepool:
- hostname: "{{hostname}}"
- username: "{{username}}"
- password: "{{password}}"
- validate_certs: "{{validate_certs}}"
- storage_pool_name: "ansible_test_pool"
- protection_domain_id: "1c957da800000000"
- media_type: "HDD"
- state: "present"
-
- - name: Modify a storage pool by name
+ - name: Create a new Storage pool
dellemc.powerflex.storagepool:
- hostname: "{{hostname}}"
- username: "{{username}}"
- password: "{{password}}"
- validate_certs: "{{validate_certs}}"
- storage_pool_name: "ansible_test_pool"
- protection_domain_id: "1c957da800000000"
+ hostname: "{{ hostname }}"
+ username: "{{ username }}"
+ password: "{{ password }}"
+ validate_certs: "{{ validate_certs }}"
+ storage_pool_name: "{{ pool_name }}"
+ protection_domain_name: "{{ protection_domain_name }}"
+ cap_alert_thresholds:
+ high_threshold: 30
+ critical_threshold: 50
+ media_type: "TRANSITIONAL"
+ enable_zero_padding: true
+ rep_cap_max_ratio: 40
+ rmcache_write_handling_mode: "Passthrough"
+ spare_percentage: 80
+ enable_rebalance: false
+ enable_fragmentation: false
+ enable_rebuild: false
use_rmcache: true
use_rfcache: true
+ parallel_rebuild_rebalance_limit: 3
+ protected_maintenance_mode_io_priority_policy:
+ policy: "unlimited"
+ rebalance_io_priority_policy:
+ policy: "unlimited"
+ vtree_migration_io_priority_policy:
+ policy: "limitNumOfConcurrentIos"
+ concurrent_ios_per_device: 10
+ persistent_checksum:
+ enable: false
state: "present"
- - name: Rename storage pool by id
+ - name: Modify a Storage pool by name
dellemc.powerflex.storagepool:
- hostname: "{{hostname}}"
- username: "{{username}}"
- password: "{{password}}"
- validate_certs: "{{validate_certs}}"
- storage_pool_id: "abcd1234ab12r"
- storage_pool_new_name: "new_ansible_pool"
+ hostname: "{{ hostname }}"
+ username: "{{ username }}"
+ password: "{{ password }}"
+ validate_certs: "{{ validate_certs }}"
+ storage_pool_name: "{{ pool_name }}"
+ protection_domain_name: "{{ protection_domain_name }}"
+ storage_pool_new_name: "pool_name_new"
+ cap_alert_thresholds:
+ high_threshold: 50
+ critical_threshold: 70
+ enable_zero_padding: false
+ rep_cap_max_ratio: 60
+ rmcache_write_handling_mode: "Passthrough"
+ spare_percentage: 90
+ enable_rebalance: true
+ enable_fragmentation: true
+ enable_rebuild: true
+ use_rmcache: true
+ use_rfcache: true
+ parallel_rebuild_rebalance_limit: 6
+ protected_maintenance_mode_io_priority_policy:
+ policy: "limitNumOfConcurrentIos"
+ concurrent_ios_per_device: 4
+ rebalance_io_priority_policy:
+ policy: "favorAppIos"
+ concurrent_ios_per_device: 10
+ bw_limit_per_device: 4096
+ vtree_migration_io_priority_policy:
+ policy: "limitNumOfConcurrentIos"
+ concurrent_ios_per_device: 10
+ persistent_checksum:
+ enable: true
+ validate_on_read: true
+ builder_limit: 1024
state: "present"
@@ -260,4 +453,5 @@ Authors
- Arindam Datta (@dattaarindam) <ansible.team@dell.com>
- P Srinivas Rao (@srinivas-rao5) <ansible.team@dell.com>
+- Trisha Datta (@trisha-dell) <ansible.team@dell.com>
diff --git a/ansible_collections/dellemc/powerflex/docs/modules/volume.rst b/ansible_collections/dellemc/powerflex/docs/modules/volume.rst
index 16dbf2b25..1132bec40 100644
--- a/ansible_collections/dellemc/powerflex/docs/modules/volume.rst
+++ b/ansible_collections/dellemc/powerflex/docs/modules/volume.rst
@@ -23,9 +23,7 @@ Requirements
The below requirements are needed on the host that executes this module.
- A Dell PowerFlex storage system version 3.6 or later.
-- Ansible-core 2.14 or later.
-- PyPowerFlex 1.11.0.
-- Python 3.9, 3.10 or 3.11.
+- PyPowerFlex 1.12.0.