netapp.elementsw.na_elementsw_network_interfaces – NetApp Element Software Configure Node Network Interfaces
Note
This plugin is part of the netapp.elementsw collection (version 20.11.0).
To install it use: ansible-galaxy collection install netapp.elementsw.
To use it in a playbook, specify: netapp.elementsw.na_elementsw_network_interfaces.
New in version 2.7.0: of netapp.elementsw
Synopsis
- Configure Element SW Node Network Interfaces for Bond 1G and 10G IP addresses.
- This module does not create interfaces, it expects the interfaces to already exists and can only modify them.
- This module cannot set or modify the method (Loopback, manual, dhcp, static).
- This module is not idempotent and does not support check_mode.
Requirements
The below requirements are needed on the host that executes this module.
- The modules were developed with SolidFire 10.1
- solidfire-sdk-python (1.1.0.92) or greater. Install using ‘pip install solidfire-sdk-python’
Parameters
| Parameter | Choices/Defaults | Comments | |
|---|---|---|---|
| bond_10g  dictionary  | settings for the Bond10G interface. | ||
| address  string  | IP address for the interface. | ||
| bond_lacp_rate  string  | 
 | Link Aggregation Control Protocol - useful only if LACP is selected as the Bond Mode. Slow - Packets are transmitted at 30 second intervals. Fast - Packets are transmitted in 1 second intervals. | |
| bond_mode  string  | 
 | Bonding mode. | |
| dns_nameservers  list / elements=string  | List of addresses for domain name servers. | ||
| dns_search  list / elements=string  | List of DNS search domains. | ||
| gateway  string  | IP router network address to send packets out of the local network. | ||
| mtu  string  | The largest packet size (in bytes) that the interface can transmit.. Must be greater than or equal to 1500 bytes. | ||
| netmask  string  | subnet mask for the interface. | ||
| virtual_network_tag  string  | The virtual network identifier of the interface (VLAN tag). | ||
| bond_1g  dictionary  | settings for the Bond1G interface. | ||
| address  string  | IP address for the interface. | ||
| bond_lacp_rate  string  | 
 | Link Aggregation Control Protocol - useful only if LACP is selected as the Bond Mode. Slow - Packets are transmitted at 30 second intervals. Fast - Packets are transmitted in 1 second intervals. | |
| bond_mode  string  | 
 | Bonding mode. | |
| dns_nameservers  list / elements=string  | List of addresses for domain name servers. | ||
| dns_search  list / elements=string  | List of DNS search domains. | ||
| gateway  string  | IP router network address to send packets out of the local network. | ||
| mtu  string  | The largest packet size (in bytes) that the interface can transmit.. Must be greater than or equal to 1500 bytes. | ||
| netmask  string  | subnet mask for the interface. | ||
| virtual_network_tag  string  | The virtual network identifier of the interface (VLAN tag). | ||
| bond_mode_10g  string  | deprecated, use bond_10g option. | ||
| bond_mode_1g  string  | deprecated, use bond_1g option. | ||
| dns_nameservers  list / elements=string  | deprecated, use bond_1g and bond_10g options. | ||
| dns_search_domains  list / elements=string  | deprecated, use bond_1g and bond_10g options. | ||
| gateway_address_10g  string  | deprecated, use bond_10g option. | ||
| gateway_address_1g  string  | deprecated, use bond_1g option. | ||
| hostname  string / required  | The hostname or IP address of the SolidFire cluster. For na_elementsw_cluster, the Management IP (MIP) or hostname of the node to initiate the cluster creation from. | ||
| ip_address_10g  string  | deprecated, use bond_10g option. | ||
| ip_address_1g  string  | deprecated, use bond_1g option. | ||
| lacp_10g  string  | deprecated, use bond_10g option. | ||
| lacp_1g  string  | deprecated, use bond_1g option. | ||
| method  string  | deprecated, this option would trigger a 'updated failed' error | ||
| mtu_10g  string  | deprecated, use bond_10g option. | ||
| mtu_1g  string  | deprecated, use bond_1g option. | ||
| password  string / required  | Password for the specified user. aliases: pass | ||
| subnet_10g  string  | deprecated, use bond_10g option. | ||
| subnet_1g  string  | deprecated, use bond_1g option. | ||
| username  string / required  | Please ensure that the user has the adequate permissions. For more information, please read the official documentation https://mysupport.netapp.com/documentation/docweb/index.html?productID=62636&language=en-US. aliases: user | ||
| virtual_network_tag  string  | deprecated, use bond_1g and bond_10g options. | ||
Notes
Note
- The modules prefixed with na\_elementsw are built to support the SolidFire storage platform.
Examples
- name: Set Node network interfaces configuration for Bond 1G and 10G properties
  tags:
  - elementsw_network_interfaces
  na_elementsw_network_interfaces:
    hostname: "{{ elementsw_hostname }}"
    username: "{{ elementsw_username }}"
    password: "{{ elementsw_password }}"
    bond_1g:
      address: 10.253.168.131
      netmask: 255.255.248.0
      gateway: 10.253.168.1
      mtu: '1500'
      bond_mode: ActivePassive
      dns_nameservers: dns1,dns2
      dns_search: domain1,domain2
    bond_10g:
      address: 10.253.1.202
      netmask: 255.255.255.192
      gateway: 10.253.1.193
      mtu: '9000'
      bond_mode: LACP
      bond_lacp_rate: Fast
      virtual_network_tag: vnet_tag
   Return Values
Common return values are documented here, the following are the fields unique to this module:
| Key | Returned | Description | 
|---|---|---|
| msg  string  | success | Success message | 
Authors
- NetApp Ansible Team (@carchi8py) <ng-ansibleteam@netapp.com>
    © 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
    https://docs.ansible.com/ansible/2.10/collections/netapp/elementsw/na_elementsw_network_interfaces_module.html