Merge pull request #68 from dell/RTS_V2.4.0

Release Version 2.4.0

CHANGELOG.rst

@@ -4,6 +4,24 @@ Dellemc.Powerscale Change Logs
 
 .. contents:: Topics
 
+v2.4.0
+======
+
+Minor Changes
+-------------
+
+- Added support for listing SMB global settings, detailed network interfaces, NTP servers, email settings,
+    cluster identity, cluster owner and SNMP settings through info module.
+- Added support for getting and modifying cluster owner information and cluster identity information
+    through settings module.
+- Added support for removing the static route for IP address pool through network pool module.
+
+New Modules
+-----------
+
+- dellemc.powerscale.smb_global_settings - Manage SMB global settings on a PowerScale Storage System.
+- dellemc.powerscale.snmp_settings - Manage SNMP settings on a PowerScale Storage System.
+
 
 v2.3.0
 ======

changelogs/changelog.yaml

@@ -234,3 +234,19 @@ releases:
         name: synciq_global_settings
         namespace: ''
     release_date: '2023-11-30'
+  2.4.0:
+    changes:
+      minor_changes:
+        - Added support for listing SMB global settings, detailed network interfaces, NTP servers, email settings,
+          cluster identity, cluster owner and SNMP settings through info module.
+        - Added support for getting and modifying cluster owner information and cluster identity information
+          through settings module.
+        - Added support for removing the static route for IP address pool through network pool module.
+    modules:
+      - description: Manage SMB global settings on a PowerScale Storage System.
+        name: smb_global_settings
+        namespace: ''
+      - description: Manage SNMP settings on a PowerScale Storage System.
+        name: snmp_settings
+        namespace: ''
+    release_date: '2023-12-29'

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-powerscale/blob/2.3.0/docs/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-powerscale/blob/2.4.0/docs/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 PowerScale 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-powerscale/blob/2.3.0/docs/ISSUE_TRIAGE.md).
+Read more about the ways you can [Triage issues](https://github.com/dell/ansible-powerscale/blob/2.4.0/docs/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 PowerScale](https://github.com/dell/ansible-powerscale/blob/2.3.0/docs/BRANCHING.md)
+* [Branching Strategy for Ansible modules for Dell PowerScale](https://github.com/dell/ansible-powerscale/blob/2.4.0/docs/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-powerscale/blob/2.3.0/docs/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-powerscale/blob/2.4.0/docs/SUPPORT.md).
 
 #### Code sanitization
 

docs/INSTALLATION.md

@@ -32,7 +32,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-2.3.0.tar.gz -p <install_path>
+	      ansible-galaxy collection install dellemc-powerscale-2.4.0.tar.gz -p <install_path>
 
   2. Set the environment variable:
 
@@ -59,7 +59,7 @@ Use this procedure to install SDK:
 
 ## Ansible modules execution
 
-The Ansible server must be configured with Python library for OneFS to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powerscale/blob/2.3.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 need to be configured before running the modules.
+The Ansible server must be configured with Python library for OneFS to run the Ansible playbooks. The [Documents](https://github.com/dell/ansible-powerscale/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 need to be configured before running the modules.
 
 ## SSL certificate validation
 

docs/ISSUE_TRIAGE.md

@@ -43,7 +43,7 @@ Should explain what happened, what was expected and how to reproduce it together
 
  - Ansible Version: [e.g. 2.15]
  - Python Version [e.g. 3.11]
- - Ansible modules for Dell PowerScale Version: [e.g. 2.3.0]
+ - Ansible modules for Dell PowerScale Version: [e.g. 2.4.0]
  - PowerScale SDK version: [e.g. isilon-sdk]
  - Any other additional information...
 

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-powerscale/blob/2.3.0/docs/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powerscale/blob/2.3.0/docs/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powerscale/blob/2.3.0/docs/COMMITTER_GUIDE.md) guides
+* Follow the [Code of Conduct](https://github.com/dell/ansible-powerscale/blob/2.4.0/docs/CODE_OF_CONDUCT.md) and the guidelines in the [Contributing](https://github.com/dell/ansible-powerscale/blob/2.4.0/docs/CONTRIBUTING.md) and [Committer](https://github.com/dell/ansible-powerscale/blob/2.4.0/docs/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.

docs/Release Notes.md

@@ -1,6 +1,6 @@
 **Ansible Modules for Dell Technologies PowerScale** 
 =========================================
-### Release notes 2.3.0
+### Release notes 2.4.0
 
 >   © 2022 Dell Inc. or its subsidiaries. All rights reserved. Dell
 >   and other trademarks are trademarks of Dell Inc. or its
@@ -27,7 +27,7 @@ Table 1. Revision history
 
 | Revision | Date          | Description                                               |
 |----------|---------------|-----------------------------------------------------------|
-| 01       | November 2023 | Ansible Modules for Dell PowerScale 2.3.0                 |
+| 01       | December 2023 | Ansible Modules for Dell PowerScale 2.4.0                 |
 
 
 Product description
@@ -63,31 +63,34 @@ The Ansible Modules for Dell PowerScale support the following features:
 - Create, modify, get details and delete an S3 bucket.
 - Get details and modify SyncIQ global settings.
 - Get details, modify, import, and delete SyncIQ certificates.
+- Get details and modify SMB global settings.
+- Get details and modify SNMP settings.
 
 The Ansible modules use playbooks, written in yaml syntax, to list, show, create, delete, and modify each of these entities.
 
 New Features and Enhancements
 ---------------------------
 This section describes the features of the Ansible Modules for Dell PowerScale for this release.
 
-The Ansible Modules for Dell PowerScale release 2.3.0 supports the following features:
+The Ansible Modules for Dell PowerScale release 2.4.0 supports the following features:
 
-- The SyncIQ global settings module supports this functionality:
-    - Added support for getting and modifying SyncIQ global settings.
-- The SyncIQ target cluster certificate module supports this functionality:
-    -  Added support for getting, importing, modifying and deleting SyncIQ target cluster certificates.
-- The Info module supports this functionality.
-    - Added support for listing SyncIQ global settings and S3 buckets in Info module.
-- The SyncIQ policy module supports this functionality.
-    - Added support for manually running a SyncIQ policy.
+- The SMB global settings module supports this functionality:
+    - Added support for getting and modifying SMB global settings.
+- The SNMP settings module supports this functionality:
+    - Added support for getting and modifying SNMP settings.
+- The network pool module supports this functionality:
+    - Added support for removing the static route for IP address pool.
+- The settings module has been enhanced to support this functionality:
+    - Added support for getting and modifying cluster owner information and cluster identity information.
+- The Info module has been enhanced to support this functionality.
+    - Added support for listing SMB global settings, detailed network interfaces, NTP servers, email settings, cluster identity, cluster owner and SNMP settings through info module.
 
 Known issues
 ------------
 Known problems in this release are listed.
 
 | **Issue**        | **Description**           | **Resolution**  |
 | ------------- |-------------| -----|
-| Snapshot schedule | If the playbook has a desired_retention field, running the same playbook again returns the changed as True (Idempotency does not work). | This is an issue in the supported OneFS versions. |
 | Filesystem creation | Creation of a filesystem can fail when api_user: "admin" is used because it is possible that the admin user may not have privileges to set an ACLs. | Assigning privileges ISI_PRIV_IFS_RESTORE and ISI_PRIV_NS_TRAVERSE to the user should enable the creation of filesystem with ACL permissions. |
 | Snapshot creation with alias name | Alias name attribute remains null in spite of creating snapshot with alias name | This is an issue with the PowerScale rest API. Alias name is not getting appended to the attribute in response. |
 | SyncIQ Job creation/modification/retrieval | When SyncIQ policy has any job of the type "resync_prep/allow_write/allow_write_revert" then creation, modification or retrieval of SyncIQ job will fail with an error saying "Invalid value for 'action', must be one of ['copy', 'sync']". | This is an issue in the supported OneFS versions. |
@@ -105,9 +108,6 @@ This section lists the limitations in this release of Ansible Modules for Dell P
   - Only local users and groups can be created. 
   - Operations on users and groups with very long names may fail.
   - Modification of user password fails for OneFS version 9.5.
-
-- Access Zone
-  - Deletion of access zones is not supported.
 
 - Filesystems
   -  Only directory quotas are supported but not user or group quotas.
@@ -129,7 +129,7 @@ This section lists the limitations in this release of Ansible Modules for Dell P
 Software media, organization, and files 
 -----------
 The software package is available for download from the [Ansible Modules
-for PowerScale GitHub](https://github.com/dell/ansible-powerscale/tree/2.3.0) page.
+for PowerScale GitHub](https://github.com/dell/ansible-powerscale/tree/2.4.0) page.
 
 Additional resources
 --------------------

docs/SECURITY.md

@@ -12,7 +12,7 @@ You may obtain a copy of the License at
 
 The Ansible modules for Dell PowerScale repository is 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-powerscale/blob/2.3.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-powerscale/blob/2.4.0/docs/CONTRIBUTING.md#Pull-requests) for more information.
 
 ## Reporting a vulnerability