Docs4dev
Docs
ansible / latest / collections / netapp_eseries / santricity / na_santricity_global_module.html

netapp_eseries.santricity.na_santricity_global – NetApp E-Series manage global settings configuration

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_global.

Synopsis

  • Allow the user to configure several of the global settings associated with an E-Series storage-system

Parameters

Parameter Choices/Defaults Comments
api_password
string / required
The password to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
api_url
string / required
The url to the SANtricity Web Services Proxy or Embedded Web Services API.
Example https://prod-1.wahoo.acme.com:8443/devmgr/v2
api_username
string / required
The username to authenticate with the SANtricity Web Services Proxy or Embedded Web Services API.
automatic_load_balancing
string
    Choices:
  • enabled
  • disabled
Enable automatic load balancing to allow incoming traffic from the hosts to be dynamically managed and balanced across both controllers.
Automatic load balancing requires host connectivity reporting to be enabled.
cache_block_size
integer
Size of the cache's block size.
All volumes on the storage system share the same cache space; therefore, the volumes can have only one cache block size.
See M(na_santricity_facts) for available sizes.
cache_flush_threshold
integer
This is the percentage threshold of the amount of unwritten data that is allowed to remain on the storage array's cache before flushing.
default_host_type
string
Default host type for the storage system.
Either one of the following names can be specified, Linux DM-MP, VMWare, Windows, Windows Clustered, or a host type index which can be found in M(na_santricity_facts)
host_connectivity_reporting
string
    Choices:
  • enabled
  • disabled
Enable host connectivity reporting to allow host connections to be monitored for connection and multipath driver problems.
When M(automatic_load_balancing==enabled) then M(host_connectivity_reporting) must be enabled
login_banner_message
string
Text message that appears prior to the login page.
login_banner_message=="" will delete any existing banner message.
name
string
Set the name of the E-Series storage-system
This label/name doesn't have to be unique.
May be up to 30 characters in length.

aliases: label
ssid
string
Default:
1
The ID of the array to manage. This value must be unique for each array.
validate_certs
boolean
    Choices:
  • no
  • yes ←
Should https certificates be validated?

Notes

Note

  • Check mode is supported.
  • This module requires Web Services API v1.3 or newer.
  • The E-Series Ansible modules require either an instance of the Web Services Proxy (WSP), to be available to manage the storage-system, or an E-Series storage-system that supports the Embedded Web Services API.
  • Embedded Web Services is currently available on the E2800, E5700, EF570, and newer hardware models.
  • M(netapp_e_storage_system) may be utilized for configuring the systems managed by a WSP instance.

Examples

- name: Set the storage-system name
  na_santricity_global:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: myArrayName
    cache_block_size: 32768
    cache_flush_threshold: 80
    automatic_load_balancing: enabled
    default_host_type: Linux DM-MP
- name: Set the storage-system name
  na_santricity_global:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    name: myOtherArrayName
    cache_block_size: 8192
    cache_flush_threshold: 60
    automatic_load_balancing: disabled
    default_host_type: 28

Return Values

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

Key Returned Description
array_name
string
on success
Current storage array's name

Sample:
arrayName
automatic_load_balancing
string
on success
Whether automatic load balancing feature has been enabled

Sample:
enabled
cache_settings
dictionary
on success
Current cache block size and flushing threshold values

Sample:
{'cache_block_size': 32768, 'cache_flush_threshold': 80}
changed
boolean
on success
Whether global settings were changed

Sample:
True
default_host_type_index
integer
on success
Current default host type index

Sample:
28
host_connectivity_reporting
string
on success
Whether host connectivity reporting feature has been enabled

Sample:
enabled
login_banner_message
string
on success
Current banner message

Sample:
Banner message here!


Authors

  • Michael Price (@lmprice)
  • 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_global_module.html