Releases: ansible-collections/netapp
20.11.0
20.10.0
20.9.1
20.9.0
20.9.0
New Modules
na_ontap_active_directory: configure active directory.
na_ontap_mcc_mediator: Configure a MCC Mediator (Supports ONTAP 9.8+).
na_ontap_metrocluster: Configure a metrocluster (Supports ONTAP 9.8+).
New Options
na_ontap_cluster: node_name to set the node name when adding a node, or as an alternative to cluster_ip_address to remove a node.
na_ontap_cluster: state can be set to absent to remove a node identified with cluster_ip_address or node_name.
na_ontap_qtree: wait_for_completion and time_out to wait for qtree deletion when using REST.
na_ontap_quotas: soft_disk_limit and soft_file_limit for the quota target.
na_ontap_rest_info: Support for gather subsets - initiator_groups_info, san_fcp_services, san_iscsi_credentials, san_iscsi_services, san_lun_maps, storage_luns_info, storage_NVMe_namespaces.
Bug fixes
na_ontap_cluster: check_mode is now working properly.
na_ontap_interface: home_node is not required in pre-cluster mode.
na_ontap_interface: role is not required if service_policy is present and ONTAP version is 9.8.
na_ontap_interface: traceback in get_interface if node is not reachable.
na_ontap_job_schedule: allow 'job_minutes' to set number to -1 for job creation with REST too.
na_ontap_qtree: fixed None is not subscriptable exception on rename operation.
na_ontap_volume: fixed KeyError exception on size when reporting creation error.
na_ontap_*: change version_added: '2.6' to version_added: 2.6.0 where applicable to satisfy sanity checker.
netapp.py: uncaught exception (traceback) on zapi.NaApiError.
20.8.0
20.8.0
20.7.0
New Modules:
- na_ontap_security_certificates: Install, create, sign, delete security certificates.
New Options:
- na_ontap_info: support continue_on_error option to continue when a ZAPI is not supported on a vserver, or for cluster RPC errors.
- na_ontap_info: support query option to specify which objects to return.
- na_ontap_info: support vserver tunneling to limit output to one vserver.
- na_ontap_snapmirror_policy: support for SnapMirror policy rules.
- na_ontap_vscan_scanner_pool: support modification.
- na_ontap_rest_info: Support for gather subsets - cluster_node_info, cluster_peer_info, disk_info, cifs_services_info, cifs_share_info.
- module_utils/netapp: add retry on wait_on_job when job failed. Abort 3 consecutive errors.
Bug fixes:
- na_ontap_firmware_download: exception on PCDATA if ONTAP returns a BEL (0x07) character.
- na_ontap_info: lists were incorrectly processed in convert_keys, returning {}.
- na_ontap_info: qtree_info is missing most entries. Changed key from vserver:id to vserver:volume:id .
- na_ontap_iscsi_security: adding no_log for password parameters.
- na_ontap_portset: adding explicit error message as modify portset is not supported.
- na_ontap_snapmirror: fixed snapmirror delete for loadsharing to not go to quiesce state for the rest of the set.
- na_ontap_ucadapter: fixed KeyError if type is not provided and mode is 'cna'.
- na_ontap_user: checked applications does not contain snmp when using REST API call.
- na_ontap_user: fixed KeyError if locked key not set with REST API call.
- na_ontap_user: fixed KeyError if vserver: is empty with REST API call (useful to indicate cluster scope).
- na_ontap_volume: fixed KeyError when getting info on a MVD volume
Example playbook
- na_ontap_pb_get_online_volumes.yml: list of volumes that are online (or offline).
- na_ontap_pb_install_SSL_certificate_REST.yml: installing SSL certificate using REST APIs.
20.6.1
20.6.0
20.6.0
Support for SSL certificate authentication in addition to password
The ONTAP Ansible modules currently require a username/password combination to authenticate with ONTAPI or REST APIs. It is now possible to use SSL certificate authentication with ONTAPI or REST. You will first need to install a SSL certificate in ONTAP, see for instance the first part of: https://netapp.io/2016/11/08/certificate-based-authentication-netapp-manageability-sdk-ontap/ The applications that need to be authorized for cert are ontapi and http.
The new cert_filepath, key_filepath options enable SSL certificate authentication. This is mutually exclusive with using username and password.
ONTAP does not support cert authentication for console, so this is not supported for na_ontap_command.
SSL certificate authentication requires python2.7 or 3.x.
New Options
na_ontap_disks: disk_type option allows to assign specified type of disk.
na_ontap_firmware_upgrade: ignore timeout when downloading image unless fail_on_502_error is set to true.
na_ontap_info: desired_attributes advanced feature to select which fields to return.
na_ontap_info: use_native_zapi_tags to disable the conversion of '' to '-' for attribute keys.
na_ontap_rest_info: fields options to request specific fields from subset.
na_ontap_software_update: stabilize_minutes option specifies number of minutes needed to stabilize node before update.
na_ontap_snapmirror: now performs restore with optional field source_snapshot for specific snapshot or uses latest.
na_ontap_ucadapter: pair_adapters option allows specifying the list of adapters which also need to be offline.
na_ontap_user: authentication_password option specifies password for the authentication protocol of SNMPv3 user.
na_ontap_user: authentication_protocol option specifies authentication protocol fo SNMPv3 user.
na_ontap_user: engine_id option specifies authoritative entity's EngineID for the SNMPv3 user.
na_ontap_user: privacy_password option specifies password for the privacy protocol of SNMPv3 user.
na_ontap_user: privacy_protocol option specifies privacy protocol of SNMPv3 user.
na_ontap_user: remote_switch_ipaddress option specifies the IP Address of the remote switch of SNMPv3 user.
na_ontap_volume: check_interval option checks if a volume move has been completed and then waits this number of seconds before checking again.
na_ontap_volume: auto_remap_luns option controls automatic mapping of LUNs during volume rehost.
na_ontap_volume: force_restore option forces volume to restore even if the volume has one or more newer Snapshotcopies.
na_ontap_volume: force_unmap_luns option controls automatic unmapping of LUNs during volume rehost.
na_ontap_volume: from_vserver option allows volume rehost from one vserver to another.
na_ontap_volume: preserve_lun_ids option controls LUNs in the volume being restored will remain mapped and their identities preserved.
na_ontap_volume: snapshot_restroe option specifies name of snapshot to restore from.
all modules: cert_filepath, key_filepath to enable SSL certificate authentication (python 2.7 or 3.x).
Bug Fixes
na_ontap_firmware_upgrade: ignore timeout when downloading firmware images by default.
na_ontap_info: conversion from '-' to '' was not done for lists of dictionaries.
na_ontap_ntfs_dacl: example fix in documentation string.
na_ontap_snapmirror: could not delete all rules (bug in netapp_module).
na_ontap_volume: modify was invoked multiple times when once is enough.
na_ontap_volume: fix KeyError on 'style' when volume is of type: data-protection.
na_ontap_volume: wait_on_completion is supported with volume moves.
module_utils/netapp_module: cater for empty lists in get_modified_attributes().
module_utils/netapp_module: cater for lists with duplicate elements in compare_lists().
Example playbook
na_ontap_pb_install_SSL_certificate.yml: installing a self-signed SSL certificate, and enabling SSL certificate authentication.
Added REST support to existing modules
na_ontap_user: added REST support for ONTAP user creation, modification & deletion.
20.5.0
New Options:
na_ontap_aggregate: raid_type options supports 'raid_0' for ONTAP Select.
na_ontap_cluster_peer: encryption_protocol_proposed option allows specifying encryption protocol to be used for inter-cluster communication.
na_ontap_info: new fact: aggr_efficiency_info.
na_ontap_info: new fact: cluster_switch_info.
na_ontap_info: new fact: disk_info.
na_ontap_info: new fact: env_sensors_info.
na_ontap_info: new fact: net_dev_discovery_info.
na_ontap_info: new fact: service_processor_info.
na_ontap_info: new fact: shelf_info.
na_ontap_info: new fact: sis_info.
na_ontap_info: new fact: subsys_health_info.
na_ontap_info: new fact: sysconfig_info.
na_ontap_info: new fact: sys_cluster_alerts.
na_ontap_info: new fact: volume_move_target_aggr_info.
na_ontap_info: new fact: volume_space_info.
na_ontap_nvme_namespace: block_size option allows specifying size in bytes of a logical block.
na_ontap_snapmirror: snapmirror now allows resume feature.
na_ontap_volume: cutover_action option allows specifying the action to be taken for cutover.
Bug Fixes
REST API call now honors the http_port parameter.
REST API detection now works with vserver (use_rest: Auto).
na_ontap_autosupport_invoke: when using ZAPI and name is not given, send autosupport message to all nodes in the cluster.
na_ontap_cg_snapshot: properly states it does not support check_mode.
na_ontap_cluster: ONTAP 9.3 or earlier does not support ZAPI element single-node-cluster.
na_ontap_cluster_ha: support check_mode.
na_ontap_cluster_peer: support check_mode.
na_ontap_cluster_peer: EMS log wrongly uses destination credentials with source hostname.
na_ontap_disks: support check_mode.
na_ontap_dns: support check_mode.
na_ontap_efficiency_policy: change duration type from int to str to support '-' input.
na_ontap_fcp: support check_mode.
na_ontap_flexcache: support check_mode.
na_ontap_info: metrocluster_check_info does not trigger a traceback but adds an "error" info element if the target system is not set up for metrocluster.
na_ontap_license: support check_mode.
na_ontap_login_messages: fix documentation link.
na_ontap_node: support check mode.
na_ontap_ntfs_sd: documentation string update for examples and made sure owner or group not mandatory.
na_ontap_ports: now support check mode.
na_ontap_restit: error can be a string in addition to a dict. This fix removes a traceback with AttributeError.
na_ontap_routes: support Check Mode correctly.
na_ontap_snapmirror: support check_mode.
na_ontap_software_update: Incorrectly stated that it support check mode, it does not.
na_ontap_svm_options: support check_mode.
na_ontap_volume: improve error reporting if required parameter is present but not set.
na_ontap_volume: suppress traceback in wait_for_completion as volume may not be completely ready.
na_ontap_volume: fix KeyError on 'style' when volume is offline.
na_ontap_volume_autosize: Support check_mode when reset option is given.
na_ontap_volume_snaplock: fix documentation link.
na_ontap_vserver_peer: support check_mode.
na_ontap_vserver_peer: EMS log wrongly uses destination credentials with source hostname.
New Modules
na_ontap_rest_info: Gather ONTAP subset information using REST APIs (9.6 and Above).
Role Change
na_ontap_cluster_config: Port Flowcontrol and autonegotiate can be set in role
20.4.1
20.4.1
New Options
- na_ontap_firmware_upgrade:
force_disruptive_update
andpackage_url
options allows to make choices for download and upgrading packages.
Added REST support to existing modules
- na_ontap_autosupport_invoke: added REST support for sending autosupport message.
Bug Fixes
- na_ontap_volume:
volume_security_style
option now allows modify. - na_ontap_info:
metrocluster_check_info
has been removed as it was breaking the info module for everyone who didn't have a metrocluster set up. We are working on adding this back in a future update
Role Changes
- na_ontap_vserver_create has a new default variable 'netapp_version' set to 140. If you are running 9.2 or below please add the variable to your playbook and set to 120