{"id":6351,"date":"2026-05-04T12:10:31","date_gmt":"2026-05-04T12:10:31","guid":{"rendered":"http:\/\/docs.connexite.co.uk\/index.php\/docs\/connexite-documentation\/synapse-cli-documentation\/cli-configuring-ethernet-interface\/"},"modified":"2026-05-04T12:19:08","modified_gmt":"2026-05-04T12:19:08","slug":"cli-configuring-ethernet-interface","status":"publish","type":"docs","link":"https:\/\/docs.connexite.co.uk\/index.php\/docs\/network\/synapse-cli-documentation\/cli-configuring-ethernet-interface\/","title":{"rendered":"Configuring Ethernet Interface"},"content":{"rendered":"<h2 class=\"connexite-doc-h2\">Overview of Interface Types<\/h2>\n<p>The interfaces of switch can be divided into the following two categories: Layer 2 interfaces and Layer 3 interfaces. L2 interface\uff0cIncluding common physical ports (Switch Port) and aggregate ports (Port Channel). Switch Port consists of a single physical port on the device and only support Layer 2 switching. The port can be an Access Port, Hybrid Port or a Trunk Port. Port Channel is formed by the aggregation of multiple physical member ports. We can bundle multiple physical links together to form a simple logical link, which we call an aggregate port. For Layer 2 switching, the aggregation port can superimpose the bandwidth of multiple ports to expand the link bandwidth. L3 interface\uff0cHere mainly refers to the SVI port. SVI is a switching virtual interface, a logical interface used to implement Layer 3 switching. SVI can be used as the local management interface, through which the administrator can manage the device. You can create an SVI with the interface vlan interface configuration command, and then assign an IP address to the SVI to establish routing between VLANs.<\/p>\n<h2 class=\"connexite-doc-h2\">Configuring<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Interface Range Mode<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)# interface IFNAME_RANGE<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Specify the range of interfaces to be configured, and enter interface-range configuration mode. When there are multiple range combinations, separate them with &#039;,&#039; without spaces. For example, the command interface range gigabitEthernet 0\/1-4, gigabitEthernet 0\/9-12 is a valid range. You can use the interface range command to configure up to five port ranges; Each interface-range must consist of the same port type.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# description DESC<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Add a description (up to 80 characters) for an interface.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# shutdown<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no shutdown<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Shut down an interface.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# speed {10 | 100 | 1000 | auto}<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no speed<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Enter auto to enable the interface to autonegotiate speed with the connected device. If you use the 10, 100, or the 1000 keywords with the auto keyword, the port autonegotiates only at the specified speeds\uff1b<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# duplex {auto | full | half}<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no duplex<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Enable half-duplex mode (for interfaces operating only at 10 or 100 Mbps). You cannot configure half-duplex mode for interfaces operating at 1000 Mbps Attention: \u2726 When both speed and duplex exit auto mode, port auto-negotiation is disabled. Flow control enables connected Ethernet ports to control traffic rates during congestion by allowing congested nodes to pause link operation at the other end. If one port experiences congestion and cannot receive any more traffic, it notifies the other port by sending a pause frame to stop sending until the condition clears. Upon receipt of a pause frame, the sending device stops sending any data packets, which prevents any loss of data packets during the congestion period.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# flowcontrol {on | off }<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Configure the flow control mode for the port. on: The port cannot send pause frames but can operate with an attached device that is required to or can send pause frames; the port can receive pause frames. off: Flow control does not operate in either direction. In case of congestion, no indication is given to the link partner, and no pause frames are sent or received by either device. When a port performs high-throughput data exchange, it may encounter a frame larger than the Ethernet standard frame length, which is called a jumbo frame. The user can control the maximum frame length that the port is allowed to send and receive by setting the MTU of the port. Frames received or forwarded by the port, if the length exceeds the set MTU, will be discarded. Due to chip limitations, the MTU value only supports even numbers. If the user configures an odd number, the device will auto-align to even. For example, if the MTU is configured as 127, it actually works as 128.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# mtu LENGTH<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no mtu<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Change the MTU size for the interface on the switch. The range is 46 to 10222 bytes; the default is 1500 bytes.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# port mode {sgmii | 2500BASE-X | 1000BASE-X | 10G}<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no port mode<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">1000BASE-X:The port operate at 1000Mbps, full-duplex only. Sgmii: Enables connection to external copper transceivers. 2500BASE-X: The port operate at 2.5G, full-duplex only. 10G: The port operate at 2.5G, full-duplex only. If a port can be configured both fiber and copper medium types, you can only use one of them. Once the medium type is determined, configure the properties of the port, such as duplex, flow control, and rate, which all refer to the properties of the currently selected type of port.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# medium {copper | fiber | auto [prefer (copper | fiber)]}<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no medium<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Configuring interface medium type. Default is auto mode\uff0cprefer copper. Copper\uff1aIndicates the choice of copper medium type. Fiber\uff1aIndicates the choice of fiber medium type. Auto\uff1aIndicates the adaptive port media type\uff0cDetermine whether it is an copper or fiber port based on the access medium, prefer copper. Auto prefer copper\uff1aIndicates the adaptive port media type\uff0cWhen both fiber and copper are connected, prefer the copper port. Auto prefer fiber\uff1aIndicates the adaptive port media type\uff0cWhen both fiber and copper are connected, prefer the fiber port. No operation restores the media type to copper. In some situations, you need to prevent Layer 2 (L2) connectivity between end devices on a switch, you can use the isolate function. When some ports are set as isolated ports, the isolated ports cannot communicate with each other, the isolated port and the non-isolated port can communicate normally, and the non-isolated port and the non-isolated port can communicate normally.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#switchport isolate<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no switchport isolate<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Setting the port as an isolated port.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# autoneg on<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)# no autoneg<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Configure port auto-negotiation on and off. Only applicable to 1000M optical port, If this command is configured on other ports, it prompts failure. Default is on. By show interface brief command, You can view the auto-negotiation status of the link up ports.<\/p>\n<h2 class=\"connexite-doc-h2\">Examples<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Enter gigabitEthernet0\/1 Interface Configuration Mode\uff1a<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH#<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH#configure terminal<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Enter configuration commands, one per line. End with CNTL\/Z.<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config)#interface gigabitEthernet0\/1<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#description TEST_A<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#no shutdown<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#speed 100<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#duplex full<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#flowcontrol on<\/code><\/pre>\n<pre class=\"connexite-doc-command\"><code>SWITCH(config-if)#mtu 1024<\/code><\/pre>\n<h2 class=\"connexite-doc-h2\">Display Information<\/h2>\n<ul class=\"connexite-doc-list\">\n<li>Display Brief Information of All Ports<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH#show interface brief<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211;<\/p>\n<h2 class=\"connexite-doc-h2\">Ethernet Type Status Reason Speed Duplex Flowcontrol Autoneg Port<\/h2>\n<p>Interface Ch # &#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211; GiE0\/1 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/2 ETH up none 1000M FULL OFF ON &#8212; GiE0\/3 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/4 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/5 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/6 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/7 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/8 ETH up none 100M FULL OFF ON &#8212; GiE0\/9 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/10 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/11 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212; GiE0\/12 ETH down none &#8212; &#8212; &#8212; &#8212; &#8212;<\/p>\n<ul class=\"connexite-doc-list\">\n<li>Display Single Port Configuration and Status<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH#show interface gigabitethernet0\/1<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface gigabitethernet0\/1 Hardware is eth current hw addr: 0050.4c82.89a0 Physical:0050.4c82.89a0<\/p>\n<p>Description: test_a Index 1 metric 0 mtu 1024 speed-unknown duplex-unknown flowcontrol-unknown<\/p>\n<h2 class=\"connexite-doc-h2\">Port mode is invalid<\/h2>\n<p>&lt;up&gt; vrf binding: not bound Bandwidth -8 Input packets 0677, bytes 072690, Multicast packets 0327 broadcast packets 0350 fcs error 00 undersizeerrors 00 oversizeerrors 00 Output packets 00, bytes 00, Multicast packets 00 broadcast packets 00<\/p>\n<ul class=\"connexite-doc-list\">\n<li>Display Port Packet Statistics<\/li>\n<\/ul>\n<pre class=\"connexite-doc-command\"><code>SWITCH#show interface gigabitEthernet0\/1 counters<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">Interface gigabitEthernet16\/1 Good Octets Tx : 1914949 Good Octets Rx : 0 Bad Octets Rx : 0 Mac Tx Err Pkts : 0 Good Packets Tx : 1913 Good Packets Rx : 0 Bad Packets Rx : 0 Broadcast Packet Tx : 24 Broadcast Packets Rx : 0 Multicast Packet Tx : 55 Multicast Packets Rx : 0 pkts_64_octets : 285 pkts_65_127_octets : 263 pkts_128_255_octets : 42 pkts_256_511_octets : 36 pkts_512_1023_octets : 91 pkts_1024_max_octets : 1196 Excessive Collisions : 0 UnRecg MAC Cntl Pkts Rx : 0 Flow Ctrl Pkts Sent : 0 Flow Ctrl Pkts Recvd : 0 Drop Events : 0 Undersized Pkts Recvd : 0 Fragments Recvd : 0 Oversized Pkts Recvd : 0 Jabber Pkts Recvd : 0 mac_rcv_error : 0 Bad CRC : 0 Collisions : 0 Late Collisions : 0 Bad Flow Ctrl Recv : 0<\/p>\n<pre class=\"connexite-doc-command\"><code>SWITCH#show switchport isolate<\/code><\/pre>\n<p class=\"connexite-doc-command-desc\">interface config GiE0\/1 isolated GiE0\/2 normal GiE0\/3 normal GiE0\/4 normal GiE0\/5 normal GiE0\/6 normal GiE0\/7 normal GiE0\/8 normal GiE0\/9 normal GiE0\/10 normal<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Networking \u203a Switching \u203a Edge \u203a Synapse<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":6349,"menu_order":2,"comment_status":"open","ping_status":"closed","template":"","doc_tag":[115,119,116],"class_list":["post-6351","docs","type-docs","status-publish","hentry","doc_tag-connexite","doc_tag-network","doc_tag-synapse-cli-documentation","no-post-thumbnail"],"acf":[],"_links":{"self":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6351","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/comments?post=6351"}],"version-history":[{"count":1,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6351\/revisions"}],"predecessor-version":[{"id":6399,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6351\/revisions\/6399"}],"up":[{"embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/docs\/6349"}],"wp:attachment":[{"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/media?parent=6351"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.connexite.co.uk\/index.php\/wp-json\/wp\/v2\/doc_tag?post=6351"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}