W3cubDocs

/Ansible

netapp_eseries.santricity.na_santricity_discover – NetApp E-Series discover E-Series storage systems

Note

This plugin is part of the netapp_eseries.santricity collection (version 1.2.13).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install netapp_eseries.santricity.

To use it in a playbook, specify: netapp_eseries.santricity.na_santricity_discover.

Synopsis

  • Module searches a subnet range and returns any available E-Series storage systems.

Requirements

The below requirements are needed on the host that executes this module.

  • ipaddress

Parameters

Parameter Choices/Defaults Comments
ports
list / elements=string
Default:
[8443]
This option specifies which ports to be tested during the discovery process.
The first usable port will be used in the returned API url.
prefer_embedded
boolean
    Choices:
  • no
  • yes
Give preference to Web Services Embedded when an option exists for both Web Services Proxy and Embedded.
Web Services Proxy will be utilized when available by default.
proxy_password
string
Web Service Proxy user password
proxy_url
string
Web Services Proxy REST API URL. Example https://192.168.1.100:8443/devmgr/v2/
proxy_username
string
Web Service Proxy username
proxy_validate_certs
boolean
    Choices:
  • no
  • yes
Whether to validate Web Service Proxy SSL certificate
subnet_mask
string / required
This is the IPv4 search range for discovering E-Series storage arrays.
IPv4 subnet mask specified in CIDR form. Example 192.168.1.0/24 would search the range 192.168.1.0 to 192.168.1.255.
Be sure to include all management paths in the search range.

Notes

Note

  • Only available for platforms E2800 or later (SANtricity Web Services Embedded REST API must be available).
  • All E-Series storage systems with SANtricity version 11.62 or later will be discovered.
  • Only E-Series storage systems without a set admin password running SANtricity versions prior to 11.62 will be discovered.
  • Use SANtricity Web Services Proxy to discover all systems regardless of SANricity version or password.

Examples

- name: Discover all E-Series storage systems on the network.
  na_santricity_discover:
    subnet_mask: 192.168.1.0/24

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
systems_found
dictionary
on success
Success message

Sample:
{"012341234123": { "addresses": ["192.168.1.184", "192.168.1.185"], "api_urls": ["https://192.168.1.184:8443/devmgr/v2/", "https://192.168.1.185:8443/devmgr/v2/"], "label": "ExampleArray01", "proxy_ssid: "", "proxy_required": false}, "012341234567": { "addresses": ["192.168.1.23", "192.168.1.24"], "api_urls": ["https://192.168.1.100:8443/devmgr/v2/"], "label": "ExampleArray02", "proxy_ssid": "array_ssid", "proxy_required": true}}


Authors

  • Nathan Swartz (@ndswartz)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp_eseries/santricity/na_santricity_discover_module.html