# Ethernet Port Configuration Mode Commands

The Ethernet Port Configuration Mode is used to create and manage Ethernet ports and their bindings between contexts.

IMPORTANT:

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

Configures an association (binds) between a virtual IP interface, an SS7 or Frame Relay link to a specific context.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] bind
    interface interface_name context_name

no

Indicates the virtual interface specified is to be unbound from the context.
interface_name

Specifies the name of the virtual interface to be bound to the context as an alphanumeric string of 1 through 79 characters.
context_name

Specifies the name of the context to be bound to the virtual port. context_name must refer to a previously configured context.
Usage:

Bind an interface to a context to allow the context to provide service.
Example:

    bind interface sampleVirtual sampleContext

    no bind interface sampleVirtual sampleContext

boxertap

Binds a a physical port to a named interface for debugging purposes.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] boxertap interface_name

no

Unbinds the physical port to the interface.
interface_name

Specifies the name of the virtual interface to be bound to the physical port as an alphanumeric string of 1 through 79 characters.
Usage:

Bind a physical port to a named interface for debugging purposes.
Example:

    boxertap ggsn01

    no boxertap ggsn01

default

Restores the speed and communication mode of the default interface for the specified context.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    default { flow-control | link-aggregation { lacp | redundancy } | medium | preferred
    slot | threshold { high-activity | monitoring | rx-utilization | tx-utilization } }

flow-control

ASR 5000: Restores the default behavior to advertise symmetric flow control.

ASR 5500: Restores the MIO card default to no flow control.
link-aggregation { lacp | redundancy }
Restores the default values for link-aggregation as follows:

- lacp: Active – sends out LACP packets periodically.
- redundancy: Standard – treats all cards in the group as one group.

medium
ASR 5000: Restores the default values for the medium options as follows:

- SPIO and fast ethernet line cards: auto
- Gigabit ethernet line card: auto

ASR 5500: Restores the MIO card default medium value to auto.
preferred slot

Sets the port for non-revertive operation for port redundancy auto-recovery; requiring an administrative user to manually issue a port switch to command to return service to the original port.
threshold { high-activity | monitoring | rx-utilization | tx-utilization }
Restores the specified port-level threshold parameters to its default value(s). The possible values are:

- high-activity: High port activity threshold settings. Default: 50 percent
- monitoring: Threshold monitoring configuration settings. Default: Disabled
- rx-utilization: Receive port utilization threshold settings. Default: 80 percent
- tx-utilization: Transmit port utilization threshold settings. Default: 80 percent

Usage:

Restores port-level parameters to their default values.
Example:

    default medium

description

Sets the port descriptive text.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    description text

    no description

no

Clears the description for the port.
text

Specifies the descriptive text as an alphanumeric string of 1 to 79 characters.
Usage:

The description should provide useful information on the port’s primary function, services, end users, etc.
Example:

    description samplePortDescriptiveText

    description “This
    is a sample description”

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.
flow-control

Enables and disables flow control on the ASR 5000 Quad Gig-E line card (QGLC) and the ASR 5500 MIO card.
Platform:

ASR 5000
Product:

PDSN, SGSN, GGSN
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] flow-control

no

Disables flow control on the specified port.
Usage:

Flow control is enabled by default on the QGLC and can be disabled using the no command on a per-port basis. This command does not work on the Fast Ethernet Line Card (FELC), Gigabit Ethernet Line Card (GELC/GLC2) or 10 GigE Line Card (XGLC) which do not support flow control.

Flow control is not supported on the MIO card.
Example:
After flow control has been disabled, use the following command to enable flow control:

    flow-control

ingress-mode

Labels this port as an ingress port.
Platform:

ASR 5000
Product:

IPSG
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] ingress-mode

no

Disables ingress port tag.
Usage:

Use this command to label this port in order for the session manager to recognize the interface from which IP data packets are being received. This command should be used in single context configurations. In single context configurations, the ingress port can only be identified if labeled.
link-aggregation

