doc: Add /etc/network/ifupdown-ng.conf to admin guide.
Signed-off-by: Maximilian Wilhelm <max@sdn.clinic>
This commit is contained in:
parent
f707c5c1ef
commit
68c51a79e7
1 changed files with 39 additions and 9 deletions
|
@ -20,6 +20,10 @@ in order of importance:
|
||||||
database, which contains information about what
|
database, which contains information about what
|
||||||
interfaces should be configured.
|
interfaces should be configured.
|
||||||
|
|
||||||
|
* `/etc/network/ifupdown-ng.conf`: the main configuration
|
||||||
|
file which controls ifupdown-ng's behaviour. See the
|
||||||
|
*ifupdown-ng Configuration* section below.
|
||||||
|
|
||||||
* `/run/ifstate`: the interface state file, which denotes
|
* `/run/ifstate`: the interface state file, which denotes
|
||||||
what physical interfaces are configured, and what
|
what physical interfaces are configured, and what
|
||||||
interface definition they are configured as.
|
interface definition they are configured as.
|
||||||
|
@ -38,7 +42,34 @@ in order of importance:
|
||||||
All configuration examples in this guide concern the
|
All configuration examples in this guide concern the
|
||||||
`/etc/network/interfaces` file.
|
`/etc/network/interfaces` file.
|
||||||
|
|
||||||
## Basic Configuration
|
## ifupdown-ng Configuration
|
||||||
|
|
||||||
|
ifupdown-ng allows to configure some parts of it's behaviour.
|
||||||
|
Currently the following settings are supported in
|
||||||
|
`/etc/network/ifupdown-ng.conf`:
|
||||||
|
|
||||||
|
* `allow_addon_scripts`: Enable support for /etc/if-X.d addon scripts.
|
||||||
|
These are used for compatibility with legacy setups, and may be
|
||||||
|
disabled for performance improvements in setups where only
|
||||||
|
ifupdown-ng executors are used. Valid values are `0` and `1`,
|
||||||
|
default is `1`.
|
||||||
|
|
||||||
|
* `allow_any_iface_as_template`: Enable any interface to act as a
|
||||||
|
template for another interface. This is presently the default,
|
||||||
|
but is deprecated. An admin may choose to disable this setting
|
||||||
|
in order to require inheritance from specified templates.
|
||||||
|
Valid values are `0` and `1`, the default is `1`.
|
||||||
|
|
||||||
|
* `implicit_template_conversion`: In some legacy configs, a template
|
||||||
|
may be declared as an iface, and ifupdown-ng automatically converts
|
||||||
|
those declarations to a proper template. If this setting is
|
||||||
|
disabled, inheritance will continue to work against non-template
|
||||||
|
interfaces without converting them to a template. Valid values
|
||||||
|
are `0` and `1`, the default is `1`.
|
||||||
|
|
||||||
|
## Interface Configuration
|
||||||
|
|
||||||
|
### Basic Configuration
|
||||||
|
|
||||||
To begin with, lets look at a basic configuration for a
|
To begin with, lets look at a basic configuration for a
|
||||||
desktop computer. This scenario involves using the DHCP
|
desktop computer. This scenario involves using the DHCP
|
||||||
|
@ -71,7 +102,7 @@ iface eth0
|
||||||
use dhcp
|
use dhcp
|
||||||
```
|
```
|
||||||
|
|
||||||
## IPv6 RA Configuration
|
### IPv6 RA Configuration
|
||||||
|
|
||||||
With IPv6, stateless auto-configuration is typically used to
|
With IPv6, stateless auto-configuration is typically used to
|
||||||
configure network interfaces. If you are not interested in
|
configure network interfaces. If you are not interested in
|
||||||
|
@ -85,7 +116,7 @@ iface eth0
|
||||||
use ipv6-ra
|
use ipv6-ra
|
||||||
```
|
```
|
||||||
|
|
||||||
## Static Configuration
|
### Static Configuration
|
||||||
|
|
||||||
We can use the `static` executor to configure static IPv4 and
|
We can use the `static` executor to configure static IPv4 and
|
||||||
IPv6 addresses. If you use the `address` keyword, the `static`
|
IPv6 addresses. If you use the `address` keyword, the `static`
|
||||||
|
@ -98,7 +129,7 @@ iface eth0
|
||||||
gateway 203.0.113.1
|
gateway 203.0.113.1
|
||||||
```
|
```
|
||||||
|
|
||||||
### Multiple Addresses
|
#### Multiple Addresses
|
||||||
|
|
||||||
A typical scenario on servers is where a server has multiple
|
A typical scenario on servers is where a server has multiple
|
||||||
IP addresses on a single interface. In this case you simply
|
IP addresses on a single interface. In this case you simply
|
||||||
|
@ -113,7 +144,7 @@ iface eth0
|
||||||
gateway 203.0.113.1
|
gateway 203.0.113.1
|
||||||
```
|
```
|
||||||
|
|
||||||
### Dual-stack configurations
|
#### Dual-stack configurations
|
||||||
|
|
||||||
Another typical scenario for servers is to run a dual-stack
|
Another typical scenario for servers is to run a dual-stack
|
||||||
configuration, where interfaces have both an IPv4 and an IPv6
|
configuration, where interfaces have both an IPv4 and an IPv6
|
||||||
|
@ -184,7 +215,7 @@ iface bond0
|
||||||
[...]
|
[...]
|
||||||
```
|
```
|
||||||
|
|
||||||
Is equivalent to:
|
Is with respect to dependency equivalent to:
|
||||||
|
|
||||||
```
|
```
|
||||||
auto bond0
|
auto bond0
|
||||||
|
@ -215,6 +246,5 @@ used for an interface, use the ifquery(8) command.
|
||||||
## Questions
|
## Questions
|
||||||
|
|
||||||
If you have further questions about how to use ifupdown-ng to
|
If you have further questions about how to use ifupdown-ng to
|
||||||
configure a specific scenario, drop by the [ifupdown-ng IRC channel][irc].
|
configure a specific scenario, drop by the
|
||||||
|
[ifupdown-ng IRC channel](irc://irc.as7007.net/#ifupdown-ng).
|
||||||
[irc]: irc://irc.as7007.net/#ifupdown-ng
|
|
||||||
|
|
Loading…
Reference in a new issue