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.1.0).

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
Parameters
Notes
Examples
Return Values

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	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 netapp_eseries.santricity.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 netapp_eseries.santricity.na_santricity_facts
host_connectivity_reporting string	enabled disabled	Enable host connectivity reporting to allow host connections to be monitored for connection and multipath driver problems. When automatic_load_balancing==enabled then host_connectivity_reporting must be enabled
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	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.
netapp_eseries.santricity.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

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/2.11/collections/netapp_eseries/santricity/na_santricity_global_module.html