201 lines
5.2 KiB
ReStructuredText
201 lines
5.2 KiB
ReStructuredText
cdist-type__network_interface(7)
|
|
================================
|
|
|
|
NAME
|
|
----
|
|
cdist-type__network_interface - configure network interfaces
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
Configures network interfaces on debian an redhat based systems.
|
|
Interface names containing a dot are assumed to be vlan tagged sub interfaces.
|
|
e.g. eth0.10 is vlan 10 on physical device eth0.
|
|
|
|
Note that this type rewrites network interface files.
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
None.
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
name
|
|
The name of the physical or logical network device.
|
|
Defaults to __object_id.
|
|
|
|
method
|
|
The method for determining an IP address for the interface.
|
|
'dhcp', 'static' or 'manual'.
|
|
Defaults to 'dhcp'.
|
|
|
|
address
|
|
The IP address of the network interface.
|
|
Only used if --method is not 'dhcp'.
|
|
|
|
broadcast
|
|
Only used if --method is not 'dhcp'.
|
|
|
|
comment
|
|
Comment.
|
|
|
|
extra-config
|
|
Additional config that is added to the generated interfaces file verbatim.
|
|
|
|
gateway
|
|
Default gateway (dotted quad).
|
|
Only used if --method is not 'dhcp'.
|
|
|
|
netmask
|
|
The subnet mask to apply to the interface.
|
|
Only used if --method is not 'dhcp'.
|
|
|
|
metric
|
|
Routing metric for the default gateway.
|
|
|
|
mtu
|
|
The Maximum Transmission Unit size to use for the interface.
|
|
|
|
state
|
|
'present' or 'absent', defaults to 'present'.
|
|
|
|
bond-arp-interval
|
|
Specifies (in milliseconds) how often ARP monitoring occurs.
|
|
|
|
bond-arp-ip-target
|
|
Specifies the target IP address of ARP requests when the arp_interval parameter is enabled.
|
|
Can be specified up to 16 times.
|
|
|
|
bond-master
|
|
The name of the master (bonding) interface to which this slave should be enslaved.
|
|
|
|
bond-miimon
|
|
Specifies (in milliseconds) how often MII link monitoring occurs.
|
|
|
|
bond-mode
|
|
Allows you to specify the bonding policy. The value can be one of:
|
|
|
|
- balance-rr (0)
|
|
- active-backup (1)
|
|
- balance-xor (2)
|
|
- broadcast (3)
|
|
- 802.3ad (4)
|
|
- balance-tlb (5)
|
|
- balance-alb (6)
|
|
|
|
bond-primary
|
|
Specifies the interface name, such as eth0, of the primary device.
|
|
|
|
bond-slaves
|
|
The slave interfaces that form this bonding.
|
|
|
|
linkdelay
|
|
Only useable on Redhat based systems.
|
|
Time in seconds that the system should pause after the specific interface
|
|
is enabled. This may be useful if one interface is connected to a
|
|
switch which has spanning tree enabled and must wait for STP to
|
|
converge before the interface should be considered usable.
|
|
|
|
BOOLEAN PARAMETERS
|
|
------------------
|
|
onboot
|
|
Whether to bring the interface up on boot.
|
|
|
|
hotplug
|
|
Allow/disallow hotplug support for this interface.
|
|
|
|
nodns
|
|
Do not configure nameservers in /etc/resolv.conf.
|
|
|
|
noroute
|
|
Do not set default route.
|
|
|
|
no-network-wait-online
|
|
Do not consider this network interface in the network-wait-online.service unit.
|
|
|
|
symmetric-routing
|
|
Manage routing tables and rules to ensure symmetric routing.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
.. code-block:: sh
|
|
|
|
__network_interface eth0 --onboot
|
|
|
|
# Same thing, but explicitly define method
|
|
__network_interface eth0 --method dhcp --onboot
|
|
|
|
__network_interface eth1 \
|
|
--method static \
|
|
--address 192.168.42.23 \
|
|
--netmask 255.255.255.0 \
|
|
--gateway 192.168.42.1 \
|
|
--onboot
|
|
|
|
__network_interface eth3 --method dhcp --hotplug
|
|
|
|
# Don't wait for Infiniband interface to be up before reaching systemd network-online.target
|
|
__network_interface ib0 --method dhcp --no-network-wait-online
|
|
|
|
# active-backup bonding with 2 slaves
|
|
__network_interface bond0 \
|
|
--onboot \
|
|
--method static \
|
|
--bond-mode active-backup \
|
|
--bond-miimon 500 \
|
|
--bond-primary eth5 \
|
|
--address 10.205.9.65 \
|
|
--netmask 255.255.224.0
|
|
|
|
__network_interface eth5 \
|
|
--onboot \
|
|
--method manual \
|
|
--bond-master bond0
|
|
|
|
__network_interface eth6 \
|
|
--onboot \
|
|
--method manual \
|
|
--bond-master bond0
|
|
|
|
# extra config
|
|
__network_interface eth0 \
|
|
--method dhcp \
|
|
--extra-config - << DONE
|
|
post-up ip route add 10.205.0.0/19 via 10.205.161.1
|
|
post-up ip route add 10.205.96.0/19 via 10.205.161.1
|
|
pre-down ip route del 10.205.0.0/19 via 10.205.161.1
|
|
pre-down ip route del 10.205.96.0/19 via 10.205.161.1
|
|
DONE
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
Redhat bonding documentation:
|
|
|
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Using_Channel_Bonding.html
|
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/7/html/Networking_Guide/sec-Using_Channel_Bonding.html
|
|
* https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s2-networkscripts-interfaces-chan.html
|
|
|
|
Debian bonding documentation
|
|
|
|
* /usr/share/doc/ifenslave-2.6/README.Debian.gz
|
|
|
|
Symmetric routing
|
|
|
|
* http://www.microhowto.info/howto/ensure_symmetric_routing_on_a_server_with_multiple_default_gateways.html
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
Steven Armstrong <steven-cdist--@--armstrong.cc>
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2012-2016 Steven Armstrong. You can redistribute it
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
published by the Free Software Foundation, either version 3 of the
|
|
License, or (at your option) any later version.
|