Aggregates ports on an ASR 5000 Quad Gig-E line card (QGLC), or 10 Gig-E line cards (XGLCs), or an ASR 5500 Management Input/Output (MIO) card and sets related parameters in accordance with IEEE 802.3ad.
Platform:

ASR 5000
Product:

WiMAX, PDSN, HA, FA, GGSN, SGSN
Privilege:

Security Administrator, Administrator
Syntax

    link-aggregation { distribution { block | random | rotate | simple } | lacp { active | passive } [ rate { auto | fast | slow } ] [ timeout { long | short } ] | master
     { global group group_number | group group_number | local group group_number }  | member { global group group_number | group group_number | local group group_number } | redundancy { standard | switched } [ hold-time sec ] [ preferred
    slot { card_number | none } ] | toggle-link }no link-aggregation [ toggle-link ]default link-aggregation { distribution | lacp | redundancy | toggle-link }

distribution { block | random | rotate | simple }

Configures link aggregation distribution and controls how a Link Aggregation Group (LAG) hash map is generated. This method is required for Equal Cost Multi-Path (ECMP) routing over LAG. Set this option on the master port for use with the whole group. The following list defines the distribution options (assuming port index 0,1,2,3 were selected.

block: Blocks of the same port index (Example: 0000111122223333)

random: Based on pseudo random number

rotate: Repetition of rotated port index (Example: 0123123023013012…)

simple: Repetition of all selected port indexes (Example: 0123012301230123…)
lacp { active | passive }

Configures the Link Aggregation Control Protocol (LACP). Set this option on the master port for use with the whole group.

active mode sends out LACP packets periodically. (Default)

passive mode only responds to LACP packets received.
rate { auto | fast | slow }

Configures the rate at which the LACP sends packets.

auto: rate is controlled by the peer

fast: 1 seconds

slow: 30 seconds (Default) [ASR 5000 only]
timeout { long | short }

Configures LACP timeout events. Set this option on the master port for use with the whole group.

long: Set LACP to long timeout

short: Set LACP to short timeout
master { global group group_number | group group_number | local group group_number }

This command creates the Master port for the aggregated group.

global: Set group global across slots.

group group_number: Set link aggregation group number. group_number must be an integer between 1 and 1023.

local: Set group local within same slot.
member { global group group_number | group group_number | local group group_number }

This command makes the port a member of the aggregated group.

global: Set group global across slots.

group group_number: Set link aggregation group number. group_number must be an integer from 1 through 1023.

local: Set group local within same slot.
redundancy { standard | switched } [ hold-time sec ] [ preferred slot { card_number | none } ]

Connects top and bottom QGLCs, side-by-side XGLCs, or MIO cards, to different Ethernet switches. The master port must be set to make this effective for the group.

standard: Treats all cards in the group as one group. (Default)

switched: Assumes cards are connected to different switches. [ASR 5000 only]

hold-time sec: Sets the amount of time to hold (in seconds) before switching between cards. Applies to standard and switched modes. sec must be an integer from 0 through 3600. Default: 10

preferred slot { card_number | none }: Specifies the preferred behavior for a LAG using two Ethernet switches. Applies to standard and switched modes. card_number is an integer between 1 and 48 on an ASR 5000, or 5 or 6 on an ASR 5500.
When a card number is specified, system behavior varies based on the card type.

- QGLC (ASR 5000) – the preferred slot is selected only when both the top and bottom slots have the same number of active LACP ports.
- XGLC (ASR 5000) – the preferred slot is selected for the initial timeout period to make the selection of an Ethernet switch less random.

none: Specifies no preferred slot.
toggle-link

Set to toggle link on port switch.
default

Restores the default values.
no

This command deletes the Ethernet port from any group it might be in. If the port was the Master of a group, the whole group would be deleted.
Usage:

Configure from one to four ports on a QGLC (vertical aggregation) or the single port on XGLCs (horizontal aggregation), or traffic ports on an MIO card to be in an aggregation group that links to an aggregation group on a remote Ethernet switch. Very large files can be downloaded across all ports in a group, which makes for a faster download when compared to serial downloads over a single link.

Related link-aggregation commands are described in the Card Configuration Mode Commands and Global Configuration Mode Commands chapters of this guide. For additional information, also refer to the System Administration Guide.
Example:
The following example configures the port to be the Master for Group 2:

    link aggregation master
    group 2

media

Configures the port interface type.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    media { rj45 | sfp }

{ rj45 | sfp}

rj45: Sets the physical interface to copper RJ-45 connectors.

sfp: Sets the physical interface connection to optical Small Form Factor (SFP) gigabit via an SFP transceiver.
Usage:

Set the media option when the physical cabling interface is changed.
Example:
The following commands are entered one-at-a-time to set the physical interface to RJ-45 and SFP:

    media rj45

    media sfp

medium

Configures the port speed and communication mode.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    medium { auto | speed { 10 | 100 | 1000 | 10000 } duplex { full | half } }

{ auto | speed { 10 | 100 | 1000 | 10000 } duplex { full | half } }

Default: auto

Optionally sets the speed of the interface and the communication mode.

auto: configures the interface to auto negotiate the interface speed.

speed { 10 | 100 | 1000 | 10000 }: specifies the speed to use at all times.

duplex { full | half }: sets the communication mode of the interface to either full or half duplex.

IMPORTANT:

Ethernet networking rules dictate that if a device whose interface is configured to auto-negotiate is communicating with a device that is manually configured to support full duplex, the first device will negotiate to the manually configured speed of the second device but will only communicate in half duplex mode.
Usage:

Set the medium options when the physical interface changes.
Example:
The following configures the port’s speed and communication mode to be auto negotiated.

    medium auto

The following command configures the port’s interface speed to gigabit with full duplex communication.

    medium speed 1000 duplex full

preferred slot

Assigns revertive or non-revertive control to port redundancy auto-recovery.

Default: non-revertive operation
Platform:

ASR 5000
Product:

PDSN, FA, HA, SGSN, GGSN
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] preferred
    slot slot#

