opx config fanout

COMMAND

opx-config-fanout — Using a breakout cable, you can split a 40GbE physical port into four (quad) 10GbE SFP+ ports, or a 100GbE port into four 25GbE SFP28 ports (if supported by the NPU). Each fanned-out port is represented by a Linux interface with a fanout field in the interface name that identifies the fanned-out port.

The fanout configuration can be saved persistently over reboots if you edit the /etc/opx/startup/config-interfaces file on the target.

SYNOPSIS

opx-config-fanout [-h,--help]
[portID <mode> <interface_speed>]

OPTIONS

Option	Description
-h,--help	Displays help text
portID <mode> <interface_speed>	Sets the port mode and interface speed to fanout or fanin during switch operation

EXAMPLES

Fanout/Fanin during switch operation

You can fanout a 40GbE port, then return the physical port to 40G operation.

opx-config-fanout portID <mode> <interface_speed>

Fanout e101-027-0 port

root@OPX:/# opx-config-fanout --port e101-027-0 --mode 4x1 --speed 10g 
_port 105
_port 106
_port 107
_port 108
Deleting... e101-027-0
Completed...
_port 105
_port 106
_port 107
_port 108
Creating interface e101-027-1
Creating interface e101-027-2
Creating interface e101-027-3
Creating interface e101-027-4
Successfully created interfaces

Unconfigure fanout e101-027-0 port

root@OPX:/# opx-config-fanout --port e101-027-1 --mode 1x1 --speed 40g 
_port 105
_port 106
_port 107
_port 108
Deleting... e101-027-1
Deleting... e101-027-2
Deleting... e101-027-3
Deleting... e101-027-4
Completed...
_port 105
_port 106
_port 107
_port 108
Creating interface e101-027-0
Successfully created interfaces

PERSISTANCE

To persist fanout settings across reboots, see the self-documented /etc/opx/startup/config-interfaces file on the target. A copy can also be found in the opx-platform-config repository.

SPECIAL CONSIDERATIONS

Some NPUs have various capabilities or limitations that require special considerations for fanout.

Dell EMC S5248F-ON and S5296F-ON

The S5248F-ON and S5296F-ON require that groups of four ports (known as "port-groups") share the same speed setting. For port-groups, the same opx-config-fanout command is used, but with a "4x4" grouping for the 10 and 25 GbE access ports.

Example

root@OPX:~# opx-config-fanout --pg_name port-group-8 --mode 4x4 --speed 10g
Given port group name is valid
dell-pg/port-groups-state/port-group-state/id = port-group-8
Port-group profile type: ethernet_sfp28
dell-pg/port-groups/port-group/id = port-group-8
Current breakout-mode: 7
Current port-speed: 5
List of ports in port group: [29, 30, 31, 32]
_port 21
Deleting... e101-029-0
Completed...
_port 21
Creating interface e101-029-0
Successfully created interfaces
_port 22
Deleting... e101-030-0
Completed...
_port 22
Creating interface e101-030-0
Successfully created interfaces
_port 23
Deleting... e101-031-0
Completed...
_port 23
Creating interface e101-031-0
Successfully created interfaces
_port 24
Deleting... e101-032-0
Completed...
_port 24
Creating interface e101-032-0
Successfully created interfaces
Change port-group breakout mode and port speed configuration
True
port-group-8
4x4
ether
10g
Success
Key: 1.271.268.17563676.17563672.17563663.
dell-pg/port-groups/port-group/phy-mode = 1
dell-pg/port-groups/port-group/port-speed = 4
cps/object-group/return-code = 0
dell-pg/port-groups/port-group/breakout-mode = 7
dell-pg/port-groups/port-group/id = port-group-8

Dell EMC Z9264F-ON

The Z9264F-ON has 64 100GbE QSFP28 ports, but the NPU supports up to 128 physical ports. To avoid exceeding the physical port limit, pairs of ports (known as a "hybrid-group") must be set to "restricted" or "unrestricted" profile modes. Hybrid groups in "unrestricted" mode can not be fanned out, but may operate at 40/100 GbE speeds. Hybrid groups in "restricted" mode only have one operational port that may be fanned out.

Fanout port on the Z9264F-ON

1. Set the hybrid-group to restricted mode.
2. Set the hybrid-group breakout setting.

Example fanout

root@OPX:~#  opx-config-hybrid-group set hybrid-group profile --name hybrid-group-12 --profile restricted
Namespace(command='set', config='profile', name='hybrid-group-12', profile='restricted', subcommand='hybrid-group')
e101-023-0
Success

root@OPX:~# opx-config-hybrid-group set hybrid-group port --name hybrid-group-12 --port-id 23 --breakout 10gx4
Namespace(breakout='10gx4', command='set', config='port', name='hybrid-group-12', phy_mode='ether', port_id='23', subcommand='hybrid-group')
e101-023-1
Success

Example fanin

root@OPX:~# opx-config-hybrid-group set hybrid-group port --name hybrid-group-12 --port-id 23 --breakout 100gx1
Namespace(breakout='100gx1', command='set', config='port', name='hybrid-group-12', phy_mode='ether', port_id='23', subcommand='hybrid-group')
e101-023-1