Administrator: Created page with "{{Versions|v5.9 +}} ==Summary== Currently DHCPv6 client can receive only delegated prefix from DHCPv6-PD server. ==Quick setup example== This simple example demonstrates h..."

2015-01-29T18:13:18Z

Created page with "{{Versions|v5.9 +}} ==Summary== Currently DHCPv6 client can receive only delegated prefix from DHCPv6-PD server. ==Quick setup example== This simple example demonstrates h..."

New page

{{Versions|v5.9 +}}

==Summary==

Currently DHCPv6 client can receive only delegated prefix from DHCPv6-PD server.

==Quick setup example==

This simple example demonstrates how to enable dhcp client to receive IPv6 prefix and add it to the pool.

<pre>
/ipv6 dhcp-client add pool-name=test-ipv6 pool-prefix-length=64 interface=ether13
</pre>

Detailed print should show status of the client and we can verify if prefix is received
<pre>
[admin@x86-test] /ipv6 dhcp-client> print detail
Flags: D - dynamic, X - disabled, I - invalid
0 interface=bypass pool-name="test-ipv6" pool-prefix-length=64 status=bound
prefix=2001:db8:7501:ff04::/62 expires-after=2d23h11m53s

</pre>

Notice that server gave us prefix 2a02:610:7501:ff04::/62 . And it should be also added to ipv6 pools

<pre>
[admin@CableFree] /ipv6 pool> print
Flags: D - dynamic
# NAME PREFIX PREFIX-LENGTH
0 D test-ipv6 2001:db8:7501:ff04::/62 64
</pre>

It works!
Now you can use this pool, for example, for pppoe clients.

==Properties==
Sub-menu: <code>/ipv6 dhcp-client</code>

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

{{Mr-arg-table
|arg=add-default-route
|type=yes {{!}} no
|default=no
|desc=Whether to add default IPv6 route after client connects.
}}

{{Mr-arg-table
|arg=comment
|type=string
|default=
|desc=Short description of the client
}}

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

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

{{Mr-arg-table
|arg=pool-name
|type=string
|default=
|desc=Name of the [[M:IPv6/Pool | IPv6 pool]] in which received IPv6 prefix will be added
}}

{{Mr-arg-table-end
|arg=pool-prefix-length
|type=string
|default=
|desc=Prefix length parameter that will be set for [[M:IPv6/Pool | IPv6 pool]] in which received IPv6 prefix is added. Prefix length must be greater than the length of received prefix, otherwise prefix-length will be set to received prefix length + 8 bits.
}}

==Status==

Command <code>/ipv6 dhcp-client print detail</code> will show current status of dhcp client and read-only properties listed in table below:

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

{{Mr-arg-ro-table
|arg=duid
|type=string
|desc=Auto generated DUID that is sent to the server. DUID is generated using one of the MAC addresses available on the router.
}}

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

{{Mr-arg-ro-table
|arg=expires-after
|type=time
|desc=Time when the IPv6 prefix expires (specified by the DHCPv6 server).
}}

{{Mr-arg-ro-table
|arg=invalid
|type=yes {{!}} no
|desc=Shows whether configuration is invalid.
}}

{{Mr-arg-ro-table
|arg=prefix
|type=IPv6 prefix
|desc=Shows received IPv6 prefix from DHCPv6-PD server
}}

{{Mr-arg-ro-table-end
|arg=status
|type=stopped {{!}} searching {{!}} requesting... {{!}} bound {{!}} renewing {{!}} rebinding {{!}} error {{!}} stopping
|desc=Shows the status of DHCPv6 Client:
* '''stopped''' - dhcpv6 client is stopped
* '''searching''' - sending "solicit" and trying to get "advertise"
* '''requesting''' - sent "request" waiting for "reply"
* '''bound''' - received "reply". Prefix assigned.
* '''renewing''' - sent "renew", waiting for "reply"
* '''rebinding''' - sent "rebind", waiting for "reply"
* '''error''' - reply was not received in time or some other error ocurred.
* '''stopping''' - sent "release"
}}