no

Disables revertive or auto-recovery operation for the selected port.
preferred slot slot#

Identifies the physical chassis slot where the ASR 5000 line card or SPIO card, or the ASR 5500 MIO card is installed.
Usage:

This command enables or disables revertive port redundancy, wherein after a port failover, when the original port is restored to service (such as link up) the system will return service to that port automatically.

Disabled, which is the default setting, causes non-revertive operation; requiring an administrative user to manually issue an Exec mode link-aggregation port switch to command to return service to the original port.

This command must be issued on a per port basis, allowing you to configure specific ports to be used on individual line card, SPIO, or an MIO card.

IMPORTANT:

This command is not supported on all platforms.
Example:
For ASR 5000:

    preferred slot 17

For ASR 5500:

    preferred slot 5

shutdown

Terminates all processes supporting the port or blocks the shutting down of the port. Conversely, the port is enabled with the use of the no keyword.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] shutdown

no

Enables the port and places it in service.
Usage:

Shut down a port prior to re-cabling and/or other maintenance activities.

This command is necessary to bring a port into service by enabling it via the no keyword.
Example:
Use the following command to disable the port:

    shutdown

Use the following command to enable the port for service:

    no shutdown

snmp trap link-status

Enables or disables the generation of an SNMP trap for link status changes.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] snmp
    trap link-status

no

Disables the sending of traps for link status changes.
Usage:

Enable link status change traps when a monitoring facility can use the information or if there are troubleshooting activities in progress.
Example:
Use the following command to disable sending of traps:

    no snmp trap link-status

srp virtual-mac-address

Configures the Standby Router Protocol (SRP) virtual MAC address for the port.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    srp virtual-mac-address MAC_Address

    no srp virtual-mac-address

no

Disables the SRP virtual MAC addressing for Ethernet ports. The block of virtual MAC addresses is not saved.
MAC_Address

Enables SRP virtual addressing for the specified MAC address.
Usage:

The SRP virtual MAC address is applied to the port when the chassis is in SRP ACTIVE state. The default is no srp virtual-mac-address.

IMPORTANT:

This command is not supported on all platforms.

