User Tools

Site Tools


doc:uci:6relayd

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:uci:6relayd [2013/01/15 14:36]
steven
doc:uci:6relayd [2014/07/15 13:49] (current)
theoradicus prettify
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.+:!: 6relayd ​is deprecated since [[https://dev.openwrt.org/changeset/40893|r40893]]
  
-6relayd ​is an IPv6-tool that relays ​IPv6-management protocols ​like router +:!: use [[doc/​techref/​odhcpd]] 
-discoveryneighbor discovery ​and DHCPv6 ​so that clients on routed (non- + 
-bridged) interfaces ​can use the public address prefix, DHCPv6 and DNS-service +The ''/​etc/​config/​6relayd''​ configures the //​6relayd// ​IPv6 server & relay. 
-of a master interface. This is useful to avoid NAT in chained IPv6-routers.+ 
 +6relayd is a daemon for serving and relaying ​IPv6 management protocols ​to 
 +configure clients and downstream routers. 
 + 
 +6relayd provides server services for RAstateless ​and stateful ​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 ====
  
  
-**Example #1: Provide Router Discovery and stateless ​DHCPv6 in server mode and+**Example #1: Provide Router Discovery and DHCPv6 in server mode and
 fallback to relaying if there is no public prefix on the master interface. ** fallback to relaying if there is no public prefix on the master interface. **
  
 | ''​config server | ''​config server
-       ​option master ​  '​wan'​ 
        ​option network ​ 'lan guest'        ​option network ​ 'lan guest'
        ​option rd       '​server'​        ​option rd       '​server'​
        ​option dhcpv6 ​  '​server'​        ​option dhcpv6 ​  '​server'​
 + # Remove the 2 following lines to disable fallback-mode
 +       ​option master ​  '​wan6'​
        ​option fallback_relay ​     'rd dhcpv6 ndp'''​ |        ​option fallback_relay ​     'rd dhcpv6 ndp'''​ |
  
  
-**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 36: Line 41:
  
  
-**Example #3: Provide Router Discovery and stateless DHCPv6 in server mode 
-This can be used as a small radvd and stateless DHCPv6-server replacement.** 
  
-| ''​config ​server +**Example #3: Create a static IPv6 lease while running in management_level 1 or 2.** 
-       ​option ​network  ​'lan+| ''​config ​lease 
-       ​option ​rd       'server'​ +       ​option ​duid '0001000115c4599a4b5b3a5a21d9
-       ​option dhcpv6 ​  '​server'''​ |+       ​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 65:
 | ''​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 (M-Flag set, A-Flags unset). |
 +| ''​management_offlink''​ | [0,1] | no | 0 | Announce prefixes as off-link (L-flags unset). |
 +| ''​management_preference''​ | [medium,​low,​high] | no | medium | Preference value announced for default router and routes. |
 +
 +
 +\\
 +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