DHCPv6 Service Configuration Mode Commands

The Dynamic Host Configuration Protocol (DHCP) for Internet Protocol Version 6 (IPv6) Service Configuration Mode is used to create and manage DHCPv6 service instances for the current context.

IMPORTANT:

The commands or keywords/variables that are available are dependent on platform type, product version, and installed license(s).

bind

Binds the DHCPv6 service to a logical IP interface facilitating the system’s connection to the DHCPv6 server.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
bind address ipv6_address [ port port_number ]

no bind address
no

Removes a previously configured binding.

address ipv6_address

Specifies the IP address of an interface in the current context through which the communication with the DHCPv6 server occurs. ipv6_address must be expressed in IPv6 colon-separated-hexadecimal notation.

port port_number

Specifies the listen port and is used to start the DHCPv6 server bound to it.

port_number must be an integer from 1 through 65535. If unspecified, the default port is 547.


Usage:

Use this command to associate or tie the DHCPv6 service to a specific logical IP address previously configured in the current context and bound to a port.

When this command is executed, the DHCPv6 service is started and begins the process of requesting addresses from the DHCPv6 server and storing them in cache memory for allocation to PDP contexts.

Only one interface can be bound to a service.


Example:
The following command binds the DHCPv6 service to the interface with an IP address of 1234:245:3456:4567:5678:6789:7890:8901:
bind address 1234:245:3456:4567:5678:6789:7890:8901
deadtime

Configures the amount of time that the system waits prior to re-communicating with a DHCPv6 server that was previously marked as down.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
deadtime max_time

default deadtime
default

Returns the command to its default setting of 120.

max_time

Specifies the maximum amount of time (in seconds) to wait before communicating with a DHCPv6 server that was previously unreachable.

max_time must be an integer value from 1 through 1932100.

Default: 120


Usage:

If the system is unable to communicate with a configured DHCPv6 server, after a pre-configured number of failures the system marks the server as being down.

This command specifies the amount of time that the system waits prior to attempting to communicate with the downed server.

IMPORTANT:

If all DHCPv6 servers are down, the system will immediately treat all DHCPv6 servers as active, regardless of the deadtime that is specified.

Refer to the detect-dead-server and max-retransmissions commands for additional information on the process the system uses to mark a server as down.


Example:
The following command configures the system to wait 600 seconds before attempting to re-communicate with a DHCPv6 server that was marked as down:
deadtime 600
detect-dead-server

Configures the number of consecutive communication failures that could occur before the system marks a DHCPv6 server as down.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
detect-dead-server consecutive-failures max_number

default detect-dead-server
consecutive-failures
default

Returns the command to its default setting of 5.

consecutive-failures max_number

Specifies the number of failures that could occur before marking a DHCPv6 server as down.

max_number must be an integer from 1 through 1000.

Default: 5


Usage:

This command works in conjunction with the max-retransmissions DHCPv6 client command to set a limit to the number of communication failures that can occur with a configured DHCPv6 server.

The max-retransmissions DHCPv6 client parameter limits the number of attempts to communicate with a server. Once that limit is reached, the system treats it as a single failure. This parameter limits the number of consecutive failures that can occur before the system marks the server as down and communicate with the server of next highest priority.

If all of the configured servers are down, the system ignores the detect-dead-server configuration and attempts to communicate with the highest priority server again.

If the system receives a message from a DHCPv6 server that was previously marked as down, the system immediately treats it as being active.


Example:
The following command configures the system to allow 8 consecutive communication failures with a DHCPv6 server before it marks it as down:
detect-dead-server
consecutive-failures 8
dhcpv6-client

Enters the DHCPv6 Client Configuration Mode.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
dhcpv6-client

Usage:

Use this command to cause the system to enter the DHCPv6 Client Configuration Mode where parameters are configured for the DHCPv6 client.

Entering this command results in the following prompt:

[context_name]hostname(config-dhcpv6-client)#

DHCPv6 Client Configuration Mode commands are defined in the DHCPv6 Client Configuration Mode Commands chapter.

dhcpv6-server

Enters the DHCPv6 Server Configuration Mode.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
dhcpv6-server

Usage:

Use this command to cause the system to enter the DHCPv6 Server Configuration Mode where parameters are configured for the DHCPv6 server.

Entering this command results in the following prompt:

[context_name]hostname(config-dhcpv6-server)#

DHCPv6 Server Configuration Mode commands are defined in the DHCPv6 Server Configuration Mode Commands chapter.

IMPORTANT:

Multiple DHCPv6 servers can be configured by entering the dhcpv6-server command multiple times. A maximum of 3 DHCPv6 servers can be configured.

end

Exits the current configuration mode and returns to the Exec mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
end

Usage:

Use this command to return to the Exec mode.

exit

Exits the current mode and returns to the parent configuration mode.

Product:

All


Privilege:

Security Administrator, Administrator


Syntax 
exit

Usage:

Use this command to return to the parent configuration mode.

server

Configures DHCPv6 servers with which the DHCPv6 service is to communicate and specifies the algorithm used to select DHCPv6 servers with which to communicate when multiple servers are configured.

Platform:

ASR 5000

ASR 5500

Product:

GGSN, P-GW, SAEGW


Privilege:

Security Administrator, Administrator


Syntax 
server { ipv6_address [ priority priority ] | selection-algorithm { first-server | round-robin } }

default server selection-algorithm

no server ipv6_address
default

Uses the first-server algorithm.

no

Deletes a previously configured DHCPv6 server.

ipv6_address

Specifies the IP address of the DHCPv6 server expressed in IPv6 colon-separated-hexadecimal notation.

priority priority

Specifies the priority of the server if multiple servers are configured.

priority is an integer from 1 through 1000. 1 is the highest priority.

selection-algorithm { first-server | round-robin }

Specifies the algorithm used to select DHCPv6 servers with which to communicate when multiple servers are configured.

first-server: Uses the first-server algorithm. This algorithm dictates that the system select the DHCPv6 servers according to their priority, starting with the highest priority server. The system communicates with the server of the next highest priority only when the previous server is unreachable.

Default: Enabled

round-robin: Uses the round-robin algorithm. This algorithm dictates that the system communicates with the servers in a circular queue according to the server’s configured priority, starting with the highest priority server. The next request is communicated with the next highest priority server, and so on until all of the servers have been used. At this point, the system starts from the highest priority server.

Default: Disabled


Usage:

Use this command to configure the DHCPv6 server(s) that the system is to communicate with. Multiple servers can be configured, each with their own priority. Up to 20 DHCPv6 servers can be configured.

In addition, use this command to determine how configured DHCPv6 servers are utilized by the system.

IMPORTANT:

If a server is removed, all calls having an IP address allocated from the server will be released.


Example:
The following command configures a DHCPv6 server with an IP address of 1234:245:3456:4567:5678:6789:7890:8901 and a priority of 1:
server 1234:245:3456:4567:5678:6789:7890:8901 priority 1