IES interface DHCP commands

dhcp

Syntax

dhcp

Context

config>service>ies>if

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

Commands in this context configure DHCP parameters.

gi-address

Syntax

gi-address ip-address [src-ip-addr]

no gi-address

Context

config>service>ies>if>dhcp

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command configures the gateway interface address for the DHCP relay. A subscriber interface can include multiple group interfaces with multiple SAPs. When the router functions as a DHCP relay, the GI address is needed to distinguish between the different subscriber interfaces and potentially between the group interfaces defined.

By default, the GI address used in the relayed DHCP packet is the primary IP address of a normal IES interface. Specifying the GI address allows the user to choose a secondary address.

Default

no gi-address

Parameters

ip-address

Specifies the host IP address to be used for DHCP relay packets.

src-ip-address

Keyword that specifies that the GI address is to be used as the source IP address for DHCP relay packets.

option

Syntax

[no] option

Context

config>service>ies>if>dhcp

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command enables DHCP Option 82 (Relay Agent Information Option) parameter processing and enters the context for configuring Option 82 suboptions.

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

Default

no option

action

Syntax

action {replace | drop | keep}

no action

Context

config>service>ies>if>dhcp>option

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command configures the processing required when the 7210 SAS receives a DHCP request that already has a Relay Agent Information Option (Option 82) field in the packet.

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

Parameters

replace

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

Keyword to specify that the DHCP packet is dropped if an Option 82 field is present, and a counter is incremented.

keep

Keyword to specify 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 sent on 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 occurs only when the incoming message already has an Option 82 field.

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

circuit-id

Syntax

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

no circuit-id

Context

config>service>ies>if>dhcp>option

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command sends an ASCII-encoded tuple in the circuit-id suboption of the DHCP packet.

To send a tuple in the circuit ID, the action replace command must be configured in the same context.

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

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

Default

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, separated by ‟|”.

ifindex

Specifies that the interface index is used. (The If Index of a router interface can be displayed using the show router interface detail command)

sap-id

Specifies that the SAP identifier is used.

vlan-ascii-tuple

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

remote-id

Syntax

[no] remote-id [mac | string string]

Context

config>service>ies>if>dhcp>option

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command specifies what information goes into the remote-id suboption in the DHCP Relay packet.

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

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

Default

no remote-id

Parameters

mac

Keyword that specifies the MAC address of the remote end is encoded in the suboption.

string string

Specifies the remote-id.

vendor-specific-option

Syntax

[no] vendor-specific-option

Context

config>service>ies>if>dhcp>option

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

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

client-mac-address

Syntax

[no] client-mac-address

Context

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

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

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

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

sap-id

Syntax

[no] sap-id

Context

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

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command enables the sending of 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>ies>if>dhcp>option>vendor

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command enables the sending of 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>ies>if>dhcp>option>vendor

Platforms

7210 SAS-D, 7210 SAS-Dxp

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

Specifies a string that 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>ies>if>dhcp>option>vendor

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command specifies whether the system ID is encoded in the vendor-specific suboption of Option 82.

server

Syntax

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

Context

config>service>ies>if>dhcp

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command specifies a list of servers where requests will be forwarded. The list of servers can 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, the request is forwarded to all the servers in the list.

There can be a maximum of 8 DHCP servers configured.

Default

no server

Parameters

server

Specifies the DHCP server IP address.

trusted

Syntax

[no] trusted

Context

config>service>ies>if>dhcp

Platforms

7210 SAS-D, 7210 SAS-Dxp

Description

This command enables relaying of untrusted packets.

The no form of this command disables the relay.

Default

no trusted