Administrator: /* Configuration Examples */

2015-01-29T18:16:17Z

Configuration Examples

← Older revision		Revision as of 18:16, 29 January 2015
Line 301:		Line 301:
	* You can make binding to specific client static, so that it always receives the same prefix		* You can make binding to specific client static, so that it always receives the same prefix
	<pre>		<pre>
	[admin@~~RB493G~~] /ipv6 dhcp-server binding> print		[admin@cablefree] /ipv6 dhcp-server binding> print
	Flags: X - disabled, D - dynamic		Flags: X - disabled, D - dynamic
	# ADDRESS DU IAID SER.. STATUS		# ADDRESS DU IAID SER.. STATUS
	0 D 2001:db8:7501:1::/62 16 0 loc.. bound		0 D 2001:db8:7501:1::/62 16 0 loc.. bound
	[admin@~~RB493G~~] /ipv6 dhcp-server binding> make-static 0		[admin@cablefree] /ipv6 dhcp-server binding> make-static 0

	</pre>		</pre>
Line 311:		Line 311:
	* DHCPv6 also installs route to assigned prefix into IPv6 routing table		* DHCPv6 also installs route to assigned prefix into IPv6 routing table
	<pre>		<pre>
	[admin@~~RB493G~~] /ipv6 route> print		[admin@cablefree] /ipv6 route> print
	Flags: X - disabled, A - active, D - dynamic, C - connect, S - static, r - rip, o - ospf, b - bgp, U - unreachable		Flags: X - disabled, A - active, D - dynamic, C - connect, S - static, r - rip, o - ospf, b - bgp, U - unreachable
	# DST-ADDRESS GATEWAY DISTANCE		# DST-ADDRESS GATEWAY DISTANCE

Administrator: /* Bindings */

2015-01-29T18:15:44Z

Bindings

← Older revision		Revision as of 18:15, 29 January 2015
Line 216:		Line 216:
	For example, dynamically assigned /62 prefix		For example, dynamically assigned /62 prefix
	<pre>		<pre>
	[admin@~~RB493G~~] /ipv6 dhcp-server binding> print detail		[admin@cablefree] /ipv6 dhcp-server binding> print detail
	Flags: X - disabled, D - dynamic		Flags: X - disabled, D - dynamic
	0 D address=2a02:610:7501:ff00::/62 duid="1605fcb400241d1781f7" iaid=0		0 D address=2a02:610:7501:ff00::/62 duid="1605fcb400241d1781f7" iaid=0

Administrator: Created page with "{{Versions|v5.9+}} ==Summary==
Standards: `RFC 3315, RFC 3633`
Package: `dhcp,ipv6`
Starting from v5.9 DHCPv6..."

2015-01-29T18:15:12Z

Created page with "{{Versions|v5.9+}} ==Summary== Standards: <code>RFC 3315, RFC 3633</code> Package: <code>dhcp,ipv6</code> Starting from v5.9 DHCPv6..."

New page

{{Versions|v5.9+}}

==Summary==

Standards: <code>RFC 3315, RFC 3633</code> 
Package: <code>dhcp,ipv6</code>


Starting from v5.9 DHCPv6 server is moved to /ipv6 sub menu

Single DUID is used for client and server identification, only IAID will vary between cients corresponding to their assigned interface.

Client binding creates dynamic pool with timeout set to binding's expiration time (note that now dynamic pools can have a timeout), which will be updated every time binding gets renewed.

When client is bound to prefix, DHCP server adds routing information to know how to reach assigned prefix.

Client bindings in server does not show MAC address anymore (as it was in v5.8), DUID (hex) and IAID are used instead. After upgrade MAC addresses will be converted to DUIDs automatically, but due to unknown DUID type and unknown IAID, they should be further updated by user;

==General==
Sub-menu: <code>/ipv6 dhcp-server</code>

This sub menu lists and allows to configure DHCPv6 servers.

