Differences
This shows you the differences between two versions of the page.
|
doc:uci:6relayd [2013/01/15 14:36] steven |
doc:uci:6relayd [2013/05/21 07:53] (current) steven |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== 6relayd IPv6 server and relay configuration ====== | ====== 6relayd IPv6 server and relay configuration ====== | ||
| - | The ''/etc/config/6relayd'' configures the //6relayd// IPv6 relay & server. | + | The ''/etc/config/6relayd'' configures the //6relayd// IPv6 server & relay. |
| - | 6relayd is an IPv6-tool that relays IPv6-management protocols like router | + | 6relayd is a daemon for serving and relaying IPv6 management protocols to |
| - | discovery, neighbor discovery and DHCPv6 so that clients on routed (non- | + | configure clients and downstream routers. |
| - | bridged) interfaces can use the public address prefix, DHCPv6 and DNS-service | + | |
| - | of a master interface. This is useful to avoid NAT in chained IPv6-routers. | + | 6relayd provides server services for RA, stateless DHCPv6, DHCPv6-PD and can |
| + | be used to relay RA, DHCPv6 and NDP between routed (non-bridged) interfaces | ||
| + | in case no delegated prefixes are provided by the upstream router. | ||
| - | It can also be used as a lightweight router advertisement daemon and provide | ||
| - | stateless DHCPv6 service where size matters. | ||
| ==== Examples ==== | ==== Examples ==== | ||
| Line 18: | Line 18: | ||
| | ''config server | | ''config server | ||
| - | option master 'wan' | + | option master 'wan6' |
| option network 'lan guest' | option network 'lan guest' | ||
| option rd 'server' | option rd 'server' | ||
| Line 25: | Line 25: | ||
| - | **Example #2: Create a relay for several networks (here wan and lan) in proxy mode. | + | **Example #2: Create a relay for several networks (here wan6 and lan) in proxy mode. |
| This can be used to proxy Router Discovery, DHCPv6 and NDP.** | This can be used to proxy Router Discovery, DHCPv6 and NDP.** | ||
| | ''config server | | ''config server | ||
| - | option master 'wan' | + | option master 'wan6' |
| option network 'lan' | option network 'lan' | ||
| option rd 'relay' | option rd 'relay' | ||
| Line 43: | Line 43: | ||
| option rd 'server' | option rd 'server' | ||
| option dhcpv6 'server''' | | option dhcpv6 'server''' | | ||
| + | |||
| + | |||
| + | **Example #4: Create a static IPv6 lease while running in management_level 1 or 2.** | ||
| + | | ''config lease | ||
| + | option duid '0001000115c4599a4b5b3a5a21d9' | ||
| + | option id '1234''' | | ||
| + | |||
| + | |||
| + | |||
| ==== Sections ==== | ==== Sections ==== | ||
| - | Each section of type '''server'' defines an instance of //6relayd// that will be run. | + | Each section of type ''server'' defines an instance of //6relayd// that will be run.\\ |
| + | Each section of type ''lease'' defines an assigned static lease while running in management_level 1 or 2. | ||
| Services of 6relayd can be used in two modes: | Services of 6relayd can be used in two modes: | ||
| - | * ''server'' if you want to use 6relayd to only announce the router and / or use it as a stateless DHCPv6 server. | + | * ''server'' if you want to use 6relayd to only announce the router and / or use it as a DHCPv6 server. |
| * ''relay'' for all other use cases (e.g. relaying between different interfaces, proxying NDP, acting as a DHCPv6 relay, ...). | * ''relay'' for all other use cases (e.g. relaying between different interfaces, proxying NDP, acting as a DHCPv6 relay, ...). | ||
| Line 59: | Line 69: | ||
| | ''dhcpv6'' | [relay,server] | no | '''' | DHCPv6 mode of operation (empty = disabled) | | | ''dhcpv6'' | [relay,server] | no | '''' | DHCPv6 mode of operation (empty = disabled) | | ||
| | ''ndp'' | [relay] | no | '''' | NDP-Proxy mode of operation (empty = disabled) | | | ''ndp'' | [relay] | no | '''' | NDP-Proxy mode of operation (empty = disabled) | | ||
| + | | ''compat_ula'' | [0,1] | no | 0 | Ensure compatbility with broken devices and deprecate ULA if public prefixes are available. | | ||
| | ''fallback_relay'' | 1 or more [rd,dhcpv6,ndp] | no | '''' | Services to relay as fallback if there is no public prefix on the wan interface available | | | ''fallback_relay'' | 1 or more [rd,dhcpv6,ndp] | no | '''' | Services to relay as fallback if there is no public prefix on the wan interface available | | ||
| | ''always_rewrite_dns'' | [0,1] | no | 0 | Define whether the RD- and DHCPv6-relay will always announce the DNS on the router itself instead of the one provided from the upstream router | | | ''always_rewrite_dns'' | [0,1] | no | 0 | Define whether the RD- and DHCPv6-relay will always announce the DNS on the router itself instead of the one provided from the upstream router | | ||
| + | | ''rewrite_dns_addr'' | <IPv6-address> | no | '''' | Override the announced DNS-server with the specified address | | ||
| | ''always_assume_default'' | [0,1] | no | 0 | Define whether the RD-server will assume that IPv6 connectivity is present even if no public addresses are announced. | | | ''always_assume_default'' | [0,1] | no | 0 | Define whether the RD-server will assume that IPv6 connectivity is present even if no public addresses are announced. | | ||
| + | | ''management_level'' | [0,1,2] | no | 0 | Define DHCPv6 mode. 0: stateless (no M-flag, A-flags set), 1: hybrid (M-Flag and A-flags set), 2: stateful-only (M-Flag set, A-Flags unset). | | ||
| + | |||
| + | |||
| + | \\ | ||
| + | A section of type lease assigns the client with the given duid adresses from every available prefix with the interface id ::1234/128. | ||
| + | The pool for non-static leases is ::100-::fff. The leasefile can be found at /tmp/hosts/6relayd for getting duids, hostnames, etc. | ||
| + | ^ Name ^ Values ^ Description ^ | ||
| + | | ''duid'' | hexadecimal | The device unique identifier. | | ||
| + | | ''id'' | hexadecimal (up to 8 chars) | The id for this lease, e.g. 1234. | | ||
doc/uci/6relayd.1358256974.txt.bz2 · Last modified: 2013/01/15 14:36 by steven