Generic commands

shutdown

Syntax

[no] shutdown

Context

config>service>ies

config>service>ies>if

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command administratively disables an entity. When disabled, an entity does not change, reset, or remove any configuration settings or statistics. The operational state of the entity is disabled as well as the operational state of entities contained within. Many objects must be shut down before they may be deleted.

Services are created in the administratively down (shutdown) state. When a no shutdown command is entered, the service becomes administratively up and then tries to enter the operationally up state. Default administrative states for services and service entities is described as follows in Special Cases.

Note:
  • See the 7210  SAS-Mxp, R6, R12, S, Sx, T Basic System Configuration Guide for information about how to allocate addresses toward IP subnets using the configure system resource-profile router max-ip-subnets and config system global-res-profile max-ip-subnets CLI commands for the 7210 SAS-R6 and 7210 SAS-R12.

  • Before using IPv6, resources for IPv6 routes must be allocated. See the 7210  SAS-Mxp, R6, R12, S, Sx, T Basic System Configuration Guide for more information about how to use the configure system resource-profile router max-ipv6-routes and config system global-res-profile max-ipv6-routes CLI commands for the 7210 SAS-R6 and 7210 SAS-R12.

The no form of this command places the entity into an administratively enabled state.

Special Cases

IES

The default administrative status of an IES service is down. While the service is down, all its associated virtual router interfaces are operationally down. The administrative state of the service is not reflected in the administrative state of the virtual router interface; for example, if:

  • IES service is operational and an associated interface is shut down

  • IES service is administratively shutdown and brought back up

  • interface shutdown remains in administrative shutdown state

A service is regarded as operational as long as one IP Interface is operational.

IES IP Interfaces

When the IP interface is shut down, it enters the administratively and operationally down states. For a SAP bound to the IP interface, no packets are transmitted out the SAP and all packets received on the SAP are dropped while incrementing the packet discard counter.

description

Syntax

description long description-string

no description

Context

config>service>ies

config>service>ies>if>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to identify the content in the configuration file.

The no form of this command removes the string from the configuration.

Parameters

string

Specifies the description character string. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

dhcp

Syntax

dhcp

Context

config>service>ies >if

config>service>vprn >if

Platforms

Supported on all 7210 SAS platforms as described in this document

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

config>service>vprn >if>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document

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 different interfaces.

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. For group interfaces, a GI address must be specified in the group interface DHCP context or subscriber-interface DHCP context for DHCP to function.

Default

no gi-address

Parameters

ip-address

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

src-ip-address

Specifies that this GI address is to be the source IP address for DHCP relay packets.

action

Syntax

action {replace | drop | keep}

no action

Context

config>service>ies >if>dhcp>option

config>service>vprn >if>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

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

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

Default

no action

Parameters

replace

Keyword to specify 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

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

keep

Keyword to specify that existing information is kept in the packet and the router does not add more 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 VSO into the Option 82 field. This is done 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

config>service>vprn >if>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the router to send either an ASCII tuple or the interface index (If Index) on the specified SAP ID in the circuit-id sub-option of the DHCP packet.

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

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

Default

circuit-id ascii-tuple

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. Display the If Index of a router interface using the show router if detail command.

sap-id

Specifies that the SAP ID is used.

vlan-ascii-tuple

Specifies that the format includes VLAN ID, dot1p bits in addition to what is already included in the ascii-tuple. The format is supported on dot1q and qinq 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>ies >if>dhcp

config>service>vprn >if>dhcp

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables DHCP Option 82 (Relay Agent Information Option) parameters processing and enables 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>ies >if>dhcp>option

config>service>vprn >if>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command identifies the host at the other end of the circuit. 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.

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

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

Default

remote-id

Parameters

mac

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

config>service>vprn >if>dhcp>option

Platforms

Supported on all 7210 SAS platforms as described in this document

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>ies >if>dhcp>option>vendor

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

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

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

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

Platforms

Supported on all 7210 SAS platforms as described in this document

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.