netapp.elementsw.na_elementsw_network_interfaces – NetApp Element Software Configure Node Network Interfaces
Note
This plugin is part of the netapp.elementsw collection (version 21.6.1).
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.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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/elementsw/na_elementsw_network_interfaces_module.html