'''Properties'''

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=address-pool
|type=string {{!}} static-only
|default=static-only
|desc=[[M:IPv6/Pool | IPv6 pool]], from which to take IPv6 prefix for the clients. If set to static-only, then only the clients that have a static binding (added in [[#Bindings | bindings]] submenu) will be allowed.
}}

{{Mr-arg-table
|arg=authoritative
|type=after-10sec-delay {{!}} after-2sec-delay {{!}} yes {{!}} no
|default=after-2sec-delay
|desc=Whether the DHCP server is the only one DHCP server for the network:
* <var>after-10sec-delay</var> - to clients request for an address, dhcp server will wait 10 seconds and if there is another request from the client after this period of time, then dhcp server will offer the address to the client or will send DHCPNAK, if the requested address is not available from this server
* <var>after-2sec-delay</var> - to clients request for an address, dhcp server will wait 2 seconds and if there is another request from the client after this period of time, then dhcp server will offer the address to the client or will send DHCPNAK, if the requested address is not available from this server
* <var>yes</var> - to clients request for an address that is not available from this server, dhcp server will send negative acknowledgment (DHCPNAK)
* <var>no</var> - dhcp server ignores clients requests for addresses that are not available from this server
}}

{{Mr-arg-table
|arg=binding-script
|type=string
|default=
|desc=Script that will be executed after binding is assigned or de-assigned. Internal "global" variables that can be used in the script:
* <var>bindingBound</var> - set to "1" if bound, otherwise set to "0"
* <var>bindingServerName</var> - dhcp server name
* <var>bindingDUID</var> - DUID
* <var>bindingAddress</var> - active address
* <var>bindingPrefix</var> - active prefix
}}

{{Mr-arg-table
|arg=delay-threshold
|type=time {{!}} none
|default=none
|desc=If secs field in DHCP packet is smaller than delay-threshold, then this packet is ignored. If set to none - there is no threshold (all DHCP packets are processed)
}}

{{Mr-arg-table
|arg=disabled
|type=yes {{!}} no
|default=no
|desc=Whether DHCPv6 server participate in prefix assignment process.
}}

{{Mr-arg-table
|arg=interface
|type=string
|default=
|desc=Interface on which server will be running.
}}

{{Mr-arg-table
|arg=lease-time
|type=time
|default=3d
|desc=The time that a client may use the assigned address. The client will try to renew this address after a half of this time and will request a new address after time limit expires.
}}

{{Mr-arg-table-end
|arg=name
|type=string
|default=
|desc=Reference name
}}

'''Read-only Properties'''

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-ro-table
|arg=dynamic
|type=yes {{!}} no
|desc=
}}

{{Mr-arg-ro-table-end
|arg=invalid
|type=yes {{!}} no
|desc=
}}

==Bindings==

Sub-menu: <code>/ipv6 dhcp-server binding</code>

DUID is used only for dynamic bindings, so if it changes then client will receive different prefix than previously.

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-table
|arg=address
|type=IPv6 prefix
|default=
|desc=IPv6 prefix that will be assigned to the client
}}

{{Mr-arg-table
|arg=comment
|type=string
|default=
|desc=Short description of an item.
}}

{{Mr-arg-table
|arg=disabled
|type=yes {{!}} no
|default=no
|desc=Whether item is disabled
}}

{{Mr-arg-table
|arg=life-time
|type=time
|default=3d
|desc=Time period after which binding expires/
}}

{{Mr-arg-table
|arg=duid
|type= hex string
|default=
|desc=DUID value. Should be specified only in hexadecimal format.
}}

{{Mr-arg-table
|arg=iaid
|type=integer [0..4294967295]
|default=
|desc=
}}

{{Mr-arg-table-end
|arg=server
|type=string {{!}} all
|default=all
|desc=Name of the server. If set to '''all''', then binding applies to all created DHCPv6 servers.
}}

'''Read-only properties'''

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-ro-table
|arg=dynamic
|type=yes {{!}} no
|desc=Whether item is dynamically created.
}}

{{Mr-arg-ro-table
|arg=expires-after
|type=time
|desc=Time period after which binding expires.
}}

{{Mr-arg-ro-table
|arg=last-seen
|type=time
|desc=Time period since client was last seen.
}}

