CodingBox Documentation

Ports and uplinks

A switch's front panel is a set of roles, not just a set of holes: downlinks that face devices, uplinks that face the rest of the network, stacking ports that face sibling switches, management ports that face the operator. Each role has a typical speed, medium, module and failure mode. This page sorts the ports by role, explains the confusing overlap of "access", "trunk" and "uplink", quantifies oversubscription, and covers uplink modules, link aggregation on uplinks and how uplink optics are chosen.

Port roles

RoleFacesTypical mediumSpeedsCount on a 48-port access switch
Downlink / accessend devices, serversRJ45 (PoE), SFP/SFP+/SFP281G–25G (mGig 2.5/5/10G on copper)24–48
Uplinkdistribution/spineSFP+/SFP28/QSFP+/QSFP28/QSFP-DD10G–400G2–8
Stackingsibling switches in a stackproprietary cable or QSFP+/QSFP28 with stacking firmware40–480 Gb/s per ring2
Management (OOB)management networkRJ45 (sometimes SFP)100M/1G1
ConsoleoperatorRJ45 (RS-232) and/or USB-C/mini-USB1–2
USBfile storage, ZTP imagesUSB-A1
Comboeither RJ45 or SFP, one active1G2–4 on small switches

On data-centre leaf/spine switches every front port is the same (32 × QSFP-DD); "uplink" is a configuration role, not a hardware class (Switch roles & topologies).

TermLayerMeaningConfusion
Access port (L2)2carries one untagged VLANvs. "access switch" (a role in the hierarchy)
Trunk port (L2)2carries several VLANs with 802.1Q tagsvs. Juniper/HP "trunk" = LAG in some CLIs
Uplinkphysical/rolethe link toward the core; usually an L2 trunk or an L3 routed portan uplink can be an access port (single VLAN) or a routed interface
Downlinkphysical/roletoward devices or lower tier
Routed port3has an IP address, no VLAN taggingleaf–spine uplinks are routed

Forwarding-layer detail: Forwarding basics.

Oversubscription

DesignDownlink capacityUplink capacityRatioTypical use
48 × 1G + 4 × 10G48 Gb/s40 Gb/s1.2 : 1campus access
48 × 1G + 2 × 10G48202.4 : 1campus access, budget
48 × 10G + 6 × 40G4802402 : 1older DC leaf
48 × 25G + 8 × 100G1 2008001.5 : 1DC leaf, general compute
48 × 25G + 6 × 100G1 2006002 : 1DC leaf, budget
32 × 100G split 16/161 6001 6001 : 1storage, AI
64 × 400G split 32/3212 80012 8001 : 1AI back-end

Ratio = sum of downlink speeds ÷ sum of uplink speeds. 3 : 1 is tolerable for office traffic, 1 : 1 required where any-to-any traffic runs at line rate (GPU fabrics). Uplinks are usually aggregated (LAG or ECMP), so their optics fail as a group of independent links rather than one big pipe.

Campus switches often take a removable uplink module: 4 × SFP+, 2 × SFP28 + 2 × QSFP28, 4 × 25G, 2 × 40G/100G. Points to check:

  • the module has its own supported-optics list and sometimes its own power budget;
  • ports on the module may not support breakout or 1G;
  • some modules are hot-swappable, others need a reload;
  • stacking may consume uplink ports or a dedicated slot (Stacking & MLAG).
MethodWhat it givesOptics consequence
LAG / port-channel (LACP)N links to one neighbour act as oneall members same speed and, ideally, same module type; one member with CRC errors degrades hashed flows
MLAG / vPC / VLTLAG across two neighboursmembers land on two switches — count optics for both
L3 ECMPN routed uplinks, equal costleaf–spine default; each uplink independent, BFD detects failures
Stacking ringswitch-to-switch backplanededicated cables/optics, not counted as uplinks

A single 100G uplink versus 4 × 25G LAG: same capacity on paper, but a single flow is capped at one member's speed in a LAG, while the 100G carries it whole (Breakout & MPO cabling).

A 100G QSFP28 uplink split into 4 × 25G reaches four leaves from one spine port; a 400G port split into 4 × 100G quadruples radix. Which ports allow it, how children are named and what the module must advertise: Port types & cages, Port naming & LEDs.

QuestionAnswer decides
Distance and fibre typeSR/SR4 on MMF ≤ 100–400 m; DR/FR/LR on SMF for 500 m–10 km; ER/ZR/CWDM/DWDM beyond (Reach tables)
Fibre count availableparallel (MPO) SR4/DR4 need 8 fibres; duplex LC FR4/LR4/CWDM4 need 2
Both ends' cages100G QSFP28 to 25G SFP28 → breakout; QSFP-DD to QSFP28 → QSFP28 module in the DD cage
FEC and speed policy of both NOSesmust match (Port configuration recipes)
Module policy of both vendorsOEM, coded or third-party (How each NOS validates a module)
Power budget of the uplink cage40 km ER4 / ZR modules may exceed it (Power & consumption)
Redundancytwo uplinks on two different modules/paths; spares on site
  • PoE on copper access ports: 15.4 / 30 / 60 / 90 W per port (802.3af/at/bt); PoE budget shares the PSU with the optics — a fully loaded PoE switch may derate.
  • Multigig RJ45 (2.5/5/10GBASE-T) uses USXGMII PHYs (SGMII & serial gigabit).
  • Server downlinks at 25G/100G: DAC ≤ 3 m, AOC beyond, optics rarely (DAC vs AOC).
  • Copper SFPs in SFP downlinks: SGMII mode needed for 10/100 clients.

Typical port faults by role

RoleFrequent problemWhere to look
UplinkFEC/speed mismatch between two vendors; wrong fibre polarity on MPOSpeed & rate, No link
Downlink (server)DAC without AN, 25G port group speed conflictPort types & cages
Downlink (copper SFP)10/100 client will not linkSGMII & serial gigabit
Stackingnon-stacking cable/module in a stack portStacking & MLAG
ComboSFP inserted but RJ45 side activemedia-type setting
Managementin-band and OOB confused, wrong VRFManagement & monitoring

In CodingBox

Whatever the role, each fibre port reads its module's memory first. Confirming a module's speed codes, power class and identity on the bench before install — especially for uplinks between different vendors — avoids a port that silently stays down (Check transceiver).

Choosing the module for the fibre behind the port — matching table by fibre type and distance, budget from the module's side, connector and polish rules, common mismatches: Transceivers in the link.