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