Example

Example
Use the following command to enable the SRP’s virtual MAC addressing:

    srp virtual-mac-address
     MAC_Address

threshold high-activity

Configures thresholds for high port activity for the port.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    threshold high-activity high_thresh [ clear low_thresh  ]

high_thresh

Specifies the high threshold high port activity percentage that must be met or exceeded within the polling interval to generate an alert or alarm. The percentage is expressed as an integer from 0 through 100. Default: 50
clear

Allows the configuration of the low threshold.
low_thresh

Specifies the low threshold high port activity percentage that maintains a previously generated alarm condition. If the activity percentage falls below the low threshold within the polling interval, a clear alarm will be generated. The percentage is expressed as an integer from 0 through 100. Default: 50

IMPORTANT:

This value is ignored for the Alert model. In addition, if this value is not configured for the Alarm model, the system assumes it is identical to the high threshold.
Usage:

High port activity thresholds generate alerts or alarms based on the utilization percentage of each configured port during the specified polling interval. This threshold is configured on a per-port basis.
Alerts or alarms are triggered for high port activity based on the following rules:

- Enter condition: Actual percent utilization of a port is greater than High Threshold.
- Clear condition: Actual percent utilization of a port is less than Low Threshold.

If a trigger condition occurs within the polling interval, the alert or alarm will not be generated until the end of the polling interval.

Refer to the threshold poll command in the Global Configuration Mode Commands chapter to configure the polling interval and the threshold monitoring command in this chapter to enable thresholding for this value.
Example:
The following command configures a high port utilization threshold percent of 70 and a low threshold percent of 50 for a system using the Alarm thresholding model:

    threshold high-activity
    70 clear 50

threshold monitoring

Enables or disables thresholding for port-level values.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    [ no ] threshold monitoring

no

Disables threshold monitoring for port-level values. This is the default setting.
Usage:

Thresholding on the system is used to monitor the system for conditions that could potentially cause errors or outage. Typically, these conditions are temporary (such as high-activity) and are quickly resolved. However, continuous or large numbers of these error conditions within a specific time interval may be indicative of larger, more severe issues. Thresholding helps identify potentially severe conditions so that immediate action can be taken to minimize and/or avoid system downtime.
Thresholding reports conditions using one of the following mechanisms:

- SNMP traps: SNMP traps have been created that indicate the condition (high threshold crossing and/or clear) of each of the monitored values. Complete descriptions and other information pertaining to these traps is located in the starentMIB(8164).starentTraps(2) section of the SNMP MIB Reference. The generation of specific SNMP traps can be enabled or disabled on the system allowing you to view only those traps that are most important to you.
- Logs: The system provides a facility called threshold for which active and event logs can be generated. As with other system facilities, logs are generated Log messages pertaining to the condition of a monitored value are generated with a severity level of WARNING.
- Alarm System: High threshold alarms generated within the specified polling interval are considered “outstanding” until a the condition no longer exists and/or a condition clear alarm is generated.

“Outstanding” alarms are reported to through the system’s alarm subsystem and are viewable through the system’s CLI.

The following table indicates the reporting mechanisms supported by each of the above models.
Table 1. Thresholding Reporting Mechanisms by Model

Model | SNMP Traps | Logs | Alarm System
--- | --- | --- | ---
Alert | X | X |
Alarm | X | X | X

This command enables thresholding for port-level values. Refer to the threshold high-activity, threshold rx-utilization, and threshold tx-utilization commands in this chapter for information on configuring these values. In addition, refer to the threshold poll command in the Global Configuration Mode Commands chapter for information on configuring the polling interval over which these values are monitored.
threshold rx-utilization

Configures thresholds for receive port utilization.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    threshold rx-utilization high_thresh [ clear low_thresh ]

high_thresh

Specifies the high threshold receive port utilization percentage that must be met or exceeded within the polling interval to generate an alert or alarm. The percentage is expressed as an integer from 0 through 100. Default: 80
clear

Allows the configuration of the low threshold.
low_thresh