{{Mr-arg-ro-table-end
|arg=status
|type=waiting {{!}} offered {{!}} bound
|desc=Three status vales are possible:
* '''waiting''' - Shown for static bindings if it is not used. For dynamic bindings this status is shown if it was used previously, server will wait 10 minutes to allow old client to get this binding, otherwise binding will be cleared and prefix willbe offered to other clients.
* '''offered''' - if '''solicit''' message was received, and server responded with '''advertise''' message, but '''request''' was not received. During this state client have 2 minutes to get this binding, otherwise it is freed or changed status to '''waiting''' for static bindings.
* '''bound''' - currently bound.
}}

For example, dynamically assigned /62 prefix
<pre>
[admin@RB493G] /ipv6 dhcp-server binding> print detail
Flags: X - disabled, D - dynamic
0 D address=2a02:610:7501:ff00::/62 duid="1605fcb400241d1781f7" iaid=0
server=local-dhcp life-time=3d status=bound expires-after=2d23h40m10s
last-seen=19m50s

1 D address=2a02:610:7501:ff04::/62 duid="0019d1393535" iaid=2
server=local-dhcp life-time=3d status=bound expires-after=2d23h43m47s
last-seen=16m13s

</pre>

===Menu specific commands===

{{Mr-arg-table-h
|prop=Property
|desc=Description
}}

{{Mr-arg-ro-table-end
|arg=make-static
|type=
|desc=Set dynamic binding as static.
}}

==Configuration Examples==

===Enabling IPv6 Prefix delegation===

Lets consider that we already have running DHCP server.

To enable IPv6 prefix delegation, first we need to create address pool

<pre>
/ipv6 pool add name=myPool prefix=2001:db8:7501::/60 prefix-length=62
</pre>
Notice that prefix-length is 62 bits, it means that clients will receive /62 prefixes from the /60 pool.

Next step is to enable DHCPv6.

<pre>
/ipv6 dhcp-server add name=myServer address-pool=myPool interface=local
</pre>

To test our server we will set up wide-dhcpv6 on ubuntu machine:
* install wide-dhcpv6-client
* edit "/etc/wide-dhcpv6/dhcp6c.conf" as above

{{ Note | You can use also RadioOS as DHCPv6-PD client. <code>[[M:IPv6/DHCP_Client#IPv6-PD_setup_example | Read more >>]] </code> }}

<pre>
interface eth2{
send ia-pd 0;
};

id-assoc pd {
prefix-interface eth3{
sla-id 1;
sla-len 2;
};
};

</pre>

* Run DHCPv6 client
<pre>
sudo dhcp6c -d -D -f eth2
</pre>

* Verify that prefix was added to eth3
<pre>
mrz@bumba:/media/aaa$ ip -6 addr
..
2: eth3: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qlen 1000
inet6 2001:db8:7501:1:200:ff:fe00:0/64 scope global
valid_lft forever preferred_lft forever
inet6 fe80::224:1dff:fe17:81f7/64 scope link
valid_lft forever preferred_lft forever
</pre>

* You can make binding to specific client static, so that it always receives the same prefix
<pre>
[admin@RB493G] /ipv6 dhcp-server binding> print
Flags: X - disabled, D - dynamic
# ADDRESS DU IAID SER.. STATUS
0 D 2001:db8:7501:1::/62 16 0 loc.. bound
[admin@RB493G] /ipv6 dhcp-server binding> make-static 0

</pre>

* DHCPv6 also installs route to assigned prefix into IPv6 routing table
<pre>
[admin@RB493G] /ipv6 route> print
Flags: X - disabled, A - active, D - dynamic, C - connect, S - static, r - rip, o - ospf, b - bgp, U - unreachable
# DST-ADDRESS GATEWAY DISTANCE
...
2 ADS 2001:db8:7501:1::/62 fe80::224:1dff:fe17:8... 1

</pre>

{{cont}}

[[Category:Manual|DHCP]]
[[Category:IPv6|DHCP]]

Manual:IPv6/DHCP Server - Revision history

Administrator: /* Configuration Examples */

Administrator: /* Bindings */

Administrator: Created page with "{{Versions|v5.9+}} ==Summary== Standards: RFC 3315, RFC 3633 Package: dhcp,ipv6 Starting from v5.9 DHCPv6..."

Administrator: Created page with "{{Versions|v5.9+}} ==Summary==
Standards: `RFC 3315, RFC 3633`
Package: `dhcp,ipv6`
Starting from v5.9 DHCPv6..."