Configuring Physical Interface Properties

The software driver for each network media type sets reasonable default values for general interface properties, such as the interface's maximum transmission unit (MTU) size, receive and transmit leaky bucket properties, link operational mode, and clock source. To modify any of the default general interface properties, include the appropriate statements at the [edit interfaces interface-name] hierarchy level:

interfaces {

    traceoptions {

        file filename <files number> <size size> <(world-readable | no-world-readable)>;

        flag flag <disable>; 

    }

    interface-name {

        accounting-profile name;

        aggregated-ether-options {

            ethernet-switch-profile {

                tag-protocol-id {

            (flow-control | no-flow-control);

            lacp mode {

                periodic interval;

            }

            link-speed speed;

            (loopback | no-loopback);

            minimum-links number;

            source-address-filter {

                mac-address;

            }

            (source-filtering | no-source-filtering);

        }

        aggregated-sonet-options {

            link-speed (speed | mixed);

            minimum-links number;

        }

        atm-options {

            cell-bundle-size cells;

            ilmi;

            linear-red-profiles profile-name {

                high-plp-max-threshold percent;

                low-plp-max-threshold percent;

                queue-depth cells high-plp-threshold percent low-plp-threshold percent;

            }

            mpls {

                pop-all-labels {

                    required-depth number;

                }

            }

            pic-type (atm1 | atm2);

            plp-to-clp;

            promiscuous-mode {

                vpi vpi-identifier;

            }

            scheduler-maps map-name {

                forwarding-class class-name {

                    epd-threshold cells plp1 cells;

                    linear-red-profile profile-name;

                    priority (high | low);

                    transmit-weight (cells number | percent number);

                }

                vc-cos-mode (alternate | strict);

            }

            vpi vpi-identifier {

                maximum-vcs maximum-vcs;

                oam-liveness {

                    up-count cells;

                    down-count cells;

                }

                oam-period (seconds | disable);

                shaping {

                    (cbr rate | rtvbr peak rate sustained rate burst length | 

                                  vbr peak rate sustained rate burst length); 

                    queue-length number;

                } 

            }

        }

        clocking clock-source;

        dce;

        description text;

        dialer-options {

            modem-options {

                init-command-string initialization-command-string; 

            pool pool-name priority number;

            }

        }

        disable;

        ds0-options {

            bert-algorithm algorithm;

            bert-error-rate rate; 

            bert-period seconds; 

            byte-encoding (nx56 | nx64);

            fcs (16 | 32);

            idle-cycle-flag (flags | ones); 

            invert-data;

            loopback payload; 

            start-end-flag (filler | shared);

        }

        e1-options {

            bert-error-rate rate; 

            bert-period seconds; 

            fcs (16 | 32);

            framing (g704 | g704-no-crc4 | unframed);

            idle-cycle-flag (flags | ones); 

            invert-data;

            loopback (local | remote); 

            start-end-flag (filler | shared);

            timeslots time-slot-range;

        }

        e3-options {

            atm-encapsulation (direct | plcp);

            bert-algorithm algorithm; 

            bert-error-rate rate; 

            bert-period seconds; 

            buildout feet;

            compatibility-mode (digital-link | kentrox | larscom) <subrate value>; 

            fcs (16 | 32);

            framing (g.751 | g.832);

            idle-cycle-flag (filler | shared); 

            loopback (local | remote); 

            (payload-scrambler | no-payload-scrambler); 

            start-end-flag value; 

            (unframed | no-unframed);

        }

        encapsulation type;

        es-options {

            backup-interface es-fpc/pic/port;

        }

        fastether-options {

            802.3ad aex;

            (flow-control | no-flow-control);

            ingress-rate-limit rate;

            (loopback | no-loopback);

            source-address-filter {

                mac-address;

            }

            (source-filtering | no-source-filtering);

        }

        framing {

            (lan-phy | wan-phy | sonet | sdh);

        {

        gigether-options {

            802.3ad aex;

            (flow-control | no-flow-control);

            (loopback | no-loopback);

            source-address-filter {

                mac-address;

            }

            (source-filtering | no-source-filtering);

            ethernet-switch-profile {

                (mac-learn-enable | no-mac-learn-enable);

                tag-protocol-id [ tpids ];

                ethernet-policer-profile {

                    input-priority-map {

                        ieee802.1p premium [ values ];

                    }

                    output-priority-map {

                        classifier { 

                            premium { 

                                forwarding-class class-name {

                                     loss-priority (high | low);

                                }

                            }

                        }

                    }

                    policer cos-policer-name {

                        aggregate {

                            bandwidth-limit bps;

                            burst-size-limit bytes;

                        }

                        premium {

                            bandwidth-limit bps;

                            burst-size-limit bytes;

                        }

                    }

                }

            }

        }

        (gratuitous-arp-reply | no-gratuitous-arp-reply);

        hold-time up milliseconds down milliseconds;

        isdn-options {

            bchannel-allocation (ascending | descending);

            calling-number number;

            spid1 spid-string;

            spid2 spid-string;

            static-tei-val value;

            switch-type (att5e | etsi | ni1 | ntdms100 | ntt); 

            t310 seconds;

            tei-option (first-call | power-up);

        }

        keepalives <down-count number> <interval seconds> <up-count number>;

        link-mode mode;

        lmi {

            lmi-type (ansi | itu);

            n391dte number;

            n392dce number;

            n392dte number;

            n393dce number;

            n393dte number;

            t391dte seconds;

            t392dce seconds;

        }

        mac mac-address;

        mlfr-uni-nni-bundle-options {

            acknowledge-retries number;

            acknowledge-timer milliseconds;

            action-red-differential-delay (disable-tx | remove-link);

            cisco-interoperability send-lip-remove-link-for-link-reject;

            drop-timeout milliseconds;

            fragment-threshold bytes;

            hello-timer milliseconds;

            link-layer-overhead percent;

            lmi-type (ansi | itu);

            minimum-links number;

            mrru bytes;

            n391 number;

            n392 number;

            n393 number;

            red-differential-delay milliseconds;

            t391 seconds;

            t392 seconds;

            yellow-differential-delay milliseconds;

        }

        mtu bytes;

        multiservice-options {

            boot-command filename;

            (core-dump | no-core-dump);

            (syslog | no-syslog);

        }

        no-gratuitous-arp-request;

        no-keepalives;

        no-partition {

            interface-type type;

        }

        optics-options {

            wavelength nm;

    )

        partition partition-number oc-slice oc-slice-range interface-type type {

            timeslots time-slot-range;

        }

        passive-monitor-mode;

        per-unit-scheduler;

        ppp-options {

            chap {

                access-profile name;

                local-name name;

                 passive;

            }

            compression {

                acfc;

                pfc;

            }

        }

            pap {

                access-profile name;

                local-name name;

                local-password password;

                 passive;

        receive-bucket {

            overflow (discard | tag);

            rate percentage;

            threshold bytes;

        }

        redundancy-options {

            primary sp-fpc/pic/port;

            secondary sp-fpc/pic/port;

        }

        schedulers number;

        serial-options {

            clock-rate rate;

            clocking-mode (dce | dte | loop);

            control-polarity (negative | positive);

            cts-polarity (negative | positive);

            dcd-polarity (negative | positive);

            dce-options {

                control-signal (assert | de-assert | normal);

                cts (ignore | normal | require);

                dcd (ignore | normal | require);

                dsr (ignore | normal | require);

                dtr signal-handling-option;

                ignore-all;

                indication (ignore | normal | require);

                rts (assert | de-assert | normal);

                tm (ignore | normal | require);

            }

            dsr-polarity (negative | positive);

            dte-options {

                control-signal (assert | de-assert | normal);

                cts (ignore | normal | require);

                dcd (ignore | normal | require);

                dsr (ignore | normal | require);

                dtr signal-handling-option;

                ignore-all;

                indication (ignore | normal | require);

                rts (assert | de-assert | normal);

                tm (ignore | normal | require);

            }

            dtr-circuit (balanced | unbalanced);

            dtr-polarity (negative | positive);

            encoding (nrz | nrzi);

            indication-polarity (negative | positive);

            line-protocol protocol;

            loopback mode;

            rts-polarity (negative | positive);

            tm-polarity (negative | positive);

            transmit-clock invert;

        }

        services-options {

            inactivity-timeout seconds;

            open-timeout seconds;

            syslog {

                host hostname {

                    facility-override facility-name;

                    log-prefix prefix-number;

                    services priority-level;

                }

            }

        }

        shdsl-options {

            annex (annex-a | annex-b);

            line-rate line-rate;

            loopback (local | payload | remote);

            snr-margin {

                current margin;

                snext margin;

            }

        }

        sonet-options {

            aggregate asx;

            aps {

                advertise-interval milliseconds;

                authentication-key key;

                force;

                hold-time milliseconds;

                lockout;

                neighbor address;

                paired-group group-name;

                protect-circuit group-name;

                request;

                revert-time seconds;

                switching-mode (bidirectional | unidirectional);

                working-circuit group-name;

            }

            bytes {

                c2 value;

                e1-quiet value;

                f1 value;

                f2 value;

                s1 value;

                z3 value;

                z4 value;

            }

            fcs (16 | 32);

            loopback (local | remote); 

            mpls {

                pop-all-labels {

                    required-depth number;

                }

            }

            path-trace trace-string;

            (payload-scrambler | no-payload-scrambler);

            rfc-2615; 

            trigger {

                defect ignore;

                defect hold-time up milliseconds down milliseconds;

                }

            }

            vtmapping (itu-t | klm);

            (z0-increment | no-z0-increment);

        }

         speed (10m | 100m | oc3 | oc12 | oc48);

        stacked-vlan-tagging;

        t1-options {

            bert-algorithm algorithm; 

            bert-error-rate rate; 

            bert-period seconds; 

            buildout value;

            byte-encoding (nx56 | nx64);

            fcs (16 | 32);

            framing (esf | sf);

            idle-cycle-flag (flags | ones); 

            invert-data;

            line-encoding (ami | b8zs);

            loopback (local | payload | remote); 

            remote-loopback-respond;

            start-end-flag (filler | shared); 

            timeslots time-slot-range;

        }

        t3-options {

            atm-encapsulation (direct | plcp);

            bert-algorithm algorithm; 

            bert-error-rate rate; 

            bert-period seconds; 

            buildout feet;

            (cbit-parity | no-cbit-parity); 

            compatibility-mode (adtran | digital-link | kentrox | larscom | verilink) 

                     <subrate value>; 

            fcs (16 | 32);

            (feac-loop-respond | no-feac-loop-respond);

            idle-cycle-flag value; 

            (long-buildout | no-long-buildout);

            (loop-timing | no-loop-timing);

            loopback (local | payload | remote); 

            (mac | no-mac);

            (payload-scrambler | no-payload-scrambler); 

            start-end-flag (filler | shared); 

        }

        traceoptions {

            flag flag <flag-modifier> <disable>;

        }

        transmit-bucket {

            overflow discard;

            rate percentage;

            threshold bytes;

        }

        (traps | no-traps); 

        unit {

            logical-interface-statements;

            }

        }

        vlan-tagging;

    }

}

This chapter discusses configuration of the following physical interface properties:

• Specifying an Aggregated Interface
• Specifying a USB Modem Interface
• Adding an Interface Description to the Configuration
• Configuring the Link Characteristics
• Configuring the Media MTU
• Configuring Interface Encapsulation
• Configuring the PPP Challenge Handshake Authentication Protocol
• Configuring the PPP Password Authentication Protocol
• Monitoring a PPP Session
• Tracing Operations of the pppd Process
• Configuring PPP Address and Control Field Compression
• Configuring the PPP Protocol Field Compression
• Configuring the Interface Speed
• Configuring Keepalives
• Configuring the Clock Source
• Configuring the Router as a DCE
• Configuring Receive and Transmit Leaky Bucket Properties
• Configuring Accounting for the Physical Interface
• Interface Diagnostics
• Tracing Operations of an Individual Router Interface
• Damping Interface Transitions
• Configuring Multiservice Physical Interface Properties
• Enabling or Disabling SNMP Notifications on Physical Interfaces
• Disabling a Physical Interface

For information about interface-specific physical properties, see Interface Types.

Table 8 lists statements that you can use to configure physical interfaces.

Table 8: Statements for Physical Interface Properties

Statement	Interface Types	Usage Guidelines
802.3ad aex	Aggregated Ethernet interfaces	Configuring Ethernet Link Aggregation or Configuring Aggregated Ethernet Interfaces
access-profile name	Interfaces with Point-to-Point Protocol (PPP) encapsulation	Configuring the PPP Challenge Handshake Authentication Protocol
accounting-profile name	All	Configuring Accounting for the Physical Interface
acfc	Interfaces with PPP encapsulation	Configuring a PPPoE Interface
acknowledge-retries number	Link services and voice services interfaces	JUNOS Services Interfaces Configuration Guide
acknowledge-timer milliseconds	Link services and voice services interfaces	JUNOS Services Interfaces Configuration Guide
action-red-differential-delay (disable-tx | remove-link)	Link services and voice services interfaces	JUNOS Services Interfaces Configuration Guide
advertise-interval milliseconds	SONET/SDH interfaces	Configuring APS and MSP
aggregate	Gigabit Ethernet intelligent queuing (IQ) interfaces and Gigabit Ethernet interfaces with small form-factor pluggable transceivers (SFPs) (except the 10-port Gigabit Ethernet PIC and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers
aggregate asx	Aggregated SONET/SDH interfaces	Configuring Aggregated SONET/SDH Interfaces
aggregated-ether-options	Aggregated Ethernet interfaces	Configuring Aggregated Ethernet Interfaces
aggregate-ports	SONET/SDH interfaces	Specifying OC768-over-OC192 Mode
aggregated-sonet-options	Aggregated SONET/SDH interfaces	Configuring Aggregated SONET/SDH Interfaces
annex (annex-a | annex-b)	ATM interfaces on J-series Services Routers	Configuring SHDSL Operating Mode on an ATM Physical Interface
aps	SONET/SDH interfaces	Configuring APS and MSP
atm-encapsulation (direct | plcp)	E3 and T3 traffic over Asynchronous Transfer Mode (ATM) interfaces	Configuring E3 and T3 Parameters on ATM Interfaces
atm-options	ATM1 and ATM2 IQ interfaces	Configuring ATM Interfaces
authentication-key key	SONET/SDH interfaces	Configuring APS and MSP
backup-interface	E1, E3, T1, T3 and Fast Ethernet	Configuring an ISDN Dialer Interface as a Backup Interface
bandwidth-limit bps	Gigabit Ethernet IQ and Gigabit Ethernet PICs with SFPs (except the 10-port Gigabit Ethernet PIC and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers
bchannel-allocation (ascending | descending);	J-series Services Routers equipped with a Dual-Port Channelized T1/E1 PIM; for Integrated Services Digital Network Primary Rate Interfaces (ISDN PRI)	Allocating B-Channels for Dialout
bert-algorithm algorithm	E3, T1, T3, multichannel DS3, channelized interfaces (DS3, OC12, and STM1), and channelized IQ interfaces (E1 and DS3)	Interface Diagnostics
bert-error-rate rate	E1, E3, T1, T3, and channelized interfaces (DS3, OC3, OC12, and STM1)	Interface Diagnostics
bert-period seconds	E1, E3, T1, T3, and channelized interfaces (DS3, OC12, and STM1)	Interface Diagnostics
boot-command filename	Adaptive services, monitoring services, and collector interfaces	Configuring Multiservice Physical Interface Properties
boot-command length	Gigabit Ethernet IQ and Gigabit Ethernet PICs with SFPs (except the 10-port Gigabit Ethernet PIC and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers
buildout value	T1 interfaces	Configuring the T1 Buildout
buildout feet	E3 and T3 traffic over ATM interfaces	Configuring E3 and T3 Parameters on ATM Interfaces
burst-size-limit bytes	Gigabit Ethernet IQ and Gigabit Ethernet PICs with SFPs (except the 10-port Gigabit Ethernet PIC and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers
byte-encoding (nx56 | nx64)	DS0 and T1 interfaces	Configuring T1 Byte Encoding
bytes [ values ]	SONET/SDH interfaces	Configuring SONET/SDH Header Byte Values
(cbit-parity | no-cbit-parity)	T3 interfaces	Disabling T3 C-Bit Parity Mode
cbr rate	ATM interfaces	Defining the ATM Traffic-Shaping Profile
cell-bundle-size cells	ATM2 IQ interfaces using ATM Layer 2 circuit cell-relay transport mode	Configuring the Layer 2 Circuit Cell-Relay Cell Maximum
chap	Interfaces with PPP encapsulation	Configuring the PPP Challenge Handshake Authentication Protocol
cisco-interoperability send-lip-remove-link-for-link-reject	link services IQ (lsq) interfaces	JUNOS Services Interfaces Configuration Guide
classifier	Gigabit Ethernet IQ interfaces	Specifying an Output Priority Map
clocking clock-source	ATM, DS0, E1, E3, SONET/SDH, T1, and T3 interfaces	Configuring the Clock Source
clocking-mode (dce | dte | loop)	Serial interfaces (EIA-530 and V.35)	Configuring the Serial Clocking Mode
clock-rate rate	Serial interfaces (EIA-530 and V.35)	Configuring the DTE Clock Rate
compatibility-mode mode	E3 and T3 interfaces	Configuring the E3 CSU Compatibility Mode and Configuring the T3 CSU Compatibility Mode
compression	Interfaces with PPP encapsulation.	Configuring the PPP Protocol Field Compression
control-polarity (negative | positive)	Serial interfaces (X.21)	Configuring Serial Signal Polarities
control-signal (assert | de-assert | normal)	Serial interfaces (X.21)	Configuring the Serial Signal Handling
(core-dump | no-core-dump)	Adaptive services, monitoring services, and collector interfaces	Configuring Multiservice Physical Interface Properties
cts (ignore | normal | require)	Serial interfaces (EIA-530 and V.35)	Configuring the Serial Signal Handling
cts-polarity (negative | positive)	Serial interfaces (EIA-530 and V.35)	Configuring Serial Signal Polarities
current margin	ATM interfaces on J-series Services Routers	Configuring SHDSL Operating Mode on an ATM Physical Interface
dcd (ignore | normal | require)	Serial interfaces (EIA-530 and V.35)	Configuring the Serial Signal Handling
dcd-polarity (negative | positive)	Serial interfaces (EIA-530 and V.35)	Configuring Serial Signal Polarities
dce	Interfaces with Frame Relay encapsulation	Configuring the Router as a DCE
dce-options	Serial interfaces (EIA-530, V.35, and X.21) on J-series Services Routers.	Configuring the Serial Signal Handling
default-chap-secret name	Interfaces with Point-to-Point Protocol (PPP) encapsulation	Configuring a Default CHAP Secret
description text	All	Adding an Interface Description to the Configuration
dialer-options	ISDN interfaces	Configuring ISDN Physical Interface Properties
disable	All	Disabling a Physical Interface, Tracing Operations of an Individual Router Interface, and Tracing Operations of an Individual Router Interface
down-count	ATM interfaces	Configuring ATM Interfaces
drop-timeout milliseconds	Multilink, link services, and voice services interfaces	JUNOS Services Interfaces Configuration Guide
ds0-options	DS0 interfaces	Channelized Interfaces Overview
dsr (ignore | normal | require)	Serial interfaces (EIA-530 and V.35)	Configuring the Serial Signal Handling
dsr-polarity (negative | positive)	Serial interfaces (EIA-530 and V.35)	Configuring Serial Signal Polarities
dte-options	Serial interfaces (EIA-530, V.35, and X.21) on M-series and T-series routing platforms.	Configuring the Serial Signal Handling
dtr signal-handling-option	Serial interfaces (EIA-530 and V.35)	Configuring the Serial Signal Handling
dtr-circuit (balanced | unbalanced)	Serial interfaces (EIA-530 and V.35)	Configuring the Serial DTR Circuit
dtr-polarity (negative | positive)	Serial interfaces (EIA-530 and V.35)	Configuring Serial Signal Polarities
e1-options	E1 interfaces	Configuring E1 Interfaces
e3-options	E3 interfaces	Configuring E3 Interfaces
encapsulation type	All interfaces, except loopback and multicast tunnel	Configuring Interface Encapsulation
encoding (nrz | nrzi)	Serial interfaces (EIA-530, V.35, and X.21)	Configuring Serial Line Encoding
epd-threshold cells	ATM2 interfaces	Configuring ATM2 IQ VC Tunnel CoS Components
es-options	ES interfaces	JUNOS Services Interfaces Configuration Guide
ethernet-policer-profile	Gigabit Ethernet IQ and Gigabit Ethernet PICs with SFPs (except the 10-port Gigabit Ethernet PIC, and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers
ethernet-switch-profile	Gigabit Ethernet IQ and Gigabit Ethernet PICs with SFPs (except the 10-port Gigabit Ethernet PIC, Aggregated Ethernet with Gigabit Ethernet IQ interfaces, and the built-in Gigabit Ethernet port on the M7i platform)	Configuring Gigabit Ethernet Policers, Configuring MAC Address Filtering, and Configuring the Management Ethernet Interface
facility-override facility-name	Adaptive services interfaces	JUNOS Services Interfaces Configuration Guide
fastether-options	Fast Ethernet interfaces	Configuring Ethernet Physical Interface Properties
fcs (16 | 32)	E1/E3, SONET/SDH, and T1/T3 interfaces	Configuring the E1 Frame Checksum, Configuring the E3 Frame Checksum, Configuring the SONET/SDH Frame Checksum, Configuring the T1 Frame Checksum, and Configuring the T3 Frame Checksum
(feac-loop-respond | no-feac-loop-respond)	T3 interfaces	Configuring the T3 FEAC Response
(flow-control | no-flow-control)	Aggregated Ethernet, Fast Ethernet, and Gigabit Ethernet interfaces	Configuring Flow Control
force	SONET/SDH interfaces	Configuring APS and MSP
forwarding-class class-name	Gigabit Ethernet IQ and ATM2 interfaces	Configuring ATM2 IQ VC Tunnel CoS Components and Specifying an Output Priority Map
fragment-threshold bytes	Multilink, link services, and voice services interfaces	JUNOS Services Interfaces Configuration Guide
framing framing-type	10-gigabit Ethernet, SONET, E1, E3, and T1 interfaces	Configuring E3 and T3 Parameters on ATM Interfaces, Configuring E1 Framing, and Configuring T1 Framing, Configuring 10-Gigabit Ethernet Framing, and Configuring SONET Options for 10-Gigabit Ethernet Interfaces.
gigether-options	Gigabit Ethernet interfaces	Configuring Ethernet Physical Interface Properties
(gratuitous-arp-reply | no-gratuitous-arp-reply)	Ethernet interfaces	Configuring Gratuitous ARP
hello-timer milliseconds	Link services and voice services interfaces	JUNOS Services Interfaces Configuration Guide
high-plp-max-threshold	ATM2 interfaces	Configuring Linear RED Profiles
high-plp-threshold percent	ATM2 interfaces