Specifies the low threshold receive port utilization percentage that maintains a previously generated alarm condition. If the utilization percentage falls below the low threshold within the polling interval, a Clear Alarm will be generated. The percentage is expressed as an integer from 0 through 100. Default: 80

IMPORTANT:

This value is ignored for the Alert model. In addition, if this value is not configured for the Alarm model, the system assumes it is identical to the high threshold.
Usage:

Receive port utilization thresholds generate alerts or alarms based on the utilization percentage of each configured port in relation to data received during the specified polling interval. This threshold is configured on a per-port basis.

IMPORTANT:

Ports configured for half-duplex do not differentiate between data received and data transmitted. Therefore, to avoid redundant alarms, it is recommended that only the receive or transmit utilization threshold be configured.
Alerts or alarms are triggered for receive port utilization based on the following rules:

- Enter condition: Actual percent utilization of a port for received data is greater than High Threshold
- Clear condition: Actual percent utilization of a port for received data is less than Low Threshold

If a trigger condition occurs within the polling interval, the alert or alarm will not be generated until the end of the polling interval.

Refer to the threshold poll command in the Global Configuration Mode Commands chapter to configure the polling interval and the threshold monitoring command in this chapter to enable thresholding for this value.
Example:
The following command configures a receive port high utilization threshold percent of 70 and a low threshold percent of 50 for an system using the Alarm thresholding model:

    threshold rx-utilization
    70 clear 50

threshold tx-utilization

Configures thresholds for transmit port utilization.
Platform:

ASR 5000
Product:

All
Privilege:

Security Administrator, Administrator
Syntax

    threshold tx-utilization  high_thresh [ clear low_thresh ]

high_thresh

The high threshold transmit port utilization percentage that must be met or exceeded within the polling interval to generate an alert or alarm. The percentage is expressed as an integer from 0 through 100. Default: 80
clear

Allows the configuration of the low threshold.
low_thresh

The low threshold transmit port utilization percentage that maintains a previously generated alarm condition. If the utilization percentage falls below the low threshold within the polling interval, a clear alarm will be generated. The percentage is expressed as an integer from 0 through 100. Default: 80

IMPORTANT:

This value is ignored for the Alert model. In addition, if this value is not configured for the Alarm model, the system assumes it is identical to the high threshold.
Usage:

Transmit port utilization thresholds generate alerts or alarms based on the utilization percentage of each configured port in relation to data transmitted during the specified polling interval. This threshold is configured on a per-port basis.

IMPORTANT:

Ports configured for half-duplex do not differentiate between data received and data transmitted. Therefore, to avoid redundant alarms, it is recommended that only the receive or transmit utilization threshold be configured.
Alerts or alarms are triggered for transmit port utilization based on the following rules:

- Enter condition: Actual percent utilization of a port for transmit data is greater than High Threshold
- Clear condition: Actual percent utilization of a port for transmit data is less than Low Threshold

If a trigger condition occurs within the polling interval, the alert or alarm will not be generated until the end of the polling interval.

Refer to the threshold poll command in the Global Configuration Mode Commands chapter to configure the polling interval and the threshold monitoring command in this chapter to enable thresholding for this value.
Example:
The following command configures a transmit port high utilization threshold percent of 70 and a low threshold of 50 for an system using the Alarm thresholding model:

    threshold tx-utilization
    70 clear 50

vlan

Enters VLAN Configuration mode. Creates VLAN if necessary.
Platform:

ASR 5000
Product:

HA, HSGW, PDSN, P-GW, SGSN
Privilege:

Security Administrator, Administrator
Syntax

    vlan vlan_id

vlan_id

Specifies a VLAN identifier as an integer from 1 through 4094. If this identifier does not already exist you are prompted to confirm the identifier an a new one is created.
Usage:

Use this command to specifiy an existing VLAN ID or create a new VLAN ID and enter the VLAN Configuration mode.

For addiitonal information, refer to the VLAN Configuration Mode Commands chapter.
Example:
The following command creates the VLAN ID 234.

    vlan 234

    Are
    you sure? [Yes|No]: y