To determine what IAID will be used, convert internal ID of an interface on which DHCP client is running from hex to decimal.

For example, DHCP client is running on interface pppoe-out1.
To get internal ID use following command
<pre>
[admin@t36] /interface> :put [find name="pppoe-out1"]
*15
</pre>

Now convert hex value 15 to decimal and you get IAID=21

==Menu specific commands==

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

{{Mr-arg-ro-table
|arg=release
|type=numbers
|desc=Release current binding and restart DHCPv6 client
}}

{{Mr-arg-ro-table-end
|arg=renew
|type=numbers
|desc=Renew current leases. If the renew operation was not successful, client tries to reinitialize lease (i.e. it starts lease request procedure (rebind) as if it had not received an IP address yet)
}}

==Application Examples==

===Use received prefix for local RA===

Consider following setup:

[[File:dhcpv6-pd-example.png]]

* ISP is routing prefix 2001:DB8::/62 to the router R1
* Router R1 runs DHCPv6 server to delegate /64 prefixes to the customer routers CE1 CE2
* DHCP client on routers CE1 and CE2 receives delegated /64 prefix from the DHCP server (R1).
* Client routers uses received prefix to set up RA on the local interface

'''Configuration'''

'''R1'''
<pre>
/ipv6 route
add gateway=fe80::1:1%to-ISP

/ipv6 pool
add name=myPool prefix=2001:db8::/62 prefix-length=64

/ipv6 dhcp-server
add address-pool=myPool disabled=no interface=to-CE-routers lease-time=3m name=server1

</pre>

'''CE1'''
<pre>
/ipv6 dhcp-client
add interface=to-R1 pool-name=my-ipv6

/ipv6 address
add address=::1/64 from-pool=my-ipv6 interface=to-clients advertise=yes
</pre>

'''CE2'''
<pre>
/ipv6 dhcp-client
add interface=to-R1 pool-name=my-ipv6

/ipv6 address
add address=::1/64 from-pool=my-ipv6 interface=to-clients advertise=yes
</pre>

'''Check the status'''

After configuration is complete we can verify that each CE router received its own prefix

On server:
<pre>
[admin@R1] /ipv6 dhcp-server binding> print
Flags: X - disabled, D - dynamic
# ADDRESS DUID IAID SERVER STATUS
1 D 2001:db8:1::/64 0019d1393536 566 server1 bound
2 D 2001:db8:2::/64 0019d1393535 565 server1 bound
</pre>

On client:
<pre>
[admin@CE1] /ipv6 dhcp-client> print
Flags: D - dynamic, X - disabled, I - invalid
# INTERFACE STATUS PREFIX
0 to-R1 bound 2001:db8:1::/64

[admin@CE1] /ipv6 dhcp-client> /ipv6 pool print
Flags: D - dynamic
# NAME PREFIX PREFIX-LENGTH
0 D my-ipv6 2001:db8:1::/64 64
</pre>

We can also see that IPv6 address was automatically added from the prefix pool:
<pre>
[admin@CE1] /ipv6 address> print
Flags: X - disabled, I - invalid, D - dynamic, G - global, L - link-local
# ADDRESS FROM-POOL INTERFACE ADVERTISE
0 G 2001:db8:1::1/64 to-clients yes
..
</pre>
And pool usage shows that 'Address' is allocating the pool
<pre>
[admin@CE1] /ipv6 pool used> print
POOL PREFIX OWNER INFO
my-ipv6 2001:db8:1::/64 Address to-clients
</pre>

{{cont}}

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

Manual:IPv6/DHCP Client - Revision history

Administrator: Created page with "{{Versions|v5.9 +}} ==Summary== Currently DHCPv6 client can receive only delegated prefix from DHCPv6-PD server. ==Quick setup example== This simple example demonstrates h..."