VPLS service SAP DHCP snooping commands

dhcp

Syntax

dhcp

Context

config>service>vpls>sap

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

Commands in this context configure DHCP snooping parameters.

action

Syntax

action {replace | drop | keep}

no action

Context

config>service>vpls>sap>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command configures the Relay Agent Information Option (Option 82) processing.

The no form of this command reverts to the default value.

Default

no action

Parameters

replace

Specifies that in the upstream direction (from the user), the Option 82 field from the router is inserted in the packet (overwriting any existing Option 82 field). In the downstream direction (toward the user) the Option 82 field is stripped (in accordance with RFC 3046).

drop

Specifies that a DHCP packet is dropped if an Option 82 field is present, and a counter is incremented.

keep

Specifies that the existing information is kept in the packet and the router does not add any additional information. In the downstream direction the Option 82 field is not stripped and is forwarded toward the client.

The behavior is slightly different in case of Vendor Specific Options (VSOs). When the keep parameter is specified, the router inserts its own VSO into the Option 82 field. This is only done when the incoming message has already an Option 82 field.

If no Option 82 field is present, the router does not create the Option 82 field. In this in that case, no VSO is added to the message.

circuit-id

Syntax

circuit-id [ascii-tuple | vlan-ascii-tuple]

no circuit-id

Context

config>service>vpls>sap>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

When enabled, the router sends an ASCII-encoded tuple in the circuit-id sub-option of the DHCP packet. This ASCII-tuple consists of the access-node-identifier, service-id, and SAPID, separated by ‟|”. If no keyword is configured, then the circuit-id sub-option is not part of the information option (Option 82).

When the command is configured without any parameters, it equals to circuit-id ascii-tuple.

If disabled, the circuit-id sub-option of the DHCP packet is left empty.

Note:

By default, circuit-id is enabled if any of the other options, such as remote-id or vso, are configured.

Default

no circuit-id

Parameters

ascii-tuple

Specifies that the ASCII-encoded concatenated tuple is used which consists of the access-node-identifier, service-id, and interface-name is used.

hex

Specifies the circuit-id hex string.

vlan-ascii-tuple

Specifies that the format includes VLAN ID and dot1p bits as well as what is included in ascii-tuple already. The format is supported on dot1q and qinq encapsulated ports only. Therefore, when the Option 82 bits are stripped, dot1p bits are copied to the Ethernet header of an outgoing packet.

option

Syntax

[no] option

Context

config>service>vpls>sap>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables DHCP Option 82 (Relay Agent Information Option) parameters processing and enters the context for configuring Option 82 sub-options.

The no form of this command reverts to the default value.

Default

no option

remote-id

Syntax

remote-id [mac | string string]

no remote-id

Context

config>service>vpls>sap>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

When enabled, the router sends the MAC address of the remote end (typically the DHCP client) in the remote-id sub-option of the DHCP packet. This command identifies the host at the other end of the circuit.

If disabled, the remote-id sub-option of the DHCP packet is left empty.

The no form of this command reverts the system to the default.

Default

remote-id

Parameters

mac

Specifies the MAC address of the remote end is encoded in the sub-option.

string string

Specifies the remote-id.

vendor-specific-option

Syntax

[no] vendor-specific-option

Context

config>service>vpls>sap>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command configures the vendor specific sub-option of the DHCP relay packet.

client-mac-address

Syntax

[no] client-mac-address

Context

config>service>vpls>sap>dhcp>option>vendor

config>service>ies>if>dhcp>option>vendor

config>service>vprn>if>dhcp>option>vendor

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables sending the MAC address in the vendor specific sub-option of the DHCP relay packet.

The no form of this command disables the sending of the MAC address in the vendor specific sub-option of the DHCP relay packet.

sap-id

Syntax

[no] sap-id

Context

config>service>vpls>sap>dhcp>option>vendor

config>service>ies>if>dhcp>option>vendor

config>service>vprn>if>dhcp>option>vendor

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables sending the SAP ID in the vendor specific suboption of the DHCP relay packet.

The no form of this command disables the sending of the SAP ID in the vendor specific suboption of the DHCP relay packet.

service-id

Syntax

[no] service-id

Context

config>service>vpls>sap>dhcp>option>vendor

config>service>ies>if>dhcp>option>vendor

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables sending the service ID in the vendor specific suboption of the DHCP relay packet.

The no form of this command disables the sending of the service ID in the vendor specific suboption of the DHCP relay packet.

string

Syntax

[no] string text

Context

config>service>vpls>sap>dhcp>option>vendor

config>service>ies>if>dhcp>option>vendor

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command specifies the string in the vendor specific suboption of the DHCP relay packet.

The no form of this command reverts to the default value.

Parameters

text

The string can be any combination of ASCII characters up to 32 characters. If spaces are used in the string, enclose the entire string in quotation marks (‟ ”).

system-id

Syntax

[no] system-id

Context

config>service>vpls>sap>dhcp>option>vendor

config>service>ies>if>dhcp>option>vendor

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command specifies whether the system-id is encoded in the vendor specific sub-option of Option 82.

relay-plain-bootp

Syntax

relay-plain-bootp

no relay-plain-bootp

Context

config>service>vpls>if>dhcp

config>service>ies>if>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables the relaying of plain BOOTP packets.

The no form of this command disables the relaying of plain BOOTP packets.

server

Syntax

server server1 [server2...(up to 8 max)]

Context

config>service>ies>if>dhcp

config>service>vprn>if>dhcp (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command specifies a list of servers where requests are forwarded. The list of servers can be entered as either IP addresses or fully qualified domain names. There must be at least one server specified for DHCP relay to work. If there are multiple servers then the request is forwarded to all of the servers in the list.

There can be a maximum of eight DHCP servers configured.

Default

no server

Parameters

server

Specifies the DHCP server IP address.

trusted

Syntax

[no] trusted

Context

config>service>ies>if>dhcp

config>service>vprn>if>dhcp (not supported in access-uplink operating mode)

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables relaying of untrusted packets.

The no form of this command disables the relay.

Default

not enabled

snoop

Syntax

[no] snoop

Context

config>service>vpls>sap>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command enables DHCP snooping of DHCP messages on the SAP. Enabling DHCP snooping on VPLS interfaces (SAPs) is required where DHCP messages where Option 82 information is to be inserted. This includes interfaces that are in the path to receive messages from either DHCP servers or from subscribers.

The no form of this command disables DHCP snooping on the specified VPLS SAP.

Default

no snoop