Release Documentation Update for patch release 3.8.1

CHANGELOG.rst

@@ -4,6 +4,14 @@ Dellemc.Powerscale Change Logs
 
 .. contents:: Topics
 
+v3.8.1
+======
+
+Bug Fixes
+-------------
+
+- GitHub defect fixes for filesystem module. (Issues # 38, # 121 and # 174)
+
 v3.8.0
 ======
 

README.md

@@ -2,8 +2,8 @@
 
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v2.0%20adopted-ff69b4.svg)](https://github.com/dell/ansible-powerscale/blob/main/docs/CODE_OF_CONDUCT.md)
 [![License](https://img.shields.io/github/license/dell/ansible-powerscale)](https://github.com/dell/ansible-powerscale/blob/main/LICENSE)
-[![Python version](https://img.shields.io/badge/python-3.9.6+-blue.svg)](https://www.python.org/downloads/)
-[![Ansible version](https://img.shields.io/badge/ansible-2.15.6+-blue.svg)](https://pypi.org/project/ansible/)
+[![Python version](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Ansible version](https://img.shields.io/badge/ansible-2.16+-blue.svg)](https://pypi.org/project/ansible/)
 [![isilon-sdk](https://img.shields.io/github/v/release/dell/python-powerscale?include_prereleases&label=isilon-sdk&style=flat-square)](https://github.com/Isilon/isilon_sdk_python)
 [![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/dell/ansible-powerscale?include_prereleases&label=latest&style=flat-square)](https://github.com/dell/ansible-powerscale/releases)
 [![codecov](https://codecov.io/gh/dell/ansible-powerscale/branch/main/graph/badge.svg)](https://app.codecov.io/gh/dell/ansible-powerscale)
@@ -74,14 +74,14 @@ The tasks can be executed by running simple playbooks written in yaml syntax.
 Ansible collection for PowerScale is released and licensed under the GPL-3.0 license. See [LICENSE](https://github.com/dell/ansible-powerscale/blob/main/LICENSE) for the full terms.
 
 ## Supported platforms
-  * Dell PowerScale OneFS versions 9.4.x, 9.5.x, 9.7.x, and 9.8.x
+  * Dell PowerScale OneFS versions 9.5.x, 9.7.x, and 9.8.x
 
 ## Prerequisites
 This table provides information about the software prerequisites for the Ansible Modules for Dell PowerScale.
 
 | **Ansible Modules** | **OneFS Version** | **Python version** | **Python SDK version** | **Ansible**              |
 |---------------------|-----------------------|--------------------|----------------------------|--------------------------|
-| v3.8.0 | 9.4.x <br> 9.5.x <br> 9.7.x <br> 9.8.x | 3.9 <br> 3.10 <br> 3.11 <br> 3.12 | 0.3.0.1 | 2.15 <br> 2.16 <br> 2.17 |
+| v3.8.1 | 9.5.x <br> 9.7.x <br> 9.8.x | 3.10 <br> 3.11 <br> 3.12 | 0.3.0.1 | 2.16 <br> 2.17 <br> 2.18 |
 
 # List of Ansible modules for Dell PowerScale
 

catalog-info.yaml

@@ -1,3 +1,4 @@
+---
 # nonk8s
 apiVersion: backstage.io/v1alpha1
 kind: Component
@@ -28,5 +29,5 @@ metadata:
 spec:
   type: service
   lifecycle: production
-  owner: user:default/sachin_apagundi
+  owner: user:default/gokul-srivathsan
   visibility: all

changelogs/changelog.yaml

@@ -346,3 +346,8 @@ releases:
         - Internal defect fixes for the modules settings, snapshot, group, nfs, smb, smb_global_settings, alert_rule,
           filesystem, nfs_alias, synciqpolicy, ads and info.
     release_date: '2025-03-28'
+  3.8.1:
+    changes:
+      bug_fixes:
+        - GitHub defect fixes for filesystem module. (Issues # 38, # 121 and # 174)
+    release_date: '2025-05-30'

docs/INSTALLATION.md

@@ -22,7 +22,7 @@ Use this procedure to install SDK:
   #### Offline installation of collections
   1. Download the latest tar build from either of the available distribution channels [Ansible Galaxy](https://galaxy.ansible.com/dellemc/powerscale) /[Automation Hub](https://console.redhat.com/ansible/automation-hub/repo/published/dellemc/powerscale) and use this command to install the collection anywhere in your system:
 
-	      ansible-galaxy collection install dellemc-powerscale-3.4.0.tar.gz -p <install_path>
+	      ansible-galaxy collection install dellemc-powerscale-3.8.1.tar.gz -p <install_path>
 
   2. Set the environment variable:
 

docs/ISSUE_TRIAGE.md

@@ -31,9 +31,9 @@ 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.15]
+ - Ansible Version: [e.g. 2.16]
  - Python Version [e.g. 3.11]
- - Ansible modules for Dell PowerScale Version: [e.g. 3.4.0]
+ - Ansible modules for Dell PowerScale Version: [e.g. 3.8.1]
  - PowerScale SDK version: [e.g. 0.3.0.1]
  - Any other additional information...
 

docs/RELEASE_NOTES.md

@@ -1,8 +1,8 @@
 **Ansible Modules for Dell Technologies PowerScale** 
 =========================================
-### Release notes 3.8.0
+### Release notes 3.8.1
 
->   © 2024 Dell Inc. or its subsidiaries. All rights reserved. Dell
+>   © 2025 Dell Inc. or its subsidiaries. All rights reserved. Dell
 >   and other trademarks are trademarks of Dell Inc. or its
 >   subsidiaries. Other trademarks may be trademarks of their respective
 >   owners.
@@ -27,8 +27,9 @@ Table 1. Revision history
 
 | Revision | Date          | Description                                               |
 |----------|---------------|-----------------------------------------------------------|
-| 01       | March 2025      | Ansible Modules for Dell PowerScale 3.8.0                 |
-| 02       | December 2024   | Ansible Modules for Dell PowerScale 3.7.0                 |
+| 03       | May 2025        | Ansible Modules for Dell PowerScale 3.8.1                 |
+| 02       | March 2025      | Ansible Modules for Dell PowerScale 3.8.0                 |
+| 01       | December 2024   | Ansible Modules for Dell PowerScale 3.7.0                 |
 
 
 Product description
@@ -81,12 +82,9 @@ New Features and Enhancements
 ---------------------------
 This section describes the features or enhancements of the Ansible Modules for Dell PowerScale for this release.
 
-The Ansible Modules for Dell PowerScale release 3.8.0 provides the following enhancements:
+The Ansible Modules for Dell PowerScale release 3.8.1 provides the following enhancements:
 
-- GitHub defect fixes networkpool module for unauthorized error (issue 133), smb share module return error (issue 138)
-  and filesystem modules cannot delete non empty folders and returns invalid error message (issue 148)
-- Internal defect fixes for the modules settings, snapshot, group, nfs, smb, smb_global_settings, alert_rule,
-  filesystem, nfs_alias, synciqpolicy, ads and info.
+- GitHub defect fixes for filesystem module. (Issues # 38, # 121 and # 174).
 
 Known issues
 ------------

docs/modules/accesszone.rst

@@ -21,7 +21,7 @@ Requirements
 The below requirements are needed on the host that executes this module.
 
 - A Dell PowerScale Storage system.
-- Ansible-core 2.15 or later.
+- Ansible-core 2.16 or later.
 - Python 3.10, 3.11 or 3.12.
 
 
@@ -54,21 +54,21 @@ Parameters
 
 
     directory_create_mask (optional, str, None)
-      Specifies the :literal:`UNIX` mask bits (octal) that are removed when a directory is created, restricting permissions.
+      Specifies the \ :literal:`UNIX`\  mask bits (octal) that are removed when a directory is created, restricting permissions.
 
       Mask bits are applied before mode bits are applied.
 
 
     directory_create_mode (optional, str, None)
-      Specifies the :literal:`UNIX` mode bits (octal) that are added when a directory is created, enabling permissions.
+      Specifies the \ :literal:`UNIX`\  mode bits (octal) that are added when a directory is created, enabling permissions.
 
 
     file_create_mask (optional, str, None)
-      Specifies the :literal:`UNIX` mask bits (octal) that are removed when a file is created, restricting permissions.
+      Specifies the \ :literal:`UNIX`\  mask bits (octal) that are removed when a file is created, restricting permissions.
 
 
     file_create_mode (optional, str, None)
-      Specifies the :literal:`UNIX` mode bits (octal) that are added when a file is created, enabling permissions.
+      Specifies the \ :literal:`UNIX`\  mode bits (octal) that are added when a file is created, enabling permissions.
 
 
     access_based_enumeration (optional, bool, None)
@@ -93,44 +93,44 @@ Parameters
 
 
     commit_asynchronous (optional, bool, None)
-      Set to :literal:`true` if NFS commit requests execute asynchronously.
+      Set to \ :literal:`true`\  if NFS commit requests execute asynchronously.
 
 
     nfsv4_domain (optional, str, None)
       Specifies the domain or realm through which users and groups are associated.
 
 
     nfsv4_allow_numeric_ids (optional, bool, None)
-      If :literal:`true`\ , sends owners and groups as UIDs and GIDs when look up fails or if the :emphasis:`nfsv4\_no\_name` property is set to 1.
+      If \ :literal:`true`\ , sends owners and groups as UIDs and GIDs when look up fails or if the \ :emphasis:`nfsv4\_no\_name`\  property is set to 1.
 
 
     nfsv4_no_domain (optional, bool, None)
-      If :literal:`true`\ , sends owners and groups without a domain name.
+      If \ :literal:`true`\ , sends owners and groups without a domain name.
 
 
     nfsv4_no_domain_uids (optional, bool, None)
-      If :literal:`true`\ , sends UIDs and GIDs without a domain name.
+      If \ :literal:`true`\ , sends UIDs and GIDs without a domain name.
 
 
     nfsv4_no_names (optional, bool, None)
-      If :literal:`true`\ , sends owners and groups as UIDs and GIDs.
+      If \ :literal:`true`\ , sends owners and groups as UIDs and GIDs.
 
 
 
   provider_state (False, str, None)
     Defines whether the auth providers should be added or removed from access zone.
 
-    If :emphasis:`auth\_providers` are given, then :emphasis:`provider\_state` should also be specified.
+    If \ :emphasis:`auth\_providers`\  are given, then \ :emphasis:`provider\_state`\  should also be specified.
 
-    :literal:`add` - indicates that the auth providers should be added to the access zone.
+    \ :literal:`add`\  - indicates that the auth providers should be added to the access zone.
 
-    :literal:`remove` - indicates that auth providers should be removed from the access zone.
+    \ :literal:`remove`\  - indicates that auth providers should be removed from the access zone.
 
 
   auth_providers (optional, list, None)
     Specifies the auth providers which need to be added or removed from access zone.
 
-    If :emphasis:`auth\_providers` are given, then :emphasis:`provider\_state` should also be specified.
+    If \ :emphasis:`auth\_providers`\  are given, then \ :emphasis:`provider\_state`\  should also be specified.
 
 
     provider_name (True, str, None)
@@ -144,18 +144,18 @@ Parameters
     priority (optional, int, None)
       Specifies the order of priority of the auth provider which needs to be added to access zone.
 
-      :literal:`1` denotes the topmost priority.
+      \ :literal:`1`\  denotes the topmost priority.
 
-      If :emphasis:`priority` is not provided, authentication provider will have lowest priority.
+      If \ :emphasis:`priority`\  is not provided, authentication provider will have lowest priority.
 
 
 
   state (True, str, None)
     Defines whether the access zone should exist or not.
 
-    :literal:`present` - indicates that the access zone should exist on the system.
+    \ :literal:`present`\  - indicates that the access zone should exist on the system.
 
-    :literal:`absent` - indicates that the access zone should not exist on the system.
+    \ :literal:`absent`\  - indicates that the access zone should not exist on the system.
 
 
   onefs_host (True, str, None)
@@ -169,9 +169,9 @@ Parameters
   verify_ssl (True, bool, None)
     boolean variable to specify whether to validate SSL certificate or not.
 
-    :literal:`true` - indicates that the SSL certificate should be verified.
+    \ :literal:`true`\  - indicates that the SSL certificate should be verified.
 
-    :literal:`false` - indicates that the SSL certificate should not be verified.
+    \ :literal:`false`\  - indicates that the SSL certificate should not be verified.
 
 
   api_user (True, str, None)
@@ -189,7 +189,7 @@ Notes
 -----
 
 .. note::
-   - The :emphasis:`check\_mode` is not supported.
+   - The \ :emphasis:`check\_mode`\  is not supported.
    - Built-in System zone cannot be deleted.
    - When access zone is deleted, all associated authentication providers remain available to other zones, the IP addresses are not reassigned to other zones.
    - When access zone is deleted, SMB shares, NFS exports, and HDFS data paths are deleted, the directories and data still exist, and  new shares, exports, or paths can be mapped in another access zone.
@@ -399,7 +399,7 @@ access_zone_details (When access zone exists, complex, {'nfs_settings': {'export
 
 
       commit_asynchronous (, bool, )
-        Set to :literal:`true` if NFS commit requests execute asynchronously
+        Set to \ :literal:`true`\  if NFS commit requests execute asynchronously
 
 
 
@@ -412,19 +412,19 @@ access_zone_details (When access zone exists, complex, {'nfs_settings': {'export
 
 
       nfsv4_allow_numeric_ids (, bool, )
-        If :literal:`true`\ , sends owners and groups as UIDs and GIDs when look up fails or if the 'nfsv4\_no\_name' property is set to 1
+        If \ :literal:`true`\ , sends owners and groups as UIDs and GIDs when look up fails or if the 'nfsv4\_no\_name' property is set to 1
 
 
       nfsv4_no_domain (, bool, )
-        If :literal:`true`\ , sends owners and groups without a domain name
+        If \ :literal:`true`\ , sends owners and groups without a domain name
 
 
       nfsv4_no_domain_uids (, bool, )
-        If :literal:`true`\ , sends UIDs and GIDs without a domain name
+        If \ :literal:`true`\ , sends UIDs and GIDs without a domain name
 
 
       nfsv4_no_names (, bool, )
-        If :literal:`true`\ , sends owners and groups as UIDs and GIDs
+        If \ :literal:`true`\ , sends owners and groups as UIDs and GIDs