3.2.43. ipoe-server

Note

requires a BNG IPoE Application License.

The IPoE server services configuration.

vsr running config# vrf <vrf> ipoe-server

enabled

Enable IPoE server.

vsr running config# vrf <vrf> ipoe-server
vsr running ipoe-server# enabled true|false
Default value
true

log-level

Log level to display.

vsr running config# vrf <vrf> ipoe-server
vsr running ipoe-server# log-level LOG-LEVEL

LOG-LEVEL values

Description

disable

Disable logging.

error

Display error message.

warning

Display error and warning message.

notice

Display error, warning and notice message.

info

Display all messages except debug.

debug

Display all messages.
Default value
error

dhcp-relay

Enable configuring IPoE DHCP relay agent.

vsr running config# vrf <vrf> ipoe-server dhcp-relay

offer-timeout

unit: seconds

Time in seconds to wait between the reception of a DHCP OFFER from the server and the sending the DHCP ACK to the client before expiring the IPoE session.

vsr running config# vrf <vrf> ipoe-server dhcp-relay
vsr running dhcp-relay# offer-timeout <uint16>
Default value
10

server-timeout

unit: seconds

Time in seconds to wait during the DHCP initialization (DISCOVER, OFFER, REQUEST, ACK) for a response from the DHCP server before retransmitting the packet. If no response is received after the last transmission, the session expires.

vsr running config# vrf <vrf> ipoe-server dhcp-relay
vsr running dhcp-relay# server-timeout <uint16>
Default value
3

server-retransmit

Maximum number of retransmission during the DHCP initialization (DISCOVER, OFFER, REQUEST, ACK) of a packet from the DHCP relay to the server before the expiration of the IPoE session.

vsr running config# vrf <vrf> ipoe-server dhcp-relay
vsr running dhcp-relay# server-retransmit <uint16>
Default value
3

router

Router DHCP Option 3 value to insert (or replace if it was set by the server) when relaying the DHCP packets from the server to the DHCP clients.

vsr running config# vrf <vrf> ipoe-server dhcp-relay
vsr running dhcp-relay# router ROUTER

ROUTER

An IPv4 address.

server

List of DHCP server IP address to which DHCP queries should be relayed.

vsr running config# vrf <vrf> ipoe-server dhcp-relay
vsr running dhcp-relay# server SERVER

SERVER

An IPv4 address.

interface

Interface on which the DHCP relay agent must listen to client DHCP requests.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface>

<interface>

An interface name.

router

Router DHCP Option 3 value to insert (or replace if it was set by the server) when relaying the DHCP packets from the server to the DHCP clients.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface>
vsr running interface <interface># router ROUTER

ROUTER

An IPv4 address.

server

List of DHCP server IP address to which DHCP queries should be relayed.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface>
vsr running interface <interface># server SERVER

SERVER

An IPv4 address.

agent-information

Configure Relay Agent information parameters like the Gateway IP ADDress (giaddr) and DHCP option 82.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface> agent-information
relay-address

Relay Agent IP Address to use as source and set in DHCP giaddr header when relaying the DHCP packets from the client to the DHCP servers.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface> agent-information
vsr running agent-information# relay-address RELAY-ADDRESS

RELAY-ADDRESS

An IPv4 address.
trusted-circuit

Defines whether the circuit between the source of the DHCP request and this relay agent is trusted in accordance with section 2.1 of RFC3046. A circuit is generally considered trusted if it is managed by the same entity. If true (trusted), all incoming requests are accepted, even if they have already passed through a relay agent. If false (untrusted), DHCP requests containing a giaddr (relay agent address) or option 82 DHCP Agent Information are discarded.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface> agent-information
vsr running agent-information# trusted-circuit true|false
Default value
false
remote-id

Agent Remote ID DHCP Option 82.2 to append when relaying the DHCP packets to the DHCP servers. It identifies the remote end device. Option 82 including option 82.1 (Circuit-ID) containing the relay input interface is only sent to the server if at least one of the remote-id or link-selection options is enabled. The use of this option is detailed in RFC3046.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface> agent-information remote-id
global

Global Agent Remote ID DCHP Option 82.2 value to append when relaying to DHCP packets to the DHCP servers. Because this value applies globally to all remote devices, it does not comply with RFC3046. However, it does ensure compatibility with certain DHCP implementations.

vsr running config# vrf <vrf> ipoe-server dhcp-relay interface <interface> agent-information remote-id
vsr running remote-id# global <string>

limits

IPoE DHCP replay limits configuration.

vsr running config# vrf <vrf> ipoe-server limits

max-session

Specify number of active IPoE sessions connections per server.

vsr running config# vrf <vrf> ipoe-server limits
vsr running limits# max-session <uint16>

max-starting

Specify number of concurrent sessions starting per server. Session startup is over when the DHCP server sends an ACK or NACK, or when startup exceeds the timeout.

vsr running config# vrf <vrf> ipoe-server limits
vsr running limits# max-starting <uint16>